# Douyin News feed API (douyin.feed)

- Canonical page: [https://everyinfra.com/en/douyin-api/feed](https://everyinfra.com/en/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 | Which recommendations to read: `home` for the home page (default), `game`, `anime`, `food`, `knowledge` or `music`. |
| page_token | not declared | no | not declared | Page token for `feed`. Leave it out for the first page, then pass back the previous response's `next_page_token` exactly as received, keeping the other inputs unchanged. Tokens last 24 hours; the last page has no `next_page_token`. A page holds about 20 videos, sometimes fewer; pages can repeat a video, so de-duplicate by `id`. |

## Response fields (items in `results`)

| field | meaning |
|---|---|
| id | The record's unique ID on the platform. Unique only within one platform; IDs can repeat across platforms. |
| url | Link to the record on the platform. |
| text | Body text with HTML removed, returned in full and never cut short (on a few platforms the list results themselves carry only an excerpt; the platform's field notes say so). |
| media_type | Media type: video, or image for image posts. |
| video_url | Video playback URL (signed, expires; download promptly if you need to keep it). Null for image posts or when the source omits it. |
| like_count | Likes. null means the platform or this capability does not disclose it; it is not 0. |
| comment_count | Comments. null means not disclosed, not 0. |
| share_count | Shares. null means not disclosed, not 0. |
| collect_count | Saves or favorites. null means not disclosed, not 0. |
| author_name | Author's display name. |
| author_id | Author's unique ID on the platform. |
| author_douyin_id | The author's Douyin ID. |
| author_bio | The author's profile bio (search / user_posts / video / posts_batch / related_posts / mix_posts / music_posts rows). |
| author_avatar_url | Author avatar image URL: the creator on search / user_posts / video / posts_batch / related_posts / mix_posts / music_posts rows, the host on live_room, the commenter on comments rows. |
| author_follower_count | Author's follower count. null means not disclosed. |
| author_following_count | How many accounts the author follows (search / user_posts / video / posts_batch / related_posts / mix_posts / music_posts rows). |
| author_like_count | Total likes the author's profile has received (search / user_posts / video / posts_batch / related_posts / mix_posts / music_posts / transcript). |
| author_video_count | Total number of posts on the author's profile (search / user_posts / video / posts_batch / related_posts / mix_posts / music_posts rows). |
| author_is_verified | Whether the author is verified (search / user_posts / video / posts_batch / related_posts / mix_posts / music_posts rows; on live_room, whether the host is; on comments rows, whether the commenter is). |
| cover_image_url | Cover image URL: the cover of a video or image post on search, user_posts, posts_batch, related_posts, mix_posts, music_posts and media_links rows; the music cover on music_search and music_detail; the topic image on billboard_topic_hot; the collection cover on user_mixes; the room cover on live_room. Signed links expire. |
| video_width | Video frame width in pixels. |
| video_height | Video frame height in pixels. |
| video_bitrates | platform-native meaning |
| has_watermark | platform-native meaning |
| duration_sec | Video length in seconds. |
| duration_seconds | Duration in seconds. null for content that is not video or audio. |
| hashtags | Hashtags in the text, in order of appearance; absent when there are none. |
| posted_at | Publish time in ISO 8601, UTC (for example 2026-08-07T12:34:56+00:00). Non-standard strings from the platform are passed through as is, so parse defensively. null means the platform does not disclose it. |
| title | Title. null when the platform has no titles (for example text-only posts). |
| music | Background track: id, title, author, is_original (original sound or not), duration_sec, cover_url and play_url (audio link, may expire). Absent when there is no music information. |
| location | Location description passed through as is; the format varies by platform. |
| image_urls | Array of image links in the platform's display order; absent when there are no images. |
| is_deleted | True when the video has been deleted; present only when Douyin reports it on the row. |
| is_private | True when the video is visible only to its author (private); present only when Douyin reports it on the row. |
| platform | Source platform identifier, the same as platform in the request (for example 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
