# 抖音 推荐流 API (douyin.feed)

- Canonical page: [https://everyinfra.com/douyin-api/feed](https://everyinfra.com/douyin-api/feed?utm_medium=ai_doc&utm_campaign=page_md)
- Endpoint: POST https://api.everyinfra.com/api/v1/social with {"platform": "douyin", "action": "feed", "params": {...}}
- Price: $0.000556 per call ($0.56 per 1,000 requests); failed calls and empty results are not charged
- Returns: list, one page of up to 20 per call; the number of rows varies from page to page and a short page is not the end (limit is ignored; pass the top-level next_page_token from the response as page_token for the next page; no next_page_token means the end)
- Pagination: pass next_page_token back as page_token for the next page, other params unchanged; one call per page, tokens last 24 hours
- Mode: sync; add "mode": "async" for slow tasks

## Health

- Live health (24h percent, hourly and daily trends): https://api.everyinfra.com/api/v1/social/availability?platform=douyin&action=feed

## Parameters

| name | type | required | default | description |
|---|---|---|---|---|
| channel | enum: anime / food / game / home / knowledge / music | no | not declared | 要看的推荐流：home 首页推荐（默认）、game 游戏、anime 二次元、food 美食、knowledge 知识、music 音乐。 |
| page_token | not declared | no | not declared | 翻页令牌。不传是第 1 页；之后把上一页响应里的 next_page_token 原样传回取下一页，其余参数不变。令牌 24 小时内有效；翻到底时没有 next_page_token。一页约 20 条，有时更少；页与页之间可能有重复的视频，按 id 去重。 |

## Response fields (items in `results`)

| field | meaning |
|---|---|
| id | 该记录在原平台上的唯一标识。仅在同一平台内唯一，跨平台可能重复。 |
| url | 该记录在原平台上的可访问链接。 |
| text | 正文内容，已去除 HTML 标签，全文返回、不截断（个别平台的列表结果本身只有摘要，以该平台的字段说明为准）。 |
| media_type | 媒体类型。 |
| video_url | 视频播放地址（带签名、会过期，要留存请及时下载）；图文笔记或来源没给时为 null。 |
| like_count | 点赞数。null 表示该平台或该接口不公开此数据，不等于 0。 |
| comment_count | 评论数。null 表示不公开，不等于 0。 |
| share_count | 分享/转发数。null 表示不公开，不等于 0。 |
| collect_count | 收藏数。null 表示不公开，不等于 0。 |
| author_name | 作者昵称（显示名）。 |
| author_id | 作者在原平台的唯一 ID。 |
| author_douyin_id | 作者抖音号。 |
| author_bio | 作者主页简介（search / user_posts / video / posts_batch / related_posts / mix_posts / music_posts 行上）。 |
| author_avatar_url | 作者头像链接：search / user_posts / video / posts_batch / related_posts / mix_posts / music_posts 行上是博主的，live_room 上是主播的，comments 行上是评论者的。 |
| author_follower_count | 作者粉丝数。null 表示不公开。 |
| author_following_count | 作者关注数（search / user_posts / video / posts_batch / related_posts / mix_posts / music_posts 行上）。 |
| author_like_count | 作者主页获赞总数（search / user_posts / video / posts_batch / related_posts / mix_posts / music_posts / transcript）。 |
| author_video_count | 作者作品总数（search / user_posts / video / posts_batch / related_posts / mix_posts / music_posts 行上）。 |
| author_is_verified | 作者是否认证（search / user_posts / video / posts_batch / related_posts / mix_posts / music_posts 行上；live_room 上是主播是否认证；comments 行上是评论者是否认证）。 |
| cover_image_url | 封面图链接：search / user_posts / posts_batch / related_posts / mix_posts / music_posts / media_links 是作品封面，music_search / music_detail 是音乐封面，billboard_topic_hot 是话题配图，user_mixes 是合集封面，live_room 是直播间封面；带签名的会过期。 |
| video_width | 视频画面宽度（像素）。 |
| video_height | 视频画面高度（像素）。 |
| video_bitrates | 各清晰度播放地址：[{quality（清晰度名）, bitrate（码率，bps）, fps, is_h265（是否 H.265 编码）, width, height（像素）, url}]，来源没给的项不出现；地址带签名、会过期（见 video_url_expires_at）。 |
| has_watermark | 平台对这条作品视频文件的水印标记（true 表示带水印）。 |
| duration_sec | 视频时长（秒）。 |
| duration_seconds | 时长，单位秒。非视频/音频内容为 null。 |
| hashtags | 正文里的话题标签数组，按出现顺序；没有时不出现这个字段。 |
| posted_at | 发布时间，ISO 8601 格式、UTC 时区（如 2026-08-07T12:34:56+00:00）。平台只给非标准字符串时原样透传，解析前建议做容错。null 表示平台未公开。 |
| title | 标题。平台无标题概念时（如纯文本帖）为 null。 |
| music | 作品背景音乐：id、title（曲名）、author（演唱/作者）、is_original（是否原声）、duration_sec（秒）、cover_url、play_url（音频地址，可能会过期）；没有音乐信息时没有这个键。 |
| location | 作品定位的地点（POI）：id、name、category（地点分类）、address、district、city、province、country、city_code、latitude、longitude、cover_url、popularity_text（如 327人想去）、view_count、post_count（该地点下的作品数）、collect_count、visitor_count；作品没带定位时没有这个键。 |
| image_urls | 图片链接数组，按平台展示顺序；没有图片时不出现这个字段。 |
| is_deleted | 作品已被删除时为 true；抖音在作品行上标了才有这个键。 |
| is_private | 作品仅自己可见（私密）时为 true；抖音在作品行上标了才有这个键。 |
| platform | 数据来源平台标识，与请求里的 platform 一致（如 xiaohongshu、tiktok）。 |

## Example

```bash
curl -X POST 'https://api.everyinfra.com/api/v1/social' \
  -H "Authorization: Bearer $EVERYINFRA_API_KEY" \
  -H 'Content-Type: application/json' \
  --data-raw '{
  "platform": "douyin",
  "action": "feed",
  "params": {}
}'
```

```python
import os
import requests

response = requests.post(
    "https://api.everyinfra.com/api/v1/social",
    headers={"Authorization": f"Bearer {os.environ['EVERYINFRA_API_KEY']}"},
    json={
        "platform": "douyin",
        "action": "feed",
        "params": {},
    },
    timeout=120,
)
print(response.status_code)
print(response.json())
```

## Response example

Real response to the example request above, captured 2026-11-21T07:17:52Z. `results` and `count` are real with personal information (names, handles, avatars, profile links, contact details) removed; the list keeps the first 2 of 19. `id`, `billing` and `quota` differ on every call, so only their shape is shown.

```text
{
  "id": "req_…",
  "platform": "douyin",
  "action": "feed",
  "results": [
    {
      "id": "•••",
      "url": "https://www.douyin.com/video/7710215594045377827",
      "text": "AI重制版《包氏父子》1-14合集 #包氏父子 #包国维",
      "media_type": "video",
      "video_url": "https://v26-webf.douyinvod.com/89778069ccaa779bfcb12828ff1d9f80/6b017a0a/video/tos/cn/tos-cn-ve-15/oQRvTAW6dATwAGtbiEIUr3a9BPIrxQN9JiuAA/?a=6383&ch=224&cr=3&dr=0&lr=all&cd=0%7C0%7C0%7C3&cv=1&br=938&bt=938&cs=0&ds=4&ft=4rzAgkIKDDhNJFVQ9wm3NOXhd.F-STL03-ApQX&mime_type=video_mp4&qs=…",
      "like_count": 24884,
      "comment_count": 708,
      "share_count": 6452,
      "collect_count": 5474,
      "author_name": "冷•••C",
      "author_id": "•••",
      "author_douyin_id": "•••",
      "author_bio": "•••",
      "author_avatar_url": "https://p3-pc.douyinpic.com/•••",
      "author_follower_count": 0,
      "author_video_count": 0,
      "author_is_verified": false,
      "cover_image_url": "https://p3-pc-sign.douyinpic.com/image-cut-tos/8eeda9b08f2c217a81cf2ef9d3ef5de7~tplv-dy-vqe2-sr-opt1:640:480:q80.webp?lk3s=138a59ce&x-expires=2110604400&x-signature=UiUhBJDEdO%2BD9JNaqZEKh4dSREg%3D&from=327834062&s=PackSourceEnum_DOUYIN_WEB_NEW_PAGE&se=false&sc=cover&biz_tag=pcwe…",
      "video_width": 1920,
      "video_height": 1080,
      "video_bitrates": [
        {
          "bitrate": 1036528,
          "width": 3840,
          "height": 2160,
          "url": "https://v26-webf.douyinvod.com/8be6e082b9e5a7e14f4d133b3debcb72/6b017a0a/video/tos/cn/tos-cn-ve-15/oQBTGYQPDhtAIRPIdViiTDAaA9E3vNwAWAIx0/?a=6383&ch=224&cr=3&dr=0&lr=all&cd=0%7C0%7C0%7C3&cv=1&br=1012&bt=1012&cs=2&ds=10&ft=4rzAgkIKDDhNJFVQ9wm3NOXhd.F-STL03-ApQX&mime_type=video_mp4&…"
        },
        {
          "bitrate": 961101,
          "width": 1920,
          "height": 1080,
          "url": "https://v26-webf.douyinvod.com/89778069ccaa779bfcb12828ff1d9f80/6b017a0a/video/tos/cn/tos-cn-ve-15/oQRvTAW6dATwAGtbiEIUr3a9BPIrxQN9JiuAA/?a=6383&ch=224&cr=3&dr=0&lr=all&cd=0%7C0%7C0%7C3&cv=1&br=938&bt=938&cs=0&ds=4&ft=4rzAgkIKDDhNJFVQ9wm3NOXhd.F-STL03-ApQX&mime_type=video_mp4&qs=…"
        },
        {
          "bitrate": 772434,
          "width": 1280,
          "height": 720,
          "url": "https://v26-webf.douyinvod.com/91086e1d14e49293765a39c1e38342ed/6b017a0a/video/tos/cn/tos-cn-ve-15/oQvwhitEAQAAibRNWGPugaIOx3TwIE4T9BTAP/?a=6383&ch=224&cr=3&dr=0&lr=all&cd=0%7C0%7C0%7C3&cv=1&br=754&bt=754&cs=0&ds=3&ft=4rzAgkIKDDhNJFVQ9wm3NOXhd.F-STL03-ApQX&mime_type=video_mp4&qs=…"
        }
      ],
      "has_watermark": false,
      "duration_sec": 2616,
      "hashtags": [
        "包氏父子",
        "包国维"
      ],
      "posted_at": "2026-11-21T00:00:00+00:00",
      "title": "AI重制版《包氏父子》1-14合集 #包氏父子 #包国维",
      "music": {
        "id": "•••",
        "title": "@•••",
        "author": "冷•••C",
        "duration_sec": 2616,
        "cover_url": "https://p3-pc.douyinpic.com/aweme/1080x1080/aweme-avatar/tos-cn-i-0813c000-ce_ogBiAi9AeI3iNiTAOnSPCxzjmpA0C9wyLpEeAE.jpeg?from=327834062",
        "play_url": "https://sf11-cdn-tos.douyinstatic.com/obj/ies-music/7710206805162330922.mp3"
      },
      "is_deleted": false,
      "is_private": false,
      "platform": "douyin",
      "duration_seconds": 2616
    },
    {
      "id": "•••",
      "url": "https://www.douyin.com/video/7710090076230847779",
      "text": "渡边淳一《钝感力》精读 看完视频，你比90%的人更懂“钝感优势”#心理学 #人生智慧 #认知思维 #精读好书 #抖音精选app征稿中 \n内容摘要：\n1. **核心定义**：钝感并非麻木迟钝，而是过滤负面信息的心理韧性，可快速从批评、挫败中抽离，避免情绪内耗，守护长期专注力。\n2. **生理价值**：有助于维持自律神经平衡，减轻压力对血管与脏器的损耗；肠胃、睡眠、五官的适度钝感，更利于健康长寿。\n3. **职场成长**：面对指责能剥离情绪、萃取有效信息，不因单次否定停滞；才华需钝感托底，才能在反复打磨中真正兑现。\n4. **人际婚恋**：亲密关系与日常相处…",
      "media_type": "video",
      "video_url": "https://v26-webf.douyinvod.com/8ffb35e57c22dc92105ba23ca191d0e2/6b017936/video/tos/cn/tos-cn-ve-15/oMACZBlAjCrReE8fqEG3EgBaIfV2IQLAfbGDAk/?a=6383&ch=224&cr=3&dr=0&lr=all&cd=0%7C0%7C0%7C3&cv=1&br=1417&bt=1417&cs=0&ds=4&ft=4rzAgkIKDDhNJFVQ9wm3NOXhd.F-STL03-ApQX&mime_type=video_mp4&…",
      "like_count": 710,
      "comment_count": 17,
      "share_count": 132,
      "collect_count": 431,
      "author_name": "达•••记",
      "author_id": "•••",
      "author_bio": "•••",
      "author_avatar_url": "https://p3-pc.douyinpic.com/•••",
      "author_follower_count": 0,
      "author_video_count": 0,
      "author_is_verified": false,
      "cover_image_url": "https://p3-pc-sign.douyinpic.com/image-cut-tos/89131e678344ea695ea8dcdf5febdd70~tplv-dy-vqe2-sr-opt1:640:480:q80.webp?lk3s=138a59ce&x-expires=2110604400&x-signature=swp5YY%2F%2Fi9S%2FkzA86zq2dluGDds%3D&from=327834062&s=PackSourceEnum_DOUYIN_WEB_NEW_PAGE&se=false&sc=cover&biz_tag=…",
      "video_width": 1920,
      "video_height": 1080,
      "video_bitrates": [
        {
          "bitrate": 1451788,
          "width": 1920,
          "height": 1080,
          "url": "https://v26-webf.douyinvod.com/8ffb35e57c22dc92105ba23ca191d0e2/6b017936/video/tos/cn/tos-cn-ve-15/oMACZBlAjCrReE8fqEG3EgBaIfV2IQLAfbGDAk/?a=6383&ch=224&cr=3&dr=0&lr=all&cd=0%7C0%7C0%7C3&cv=1&br=1417&bt=1417&cs=0&ds=4&ft=4rzAgkIKDDhNJFVQ9wm3NOXhd.F-STL03-ApQX&mime_type=video_mp4&…"
        },
        {
          "bitrate": 1396636,
          "width": 1920,
          "height": 1080,
          "url": "https://v26-webf.douyinvod.com/79472b4a252594d9b3c17e2962e2b83a/6b02a086/video/tos/cn/tos-cn-vd-0026/oEAAegAAA6qAQZnWpPiyBifA9AEBgg6CBIPAhJ/media-video-avc1/?a=6383&ch=0&cr=8&dr=0&er=1&lr=default&cd=0%7C0%7C0%7C3&cv=1&br=1363&bt=1363&cs=0&ds=4&mime_type=video_mp4&qs=0&rc=NDo2ZjM7…"
        },
        {
          "bitrate": 1055420,
          "width": 1280,
          "height": 720,
          "url": "https://v26-webf.douyinvod.com/3df65b80108b3ed5de964d8076c4445f/6b017936/video/tos/cn/tos-cn-ve-15/ocqfAGARIBGAfIML3sEkfrwQq5CC2DSpg4QleE/?a=6383&ch=224&cr=3&dr=0&lr=all&cd=0%7C0%7C0%7C3&cv=1&br=1030&bt=1030&cs=0&ds=3&ft=4rzAgkIKDDhNJFVQ9wm3NOXhd.F-STL03-ApQX&mime_type=video_mp4&…"
        }
      ],
      "has_watermark": false,
      "duration_sec": 2404,
      "hashtags": [
        "心理学",
        "人生智慧",
        "认知思维"
      ],
      "posted_at": "2026-11-20T12:30:00+00:00",
      "title": "渡边淳一《钝感力》精读 看完视频，你比90%的人更懂“钝感优势”#心理学 #人生智慧 #认知思维 #精读好书 #抖音精选app征稿中",
      "music": {
        "id": "•••",
        "title": "@•••",
        "author": "达•••记",
        "duration_sec": 2403,
        "cover_url": "https://p3-pc.douyinpic.com/aweme/1080x1080/aweme-avatar/tos-cn-i-0813c000-ce_owEcA0lEuuJiAMiejYIA61Ae4pwfmWwUADaEKB.jpeg?from=327834062",
        "play_url": "https://sf6-cdn-tos.douyinstatic.com/obj/ies-music/7710079304729971475.mp3"
      },
      "is_deleted": false,
      "is_private": false,
      "platform": "douyin",
      "duration_seconds": 2404
    }
  ],
  "next_page_token": …,
  "pagination": { … },
  "count": 19,
  "billing": {
    "charged": …,
    "charged_usd": …,
    "balance_after_usd": …,
    …
  },
  "quota": { … }
}
```

## Also

- Capability catalog (no key): https://api.everyinfra.com/api/v1/social/catalog?platform=douyin
- OpenAPI: https://everyinfra.com/openapi.json · Agents guide: https://everyinfra.com/agents.md
