Douyin News feed API
Read the videos in the Douyin home recommendation feed with no required parameter, one row per video: text, like_count, comment_count, share_count and collect_count, for $0.56 per 1,000 calls. Set channel to food, game and so on for other feeds.
channelhas six values:home,game,anime,food,knowledgeandmusic.- Pages can repeat a video, so remove duplicates by
id. - Failed calls and empty results are not charged.
API health
- 24h health
- Normal
- Healthy / normal
- Available
- Limited
- Mostly down
Last 24 hours
Last 30 days
1Request
POST /api/v1/social { "platform": "douyin", "action": "feed", "params": {} }2JSON response
{ "results": [ { "author_name": "冷•••C", "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=…" }, … ], "count": 19 }3Rows
author_name text media_type video_url 冷•••C AI重制版《包氏父子》1-14合集 #包氏父子 #包国维 video 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=… 达•••记 渡边淳一《钝感力》精读 看完视频,你比90%的人更懂“钝感优势”#心理学 #人生智慧 #认知思维 #精读好书 #抖音精选app征稿中 内容摘要: 1. **核心定义**:钝感并非麻木迟钝,而是过滤负面信息的心理韧性,可快速从批评、挫败中抽离,避免情绪内耗,守护长期专注力。 2. **生理价值**:有助于维持自律神经平衡,减轻压力对血管与脏器的损耗;肠胃、睡眠、五官的适度钝感,更利于健康长寿。 3. **职场成长**:面对指责能剥离情绪、萃取有效信息,不因单次否定停滞;才华需钝感托底,才能在反复打磨中真正兑现。 4. **人际婚恋**:亲密关系与日常相处… video 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&… 4CSV
douyin-feed-sample.csv id,url,text,media_type,video_url,like_count,comment_count,share_count,collect_count,author_name,author_id,author_douyin_id,author_bio,author_avatar_url,author_follower_count,author_following_count,author_like_count,author_video_count,author_is_verified,cover_image_url,video_width,video_height,video_bitrates,has_watermark,duration_sec,duration_seconds,hashtags,posted_at,title,music,location,image_urls,is_deleted,is_private,platform
results is one video, listed as a field table and a CSV file.What data you get
The table shows a real call with no required parameter, captured November 21, 2026 at 07:17 (UTC), that returned 19 rows; gray bars mark removed personal information (••• in the CSV). Your own calls return these fields as listed in the field reference.
| id | url | text | media_type | video_url | like_count | comment_count | share_count | collect_count | author_name | author_id | author_douyin_id | author_bio | author_avatar_url | author_follower_count | author_following_count | author_like_count | author_video_count | author_is_verified | cover_image_url | video_width | video_height | video_bitrates | has_watermark | duration_sec | duration_seconds | hashtags | posted_at | title | music | location | image_urls | is_deleted | is_private | platform |
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| https://www.douyin.com/video/7710215594045377827 | AI重制版《包氏父子》1-14合集 #包氏父子 #包国维 | video | 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=… | 24884 | 708 | 6452 | 5474 | 冷•••C | 0 | null | null | 0 | false | 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… | 1920 | 1080 | [{"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=…"}] | false | 2616 | 2616 | ["包氏父子","包国维"] | 2026-11-21T00:00:00+00:00 | AI重制版《包氏父子》1-14合集 #包氏父子 #包国维 | {"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"} | null | null | false | false | douyin | |||||
| https://www.douyin.com/video/7710090076230847779 | 渡边淳一《钝感力》精读 看完视频,你比90%的人更懂“钝感优势”#心理学 #人生智慧 #认知思维 #精读好书 #抖音精选app征稿中 内容摘要: 1. **核心定义**:钝感并非麻木迟钝,而是过滤负面信息的心理韧性,可快速从批评、挫败中抽离,避免情绪内耗,守护长期专注力。 2. **生理价值**:有助于维持自律神经平衡,减轻压力对血管与脏器的损耗;肠胃、睡眠、五官的适度钝感,更利于健康长寿。 3. **职场成长**:面对指责能剥离情绪、萃取有效信息,不因单次否定停滞;才华需钝感托底,才能在反复打磨中真正兑现。 4. **人际婚恋**:亲密关系与日常相处… | video | 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&… | 710 | 17 | 132 | 431 | 达•••记 | null | 0 | null | null | 0 | false | 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=… | 1920 | 1080 | [{"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&…"}] | false | 2404 | 2404 | ["心理学","人生智慧","认知思维"] | 2026-11-20T12:30:00+00:00 | 渡边淳一《钝感力》精读 看完视频,你比90%的人更懂“钝感优势”#心理学 #人生智慧 #认知思维 #精读好书 #抖音精选app征稿中 | {"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"} | null | null | false | false | douyin |
Use cases
See what the home feed pushes now
Read
text,hashtagsandlike_countof the home feed to see which kinds of content the platform is pushing at the moment.Sample by channel
Set
channeltofood,gameandknowledgein turn, read one page each, and compareshare_countandcollect_countacross the channels.Find new accounts
Read
author_nameandauthor_id, then pass accounts you have not seen before toprofile.Read a single video next
Pass the
urlof a row tovideofor the details, or tocommentsfor the comments.
Douyin Open Platform vs EveryInfra
Here is how the Douyin Open Platform documentation and EveryInfra feed compare on what you need to connect.
| Compared | Douyin Open Platform | EveryInfra |
|---|---|---|
| Access you need | The documentation says that third-party developers who have applied for the user management permission and have the user's authorization can get the matching data. | One EveryInfra API key in the Authorization: Bearer header. The request has no required parameter, and no user needs to authorize anything. |
The Douyin Open Platform documentation is in Chinese. The table shows a translation, checked against the page on 2026-11-22. The page shows no update date. The Open Platform API list has no endpoint for the home feed or the channel feeds, so this row compares only what you need to connect. Official sources: User information access solution
Limits and gotchas
- No parameter is required.
channelis optional:homefor the home feed (the default),game,anime,food,knowledgeandmusic. - One call returns one page. The number of rows per page is not fixed. A video can appear on more than one page, so remove duplicates by
id. - To get the next page, pass
next_page_tokenback aspage_tokenand keep the other parameters. The token is valid for 24 hours, and the last page has nonext_page_token. - The rows have no play count field. Judge reach with
like_count,comment_count,share_countandcollect_count. video_urlis signed and expires. It isnullfor an image post or when the source gives none.
Pricing
You pay $0.000556 per call, not per row. One call returns one page, so each page you read counts as one call. Failed calls and empty results are not charged.
| Calls | Cost |
|---|---|
| 10,000 | $5.56 |
| 100,000 | $55.56 |
| 1,000,000 | $555.56 |
Totals use the list price per call.
Code samples
#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": {}
}'OpenAPI definition (JSON)Samples read the key from the EVERYINFRA_API_KEY environment variable; copied code never contains your key.
API reference
See the parameters, response fields, errors and billing for feed, and copy the page or open it as Markdown for an AI assistant.
AI prompt
#Please help me write a data collection script with the EveryInfra Douyin News feed endpoint (douyin/feed).
How the endpoint works:
- Request: POST https://api.everyinfra.com/api/v1/social with the header Authorization: Bearer <API key>. Read the key from the EVERYINFRA_API_KEY environment variable and never hard-code it.
- In the request body, set platform to douyin and action to feed, and put the parameters inside params.
- No required parameters.
- Optional parameters:
- channel: Which recommendations to read: home for the home page (default), game, anime, food, knowledge or music. (allowed: anime / food / game / home / knowledge / music)
- page_token: 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.
- Returns a list of records. Main fields of each record: id, url, text, media_type (Media type: video, or image for image p…), video_url (Video playback URL (signed, expires), like_count, comment_count, share_count, collect_count, author_name, author_id, author_douyin_id (The author's Douyin ID); 34 fields in total, full list at https://api.everyinfra.com/api/v1/social/catalog?platform=douyin.
- Example request body:
{
"platform": "douyin",
"action": "feed",
"params": {}
}
- Price: $0.56 per 1,000 requests; failed and empty results are not charged.
- For dozens or hundreds of targets, add "mode": "async" to the body: you get a job_id at once and poll GET https://api.everyinfra.com/api/v1/jobs/{job_id} for the result.
- On 422, fix the request using the suggested parameter names and allowed values in the error; on 429 or 503, wait for Retry-After and try again.
Before writing code, ask me which targets I need, how many, which fields, and what output format I want; then confirm the plan and the rough cost with me.Request parameters
#| Name | In | Type | Required | Default | Description |
|---|---|---|---|---|---|
Authorization | header | string | Yes | - | Bearer followed by your API key. Create it in the console; never put it in a URL or a code repository. |
platform | body | string | Yes | douyin | Platform identifier, fixed value. |
action | body | string | Yes | feed | Capability identifier, fixed value. |
channel | body.params | string (enum) | No | - | Which recommendations to read: home for the home page (default), game, anime, food, knowledge or music.Allowed valuesanimefoodgamehomeknowledgemusic |
page_token | body.params | string | No | - | 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 example
#{ "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": { … }}
Response fields
#Business data is in results. The table lists the fields a record can contain; values the platform does not show are never made up.
| 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 | Keeps the platform's own meaning |
has_watermark | Keeps the platform's own 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). |
Errors and billing
#- 401
- Missing or invalid key.
- 402
- Insufficient balance. Top up first.
- 422
- Invalid parameter name or value. Fix it using the suggestions in the error. No charge.
- 429
- Per-minute request limit reached. Wait for Retry-After, then try again.
- 503
- Could not complete. The held charge is returned to your balance. If the outcome is unknown, verify it before you retry.
- 200 empty
- No data. No charge.
FAQ
What does the Douyin recommendation feed API return?
One row per video: id, url, text, media_type, video_url, like_count, comment_count, share_count, collect_count, hashtags and posted_at, plus author fields such as author_name and author_id.
How do I read the feed of one topic only?
Set channel to game, anime, food, knowledge or music. Without it you get the home feed, home.
How much does one page of the feed cost?
It costs $0.000556 per call, or $0.56 per 1,000 calls, billed per call and not per row. Failed calls and empty results are not charged.
Related Douyin endpoints
You can call the other Douyin endpoints with the same EveryInfra API key.
- Search
search$8.33 per 1,000 callsFind Douyin videos for a search term. - Details
profile$0.56 per 1,000 callsLook up a Douyin account by secUid. - Posts by user
user_posts$0.56 per 1,000 callsTrack the videos a Douyin account publishes, newest first. - Video details
video$0.56 per 1,000 callsFetch one Douyin video's caption, hashtags, length, engagement counts, author profile, background music and publish time from its video link, plusis_deletedandis_privatewhen Douyin reports them. - Comments
comments$0.56 per 1,000 callsPull viewer comments on a Douyin video, with likes, reply count, IP region, hot-comment and author-liked flags, mentions and any images. - Comment replies
comment_replies$0.56 per 1,000 callsList the replies under one top-level comment on a Douyin video, up to 100 per call, read 20 at a time. - Trending
trending$0.56 per 1,000 callsCheck Douyin's trending boards for hot keywords. - Transcript
transcript$0.56 per 1,000 callsTurn a Douyin video's speech into text with sentence-level timestamps. - Creator search
creator_search$0.56 per 1,000 callsSearch Douyin creator accounts by nickname, handle or phrase. - Creator audience
creator_audience$0.56 per 1,000 callsBreak down a Douyin creator's followers by device price band, gender, age or province, with each bucket's share and its TGI index. - Creator growth trend
creator_trend$0.56 per 1,000 callsTrack a Douyin creator's follower count over time as a dated series, with the average follower count across the window. - Creator benchmark
creator_benchmark$0.56 per 1,000 callsCompare a Douyin creator with similar accounts through average posts, likes, comments, shares and follower growth, each with a percentile rank. - Xingtu creator search
xingtu_creator_search$0.56 per 1,000 callsSearch Douyin's Xingtu creator records by keyword. - Xingtu creator analytics
xingtu_creator_analytics$0.56 per 1,000 callsGet a creator's Xingtu commercial profile on Douyin. - Xingtu creator rate card
xingtu_rate_card$0.56 per 1,000 callsSee the rate tiers a Douyin creator lists on Xingtu. - Xingtu creator rankings
xingtu_creator_rankings$0.56 per 1,000 callsPull up to five creators from a Douyin Xingtu ranking board. - Product search
product_search$8 per 1,000 callsSearch Douyin Mall products by keyword, up to 30 a page. - Shop store products
shop_products$8 per 1,000 callsList the products of one Douyin Mall shop from its numericshop_id, 10 a page. - Product details
product_detail$8 per 1,000 callsRead one Douyin Mall product by numeric ID. - Live product search
live_product_search$0.56 per 1,000 callsFind up to three Douyin products sold in live streams now for a keyword. - Hashtag search
hashtag_search$15.56 per 1,000 callsFind Douyin hashtags whose names contain akeyword, ranked by heat. - Hashtag detail
hashtag_detail$15.56 per 1,000 callsRead one Douyin hashtag by its numerichashtag_idfromhashtag_search. - Hot video board
billboard_video_hot$0.81 per 1,000 callsRead the video board of Hot Spot Treasure, Douyin's own trend tool: the overall board, or the boards for highest follower growth or highest like rate, over the last hour, day, 3 days or 7 days. - Low-follower hit board
billboard_low_fan_explosion$0.81 per 1,000 callsSpot Douyin works from small accounts that took off, from the low-follower hit board in Hot Spot Treasure. - High completion-rate board
billboard_high_completion$0.81 per 1,000 callsSee which Douyin works viewers watch to the end, from the high completion-rate board in Hot Spot Treasure. - Hot search board
billboard_search_hot$0.81 per 1,000 callsFind the search terms rising on Douyin, from the search board in Hot Spot Treasure. - Hot Spot account search
billboard_account_search$0.81 per 1,000 callsLook for Douyin accounts related to akeywordthrough Hot Spot Treasure, with follower, like and video counts for each. - Music search
music_search$8 per 1,000 callsSearch Douyin's music library by song title, artist or sound name. - Search suggestions
search_suggest$8 per 1,000 callsGet the autocomplete suggestions Douyin's search box shows for akeyword, in Douyin's order, withrankfrom 1. - Billboard rise list
billboard_rise_list$0.81 per 1,000 callsSpot the trends climbing fastest on Douyin, from the rising board in Hot Spot Treasure. - Billboard challenge hot
billboard_challenge_hot$0.81 per 1,000 callsRead the challenge board of Hot Spot Treasure, Douyin's own trend tool: the whole board of 50 trends in one call. - Billboard topic hot
billboard_topic_hot$0.81 per 1,000 callsSee which Douyin hashtags are heating up, from the hashtag board in Hot Spot Treasure, over the last hour, day, 3 days or 7 days. - Music detail
music_detail$0.81 per 1,000 callsRead one Douyin track by the numericmusic_idfrommusic_search, or a douyin.com/music link. - Xingtu creator conversion ability
xingtu_conversion_ability$1.6 per 1,000 callsRead the conversion figures Xingtu shows for one Douyin creator's Xingtu order videos over the last 7, 30 or 90 days: related videos, median plays, component clicks and click rate, CPC, GPM, average sales, products promoted and their categories. - Xingtu connected-user structure
xingtu_link_structure$16 per 1,000 callsSee how many users Xingtu counts as connected to one Douyin creator, split into Xingtu's four levels, each with its count, its share of the total and the median for creators in the same industry. - Xingtu recommended videos
xingtu_recommended_videos$1.6 per 1,000 callsList the four video groups on a Douyin creator's Xingtu page: signature videos, latest videos, top Xingtu order videos and top personal videos. - Xingtu connected-user sources
xingtu_touch_distribution$16 per 1,000 callsSee which content categories a Douyin creator's connected users came from, as Xingtu counts them: a tree of up to three levels, usually personal versus Xingtu content, then category and subcategory, each with a count. - Xingtu video performance
xingtu_video_performance$16 per 1,000 callsCompare a Douyin creator's personal videos and Xingtu order videos on engagement rate, median plays and completion rate. - Posts in bulk
posts_batch$0.56 per 1,000 callsLook up as many as 20 Douyin videos at once fromurls, each given as a numeric video ID, ahttps://www.douyin.com/video/<video_id>link, av.douyin.comshort link, or a whole share text that contains a short link. - Profiles in bulk
profiles_batch$0.56 per 1,000 callsLook up as many as 20 Douyin accounts at once fromurls, each given as asecUid(startingMS4w) or a profile linkhttps://www.douyin.com/user/<secUid>. - Media download links
media_links$0.56 per 1,000 callsGet download links for as many as 20 Douyin videos at once fromurls, each given as a numeric video ID or ahttps://www.douyin.com/video/<video_id>link; short links and share texts are not accepted. - Related posts
related_posts$0.56 per 1,000 callsList the videos Douyin recommends next to one video, from itsurl: a numeric video ID, ahttps://www.douyin.com/video/<video_id>link, av.douyin.comshort link or a whole share text. - Post metrics history
post_history$0.79 per 1,000 callsRead the saved history of one Douyin video'slike_count,comment_count,share_countandcollect_count. - Posts using a track
music_posts$0.79 per 1,000 callsList the videos that use one Douyin track, from itsmusic_id(taken from a video'smusic.idor frommusic_detail; a douyin.com/music link also works). - Link recognition
resolve_links$0.79 per 1,000 callsFind Douyin links and IDs inside a piece of text, such as a whole share text. - Trending history
trending_history$0.79 per 1,000 callsSee how Douyin trending terms moved over the last hours. - Account collections
user_mixes$0.79 per 1,000 callsList the collections (mixes) a Douyin account has published, from itssecUidinuser_id(aMS4wstring) or ahttps://www.douyin.com/user/<secUid>link. - Collection posts
mix_posts$0.79 per 1,000 callsList the videos in one Douyin collection from itsmix_id(taken fromuser_mixes; ahttps://www.douyin.com/collection/<ID>link also works). - Account overview
user_overview$1.6 per 1,000 callsGet a quick read on one Douyin account from itssecUidinuser_id(aMS4wstring) or ahttps://www.douyin.com/user/<secUid>link; nicknames, Douyin IDs and short links are not accepted. - Live room
live_room$0.79 per 1,000 callsRead one Douyin live room from its numericroom_id, the number inhttps://live.douyin.com/<room_id>. - Short-drama channel
series_feed$0.56 per 1,000 callsList the short dramas on Douyin's short-drama channel, 16 per page. - Short-drama episodes
series_posts$0.79 per 1,000 callsList the episodes of one Douyin short drama from itsseries_id, in episode order, up to 20 per page. - Account short dramas
user_series$0.79 per 1,000 callsList the short dramas a Douyin account has published, from itssecUidinuser_id(aMS4wstring) or ahttps://www.douyin.com/user/<secUid>link, up to 20 per page. - On-screen video comments
danmaku$0.56 per 1,000 callsRead the on-screen comments (danmaku) of one Douyin video from itsurl: a numeric video ID, ahttps://www.douyin.com/video/<video_id>link, av.douyin.comshort link or a whole share text that contains a short link. - Broadcast viewer ranking
live_viewers$0.56 per 1,000 callsRead the viewer ranking of one Douyin broadcast from itslive_id: up to 200 viewers in one response, each withrank,user_id,douyin_id,nickname,avatar_url,is_verifiedandurl. - Short-drama details
series_detail$0.79 per 1,000 callsRead one Douyin short drama from its numericseries_id(fromseries_feedoruser_series; a share link also works). - Collection details
mix_detail$0.56 per 1,000 callsRead one Douyin collection (mix) from its numericmix_id(fromuser_mixes; ahttps://www.douyin.com/collection/<ID>link also works). - Broadcast details
live_session$0.79 per 1,000 callsRead one Douyin broadcast from itslive_id(fromlive_roomoruser_liverows; a new one each time the host goes live, not the number in the live-room link). - User live
user_live$0.79 per 1,000 callsCheck whether a Douyin host is live now, from theirsecUidinuser_id(aMS4wstring) or ahttps://www.douyin.com/user/<secUid>link. - Profile by numeric ID
profile_by_id$0.56 per 1,000 callsLook up a Douyin account by its numericuid: theauthor_uidon video and comment rows, or theuidfromprofile.