抖音推荐流 API
不带必填参数,读抖音首页推荐流里的视频,每行是一条:text、like_count、comment_count、share_count、collect_count,每千次 $0.56;channel 取 food、game 等读对应频道。
channel有home、game、anime、food、knowledge、music六档- 页与页之间可能有重复的视频,按
id去重 - 失败和空结果不收费
接口健康状态
- 24h 健康值
- 正常
- 健康 / 正常
- 可用
- 少量可用
- 基本不可用
24 小时趋势
30 天趋势
1请求
POST /api/v1/social { "platform": "douyin", "action": "feed", "params": {} }2JSON 响应
{ "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 }3行
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 里每行是一条视频,列成字段表,也可下载为 CSV。能拿到什么数据
下表取自一次不带必填参数的真实调用,采集于 2026年11月21日 15:17(UTC),共返回 19 行;灰条是隐去的个人信息(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 |
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| 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 |
用途
看首页此刻在推什么
读首页推荐的
text、hashtags和like_count,看平台当下在推哪类内容。分频道采样
channel分别取food、game、knowledge,各读一页,比较各频道视频的share_count和collect_count。发现新账号
读
author_name和author_id,把没见过的账号交给profile读主页。接着读单条视频
把行里的
url交给video读详情,交给comments读评论。
抖音开放平台 与 EveryInfra 对比
下面从接入条件看,比较抖音开放平台文档和 EveryInfra feed。
| 对比项 | 抖音开放平台 | EveryInfra |
|---|---|---|
| 接入条件 | "已经申请用户管理权限,并且通过用户授权的第三方开发者,可以获取相应数据。" | 一把 EveryInfra API Key 放在 Authorization: Bearer 请求头里,请求不带必填参数,也不需要任何用户授权。 |
引文出自抖音开放平台的用户信息获取接入方案,2026-11-22 核对;页面没有标更新日期。开放平台的 OpenAPI 列表里没有首页和频道推荐流的接口,所以这里只比接入条件。 官方出处: 用户信息获取接入方案
限制和注意事项
- 没有必填参数;
channel可选:home首页推荐(默认)、game游戏、anime二次元、food美食、knowledge知识、music音乐。 - 一次调用返回一页,每页条数不固定;页与页之间可能有重复的视频,按
id去重。 - 拿下一页:把响应里的
next_page_token原样作为page_token传回,其余参数不变,令牌 24 小时内有效,翻到底时没有next_page_token。 - 返回行里没有播放量字段,热度看
like_count、comment_count、share_count和collect_count。 video_url带签名、会过期;图文作品或来源没给时为null。
价格
每次调用 $0.000556,按次计费,不按条数算;一次调用返回一页,翻一页算一次调用。失败和空结果不收费。
| 调用次数 | 费用 |
|---|---|
| 10,000 | $5.56 |
| 100,000 | $55.56 |
| 1,000,000 | $555.56 |
合计按每次调用的标价算。
代码示例
#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 定义 (JSON)示例从环境变量 EVERYINFRA_API_KEY 读取 Key,复制出去的代码不含你的 Key。
API 参考
下面是 feed 的参数、响应字段、错误和计费,可以复制整页,或用 Markdown 打开后交给 AI 助手。
AI 提示词
#请帮我用 EveryInfra 的「抖音推荐流」接口(douyin/feed)写一个数据采集脚本。
接口约定:
- 请求:POST https://api.everyinfra.com/api/v1/social,请求头 Authorization: Bearer <API Key>;Key 从环境变量 EVERYINFRA_API_KEY 读取,不要写进代码。
- 请求体里 platform 填 douyin,action 填 feed,参数放在 params 里。
- 没有必填参数。
- 可选参数:
- channel:要看的推荐流:home 首页推荐(默认)、game 游戏、anime 二次元、food 美食、knowledge 知识、music 音乐。(可选值:anime / food / game / home / knowledge / music)
- page_token:翻页令牌。不传是第 1 页;之后把上一页响应里的 next_page_token 原样传回取下一页,其余参数不变。令牌 24 小时内有效;翻到底时没有 next_page_token。一页约 20 条,有时更少。
- 返回一组记录,每条记录的主要字段:id、url、text、media_type(媒体类型)、video_url(视频播放地址(带签名、会过期)、like_count、comment_count、share_count、collect_count、author_name、author_id、author_douyin_id(作者抖音号);一共 34 个字段,完整列表见 https://api.everyinfra.com/api/v1/social/catalog?platform=douyin。
- 示例请求体:
{
"platform": "douyin",
"action": "feed",
"params": {}
}
- 计费:$0.56 / 千次;失败和空结果不扣费。
- 一次要采几十上百个时,在请求体加 "mode": "async":先拿到 job_id,再轮询 GET https://api.everyinfra.com/api/v1/jobs/{job_id} 取结果。
- 返回 422 时,按错误信息里的候选参数和允许值修正;返回 429 或 503 时,按 Retry-After 等待后重试。
写代码前,先问清楚我要采哪些对象、一共多少个、需要哪些字段、结果存成什么格式,再把方案和大概花费讲给我确认。请求参数
#| 参数名 | 位置 | 类型 | 必填 | 默认值 | 说明 |
|---|---|---|---|---|---|
Authorization | header | string | 是 | - | Bearer 加你的 API Key。在控制台创建;不要放进网址或代码仓库。 |
platform | body | string | 是 | douyin | 平台标识,固定值。 |
action | body | string | 是 | feed | 能力标识,固定值。 |
channel | body.params | string (enum) | 否 | - | 要看的推荐流:home 首页推荐(默认)、game 游戏、anime 二次元、food 美食、knowledge 知识、music 音乐。允许值animefoodgamehomeknowledgemusic |
page_token | body.params | string | 否 | - | 翻页令牌。不传是第 1 页;之后把上一页响应里的 next_page_token 原样传回取下一页,其余参数不变。令牌 24 小时内有效;翻到底时没有 next_page_token。一页约 20 条,有时更少;页与页之间可能有重复的视频,按 id 去重。 |
响应示例
#{ "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": { … }}
返回字段
#业务数据在 results 里;下表是每条记录可能包含的字段,平台没有提供的值不会被编造。
| 字段 | 含义 |
|---|---|
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)。 |
错误与计费
#- 401
- 缺少 Key 或 Key 无效。
- 402
- 余额不足,先充值。
- 422
- 参数名或取值不对,按错误信息给的候选改;不扣费。
- 429
- 超过每分钟请求上限,按 Retry-After 等待后再试。
- 503
- 暂时无法完成,预扣的费用退回;结果未知时先核对,不要直接重发。
- 200 空结果
- 没有数据,不扣费。
常见问题
抖音推荐流接口返回什么?
每行一条视频:id、url、text、media_type、video_url、like_count、comment_count、share_count、collect_count、hashtags、posted_at,加上作者的 author_name、author_id 等字段。
怎么只看某个领域的推荐?
channel 填 game、anime、food、knowledge 或 music;不传就是首页推荐 home。
读一页推荐流要多少钱?
每次 $0.000556,每千次 $0.56,按调用次数算,不按条数算。失败和空结果不收费。
相关的 抖音 能力
同一把 Key 还能调用抖音的其他能力。
- 关键词搜索
search每千次 $8.33关键词搜索:返回列表,默认 10 条、单次最多 50 条;主要字段 next_page_token、id、url、text、media_type、video_url。支持翻页:把响应里的 next_page_token 作为 page_token 传回拿下一页,其他参数不变,每页算一次调用。 - 主页或对象详情
profile每千次 $0.56主页或对象详情:返回单个对象;主要字段 user_id、douyin_id、nickname、bio、url、follower_count。 - 用户内容
user_posts每千次 $0.56用户内容:返回列表,默认 20 条、单次最多 100 条;主要字段 next_page_token、id、url、text、media_type、video_url。支持翻页:把响应里的 next_page_token 作为 page_token 传回拿下一页,其他参数不变,每页算一次调用。 - 视频详情
video每千次 $0.56视频详情:返回单个对象;主要字段 id、url、text、media_type、video_url、like_count。 - 评论
comments每千次 $0.56评论:返回列表,默认 20 条、单次最多 150 条;主要字段 next_page_token、id、text、like_count、reply_count、author_name。支持翻页:把响应里的 next_page_token 作为 page_token 传回拿下一页,其他参数不变,每页按这一页的条数计费,每 20 条算一次调用。 - 评论回复
comment_replies每千次 $0.56评论回复:返回列表,默认 20 条、单次最多 100 条;主要字段 next_page_token、id、text、like_count、author_name、author_id。支持翻页:把响应里的 next_page_token 作为 page_token 传回拿下一页,其他参数不变,每页按这一页的条数计费,每 20 条算一次调用。 - 热榜
trending每千次 $0.56热榜:返回列表,默认 20 条、单次最多 60 条;主要字段 rank、keyword、hot_value、video_count、board、image_url。 - 视频文稿
transcript每千次 $0.56视频文稿:返回单个对象;主要字段 id、url、title、text、posted_at、play_count。 - 达人搜索
creator_search每千次 $0.56达人搜索:返回列表,默认 20 条、单次最多 20 条;主要字段 user_id、douyin_id、nickname、url、avatar_url、follower_count。 - 达人粉丝画像
creator_audience每千次 $0.56达人粉丝画像:返回单个对象;主要字段 user_id、audience_distribution、audience_tgi、dimension_code、platform。 - 达人涨粉趋势
creator_trend每千次 $0.56达人涨粉趋势:返回单个对象;主要字段 user_id、follower_trend、average_follower_count、dimension_code、platform。 - 同类达人对比
creator_benchmark每千次 $0.56同类达人对比:返回单个对象;主要字段 user_id、average_post_count、average_comment_count、average_share_count、average_follower_growth、average_like_count。 - 星图达人搜索
xingtu_creator_search每千次 $0.56星图达人搜索:返回列表,默认 20 条、单次最多 20 条;主要字段 creator_id、user_id、nickname、follower_count、gender、city。 - 星图达人分析
xingtu_creator_analytics每千次 $0.56星图达人分析:返回单个对象;主要字段 creator_id、creator_type、follower_count、average_play_count、city、province。 - 星图达人报价
xingtu_rate_card每千次 $0.56星图达人报价:返回单个对象;主要字段 creator_id、rate_tiers、platform。 - 星图达人榜单
xingtu_creator_rankings每千次 $0.56星图达人榜单:返回列表,默认 5 条、单次最多 5 条;主要字段 creator_id、user_id、url、nickname、avatar_url、gender。 - 商品搜索
product_search每千次 $8商品搜索:返回列表。按关键词搜索抖音商城商品,一页最多 30 条,返回价格、近 30 天销量、好评率、店铺、类目、佣金和合作达人数。目前只出第 1 页,第 2 页起(不管用 page_token 还是 page)暂时回 503、不扣费;每页算一次调用。主来源暂时不可用时改由备用来源返回,这时最多 5 条、没有下一页,且只有 product_id、title、url、image_url、price_cny、price_cny_minor、shop_id、source_keyword 和 search_rank,promotion_id、white_image_url、price_label、monthly_sales、good_review_ratio、sales_trend、category_path、category_ids、category_depth、shop_name、shop_logo_url、shop_score、commission_rate_percent、commission_cny、cooperating_creator_count、tags、recommend_reason 都不出现;标价在一角及以下的是引流起售价,不返回价格。支持翻页:把响应里的 next_page_token 作为 page_token 传回拿下一页,其他参数不变,每页算一次调用。 - 店铺商品
shop_products每千次 $8店铺商品:返回列表,每次一页、固定 10 条(最后一页可能更少),要更多就把响应顶层的 next_page_token 作为 page_token 再调;limit 照收但不起作用;主要字段 next_page_token、product_id、promotion_id、title、url、image_url。支持翻页:把响应里的 next_page_token 作为 page_token 传回拿下一页,其他参数不变,每页算一次调用。 - 商品详情
product_detail每千次 $8商品详情:返回单个对象;主要字段 product_id、title、price_cny、discount_price_cny、sales_text、sold_count。 - 直播商品搜索
live_product_search每千次 $0.56直播商品搜索:返回列表,默认 3 条、单次最多 3 条;主要字段 product_id、sku_id、title、image_url、price_cny、shop_id。 - 话题搜索
hashtag_search每千次 $15.56话题搜索:返回列表,默认 20 条、单次最多 200 条;主要字段 hashtag_id、hashtag_name、search_rank、heat_index、period_video_count、period_like_count。 - 话题详情
hashtag_detail每千次 $15.56话题详情:返回单个对象;主要字段 hashtag_id、hashtag_name、total_view_count、participant_count、created_at、url。 - 热点宝视频热榜
billboard_video_hot每千次 $0.81热点宝视频热榜:返回列表,每次一页、每页最多 50 条,条数不固定(短页不代表到底),要更多就把响应顶层的 next_page_token 作为 page_token 再调,没有 next_page_token 才是到底;limit 照收但不起作用;主要字段 id、url、text、media_type、image_count、cover_image_url。支持翻页:把响应里的 next_page_token 作为 page_token 传回拿下一页,其他参数不变,每页算一次调用。 - 热点宝低粉爆款榜
billboard_low_fan_explosion每千次 $0.81热点宝低粉爆款榜:返回列表,每次一页、每页最多 50 条,条数不固定(短页不代表到底),要更多就把响应顶层的 next_page_token 作为 page_token 再调,没有 next_page_token 才是到底;limit 照收但不起作用;主要字段 id、url、text、media_type、image_count、cover_image_url。支持翻页:把响应里的 next_page_token 作为 page_token 传回拿下一页,其他参数不变,每页算一次调用。 - 热点宝高完播率榜
billboard_high_completion每千次 $0.81热点宝高完播率榜:返回列表,每次一页、每页最多 50 条,条数不固定(短页不代表到底),要更多就把响应顶层的 next_page_token 作为 page_token 再调,没有 next_page_token 才是到底;limit 照收但不起作用;主要字段 id、url、text、media_type、image_count、cover_image_url。支持翻页:把响应里的 next_page_token 作为 page_token 传回拿下一页,其他参数不变,每页算一次调用。 - 热点宝搜索热榜
billboard_search_hot每千次 $0.81热点宝搜索热榜:返回列表,每次一页、固定 50 条(最后一页可能更少),要更多就把响应顶层的 next_page_token 作为 page_token 再调;limit 照收但不起作用;主要字段 rank、keyword、hot_value、search_trend、platform。支持翻页:把响应里的 next_page_token 作为 page_token 传回拿下一页,其他参数不变,每页算一次调用。 - 热点宝账号搜索
billboard_account_search每千次 $0.81热点宝账号搜索:返回列表,每次一页、每页最多 30 条,条数不固定(短页不代表到底),要更多就把响应顶层的 next_page_token 作为 page_token 再调,没有 next_page_token 才是到底;limit 照收但不起作用;主要字段 user_id、nickname、url、avatar_url、follower_count、like_count。支持翻页:把响应里的 next_page_token 作为 page_token 传回拿下一页,其他参数不变,每页算一次调用。 - 音乐搜索
music_search每千次 $8音乐搜索:返回列表,每次一页、固定 10 条(最后一页可能更少),要更多就把响应顶层的 next_page_token 作为 page_token 再调;limit 照收但不起作用;主要字段 id、url、title、author_name、duration_seconds、duration_sec。支持翻页:把响应里的 next_page_token 作为 page_token 传回拿下一页,其他参数不变,每页算一次调用。 - 搜索联想词
search_suggest每千次 $8搜索联想词:返回列表,默认 10 条、单次最多 10 条;主要字段 rank、keyword、platform。 - 热点宝上升热点榜
billboard_rise_list每千次 $0.81热点宝上升热点榜:返回列表,每次一页、固定 50 条(最后一页可能更少),要更多就把响应顶层的 next_page_token 作为 page_token 再调;limit 照收但不起作用;主要字段 rank、rank_change、title、topic_id、hot_value、video_count。支持翻页:把响应里的 next_page_token 作为 page_token 传回拿下一页,其他参数不变,每页算一次调用。 - 热点宝挑战热榜
billboard_challenge_hot每千次 $0.81热点宝挑战热榜:返回列表,默认 50 条、单次最多 50 条(传更大的数按 50 条返回);主要字段 rank、title、topic_id、hot_value、video_count、created_at。 - 热点宝话题热榜
billboard_topic_hot每千次 $0.81热点宝话题热榜:返回列表,每次一页、固定 50 条(最后一页可能更少),要更多就把响应顶层的 next_page_token 作为 page_token 再调;limit 照收但不起作用;主要字段 rank、hashtag_id、hashtag_name、hot_value、total_view_count、total_video_count。支持翻页:把响应里的 next_page_token 作为 page_token 传回拿下一页,其他参数不变,每页算一次调用。 - 音乐详情
music_detail每千次 $0.81音乐详情:返回单个对象;主要字段 id、url、title、author_name、duration_seconds、duration_sec。 - 星图达人转化能力
xingtu_conversion_ability每千次 $1.6星图达人转化能力:返回单个对象;主要字段 creator_id、time_window、related_video_count、video_play_median、component_click_count_range、component_click_rate_range。 - 星图达人连接用户结构
xingtu_link_structure每千次 $16星图达人连接用户结构:返回单个对象;主要字段 creator_id、link_type、total_user_count、total_rank_top_percent、levels、platform。 - 星图达人推荐视频
xingtu_recommended_videos每千次 $1.6星图达人推荐视频:返回单个对象;主要字段 creator_id、signature_videos、latest_videos、top_xingtu_order_videos、top_personal_videos、platform。 - 星图达人连接用户来源
xingtu_touch_distribution每千次 $16星图达人连接用户来源:返回单个对象;主要字段 creator_id、categories、platform。 - 星图达人视频表现
xingtu_video_performance每千次 $16星图达人视频表现:返回单个对象;主要字段 creator_id、personal_videos、xingtu_videos、latest_videos、latest_xingtu_videos、platform。 - 批量查作品
posts_batch每千次 $0.56批量查作品:返回列表;主要字段 id、url、text、media_type、video_url、like_count。 - 批量查作者
profiles_batch每千次 $0.56批量查作者:返回列表;主要字段 user_id、douyin_id、nickname、bio、url、follower_count。 - 作品下载链接
media_links每千次 $0.56作品下载链接:返回列表;主要字段 id、url、media_type、video_url、video_url_expires_at、video_width。 - 相关推荐作品
related_posts每千次 $0.56相关推荐作品:返回列表;主要字段 id、url、text、media_type、video_url、like_count。 - 作品数据历史
post_history每千次 $0.79作品数据历史:返回列表;主要字段 video_id、captured_at、like_count、comment_count、share_count、collect_count。 - 用某段音乐的作品
music_posts每千次 $0.79用某段音乐的作品:返回列表;主要字段 id、url、text、media_type、video_url、like_count。 - 链接识别
resolve_links每千次 $0.79链接识别:返回列表;主要字段 matched_text、match_type、resource_type、resource_id、handle、url。 - 热榜历史
trending_history每千次 $0.79热榜历史:返回列表;主要字段 keyword、board、first_seen_at、last_seen_at、snapshot_count、best_rank。 - 作者的合集
user_mixes每千次 $0.79作者的合集:返回列表,每次一页、每页最多 20 条,条数不固定(短页不代表到底),要更多就把响应顶层的 next_page_token 作为 page_token 再调,没有 next_page_token 才是到底;limit 照收但不起作用;主要字段 mix_id、name、description、url、cover_image_url、author_id。支持翻页:把响应里的 next_page_token 作为 page_token 传回拿下一页,其他参数不变,每页算一次调用。 - 合集里的作品
mix_posts每千次 $0.79合集里的作品:返回列表,每次一页、每页最多 15 条,条数不固定(短页不代表到底),要更多就把响应顶层的 next_page_token 作为 page_token 再调,没有 next_page_token 才是到底;limit 照收但不起作用;主要字段 id、url、text、media_type、video_url、like_count。支持翻页:把响应里的 next_page_token 作为 page_token 传回拿下一页,其他参数不变,每页算一次调用。 - 作者一览
user_overview每千次 $1.6作者一览:返回单个对象;主要字段 user_id、douyin_id、nickname、bio、url、follower_count。 - 直播间
live_room每千次 $0.79直播间:返回单个对象;主要字段 room_id、live_id、title、is_live、url、cover_image_url。 - 短剧频道
series_feed每千次 $0.56短剧频道:返回列表,每次一页、每页最多 16 条,条数不固定(短页不代表到底),要更多就把响应顶层的 next_page_token 作为 page_token 再调,没有 next_page_token 才是到底;limit 照收但不起作用;主要字段 series_id、name、description、url、cover_image_url、genres。支持翻页:把响应里的 next_page_token 作为 page_token 传回拿下一页,其他参数不变,每页算一次调用。 - 短剧分集
series_posts每千次 $0.79短剧分集:返回列表,每次一页、每页最多 20 条,条数不固定(短页不代表到底),要更多就把响应顶层的 next_page_token 作为 page_token 再调,没有 next_page_token 才是到底;limit 照收但不起作用;主要字段 id、url、text、media_type、video_url、like_count。支持翻页:把响应里的 next_page_token 作为 page_token 传回拿下一页,其他参数不变,每页算一次调用。 - 作者的短剧
user_series每千次 $0.79作者的短剧:返回列表,每次一页、每页最多 20 条,条数不固定(短页不代表到底),要更多就把响应顶层的 next_page_token 作为 page_token 再调,没有 next_page_token 才是到底;limit 照收但不起作用;主要字段 series_id、name、description、url、cover_image_url、genres。支持翻页:把响应里的 next_page_token 作为 page_token 传回拿下一页,其他参数不变,每页算一次调用。 - 弹幕
danmaku每千次 $0.56弹幕:返回列表;主要字段 id、text、video_id、video_time、video_time_seconds、like_count。支持翻页:把响应里的 next_page_token 作为 page_token 传回拿下一页,其他参数不变,每页算一次调用。 - 直播间观众榜
live_viewers每千次 $0.56直播间观众榜:返回列表;主要字段 rank、user_id、douyin_id、nickname、avatar_url、is_verified。 - 短剧详情
series_detail每千次 $0.79短剧详情:返回单个对象;主要字段 series_id、name、description、url、cover_image_url、genres。 - 合集详情
mix_detail每千次 $0.56合集详情:返回单个对象;主要字段 mix_id、name、description、url、cover_image_url、episode_count。 - 直播场次详情
live_session每千次 $0.79直播场次详情:返回单个对象;主要字段 room_id、live_id、title、is_live、url、cover_image_url。 - 主播直播状态
user_live每千次 $0.79主播直播状态:返回单个对象;主要字段 room_id、live_id、title、is_live、url、cover_image_url。 - 按数字 UID 查主页
profile_by_id每千次 $0.56按数字 UID 查主页:返回单个对象;主要字段 user_id、douyin_id、nickname、bio、url、follower_count。