社交内容 · 数据 API

抖音

抖音 API

搜索抖音视频,按 secUid 查作品和作者资料,读取评论、语音文稿及热点、种草、挑战等榜单;作品文案不同于转写,榜单热度不跨榜混排。 调用 POST /api/v1/social ;返回结构化 JSON,$0.56 / 千次;失败不计费。

18

个能力

$0.56 / 千次

能力价格

同步

调用模式

1 个

一把 Key 通用 89 个平台

抖音 能力清单

action必填参数可选参数单次条数模式单价返回字段
searchkeywordpublish_time, sort默认 10 · 最多 50同步$0.56 / 千次id · url · text · media_type · like_count · comment_count · share_count · collect_count · view_count · author_name · author_id · author_douyin_id · author_follower_count · region · posted_at · platform · duration_sec · hashtags
profileuser_id——同步$0.56 / 千次user_id · douyin_id · nickname · bio · url · follower_count · following_count · like_count · video_count · gender · ip_location · is_verified · avatar_url · platform · verify_reason
user_postsuser_idsince默认 20 · 最多 100同步$0.56 / 千次id · url · text · media_type · like_count · comment_count · share_count · collect_count · view_count · author_name · author_id · author_douyin_id · author_follower_count · region · posted_at · platform · duration_sec · hashtags
videourl——同步$0.56 / 千次id · url · text · media_type · like_count · comment_count · share_count · collect_count · view_count · author_name · author_id · author_douyin_id · author_follower_count · region · posted_at · platform · duration_sec · hashtags
commentsurl—默认 20 · 最多 150同步$0.56 / 千次id · text · like_count · reply_count · author_name · author_id · ip_location · liked_by_author · is_reply · reply_to_id · posted_at · platform
trending—boards默认 20 · 最多 60同步$0.56 / 千次rank · keyword · hot_value · video_count · board · image_url · event_time · platform
transcripturl——同步$0.56 / 千次id · url · title · text · posted_at · play_count · like_count · comment_count · share_count · collect_count · author_name · author_avatar · author_follower_count · platform
creator_searchkeywordfollower_range, user_type默认 20 · 最多 20同步$0.56 / 千次user_id · douyin_id · nickname · url · avatar_url · follower_count · gender · is_verified · verify_reason · is_live · source_keyword · platform
creator_audienceuser_iddimension—同步$0.56 / 千次user_id · audience_distribution · audience_tgi · dimension_code · platform
creator_trenduser_id——同步$0.56 / 千次user_id · follower_trend · average_follower_count · dimension_code · platform
creator_benchmarkuser_id——同步$0.56 / 千次user_id · average_post_count · average_comment_count · average_share_count · average_follower_growth · average_like_count · post_count_percentile · comment_count_percentile · share_count_percentile · follower_growth_percentile · like_count_percentile · platform
xingtu_creator_searchkeyword—默认 20 · 最多 20同步$0.56 / 千次creator_id · user_id · nickname · follower_count · gender · city · province · creator_score · engagement_rate_30d · expected_play_count · expected_natural_play_count · interaction_median_30d · play_over_rate_30d · follower_growth_30d · follower_growth_rate_15d · content_themes · ecommerce_level · ecommerce_score · gmv_30d_range · gpm_30d_range · average_order_value_30d_range · commercial_index · conversion_index · spread_index · shopping_index · quote_1_20s_cny · quote_20_60s_cny · quote_60s_plus_cny · platform
xingtu_creator_analyticsdouyin_id——同步$0.56 / 千次creator_id · creator_type · follower_count · average_play_count · city · province · gender · category_id · content_themes · tags · creator_grade · is_xingtu_creator · ecommerce_enabled · lowest_quote_cny · platform
xingtu_rate_carddouyin_id——同步$0.56 / 千次creator_id · rate_tiers · platform
xingtu_creator_rankingsindustry, ranking_type, time_window—默认 5 · 最多 5同步$0.56 / 千次creator_id · user_id · url · nickname · avatar_url · gender · city · province · follower_count · cpm_cny · completed_order_range · repurchase_rate_range · item_order_rate · average_view_count · industry · rank · previous_rank · ranking_score · is_new · ranking_board · period_days · snapshot_date · source_kind · platform
product_searchkeyword—默认 5 · 最多 5同步$0.56 / 千次product_id · promotion_id · title · url · image_url · white_image_url · price_cny · price_cny_minor · price_label · monthly_sales · good_review_ratio · sales_trend · category_path · category_depth · shop_id · shop_name · shop_logo_url · shop_score · commission_rate_percent · commission_cny · cooperating_creator_count · tags · source_keyword · search_rank · platform
product_detailproduct_id——同步$0.56 / 千次product_id · title · price_cny · discount_price_cny · sales_text · sold_count · shop_id · shop_name · shop_avatar_url · image_url · main_image_urls · detail_image_urls · assurances · shipping_fee_text · shipping_estimate_text · variant_groups · on_sale · platform
live_product_searchkeyword—默认 3 · 最多 3同步$0.56 / 千次product_id · sku_id · title · image_url · price_cny · shop_id · live_room_id · is_live_product · source_keyword · platform

抖音 每个接口分别做什么

下面逐个解释 action、必填参数、可选筛选项和允许值。 请求都发到 POST /api/v1/social, 切换 action 时,也要按对应接口调整参数。 同名参数在不同平台、不同接口中可能指向不同对象;请以该条说明中的格式和适用范围为准。

下方只展示平台官方资料,用于核对对象与术语,不表示平台对 EveryInfra 的授权或背书。 本接口接受的参数、字段与能力边界以各条说明为准,不与平台官方 API 直接等同。

怎么调用 抖音 主页或对象详情 API?

profile

使用 platform="douyin"、action="profile" 调用“主页或对象详情”能力;返回单个对象,主要包含 user_id、douyin_id、nickname、bio、url、follower_count 等 15 个字段。

抖音 profile 的参数分别是什么意思?

user_id必填
抖音用户的 secUid(通常以 MS4w 开头),用于读取账号资料;该动作不接受 since 筛选账号。

抖音开放平台将 Open ID 定义为当前应用内的用户标识,Union ID 则属于开发者账号范围。本页 user_id 按上方说明填写 secUid,不把开放平台的标识直接当作同一种输入。官方来源:抖音开放平台:Open ID 与 Union ID来源核查:

抖音 特有返回字段与含义(5)
douyin_id
抖音号(用户自定义的可搜索 ID)。
nickname
昵称。
gender
性别。
ip_location
IP 属地(平台强制展示,非用户填写)。
video_count
视频数。

怎么调用 抖音 用户内容 API?

user_posts

使用 platform="douyin"、action="user_posts" 调用“用户内容”能力;返回列表,默认 20 条、单次最多 100 条,主要包含 id、url、text、media_type、like_count、comment_count 等 18 个字段。

抖音 user_posts 的参数分别是什么意思?

user_id必填
抖音用户的 secUid(通常以 MS4w 开头),不是昵称或短数字抖音号。用于定位 profile / user_posts 的账号;可从搜索结果的 author_id 或抖音用户主页链接取得。

抖音开放平台将 Open ID 定义为当前应用内的用户标识,Union ID 则属于开发者账号范围。本页 user_id 按上方说明填写 secUid,不把开放平台的标识直接当作同一种输入。官方来源:抖音开放平台:Open ID 与 Union ID来源核查:

since可选
频道视频的最早发布日期,格式 YYYY-MM-DD;只用于 user_posts 列表,不是账号创建日期。
抖音 特有返回字段与含义(4)
author_douyin_id
作者抖音号。
region
地区。
view_count
播放量。抖音不对外公开播放量,该字段恒为 0,不代表真实播放;判断视频热度请用 like_count(点赞)、comment_count、share_count。
media_type
媒体类型。

怎么调用 抖音 视频详情 API?

video

使用 platform="douyin"、action="video" 调用“视频详情”能力;返回单个对象,主要包含 id、url、text、media_type、like_count、comment_count 等 18 个字段。

抖音 video 的参数分别是什么意思?

url必填
目标抖音视频的完整链接,格式如 https://www.douyin.com/video/<视频ID>。video 读取该视频详情,comments 读取其评论,transcript 提取该视频的语音文稿;不要传用户主页或搜索页。

官方说明 PC 端视频播放 URL 可用于取得 VideoID,并可按 VideoID 获取播放器信息;这里只支撑 EveryInfra 将视频 URL 规范化为标识的对象语义,不证明任意公开视频都可读取、无需授权或本接口全部字段均由该官方接口提供。官方来源:抖音开放平台:视频播放 URL 与 VideoID来源核查:

抖音 特有返回字段与含义(4)
author_douyin_id
作者抖音号。
region
地区。
view_count
播放量。抖音不对外公开播放量,该字段恒为 0,不代表真实播放;判断视频热度请用 like_count(点赞)、comment_count、share_count。
media_type
媒体类型。

怎么调用 抖音 评论 API?

comments

使用 platform="douyin"、action="comments" 调用“评论”能力;返回列表,默认 20 条、单次最多 150 条,主要包含 id、text、like_count、reply_count、author_name、author_id 等 12 个字段。

抖音 comments 的参数分别是什么意思?

url必填
目标抖音视频的完整链接,格式如 https://www.douyin.com/video/<视频ID>。video 读取该视频详情,comments 读取其评论,transcript 提取该视频的语音文稿;不要传用户主页或搜索页。

官方评论接口以 item_id 查询视频评论,单次 count 最大 50;EveryInfra 的 url 到视频标识转换属于自身实现,该来源不能证明任意公开视频、全部评论、无需授权或本接口的结果上限。官方来源:抖音开放平台:按视频标识读取评论列表来源核查:

抖音 特有返回字段与含义(4)
ip_location
IP 属地(平台强制展示,非用户填写)。
is_reply
是否为回复。
reply_to_id
被回复评论 ID。
liked_by_author
评论是否被作者点赞。作者亲自点赞的评论互动价值高。

怎么调用 抖音 视频文稿 API?

transcript

使用 platform="douyin"、action="transcript" 调用“视频文稿”能力;返回单个对象,主要包含 id、url、title、text、posted_at、play_count 等 14 个字段。

抖音 transcript 的参数分别是什么意思?

url必填
目标抖音视频的完整链接,格式如 https://www.douyin.com/video/<视频ID>。video 读取该视频详情,comments 读取其评论,transcript 提取该视频的语音文稿;不要传用户主页或搜索页。
抖音 特有返回字段与含义(2)
author_avatar
作者头像。
play_count
播放量。抖音不对外公开播放量,该字段恒为 0;热度判断请用点赞/评论/分享数。

怎么调用 抖音 达人粉丝画像 API?

creator_audience

使用 platform="douyin"、action="creator_audience" 调用“达人粉丝画像”能力;返回单个对象,主要包含 user_id、audience_distribution、audience_tgi、dimension_code、platform。

抖音开放平台的可读 OpenAPI 文档列出年龄、设备、性别、地域、兴趣和流量贡献等粉丝分布,并明确需要申请权限、用户授权及账号规模条件。它不证明 EveryInfra 可枚举逐个粉丝,也不能把粉丝分布写成视频观众、商品买家或成交用户画像。官方来源:抖音开放平台:授权账号的粉丝画像维度来源核查:

抖音 creator_audience 的参数分别是什么意思?

user_id必填
抖音用户的 secUid(通常以 MS4w 开头),不是昵称或短数字抖音号。用于定位 profile / user_posts 的账号;可从搜索结果的 author_id 或抖音用户主页链接取得。
dimension可选
达人粉丝画像维度:device_price_band 设备价格带(默认)、gender 性别、age 年龄、province 省份。
查看全部 4 个允许值

agedevice_price_bandgenderprovince

抖音 特有返回字段与含义(3)
audience_distribution
粉丝受众分布桶;value 是 0–1 的份额小数,不是百分数、人数或实际买家占比。
audience_tgi
受众桶相对平台平均的 TGI 指数;与份额 value 是独立量纲,不是人数或成交占比。
dimension_code
画像维度:device_price_band、gender、age 或 province;由请求 option 映射,不把领先分布桶标签当维度。

怎么调用 抖音 达人涨粉趋势 API?

creator_trend

使用 platform="douyin"、action="creator_trend" 调用“达人涨粉趋势”能力;返回单个对象,主要包含 user_id、follower_trend、average_follower_count、dimension_code、platform。

巨量星图客户移动端指南将播放趋势、粉丝趋势和粉丝分布列为达人页面资料。该来源只支撑趋势对象及投前复核场景,不定义 EveryInfra 的 dimension_code、采样窗口、时间点完整性或变化原因。官方来源:巨量星图:达人主页的播放趋势与粉丝趋势来源核查:

抖音 creator_trend 的参数分别是什么意思?

user_id必填
抖音用户的 secUid(通常以 MS4w 开头),不是昵称或短数字抖音号。用于定位 profile / user_posts 的账号;可从搜索结果的 author_id 或抖音用户主页链接取得。
抖音 特有返回字段与含义(3)
dimension_code
画像维度:device_price_band、gender、age 或 province;由请求 option 映射,不把领先分布桶标签当维度。
follower_trend
粉丝数量随日期变化的序列。
average_follower_count
趋势窗口内的平均粉丝量。

怎么调用 抖音 达人同类对标 API?

creator_benchmark

使用 platform="douyin"、action="creator_benchmark" 调用“达人同类对标”能力;返回单个对象,主要包含 user_id、average_post_count、average_comment_count、average_share_count、average_follower_growth、average_like_count 等 12 个字段。

巨量星图指南列出传播、性价比、涨粉、合作、种草等指数,以及任务数、预期播放和 CPM 性价比等重点数据。它不定义 EveryInfra 的平均值或 percentile 算法,也不证明分位是官方排名、同行全量样本或未来效果保证。官方来源:巨量星图:达人指数与重点数据用于候选评估来源核查:

抖音 creator_benchmark 的参数分别是什么意思?

user_id必填
抖音用户的 secUid(通常以 MS4w 开头),不是昵称或短数字抖音号。用于定位 profile / user_posts 的账号;可从搜索结果的 author_id 或抖音用户主页链接取得。
抖音 特有返回字段与含义(10)
average_post_count
对标窗口内的平均发布量。
average_comment_count
对标窗口内的平均评论量。
average_share_count
对标窗口内的平均分享量。
average_follower_growth
对标窗口内的平均新增粉丝量。
average_like_count
对标窗口内的平均点赞量。
post_count_percentile
发布量在同类账号中的百分位。
comment_count_percentile
评论量在同类账号中的百分位。
share_count_percentile
分享量在同类账号中的百分位。
follower_growth_percentile
新增粉丝量在同类账号中的百分位。
like_count_percentile
点赞量在同类账号中的百分位。

怎么调用 抖音 星图达人分析 API?

xingtu_creator_analytics

使用 platform="douyin"、action="xingtu_creator_analytics" 调用“星图达人分析”能力;返回单个对象,主要包含 creator_id、creator_type、follower_count、average_play_count、city、province 等 15 个字段。

巨量星图达人广场指南说明客户会从商业能力、创作能力和履约能力筛选达人,并列出播放量中位数、完播率、互动率、预期播放、预期 CPM、内容主题及转化能力等投前语境。该来源不定义 EveryInfra 的 douyin_id 输入、字段全集、匿名访问、更新频率或数据完整性,也不把平台指标变成合作效果保证。官方来源:巨量星图:达人广场的商业、创作与履约分析维度来源核查:

抖音 xingtu_creator_analytics 的参数分别是什么意思?

douyin_id必填
达人个人主页展示的抖音号(unique_id),从普通 creator_search 结果取得;不是 secUid、昵称或星图 ID。
抖音 特有返回字段与含义(10)
gender
性别。
creator_id
星图商业达人稳定 ID;不是公开主页 user_id 或抖音号。
content_themes
平台给达人标记的内容主题标签。
lowest_quote_cny
星图展示的最低合作报价,人民币;是报价,不是成交价。
creator_type
星图返回的达人类型。
average_play_count
星图返回的平均播放量。
category_id
星图达人分类 ID。
creator_grade
星图达人等级。
is_xingtu_creator
是否为星图达人。
ecommerce_enabled
是否具备星图电商能力标记。

怎么调用 抖音 星图达人报价 API?

xingtu_rate_card

使用 platform="douyin"、action="xingtu_rate_card" 调用“星图达人报价”能力;返回单个对象,主要包含 creator_id、rate_tiers、platform。

巨量星图报价指南说明报价会按任务类型与视频时长设置,修改可能立即或次月生效,平台建议报价也会随账号的内容、增长、互动和转化能力评估而变化。该来源只支撑报价是分档、可变的当前状态,不证明 EveryInfra 返回全部任务报价、最终合同价、结算结果或达人必然接单。官方来源:巨量星图:达人报价档位与生效边界来源核查:

抖音 xingtu_rate_card 的参数分别是什么意思?

douyin_id必填
达人个人主页展示的抖音号(unique_id),从普通 creator_search 结果取得;不是 secUid、昵称或星图 ID。
抖音 特有返回字段与含义(2)
creator_id
星图商业达人稳定 ID;不是公开主页 user_id 或抖音号。
rate_tiers
星图报价档位;每档保留形式说明、实际报价、原报价、结算说明、视频类型与开放状态。

怎么调用 抖音 星图达人榜单 API?

xingtu_creator_rankings

使用 platform="douyin"、action="xingtu_creator_rankings" 调用“星图达人榜单”能力;返回列表,默认 5 条、单次最多 5 条,主要包含 creator_id、user_id、url、nickname、avatar_url、gender 等 24 个字段。

巨量星图榜单指南区分内容价值榜与商业价值榜,并说明可按营销目标或主播类型、榜单类型和时间范围查看;排名可能使用商单数、复购率、播放量、CPM、CTR、CVR、GPM 等不同指标。该来源不定义 EveryInfra 的英文枚举、5 条上限、字段全集、榜单覆盖或刷新频率,也不能把榜单名次写成合作推荐。官方来源:巨量星图:达人榜单类型、时间范围与排名口径来源核查:

抖音 xingtu_creator_rankings 的参数分别是什么意思?

industry必填
星图商业达人榜的行业:beauty、electronics、food_beverage、apparel_accessories、automotive、mother_baby_pets、household_goods。
查看全部 7 个允许值

apparel_accessoriesautomotivebeautyelectronicsfood_beveragehousehold_goodsmother_baby_pets

ranking_type必填
星图榜单类型:top_creators、rising_stars、sales_champions、viral_drivers、paid_ad_performers、head_tier 或 all_top。
查看全部 7 个允许值

all_tophead_tierpaid_ad_performersrising_starssales_championstop_creatorsviral_drivers

time_window必填
榜单时间窗:latest_weekly、latest_monthly、all_history_weekly 或 all_history_monthly。
查看全部 4 个允许值

all_history_monthlyall_history_weeklylatest_monthlylatest_weekly

抖音 特有返回字段与含义(16)
nickname
昵称。
gender
性别。
rank
热榜排名。
creator_id
星图商业达人稳定 ID;不是公开主页 user_id 或抖音号。
cpm_cny
星图榜单展示的千次曝光成本,人民币元。
completed_order_range
已完成品牌合作订单的平台区间字符串;不是精确订单数。
repurchase_rate_range
客户复购率的平台区间字符串;不是精确比率。
item_order_rate
星图展示的内容下单率。
average_view_count
榜单快照内的平均视频播放量。
previous_rank
同榜单上一期排名。
ranking_score
星图榜单综合分;只在同一榜单与时间窗内比较。
is_new
是否为本期新进榜达人。
ranking_board
星图榜单展示名称。
period_days
榜单统计周期天数。
snapshot_date
榜单快照日期,格式 YYYYMMDD。
source_kind
数据来源类型;当前公开契约只接受并返回 ranking。

怎么调用 抖音 商品详情 API?

product_detail

使用 platform="douyin"、action="product_detail" 调用“商品详情”能力;返回单个对象,主要包含 product_id、title、price_cny、discount_price_cny、sales_text、sold_count 等 18 个字段。

抖音 product_detail 的参数分别是什么意思?

product_id必填
抖音商城商品数字 ID;从 product_search 或 live_product_search 结果取得,不是 SKU ID、推广 ID 或商品标题。
抖音 特有返回字段与含义(15)
product_id
抖音商城商品稳定 ID。
price_cny
商品展示价格,人民币元。
shop_id
抖音商城店铺 ID。
shop_name
抖音商城店铺名称。
discount_price_cny
商品当前公开优惠价,人民币元;缺失时不从原价推算。
sold_count
商品详情当前公开的已售数量;是采集时快照,不等于指定达人销量。
sales_text
商品详情公开销量原文。
shop_avatar_url
抖音商城店铺头像 URL。
main_image_urls
商品头图/轮播图 URL 列表。
detail_image_urls
商品详情长图 URL 列表。
assurances
商品公开服务保障标签。
shipping_fee_text
商品公开运费或发货地说明原文。
shipping_estimate_text
商品公开预计发货说明原文。
variant_groups
商品规格组与可选项;只保留规格名、选项名和公开规格 ID。
on_sale
商品在采集时是否显示在售。
抖音 search 调用流程一次 抖音 search 调用的全过程:向 POST /api/v1/social 发送 platform="douyin"、action="search",以及必填参数 keyword;返回结构化 JSON,含 id、url、text、media_type、like_count 等字段;返回列表,单次最多 50 条,计费 $0.56 / 千次,失败与空结果不计费。1 · 请求POST /api/v1/socialplatform: "douyin"action: "search"keywordEveryInfra$0.56 / 千次2 · 响应 · 列表idurltextmedia_typelike_count
一次 抖音 search 调用的全过程:向 POST /api/v1/social 发送 platform="douyin"、action="search",以及必填参数 keyword;返回结构化 JSON,含 id、url、text、media_type、like_count 等字段;返回列表,单次最多 50 条,计费 $0.56 / 千次,失败与空结果不计费。

抖音 原始字段名

EveryInfra 统一字段名

左边是 抖音 数据里原本的字段名,右边是我们统一后的。点任意一行看对应关系。89 个平台复用通用字段命名,减少重复适配; 切换平台仍需核对参数、字段集合、类型与空值含义。这里展示映射关系,不是目标的实时返回数据。

抖音 的独有字段名(当前目录)

全站 89 个平台的当前目录中,这 86 个字段名只在 抖音 出现。 这是字段命名的分布,不代表其他平台没有同类信息,也不保证每次响应都含这些字段;具体含义和返回条件仍需逐接口核对。

  • author_douyin_id
  • douyin_id
  • board
  • event_time
  • source_keyword
  • audience_distribution
  • audience_tgi
  • dimension_code
  • follower_trend
  • average_follower_count
  • average_post_count
  • average_comment_count
  • average_share_count
  • average_follower_growth
  • average_like_count
  • post_count_percentile
  • comment_count_percentile
  • share_count_percentile

返回字段含义

通用字段采用统一命名;切换平台时仍需核对目标格式、字段是否存在、类型、空值与平台特有含义。 机器可读版:/api/v1/social/fields

id
该记录在原平台上的唯一标识。仅在同一平台内唯一,跨平台可能重复。
url
该记录在原平台上的可访问链接。
text
正文内容,已去除 HTML 标签。长文可能被截断。
media_type
媒体类型。
like_count
点赞数。null 表示该平台或该接口不公开此数据,不等于 0。
comment_count
评论数。null 表示不公开,不等于 0。
share_count
分享/转发数。null 表示不公开,不等于 0。
collect_count
收藏数。null 表示不公开,不等于 0。
view_count
播放量。抖音不对外公开播放量,该字段恒为 0,不代表真实播放;判断视频热度请用 like_count(点赞)、comment_count、share_count。
author_name
作者昵称(显示名)。
author_id
作者在原平台的唯一 ID。
author_douyin_id
作者抖音号。
author_follower_count
作者粉丝数。null 表示不公开。
region
地区。
posted_at
发布时间,ISO 8601 格式、UTC 时区(如 2026-08-07T12:34:56+00:00)。平台只给非标准字符串时原样透传,解析前建议做容错。null 表示平台未公开。
platform
数据来源平台标识,与请求里的 platform 一致(如 xiaohongshu、tiktok)。
user_id
用户在原平台的唯一 ID。
douyin_id
抖音号(用户自定义的可搜索 ID)。
nickname
昵称。
bio
个人简介,账号自己填写的文本。可能含换行和 emoji。
follower_count
粉丝数。null 表示不公开,不等于 0。
following_count
关注数。null 表示不公开,不等于 0。
video_count
视频数。
gender
性别。
ip_location
IP 属地(平台强制展示,非用户填写)。
is_verified
是否为平台认证账号(蓝V等)。null 表示无法判定。
avatar_url
头像图片链接。部分平台给的是带尺寸参数的 CDN 链接,可能有时效。
reply_count
回复数,通常用于评论的子回复。null 表示不公开。
liked_by_author
评论是否被作者点赞。作者亲自点赞的评论互动价值高。
is_reply
是否为回复。
reply_to_id
被回复评论 ID。
rank
热榜排名。
keyword
热点关键词。
hot_value
热榜热度值。抖音自有指标,只在榜单内可比。
board
所属榜单。
image_url
图片链接。多图能力可能返回 image_urls 数组。
event_time
热点事件时间。
title
标题。平台无标题概念时(如纯文本帖)为 null。
play_count
播放量。抖音不对外公开播放量,该字段恒为 0;热度判断请用点赞/评论/分享数。
author_avatar
作者头像。
is_live
账号在采集时是否正在直播;属于时点状态。
source_keyword
本行命中的搜索关键词。
audience_distribution
粉丝受众分布桶;value 是 0–1 的份额小数,不是百分数、人数或实际买家占比。
audience_tgi
受众桶相对平台平均的 TGI 指数;与份额 value 是独立量纲,不是人数或成交占比。
dimension_code
画像维度:device_price_band、gender、age 或 province;由请求 option 映射,不把领先分布桶标签当维度。
follower_trend
粉丝数量随日期变化的序列。
average_follower_count
趋势窗口内的平均粉丝量。
average_post_count
对标窗口内的平均发布量。
average_comment_count
对标窗口内的平均评论量。
average_share_count
对标窗口内的平均分享量。
average_follower_growth
对标窗口内的平均新增粉丝量。
average_like_count
对标窗口内的平均点赞量。
post_count_percentile
发布量在同类账号中的百分位。
comment_count_percentile
评论量在同类账号中的百分位。
share_count_percentile
分享量在同类账号中的百分位。
follower_growth_percentile
新增粉丝量在同类账号中的百分位。
like_count_percentile
点赞量在同类账号中的百分位。
creator_id
星图商业达人稳定 ID;不是公开主页 user_id 或抖音号。
city
城市名,用原平台的语言书写,未做中英归一。
creator_score
星图达人综合指数;只在同一次取得的结果中比较。
engagement_rate_30d
星图近 30 天互动率。
expected_play_count
星图预期播放量;属于平台估计,不是实际播放结果。
expected_natural_play_count
星图预期自然播放量;属于平台估计。
interaction_median_30d
星图近 30 天互动量中位数。
play_over_rate_30d
星图近 30 天完播率。
follower_growth_30d
星图近 30 天涨粉量。
follower_growth_rate_15d
星图近 15 天涨粉率。
content_themes
平台给达人标记的内容主题标签。
ecommerce_level
星图电商能力等级。
ecommerce_score
星图电商能力分;是平台指标,不是实际成交额。
gmv_30d_range
星图近 30 天 GMV 区间;是区间/估计,不是精确成交额。
gpm_30d_range
星图近 30 天 GPM 区间字符串;不改写为精确值。
average_order_value_30d_range
星图近 30 天客单价区间字符串;不是真实订单明细。
commercial_index
星图商业价值指数。
conversion_index
星图转化能力指数。
spread_index
星图传播能力指数。
shopping_index
星图种草能力指数。
quote_1_20s_cny
1–20 秒视频报价,人民币元。
quote_20_60s_cny
20–60 秒视频报价,人民币元。
quote_60s_plus_cny
60 秒以上视频报价,人民币元。
creator_type
星图返回的达人类型。
average_play_count
星图返回的平均播放量。
category_id
星图达人分类 ID。
tags
标签数组。无标签时为空数组,不是 null。
creator_grade
星图达人等级。
is_xingtu_creator
是否为星图达人。
ecommerce_enabled
是否具备星图电商能力标记。
lowest_quote_cny
星图展示的最低合作报价,人民币;是报价,不是成交价。
rate_tiers
星图报价档位;每档保留形式说明、实际报价、原报价、结算说明、视频类型与开放状态。
cpm_cny
星图榜单展示的千次曝光成本,人民币元。
completed_order_range
已完成品牌合作订单的平台区间字符串;不是精确订单数。
repurchase_rate_range
客户复购率的平台区间字符串;不是精确比率。
item_order_rate
星图展示的内容下单率。
average_view_count
榜单快照内的平均视频播放量。
previous_rank
同榜单上一期排名。
ranking_score
星图榜单综合分;只在同一榜单与时间窗内比较。
is_new
是否为本期新进榜达人。
ranking_board
星图榜单展示名称。
period_days
榜单统计周期天数。
snapshot_date
榜单快照日期,格式 YYYYMMDD。
source_kind
数据来源类型;当前公开契约只接受并返回 ranking。
product_id
抖音商城商品稳定 ID。
promotion_id
抖音带货计划中的推广 ID。
white_image_url
商品白底图 URL。
price_cny
商品展示价格,人民币元。
price_cny_minor
商品展示价格,人民币分的整数值。
price_label
商品价格标签,例如到手价。
monthly_sales
商品近 30 天销量。
good_review_ratio
商品好评率百分比。
sales_trend
商品近 30 天每日销量序列。
category_path
商品从一级到叶子类目的名称路径。
category_depth
商品类目路径深度。
shop_id
抖音商城店铺 ID。
shop_name
抖音商城店铺名称。
shop_logo_url
店铺 Logo URL,可能带有效期。
shop_score
店铺公开体验分(如有)。
commission_rate_percent
公开带货佣金比例。
commission_cny
按当前展示价计算的佣金金额,人民币。
cooperating_creator_count
商品带货计划显示的合作达人数;不能反推某位指定达人卖过该商品。
search_rank
商品在该关键词自然搜索结果中的位置。
discount_price_cny
商品当前公开优惠价,人民币元;缺失时不从原价推算。
sales_text
商品详情公开销量原文。
sold_count
商品详情当前公开的已售数量;是采集时快照,不等于指定达人销量。
shop_avatar_url
抖音商城店铺头像 URL。
main_image_urls
商品头图/轮播图 URL 列表。
detail_image_urls
商品详情长图 URL 列表。
assurances
商品公开服务保障标签。
shipping_fee_text
商品公开运费或发货地说明原文。
shipping_estimate_text
商品公开预计发货说明原文。
variant_groups
商品规格组与可选项;只保留规格名、选项名和公开规格 ID。
on_sale
商品在采集时是否显示在售。
sku_id
抖音商城 SKU ID;与商品 product_id 不是同一标识。
live_room_id
采集时挂载该商品的直播间 ID;只表示当前直播搜索命中。
is_live_product
是否由当前直播商品搜索明确返回;不是历史直播归因。

当前目录另列出 duration_sec · hashtags · verify_reason · province · industry,这些字段尚无逐项释义;请先核对 抖音 对应接口的用例与实际响应,不按字段名猜测类型或含义。

请求填写示例

检索视频主题;sort 与 publish_time 分别控制排序与发布时间窗口。

以下为填写格式示意,并非成功调用记录。请替换 API Key 和尖括号中的目标,确认可选筛选项后再调用;示例不保证目标当前有数据。

douyin_search.sh
curl -X POST https://api.everyinfra.com/api/v1/social \
  -H "Authorization: Bearer omg_你的KEY" \
  -H "Content-Type: application/json" \
  -d '{"platform":"douyin","action":"search","params":{"keyword":"城市骑行"}}'

记录字段预览(非真实响应)

仅展示 search 的记录字段,不包含外层响应、计费或任务状态。null 只作展示占位,不表示字段类型或实际空值;完整响应须以接口文档与实际调用为准。

fields.preview.json
{
  "id": null,
  "url": null,
  "text": null,
  "media_type": null,
  "like_count": null,
  "comment_count": null,
  "share_count": null,
  "collect_count": null,
  "view_count": null,
  "author_name": null,
  "author_id": null,
  "author_douyin_id": null,
  "author_follower_count": null,
  "region": null,
  "posted_at": null,
  "platform": null,
  "duration_sec": null,
  "hashtags": null
}

常见用例

以下是基于现有接口的接入思路,不是开箱即用的分析或告警功能。字段以实际返回为准,缺失值不按零处理。

用 secUid 核对抖音创作者资料与账号计数

用 profile 获取内容所关联的作者资料,不把抖音号、昵称与 secUid 混为一谈。

查看 profile 的 user_id 参数 →
  • user_id 填账号 secUid,通常以 MS4w 开头;返回的 user_id、douyin_id、nickname 分别是 secUid、抖音号和昵称。资料取自取得的视频关联作者,若没有可用作品,不能保证仅靠账号存在就能取得档案。
  • since 按 YYYY-MM-DD 筛选用于取资料的视频发布日期,不是账号注册时间,也不是历史时点画像。like_count 是账号维度的获赞数,video_count 是作品计数;不是此次取得的视频数。ip_location 不能当作精确住址或实时定位,is_verified 也不替代经营资质核验。

读取抖音单条作品,区分收藏、点赞与播放计数

用 video 看指定作品的元数据,不把作品文案当语音全文。

查看 video 的 url 参数 →
  • url 填完整 douyin.com/video/ 视频地址,不传用户主页或热榜链接。text 是作品文案,语音转写需另用 transcript;author_id 是作者 secUid,author_douyin_id 是作者抖音号,不能用作视频 ID。
  • collect_count 是收藏数,like_count 是点赞数,comment_count 只是评论数量。view_count 可能未公开或回传零值,不能据此断言无人观看。时长与标签的条件字段当前目录有漏项;本接口也没有视频下载、评论展开或排序筛选参数。

抖音评论 API 如何区分顶层评论、回复和作者点赞?

用 comments 读取作品讨论,并保留能确定的父子关系。

查看 comments 的 url 参数 →
  • url 定位一条抖音作品;结果是平铺评论行,is_reply 区分回复,reply_to_id 在可取得时关联父评论。reply_count 是声明的回复数量,不等于本次实际取得的回复行数;不能将未返回的回复补成空内容或认定已全量展开。
  • 当前公开参数没有评论排序或每条评论的回复上限开关。author_id 是评论者 secUid,liked_by_author 只是作品作者点赞标记,不表示作者认可评论中的全部事实。ip_location 是平台显示的属地信息,不能推断精确位置。

抖音搜索 API 如何用 publish_time 按发布时间筛选?

按关键词搜索视频,把近期讨论与较长时间范围的内容分开看。

查看 search 的 publish_time 参数 →
  • publish_time:one_day 最近 24 小时、one_week 最近 7 天、half_year 最近 6 个月、unlimited 不限。
  • 结合 text、posted_at 与 like_count 整理结果;搜索样本不是全站完整舆情,也不自带情绪判断。

抖音热榜 API 的 boards 和 hot_value 分别是什么?

用 boards 选择抖音榜单,按榜单来源整理选题。

查看 trending 的 boards 参数 →
  • hotspot 热点、seeding 种草、entertainment 娱乐、social 社会、challenge 挑战;可用字符串数组同时查询。
  • 保留 board、rank 与 keyword;hot_value 缺失不按零算,也不把不同榜单的热度直接混排。

按 secUid 观察博主作品

用抖音用户的 secUid 读取作品列表,整理内容主题和发布时间。

查看 user_posts 的 user_id 参数 →
  • user_id 不是昵称或短数字抖音号;结合 author_id、text、posted_at 与 collect_count 识别作品和互动。
  • 只分析实际返回内容;view_count 为零或缺失时,不能直接判断作品无人观看。

抖音视频口播整理

给 transcript 一个具体视频链接,读取语音文稿供后续整理。

查看 transcript 的 url 参数 →
  • url 使用 /video/ 视频链接;text 是文稿,title 可辅助核对目标。
  • 需要自行做摘要并回看视频核对识别结果;本接口没有声明带时间戳的 segments 字段。

怎样按关键词和粉丝区间建立抖音达人候选池?

用 creator_search 发现账号候选,再用返回的 user_id 读取资料、作品和可用的受众分析。

查看 creator_search 的 keyword 参数 →
  • keyword 可以是达人昵称、抖音号或相关主题词;follower_range 与 user_type 是 EveryInfra 当前公开的筛选条件。结果中的 user_id 是后续账号动作使用的 secUid,douyin_id 是抖音号,两者不能互换。
  • follower_count、gender、认证状态和来源关键词只用于缩小候选范围,不证明账号适合某次合作,也不代表粉丝是实际观众或买家。只保留实际返回的账号,不从昵称或认证信息推断经营资质。

怎样查看抖音达人的粉丝年龄、性别、地域和设备分布?

用 creator_audience 读取账号可得的受众分布与 TGI,用于判断内容受众是否接近目标人群。

查看 creator_audience 的 user_id 参数 →
  • user_id 填抖音账号 secUid,可从 creator_search 或 profile 结果取得。audience_distribution 是按维度组织的分布,audience_tgi 是相对指数;必须连同 dimension_code 阅读,不能把不同维度直接相加。
  • 粉丝分布不是逐个用户清单,也不等于视频观众、商品买家或真实成交人群。数据可能受授权、账号规模和可得维度限制;缺少某一维度时保持未知,不补成零。

怎样观察抖音达人的粉丝变化趋势?

用 creator_trend 保存可得的粉丝趋势和平均粉丝数,为周期性复核建立指标一致的快照。

查看 creator_trend 的 user_id 参数 →
  • user_id 使用账号 secUid,不是昵称或短数字抖音号。follower_trend 与 average_follower_count 应按返回的 dimension_code 和时间顺序保存;接口没有返回的日期点不能自行插值。
  • 趋势变化只能说明所取窗口内的账号指标变化,不能单独归因于某条内容、广告投放或商业合作;粉丝增长也不等于播放、成交或收入增长。

怎样把达人发布、互动和涨粉表现放进同类样本中比较?

用 creator_benchmark 读取平均值与对应分位,识别需要继续人工复核的强项和短板。

查看 creator_benchmark 的 user_id 参数 →
  • average_post_count、average_comment_count、average_share_count、average_like_count 与 average_follower_growth 是不同指标;对应 percentile 只在各自指标内比较,不能混成一个总分。
  • 分位值取决于当前可得的比较样本和计算方式,不是抖音官方排名、合作推荐或未来效果保证。缺失的平均值或分位保持未知,不以 0 代替。

怎样从星图达人广场建立可继续分析的商业合作候选?

用 xingtu_creator_search 按创作者关键词发现候选,比较同一次查询结果内的内容、增长、报价和商业指标。

查看 xingtu_creator_search 的 keyword 参数 →
  • keyword 用于星图达人发现;creator_id 是星图商业达人标识,不能与 user_id、公开主页 secUid、抖音号或昵称互换。搜索不到也可能与入驻、任务类型或账号状态有关。
  • expected_play_count 与 expected_natural_play_count 是预估,quote_1_20s_cny 等字段是按视频时长给出的报价,gmv_30d_range、gpm_30d_range 和 average_order_value_30d_range 都是区间。它们适合候选比较,不是最终合同价、保量承诺、订单明细或精确成交额。

怎样核对一位星图达人的账号画像与内容表现?

用 xingtu_creator_analytics 读取一个抖音号对应的可得星图资料,辅助人工复核候选。

查看 xingtu_creator_analytics 的 douyin_id 参数 →
  • douyin_id 填达人主页展示的抖音号,可从 creator_search 返回的 douyin_id 取得;它不是 secUid、nickname 或星图 creator_id。
  • average_play_count、content_themes、tags、creator_grade 和最低报价来自不同口径,只能分别阅读。is_xingtu_creator 与 ecommerce_enabled 是平台标记,不证明账号资质、未来流量、成交能力或任何合作结果。缺失字段保持未知,不补成零或 false。

怎样读取星图达人的分档报价?

用 xingtu_rate_card 读取一个抖音号当前可得的报价档位,保留每档的形式和结算说明。

查看 xingtu_rate_card 的 douyin_id 参数 →
  • douyin_id 使用 creator_search 返回的抖音号,不传 secUid、昵称或 creator_id。rate_tiers 中的 description、video_type 与 is_open 用于区分当前可得档位;不要只取最低数字后覆盖其他档位。
  • price_cny 是当前档位报价,list_price_cny 是原报价,settlement_terms 是可得结算说明。报价可能随任务形式、视频时长、开放状态和改价生效时间变化,不是最终合同价,也不保证达人接受合作。

怎样按行业、榜单类型和时间窗筛选星图达人榜?

用 xingtu_creator_rankings 读取一个明确榜单快照,保留排名、上期名次和榜单统计范围。

查看 xingtu_creator_rankings 的 ranking_type 参数 →
  • industry、ranking_type 和 time_window 都是必填字段;榜单类型包括头部、高潜、带货、传播和投流等标准,时间窗包括最新周榜、最新月榜、历史周榜和月榜。目前每次最多返回 5 条榜单本身,不保证相似达人的扩展。
  • rank、previous_rank、ranking_score、cpm_cny、复购率和已完成订单区间只在同一 ranking_board、industry、period_days 与 snapshot_date 下比较。source_kind 当前只保证 ranking;榜单位置不是合作推荐,也不构成未来表现保证。

怎样按关键词建立独立的抖音商城商品池?

用 product_search 搜索商品,比较商品卡、价格、销量趋势、店铺和佣金线索。

查看 product_search 的 keyword 参数 →
  • keyword 是抖音商城商品关键词,结果与某位达人无绑定关系;不能把 product_search 返回的商品写成该达人历史带货商品、偏好品类或真实成交归因。category_path 应按原层级保存。
  • price_cny 是展示价格,monthly_sales 与 sales_trend 是返回的销量统计,不是独立买家人数;good_review_ratio、佣金和合作达人数也可能随时点或计划变化,cooperating_creator_count 不能证明某位指定达人带过该商品。缺失价格、销量、好评率或佣金时保持未知,不补零。

怎样读取一个抖音商城商品的图集和规格?

用 product_detail 按商品 ID 查看图片、规格、店铺和公开已售数据。

查看 product_detail 的 product_id 参数 →
  • product_id 填 product_search 或 live_product_search 返回的数字商品 ID;每次读取一个商品。
  • main_image_urls、detail_image_urls 和 variant_groups 按实际返回使用;图片数量和规格组数量随商品而变。

怎样按关键词发现当前直播商品?

用 live_product_search 查找当前直播商品,并保存商品与直播间标识。

查看 live_product_search 的 keyword 参数 →
  • keyword 填商品关键词,limit 最多为 3;直播筛选由接口固定处理,不需要额外参数。
  • live_room_id 对应本次发现的直播间;当前接口不支持按指定达人筛选完整挂车清单。

抖音 教程与实战

先在本页核对当前 action、参数与字段,再按真实任务进入完整步骤或相邻方法;文章中的示例和边界不会替代本页机器目录。

指南

抖音评论数据怎么获取:从视频 URL 到保留回复关系的 JSON

从 douyin.comments 的实时参数开始,用最小请求读取评论,保留视频来源、评论 ID 与回复关系,并处理数量限制、空结果、时间解析和重复观察。

阅读完整文章 →
指南

多平台口碑监控蓝图:先记录采集范围,再判断负面变化

从目标清单、评论身份和增量游标开始,设计可追溯的口碑监控流程;用离线样本演示去重与采集缺口,保留人工复核,不冒充客户案例。

阅读完整文章 →
指南

统一数据 API 入门:从能力目录到第一条可用结果

用 platform、action、params 接入多平台数据:读懂能力目录,完成最小请求,处理异步任务、部分结果与计费,并建立可追溯的数据记录。

阅读完整文章 →

抖音 API 常见问题

抖音 API 怎么调用?

调用 POST /api/v1/social,请求体传 platform="douyin"、action 和 params。以 search 为例,必填 keyword,可选 publish_time、sort。检索视频主题;sort 与 publish_time 分别控制排序与发布时间窗口。 抖音 共 18 个 action,鉴权用 Authorization: Bearer <API Key>,同一把 Key 通 89 个平台。

抖音 API 怎么收费?

$0.56 / 千次,抖音 全部 18 个能力同价。按本页最高能力单价、每次单目标估算,$1 免费额度约可用于 1,798 次 抖音 调用。费用按所选能力与目标数量计算,多目标请求不要按单目标估算;参数错误、鉴权失败和空结果不计费。

抖音 API 一次能返回多少条数据?

抖音 有 9 个列表接口,包括 search、user_posts、comments、trending、creator_search、xingtu_creator_search、xingtu_creator_rankings、product_search、live_product_search。其余 9 个接口返回单个对象;对象内仍可能包含数组。数量参数要逐接口区分目标数、页数和记录数,不能将目录数值直接当作保证返回的条数;具体限制见对应参数与用例,不保证完整历史。

抖音 API 返回哪些字段?

当前目录为 search 列出 id、url、text、media_type、like_count、comment_count 等 18 个字段名。按全站当前目录统计,86 个字段名只在 抖音 出现;这不表示其他平台没有同类信息。字段不保证每次齐全,嵌套位置、类型与空值须按各接口说明核对,同名字段不代表语义可互换。

「用 secUid 核对抖音创作者资料与账号计数」怎样接入 抖音 API?

用 profile 获取内容所关联的作者资料,不把抖音号、昵称与 secUid 混为一谈。 user_id 填账号 secUid,通常以 MS4w 开头;返回的 user_id、douyin_id、nickname 分别是 secUid、抖音号和昵称。资料取自取得的视频关联作者,若没有可用作品,不能保证仅靠账号存在就能取得档案。 since 按 YYYY-MM-DD 筛选用于取资料的视频发布日期,不是账号注册时间,也不是历史时点画像。like_count 是账号维度的获赞数,video_count 是作品计数;不是此次取得的视频数。ip_location 不能当作精确住址或实时定位,is_verified 也不替代经营资质核验。

「读取抖音单条作品,区分收藏、点赞与播放计数」怎样接入 抖音 API?

用 video 看指定作品的元数据,不把作品文案当语音全文。 url 填完整 douyin.com/video/ 视频地址,不传用户主页或热榜链接。text 是作品文案,语音转写需另用 transcript;author_id 是作者 secUid,author_douyin_id 是作者抖音号,不能用作视频 ID。 collect_count 是收藏数,like_count 是点赞数,comment_count 只是评论数量。view_count 可能未公开或回传零值,不能据此断言无人观看。时长与标签的条件字段当前目录有漏项;本接口也没有视频下载、评论展开或排序筛选参数。

抖音评论 API 如何区分顶层评论、回复和作者点赞?

用 comments 读取作品讨论,并保留能确定的父子关系。 url 定位一条抖音作品;结果是平铺评论行,is_reply 区分回复,reply_to_id 在可取得时关联父评论。reply_count 是声明的回复数量,不等于本次实际取得的回复行数;不能将未返回的回复补成空内容或认定已全量展开。 当前公开参数没有评论排序或每条评论的回复上限开关。author_id 是评论者 secUid,liked_by_author 只是作品作者点赞标记,不表示作者认可评论中的全部事实。ip_location 是平台显示的属地信息,不能推断精确位置。

抖音搜索 API 如何用 publish_time 按发布时间筛选?

按关键词搜索视频,把近期讨论与较长时间范围的内容分开看。 publish_time:one_day 最近 24 小时、one_week 最近 7 天、half_year 最近 6 个月、unlimited 不限。 结合 text、posted_at 与 like_count 整理结果;搜索样本不是全站完整舆情,也不自带情绪判断。

可以先免费试用 抖音 API 吗?

可以。注册免费,加微信领邀请码可得 $1 免费额度(≈720 次数据调用)。请先选择 抖音 的目标接口,用单目标请求核对结果;实际可调用次数取决于能力价格与目标数量,不保证覆盖全部 18 个能力。无需信用卡。

开始调用 抖音 API

加微信领 $1 免费额度,先选一个 抖音 接口验证结果。实际可调用次数取决于能力价格与目标数量。

免费开始