抖音短剧详情 API
按 series_id 读一部抖音短剧的资料:name、description、episode_count、updated_to_episode、collect_count,付费短剧另有付费集数和价格,每千次 $0.79。
icp_number是短剧的备案号last_episode_at是最新一集的发布时间- 失败和空结果不收费
接口健康状态
- 24h 健康值
- 正常
- 健康 / 正常
- 可用
- 少量可用
- 基本不可用
24 小时趋势
30 天趋势
1请求
POST /api/v1/social { "platform": "douyin", "action": "series_detail", "params": { "series_id": "7703828515069626394" } }2JSON 响应
{ "results": { "author_id": "", "series_id": "7703828515069626394", "name": "短剧 · 温柔以待,终有回甘", "description": "中秋夜,林哲与前妻的儿子林屿浑身湿透找上门,怯生生问能不能借住两天。苏晚挺着孕肚拉住他,说这是你爸的家,想住就住。她发现孩子面黄肌瘦,得知前妻宋丽纵容现任丈夫苛待亲生儿子,便要求林哲降低抚养费,把钱直接花在林屿身上。国庆期间,林屿又遭张浩驱赶出门。苏晚挺着孕肚带他回公司讨说法,宋丽大闹,自称身份不凡。苏晚亮明身份,张浩——她父亲曾经的司机——当场愣住。混乱中,苏晚摔倒了。", … } }3字段
author_id series_id name description 7703828515069626394 短剧 · 温柔以待,终有回甘 中秋夜,林哲与前妻的儿子林屿浑身湿透找上门,怯生生问能不能借住两天。苏晚挺着孕肚拉住他,说这是你爸的家,想住就住。她发现孩子面黄肌瘦,得知前妻宋丽纵容现任丈夫苛待亲生儿子,便要求林哲降低抚养费,把钱直接花在林屿身上。国庆期间,林屿又遭张浩驱赶出门。苏晚挺着孕肚带他回公司讨说法,宋丽大闹,自称身份不凡。苏晚亮明身份,张浩——她父亲曾经的司机——当场愣住。混乱中,苏晚摔倒了。 4CSV
douyin-series_detail-sample.csv series_id,name,description,url,cover_image_url,genres,sub_genres,status_text,episode_count,updated_to_episode,play_count,collect_count,is_paid,paid_episode_count,episode_price_cny,full_price_cny,icp_number,author_id,author_uid,author_name,author_douyin_id,author_avatar_url,author_is_verified,author_follower_count,created_at,updated_at,last_episode_at,platform
series_id,返回一个 JSON 对象,里面有 name、episode_count 等字段,列成字段表,也可下载为 CSV。能拿到什么数据
下表取自对 7703828515069626394 的一次真实调用,采集于 2026年11月21日 15:17(UTC),返回一个对象;灰条是隐去的个人信息(CSV 里是 •••)。你自己调用时,按字段表返回这些字段。
| series_id | name | description | url | cover_image_url | genres | sub_genres | status_text | episode_count | updated_to_episode | play_count | collect_count | is_paid | paid_episode_count | episode_price_cny | full_price_cny | icp_number | author_id | author_uid | author_name | author_douyin_id | author_avatar_url | author_is_verified | author_follower_count | created_at | updated_at | last_episode_at | platform |
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| 7703828515069626394 | 短剧 · 温柔以待,终有回甘 | 中秋夜,林哲与前妻的儿子林屿浑身湿透找上门,怯生生问能不能借住两天。苏晚挺着孕肚拉住他,说这是你爸的家,想住就住。她发现孩子面黄肌瘦,得知前妻宋丽纵容现任丈夫苛待亲生儿子,便要求林哲降低抚养费,把钱直接花在林屿身上。国庆期间,林屿又遭张浩驱赶出门。苏晚挺着孕肚带他回公司讨说法,宋丽大闹,自称身份不凡。苏晚亮明身份,张浩——她父亲曾经的司机——当场愣住。混乱中,苏晚摔倒了。 | https://www.iesdouyin.com/share/playlet/detail/7703828515069626394/?schema_type=43&object_id=7703828515069626394&from_ssr=1 | https://p3-sign.douyinpic.com/tos-cn-i-dy/63264312790795d05be78f3f6237f7dd~tplv-dy-resize-walign-adapt-aq:640:q80.webp?lk3s=f3356eed&x-expires=1795417200&x-signature=LTQ11M24SRFxEsSP3vO2ltpC81Y%3D&from=4080365293&s=PackSourceEnum_SERIES_DETAIL&se=false&sc=series_cover&biz_tag=awe… | ["其他"] | ["家长里短","都市日常"] | 84集全 | 84 | 84 | 894093630 | 1162009 | true | 82 | 1.2 | 98.4 | (抖音)微短剧备字(2026)第061503号 | 月•••场 | true | 0 | 2026-11-03T06:29:11+00:00 | 2026-11-17T06:15:00+00:00 | 2026-11-03T06:53:04+00:00 | douyin |
用途
核对短剧体量
读
episode_count和collect_count,看一部短剧有多少集、被收藏了多少;play_count不代表真实播放量,不拿它比体量。判断是否更新完
对比
episode_count和updated_to_episode,再看status_text上的更新状态。算看完要花多少钱
付费短剧读
paid_episode_count和episode_price_cny,或直接读买下全部付费集的full_price_cny。取准类型
user_series的行里sub_genres常常没有,到这里读genres和sub_genres。
抖音开放平台 与 EveryInfra 对比
下面从接入条件看,比较抖音开放平台文档和 EveryInfra series_detail。
| 对比项 | 抖音开放平台 | EveryInfra |
|---|---|---|
| 接入条件 | "已经申请用户管理权限,并且通过用户授权的第三方开发者,可以获取相应数据。" | 一把 EveryInfra API Key 放在 Authorization: Bearer 请求头里,请求只带 series_id,不需要作者授权。 |
引文出自抖音开放平台的用户信息获取接入方案,2026-11-22 核对;页面没有标更新日期。开放平台的短剧文档讲的是短剧小程序托管自己的剧集,没有读取任意公开短剧资料的接口,所以这里只比接入条件。 官方出处: 用户信息获取接入方案
限制和注意事项
series_id必填:纯数字的短剧 ID,取自series_feed、user_series返回行的series_id;也收短剧分享链接 https://www.iesdouyin.com/share/playlet/detail/<ID>。- 一次调用读一部短剧,返回一个对象;分集用
series_posts取。 - 只有付费短剧带
paid_episode_count、episode_price_cny、full_price_cny,单位是人民币元;免费短剧没有这几个键。 genres、sub_genres是抖音给的中文类型名;icp_number是短剧的备案号。created_at、updated_at、last_episode_at是 ISO 8601 时间(UTC)。
价格
每次调用 $0.000792,按次计费,不按字段多少算;一次调用读一部短剧。失败和空结果不收费。
| 调用次数 | 费用 |
|---|---|
| 10,000 | $7.92 |
| 100,000 | $79.17 |
| 1,000,000 | $791.67 |
合计按每次调用的标价算。
代码示例
#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": "series_detail",
"params": {
"series_id": "7703828515069626394"
}
}'OpenAPI 定义 (JSON)示例从环境变量 EVERYINFRA_API_KEY 读取 Key,复制出去的代码不含你的 Key。
API 参考
下面是 series_detail 的参数、响应字段、错误和计费,可以复制整页,或用 Markdown 打开后交给 AI 助手。
AI 提示词
#请帮我用 EveryInfra 的「抖音短剧详情」接口(douyin/series_detail)写一个数据采集脚本。
接口约定:
- 请求:POST https://api.everyinfra.com/api/v1/social,请求头 Authorization: Bearer <API Key>;Key 从环境变量 EVERYINFRA_API_KEY 读取,不要写进代码。
- 请求体里 platform 填 douyin,action 填 series_detail,参数放在 params 里。
- 必填参数:
- series_id:抖音短剧 ID,纯数字,取自 series_feed、user_series 返回行的 series_id。
- 返回一个对象,主要字段:series_id(抖音短剧 ID(series_fe…)、name、description、url、cover_image_url(封面图链接:search / us…)、genres(短剧的类型(series_feed…)、sub_genres(短剧的细分类型(series_fe…)、status_text(抖音页面上显示的更新状态原文(se…)、episode_count(一共几集:user_mixes、m…)、updated_to_episode(短剧已经更新到第几集(series…)、play_count(仅热点宝视频榜单和合集上是真实播放数)、collect_count;一共 27 个字段,完整列表见 https://api.everyinfra.com/api/v1/social/catalog?platform=douyin。
- 示例请求体:
{
"platform": "douyin",
"action": "series_detail",
"params": {
"series_id": "7703828515069626394"
}
}
- 计费:$0.79 / 千次;失败和空结果不扣费。
- 一次要采几十上百个时,在请求体加 "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 | 是 | series_detail | 能力标识,固定值。 |
series_id | body.params | string | 是 | - | 抖音短剧 ID,纯数字,取自 series_feed、user_series 返回行的 series_id;也收短剧分享链接 https://www.iesdouyin.com/share/playlet/detail/<ID>。 |
响应示例
#{ "id": "req_…", "platform": "douyin", "action": "series_detail", "results": { "series_id": "7703828515069626394", "name": "短剧 · 温柔以待,终有回甘", "description": "中秋夜,林哲与前妻的儿子林屿浑身湿透找上门,怯生生问能不能借住两天。苏晚挺着孕肚拉住他,说这是你爸的家,想住就住。她发现孩子面黄肌瘦,得知前妻宋丽纵容现任丈夫苛待亲生儿子,便要求林哲降低抚养费,把钱直接花在林屿身上。国庆期间,林屿又遭张浩驱赶出门。苏晚挺着孕肚带他回公司讨说法,宋丽大闹,自称身份不凡。苏晚亮明身份,张浩——她父亲曾经的司机——当场愣住。混乱中,苏晚摔倒了。", "url": "https://www.iesdouyin.com/share/playlet/detail/7703828515069626394/?schema_type=43&object_id=7703828515069626394&from_ssr=1", "cover_image_url": "https://p3-sign.douyinpic.com/tos-cn-i-dy/63264312790795d05be78f3f6237f7dd~tplv-dy-resize-walign-adapt-aq:640:q80.webp?lk3s=f3356eed&x-expires=1795417200&x-signature=LTQ11M24SRFxEsSP3vO2ltpC81Y%3D&from=4080365293&s=PackSourceEnum_SERIES_DETAIL&se=false&sc=series_cover&biz_tag=awe…", "genres": [ "其他" ], "sub_genres": [ "家长里短", "都市日常" ], "status_text": "84集全", "episode_count": 84, "updated_to_episode": 84, "play_count": 894093630, "collect_count": 1162009, "is_paid": true, "paid_episode_count": 82, "episode_price_cny": 1.2, "full_price_cny": 98.4, "icp_number": "(抖音)微短剧备字(2026)第061503号", "author_id": "•••", "author_uid": "•••", "author_name": "月•••场", "author_douyin_id": "•••", "author_avatar_url": "https://p3-pc.douyinpic.com/•••", "author_is_verified": true, "author_follower_count": 0, "created_at": "2026-11-03T06:29:11+00:00", "updated_at": "2026-11-17T06:15:00+00:00", "last_episode_at": "2026-11-03T06:53:04+00:00", "platform": "douyin" }, "billing": { "charged": …, "charged_usd": …, "balance_after_usd": …, … }, "quota": { … }}
返回字段
#业务数据在 results 里;下表是每条记录可能包含的字段,平台没有提供的值不会被编造。
| 字段 | 含义 |
|---|---|
series_id | 抖音短剧 ID(series_feed、series_detail、user_series、series_posts),传给 series_detail、series_posts 的 series_id。 |
name | 名称。用于账号/商品/商家类能力,指该对象本身的名字。 |
description | 简介或描述,通常比 text 短。 |
url | 该记录在原平台上的可访问链接。 |
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 是直播间封面;带签名的会过期。 |
genres | 短剧的类型(series_feed、series_detail、user_series),如 ["其他"];抖音给的中文类型名。 |
sub_genres | 短剧的细分类型(series_feed、series_detail、user_series),如 ["都市日常", "爱情"];user_series 里常常没有,要准的看 series_detail。 |
status_text | 抖音页面上显示的更新状态原文(series_feed、series_detail、user_series),如「65集全」。 |
episode_count | 一共几集:user_mixes、mix_detail 是合集的集数,series_feed、series_detail、user_series 是短剧的总集数。 |
updated_to_episode | 短剧已经更新到第几集(series_feed、series_detail、user_series)。 |
play_count | 仅热点宝视频榜单和合集上是真实播放数。在 billboard_video_hot、billboard_low_fan_explosion、billboard_high_completion 上是抖音平台自己统计的播放数,mix_posts 是这一集作品的播放数,user_mixes 是整个合集的播放数;其余能力上抖音不对外公开播放量,值多为 0,不代表真实播放,热度请看点赞、评论、分享数。 |
collect_count | 收藏数。null 表示不公开,不等于 0。 |
is_paid | 是否付费:series_feed、series_detail、user_series 是这部短剧有没有付费集;series_posts 是这一集要不要付费(付费集的视频链接是加密的,下载后无法播放);live_session、user_live 是这一场是不是付费直播。 |
paid_episode_count | 这部短剧有几集要付费(series_feed、series_detail、user_series);前 episode_count − paid_episode_count 集免费。免费短剧没有这个键。 |
episode_price_cny | 付费短剧单集的价格,人民币元(series_feed、series_detail、user_series)。免费短剧没有这个键。 |
full_price_cny | 付费短剧买下全部付费集的价格,人民币元(series_feed、series_detail、user_series)。免费短剧没有这个键。 |
icp_number | 短剧的备案号(series_feed、series_detail、user_series),如「(抖音)微短剧备字(2026)第000001号」。 |
author_id | 作者在原平台的唯一 ID。 |
author_uid | 作者(评论里是评论者)的数字用户 ID;author_id 是 secUid,两者是同一个人的两种 ID。 |
author_name | 作者昵称(显示名)。 |
author_douyin_id | 作者抖音号。 |
author_avatar_url | 作者头像链接:search / user_posts / video / posts_batch / related_posts / mix_posts / music_posts 行上是博主的,live_room 上是主播的,comments 行上是评论者的。 |
author_is_verified | 作者是否认证(search / user_posts / video / posts_batch / related_posts / mix_posts / music_posts 行上;live_room 上是主播是否认证;comments 行上是评论者是否认证)。 |
author_follower_count | 作者粉丝数。null 表示不公开。 |
created_at | 创建时间,格式同 posted_at。 |
updated_at | 最近一次更新的时间(ISO 8601,UTC):user_mixes、mix_detail 是合集的,series_feed、series_detail、user_series 是短剧的。 |
last_episode_at | 最新一集的发布时间(series_feed、series_detail、user_series,ISO 8601,UTC)。 |
platform | 数据来源平台标识,与请求里的 platform 一致(如 xiaohongshu、tiktok)。 |
错误与计费
#- 401
- 缺少 Key 或 Key 无效。
- 402
- 余额不足,先充值。
- 422
- 参数名或取值不对,按错误信息给的候选改;不扣费。
- 429
- 超过每分钟请求上限,按 Retry-After 等待后再试。
- 503
- 暂时无法完成,预扣的费用退回;结果未知时先核对,不要直接重发。
- 200 空结果
- 没有数据,不扣费。
常见问题
抖音短剧详情接口返回什么?
返回一个对象:series_id、name、description、url、genres、sub_genres、status_text、episode_count、updated_to_episode、play_count、collect_count、is_paid、icp_number、last_episode_at,付费短剧另有价格字段,加上作者字段。
短剧的分集怎么读?
把同一个 series_id 传给 series_posts,每集一行。
读一部短剧要多少钱?
每次 $0.000792,每千次 $0.79,按调用次数算,不按字段多少算。失败和空结果不收费。
相关的 抖音 能力
同一把 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。 - 推荐流
feed每千次 $0.56推荐流:返回列表,每次一页、每页最多 20 条,条数不固定(短页不代表到底),要更多就把响应顶层的 next_page_token 作为 page_token 再调,没有 next_page_token 才是到底;limit 照收但不起作用;主要字段 id、url、text、media_type、video_url、like_count。支持翻页:把响应里的 next_page_token 作为 page_token 传回拿下一页,其他参数不变,每页算一次调用。 - 短剧频道
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。 - 合集详情
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。