TikTok

TikTok API

分别读取 TikTok 视频、话题内容、创作者资料和评论,按单视频获取可解析文稿;TikTok Shop 另提供商品搜索与达人指标,内容数据和电商数据分开核对。

请求发到 POST https://api.everyinfra.com/api/v1/social,platform 填 tiktok,action 填下方列表里的能力名,例如 search。

  • 24 个能力
  • 每千次 $0.56 起
  • 失败和空结果都不收费
  • 24h 健康值 61%

平台运行状态

24h 健康值
61%
少量可用

30 天趋势

TikTok 能力清单

能力做什么单价24 小时运行状态
关键词搜索searchsearch 的 keyword 用于发现公开视频;先按视频对象整理内容与互动,再决定是否读取单视频详情。$0.56 / 千次健康 · 健康值 100%
主页或对象详情profileprofile 用 username 定位账号,区分用户 ID、@短名、显示昵称和主页统计。$0.56 / 千次正常
用户视频user_videos用账号短名读取 user_videos,比较作者的视频内容与互动。$0.56 / 千次正常
视频详情videovideo 接收具体 TikTok 视频 url,返回单个视频对象,适合从发现列表进入内容核对。$0.56 / 千次健康 · 健康值 100%
评论commentscomments 以视频 url 定位讨论,结合评论 ID、被回复 ID 和作者互动标记整理实际取得的评论。$0.56 / 千次正常
话题内容hashtag按 hashtag 获取话题相关视频,整理参与者与内容方向。$0.56 / 千次正常
粉丝数量followersfollowers 用 username 读取账号粉丝数快照,适合对照账号规模,不返回关注该账号的个人列表。$0.56 / 千次正常
视频文稿transcripttranscript 建议每次只传一个视频 url,读取可解析文稿的 text、segments 和 has_transcript。$0.56 / 千次正常
电商商品搜索shop_search用 shop_search 搜索商品,区分商城地区和视频内容检索。$0.56 / 千次正常
带货达人shop_creator按账号和商城地区查询带货达人资料,建立待核对的合作清单。$0.56 / 千次基本不可用 · 健康值 14%
话题搜索hashtag_search用 hashtag_search 按关键词找 TikTok 话题,带话题 ID、视频数和播放量。$0.81 / 千次正常
音乐搜索music_search用 music_search 在 TikTok 音乐库里按歌名、歌手搜声音,带使用人数和是否商用曲库。$0.81 / 千次正常
音乐榜music_chart用 music_chart 一次读完整张 50 首的 TikTok 音乐榜,按名次排。$0.81 / 千次正常
账号搜索user_search用 user_search 按关键词搜 TikTok 账号,顺序同 TikTok 搜索,带粉丝数和 sec_uid。$0.56 / 千次正常
用某音乐的视频sound_videos用 sound_videos 按声音 ID 列出用了这首音乐或原声的视频。$0.56 / 千次正常
评论回复comment_replies用 comment_replies 按视频链接和评论 ID 读这条评论下的全部回复。$0.56 / 千次正常
商城热销榜shop_hot_products用 shop_hot_products 读一个站的 TikTok Shop 热销榜,按名次排。$0.81 / 千次正常
商城类目商品shop_category_products用 shop_category_products 按类目 ID 列 TikTok Shop 商品,带价格、销量和评分。$0.81 / 千次正常
关注列表following用 following 列出一个 TikTok 账号关注的账号,带粉丝数和认证。$0.64 / 千次正常
视频下载链接video_download用 video_download 按视频链接拿无水印视频地址,带清晰度、文件大小和失效时间。$0.64 / 千次正常
直播间live_room用 live_room 看一个 TikTok 账号此刻是否在直播,在播时带在线人数、峰值、点赞和拉流地址。$0.81 / 千次正常
店铺商品shop_products用 shop_products 按店铺 ID 列出一家 TikTok Shop 店的商品,带价格、销量和评分。$0.81 / 千次正常
商品评价shop_product_reviews用 shop_product_reviews 按商品 ID 读 TikTok Shop 买家评价,可按星级筛。$0.76 / 千次正常
趋势话题榜trending_hashtags用 trending_hashtags 读一个国家的 TikTok 趋势话题榜,可按行业和 7、30、90 天看。$0.81 / 千次正常

TikTok 每个接口分别做什么

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

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

所有能力都是同步调用。

能力必填参数可选参数单次条数单价返回字段
searchkeywordcontent_type默认 10 · 最多 200$0.56 / 千次id · url · text · author_name · author_username · like_count · comment_count · share_count · view_count · posted_at · collect_count · repost_count · duration_sec · duration_seconds · cover_image_url · language · country · hashtags · music · is_ad · is_pinned · is_sponsored · is_slideshow · has_shop_product · author_id · author_url · author_avatar_url · author_bio · author_is_verified · author_is_private · author_is_seller · author_follower_count · author_following_count · author_like_count · author_video_count · platform
profileusername——$0.56 / 千次user_id · username · display_name · bio · url · external_url · follower_count · following_count · like_count · video_count · friend_count · is_verified · is_private · avatar_url · created_at · platform
user_videosusernamemin_likes, sort, until默认 10 · 最多 50$0.56 / 千次id · url · text · author_name · author_username · like_count · comment_count · share_count · view_count · posted_at · collect_count · repost_count · duration_sec · duration_seconds · cover_image_url · language · country · hashtags · music · is_ad · is_pinned · is_sponsored · is_slideshow · has_shop_product · author_id · author_url · author_avatar_url · author_bio · author_is_verified · author_is_private · author_is_seller · author_follower_count · author_following_count · author_like_count · author_video_count · platform
videourl——$0.56 / 千次id · url · text · author_name · author_username · like_count · comment_count · share_count · view_count · posted_at · collect_count · repost_count · duration_sec · duration_seconds · cover_image_url · language · country · hashtags · music · is_ad · is_pinned · is_sponsored · is_slideshow · has_shop_product · author_id · author_url · author_avatar_url · author_bio · author_is_verified · author_is_private · author_is_seller · author_follower_count · author_following_count · author_like_count · author_video_count · platform
commentsurl—默认 20 · 最多 200$0.56 / 千次id · text · author_username · author_id · like_count · reply_count · reply_to_id · is_reply · liked_by_author · pinned_by_author · posted_at · platform
hashtaghashtag—默认 10 · 最多 30$0.56 / 千次id · url · text · author_name · author_username · like_count · comment_count · share_count · view_count · posted_at · collect_count · repost_count · duration_sec · duration_seconds · cover_image_url · language · country · hashtags · music · is_ad · is_pinned · is_sponsored · is_slideshow · has_shop_product · author_id · author_url · author_avatar_url · author_bio · author_is_verified · author_is_private · author_is_seller · author_follower_count · author_following_count · author_like_count · author_video_count · platform
followersusernamechannel—$0.56 / 千次id · username · url · follower_count · following_count · post_count · like_count · connection_count · precision · platform
transcripturl——$0.56 / 千次id · url · text · segments · has_transcript · platform
shop_searchkeywordcountry, page默认 20 · 最多 100$0.56 / 千次id · url · name · price · original_price · currency · sold_count · rating · rating_scale · review_count · category · shop_name · image_url · platform
shop_creatorusernamecountry—$0.56 / 千次id · username · url · name · text · avatar_url · country · categories · follower_count · video_count · product_count · sold_count · avg_views · platform
hashtag_searchkeywordpage_token每页 20 条$0.81 / 千次hashtag_id · hashtag_name · url · description · video_count · view_count · next_page_token · platform
music_searchkeywordpage_token每页 20 条$0.81 / 千次id · url · title · author_name · album · duration_seconds · duration_sec · use_count · is_original · is_commercial · released_at · cover_image_url · audio_url · next_page_token · platform
music_chart—chart默认 50 · 最多 50$0.81 / 千次rank · id · url · title · author_name · album · language · duration_seconds · duration_sec · use_count · is_commercial · released_at · cover_image_url · audio_url · platform
user_searchkeywordpage_token每页 20 条$0.56 / 千次user_id · username · display_name · url · sec_uid · follower_count · following_count · like_count · video_count · is_verified · verified_label · avatar_url · is_live · next_page_token · platform
sound_videosmusic_idpage_token每页 20 条$0.56 / 千次id · url · text · author_name · author_username · like_count · comment_count · share_count · view_count · posted_at · collect_count · repost_count · duration_sec · duration_seconds · cover_image_url · language · country · hashtags · music · is_ad · is_pinned · is_sponsored · is_slideshow · has_shop_product · author_id · author_url · author_avatar_url · author_bio · author_is_verified · author_is_private · platform · next_page_token
comment_repliesurl, comment_idpage_token每页 20 条$0.56 / 千次id · text · like_count · author_username · author_name · author_id · author_url · author_avatar_url · liked_by_author · is_reply · reply_to_id · reply_to_reply_id · language · posted_at · video_id · next_page_token · platform
shop_hot_products—country默认 20 · 最多 100$0.81 / 千次rank · id · url · name · price · original_price · currency · sold_count · rating · rating_scale · review_count · shop_name · shop_id · image_url · platform
shop_category_productscategory_idcountry, page_token每页 15 条$0.81 / 千次id · url · name · price · original_price · currency · sold_count · rating · rating_scale · review_count · shop_name · shop_id · image_url · platform · next_page_token
followingusernamepage_token每页 20 条$0.64 / 千次user_id · username · display_name · url · sec_uid · bio · follower_count · following_count · like_count · video_count · is_verified · verified_label · avatar_url · country · next_page_token · platform
video_downloadurl——$0.64 / 千次id · url · text · author_username · duration_seconds · duration_sec · video_url · video_backup_urls · width · height · size_bytes · hd_video_url · hd_width · hd_size_bytes · watermarked_video_url · audio_url · cover_image_url · image_urls · is_slideshow · expires_at · platform
live_roomusername——$0.81 / 千次username · display_name · user_id · is_live · room_id · url · title · viewer_count · peak_viewer_count · total_viewer_count · like_count · share_count · product_count · started_at · cover_image_url · stream_url · platform
shop_productsshop_idcountry, page_token—$0.81 / 千次id · url · name · price · original_price · currency · sold_count · rating · rating_scale · review_count · shop_name · shop_id · image_url · platform · next_page_token
shop_product_reviewsproduct_idcountry, page_token, rating, sort默认 20 · 最多 20$0.76 / 千次id · rating · rating_scale · text · posted_at · variant · is_verified_purchase · is_incentivized · image_urls · author_name · country · product_id · next_page_token · platform
trending_hashtags—country, industry, page_token, time_window每页 20 条$0.81 / 千次rank · hashtag_id · hashtag_name · url · video_count · view_count · trend · next_page_token · platform

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

profile

使用 platform="tiktok"、action="profile" 调用“主页或对象详情”能力;返回单个对象,主要包含 user_id、username、display_name、bio、url、external_url 等 16 个字段。

查看完整接口文档:参数、代码示例、响应样例与健康状态

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

username必填
公开 TikTok 用户短名,可带 @,不要把抖音 secUid 或完整主页 URL 塞入此字段。followers 只取粉丝数量;shop_creator 查询指定市场的带货达人信息。

TikTok 将 username 与 nickname 分开:username 构成 @ 标记及个人主页链接,昵称是显示给其他用户的名字;更改 username 也会改变主页链接。官方来源:TikTok:username 与昵称的区别来源核查:

TikTok 返回字段与含义(4)
video_count
视频数。
friend_count
好友数。
is_private
是否私密账号。
external_url
主页外链。

怎么调用 TikTok 用户视频 API?

user_videos

使用 platform="tiktok"、action="user_videos" 调用“用户视频”能力;返回列表,默认 10 条、单次最多 50 条,主要包含 id、url、text、author_name、author_username、like_count 等 36 个字段。

查看完整接口文档:参数、代码示例、响应样例与健康状态

TikTok user_videos 的参数分别是什么意思?

username必填
公开 TikTok 用户短名,可带 @,不要把抖音 secUid 或完整主页 URL 塞入此字段。followers 只取粉丝数量;shop_creator 查询指定市场的带货达人信息。

TikTok 将 username 与 nickname 分开:username 构成 @ 标记及个人主页链接,昵称是显示给其他用户的名字;更改 username 也会改变主页链接。官方来源:TikTok:username 与昵称的区别来源核查:

min_likes可选
user_videos 的作者视频最低点赞数筛选,使用正整数;不是作者粉丝数或评论点赞门槛。
sort可选
user_videos 的作者视频排序:newest 最新、oldest 最早、popular 热门。只用于 user_videos,search 不支持排序。
查看全部 3 个允许值

newestoldestpopular

until可选
user_videos 的作者视频发布时间上界,不是数据采集时间;只用于 user_videos。
TikTok 返回字段与含义(11)
repost_count
转发数。
cover_image_url
视频封面图链接(带签名,会过期)。
music
背景音乐:id、title(曲名)、author、is_original(是否原声)、play_url(音频地址,会过期)、cover_url。
is_ad
是否广告视频。
is_pinned
是否在作者主页置顶。
is_sponsored
是否含赞助内容。
is_slideshow
是否图文轮播(不是视频)。
has_shop_product
视频是否挂了 TikTok Shop 商品;没有这个键表示无法判定。
author_is_private
作者是否私密账号。
author_is_seller
作者是否 TikTok Shop 卖家。
author_name
评价人名字(shop_product_reviews),平台已打码,如 n**h。

怎么调用 TikTok 视频详情 API?

video

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

查看完整接口文档:参数、代码示例、响应样例与健康状态

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

url必填
video / comments / transcript 的具体 TikTok 视频链接;comments 按视频取评论,每条顶层评论最多附带两条回复,不保证完整对话树。

官方 Research API 支持按 video_id 查询视频数据;EveryInfra 从视频 URL 规范化为 ID 属于自身实现,该来源不能证明任意公开视频 URL、所有返回字段或无需研究产品授权的访问。官方来源:TikTok Research API:按 video_id 查询视频来源核查:

TikTok 返回字段与含义(11)
repost_count
转发数。
cover_image_url
视频封面图链接(带签名,会过期)。
music
背景音乐:id、title(曲名)、author、is_original(是否原声)、play_url(音频地址,会过期)、cover_url。
is_ad
是否广告视频。
is_pinned
是否在作者主页置顶。
is_sponsored
是否含赞助内容。
is_slideshow
是否图文轮播(不是视频)。
has_shop_product
视频是否挂了 TikTok Shop 商品;没有这个键表示无法判定。
author_is_private
作者是否私密账号。
author_is_seller
作者是否 TikTok Shop 卖家。
author_name
评价人名字(shop_product_reviews),平台已打码,如 n**h。

怎么调用 TikTok 评论 API?

comments

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

查看完整接口文档:参数、代码示例、响应样例与健康状态

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

url必填
video / comments / transcript 的具体 TikTok 视频链接;comments 按视频取评论,每条顶层评论最多附带两条回复,不保证完整对话树。

官方 Research API 可按 video_id 查询评论,单次最多 100,并说明删除等原因可能造成返回不足;EveryInfra 的 URL 解析属于自身实现,不能据此承诺任意视频、评论完整性、完整回复树或本接口的结果上限。官方来源:TikTok Research API:视频评论查询来源核查:

TikTok 返回字段与含义(4)
is_reply
是否为回复。
reply_to_id
被回复评论 ID。
liked_by_author
评论是否被作者点赞。
pinned_by_author
评论是否被作者置顶。

怎么调用 TikTok 话题内容 API?

hashtag

使用 platform="tiktok"、action="hashtag" 调用“话题内容”能力;返回列表,默认 10 条、单次最多 30 条,主要包含 id、url、text、author_name、author_username、like_count 等 36 个字段。

查看完整接口文档:参数、代码示例、响应样例与健康状态

TikTok hashtag 的参数分别是什么意思?

hashtag必填
hashtag 的话题名,可带或不带 #,不等同于任意全文搜索词。

TikTok Research API 明确定义 hashtag_name 视频查询条件;EveryInfra 的 hashtag 是对应的产品输入命名,但该来源不证明任意历史范围、结果完整性,也不把全文 keyword、排序或其他搜索筛选自动带入本 action。官方来源:TikTok Research API:hashtag_name 视频条件来源核查:

TikTok 返回字段与含义(11)
repost_count
转发数。
cover_image_url
视频封面图链接(带签名,会过期)。
music
背景音乐:id、title(曲名)、author、is_original(是否原声)、play_url(音频地址,会过期)、cover_url。
is_ad
是否广告视频。
is_pinned
是否在作者主页置顶。
is_sponsored
是否含赞助内容。
is_slideshow
是否图文轮播(不是视频)。
has_shop_product
视频是否挂了 TikTok Shop 商品;没有这个键表示无法判定。
author_is_private
作者是否私密账号。
author_is_seller
作者是否 TikTok Shop 卖家。
author_name
评价人名字(shop_product_reviews),平台已打码,如 n**h。

怎么调用 TikTok 粉丝数量 API?

followers

使用 platform="tiktok"、action="followers" 调用“粉丝数量”能力;返回单个对象,主要包含 id、username、url、follower_count、following_count、post_count 等 10 个字段。

查看完整接口文档:参数、代码示例、响应样例与健康状态

TikTok followers 的参数分别是什么意思?

username必填
公开 TikTok 用户短名,可带 @,不要把抖音 secUid 或完整主页 URL 塞入此字段。followers 只取粉丝数量;shop_creator 查询指定市场的带货达人信息。

TikTok 将 username 与 nickname 分开:username 构成 @ 标记及个人主页链接,昵称是显示给其他用户的名字;更改 username 也会改变主页链接。官方来源:TikTok:username 与昵称的区别来源核查:

channel可选
followers 的账号兼容输入,优先级低于 username;不用于 TikTok Shop 商品搜索。
TikTok 返回字段与含义(2)
connection_count
关联数。
precision
数据精确度标记。

怎么调用 TikTok 视频文稿 API?

transcript

使用 platform="tiktok"、action="transcript" 调用“视频文稿”能力;返回单个对象,主要包含 id、url、text、segments、has_transcript、platform。

查看完整接口文档:参数、代码示例、响应样例与健康状态

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

url必填
video / comments / transcript 的具体 TikTok 视频链接;comments 按视频取评论,每条顶层评论最多附带两条回复,不保证完整对话树。

官方视频字段包含 voice_to_text,并说明它仅在相应视频功能开启时提供语音转文字或字幕信息;这不证明 EveryInfra 会主动生成转写、任意 URL 都有文稿、批量 urls 的返回形状或字幕语言与完整性。官方来源:TikTok Research API:voice_to_text 视频字段来源核查:

TikTok 返回字段与含义(2)
has_transcript
是否有字幕可提取。
segments
字幕分段(带时间戳的文本)。

怎么调用 TikTok 带货达人 API?

shop_creator

使用 platform="tiktok"、action="shop_creator" 调用“带货达人”能力;返回单个对象,主要包含 id、username、url、name、text、avatar_url 等 14 个字段。

查看完整接口文档:参数、代码示例、响应样例与健康状态

TikTok shop_creator 的参数分别是什么意思?

username必填
公开 TikTok 用户短名,可带 @,不要把抖音 secUid 或完整主页 URL 塞入此字段。followers 只取粉丝数量;shop_creator 查询指定市场的带货达人信息。

TikTok 官方说明 username 构成 @ 标识和个人主页链接,并与可变显示昵称不同。这里只核对 shop_creator 的账号输入语义;它不证明该账号具备 Shop 创作者身份,也不为销量、GMV、商品或 country 覆盖背书。官方来源:TikTok:username 与显示昵称是不同标识来源核查:

country可选
shop_search / shop_creator 的商城地区代码,默认 US/us;不是视频作者国籍或全站内容地区过滤。支持的市场以目录为准。
TikTok 返回字段与含义(5)
video_count
视频数。
sold_count
销量。
avg_views
平均播放量。衡量达人真实水位:粉丝数会造假,均播难。
categories
分类。
product_count
带货商品数。

怎么调用 TikTok 音乐榜 API?

music_chart

使用 platform="tiktok"、action="music_chart" 调用“音乐榜”能力;返回列表,默认 50 条、单次最多 50 条,主要包含 rank、id、url、title、author_name、album 等 15 个字段。

查看完整接口文档:参数、代码示例、响应样例与健康状态

TikTok 官方创作者学院说明 TikTok Billboard Top 50 是按创作量、播放量和互动算的美国 TikTok 热门歌曲周榜,Viral 50 是 App 内独有、按全球互动选出上升最快歌曲的榜单,两张榜都能从 App 的音乐详情页打开。可证明 top50、viral50 两张榜的对象和口径;不证明本接口返回的字段、刷新时间与 App 内同步。官方来源:TikTok 创作者学院:TikTok Billboard Top 50 与 Viral 50 榜来源核查:

TikTok music_chart 的参数分别是什么意思?

chart可选
榜单:top50(TikTok 音乐 Top 50,默认)或 viral50(Viral 50,近期在 TikTok 上走红的歌)。一次给整榜 50 首。
查看全部 2 个允许值

top50viral50

TikTok 返回字段与含义(8)
cover_image_url
视频封面图链接(带签名,会过期)。
author_name
评价人名字(shop_product_reviews),平台已打码,如 n**h。
album
专辑名(music_search / music_chart);原声、没登记专辑的没有这个字段。
use_count
用过这首音乐的视频数(music_search / music_chart)。
is_commercial
是否 TikTok 商用曲库里的音乐(music_search / music_chart)。
released_at
音乐发行日期(music_search / music_chart);原声、没登记发行日期的没有这个字段。
audio_url
试听音频链接(music_search / music_chart),多为 60 秒片段,带签名、会过期。
rank
名次,从 1 起(music_chart / shop_hot_products)。

怎么调用 TikTok 用某音乐的视频 API?

sound_videos

使用 platform="tiktok"、action="sound_videos" 调用“用某音乐的视频”能力;返回列表,每次一页、固定 20 条,更多用 next_page_token 翻页,主要包含 id、url、text、author_name、author_username、like_count 等 32 个字段。

查看完整接口文档:参数、代码示例、响应样例与健康状态

TikTok 官方 Research API 的视频查询可以用 music_id(视频所用音乐的 ID)作条件筛视频,研究数据说明也把 music_id 列为视频字段。可证明「用了同一首音乐的视频」可以按音乐 ID 定位;官方接口只开放给获批的研究者,本接口的每页条数、排序和是否收全以返回为准。官方来源:TikTok Research API:music_id 视频查询条件来源核查:

TikTok sound_videos 的参数分别是什么意思?

music_id必填
音乐 ID(music_search / music_chart 行里的 id、视频行 music.id),或 https://www.tiktok.com/music/<名字>-<ID> 链接。
page_token可选
翻页令牌:把上一次响应里的 next_page_token 原样传回,拿下一页;不传从第一页开始。令牌 24 小时有效,每页算一次调用。每页最多 20 条,常见 12–13 条;短页不代表到底,没有 next_page_token 才是最后一页。
TikTok 返回字段与含义(10)
repost_count
转发数。
cover_image_url
视频封面图链接(带签名,会过期)。
music
背景音乐:id、title(曲名)、author、is_original(是否原声)、play_url(音频地址,会过期)、cover_url。
is_ad
是否广告视频。
is_pinned
是否在作者主页置顶。
is_sponsored
是否含赞助内容。
is_slideshow
是否图文轮播(不是视频)。
has_shop_product
视频是否挂了 TikTok Shop 商品;没有这个键表示无法判定。
author_is_private
作者是否私密账号。
author_name
评价人名字(shop_product_reviews),平台已打码,如 n**h。

怎么调用 TikTok 评论回复 API?

comment_replies

使用 platform="tiktok"、action="comment_replies" 调用“评论回复”能力;返回列表,每次一页、固定 20 条,更多用 next_page_token 翻页,主要包含 id、text、like_count、author_username、author_name、author_id 等 17 个字段。

查看完整接口文档:参数、代码示例、响应样例与健康状态

TikTok 官方 Research API 的评论查询传 comment_id 时返回这条评论下的回复,回复带 parent_comment_id 和发布时间,单次最多 100 条。可证明「一条评论下的回复」是可以单独查询的对象;官方接口只开放给获批的研究者,不证明本接口每页条数或回复收全。官方来源:TikTok Research API:按 comment_id 查评论的回复来源核查:

TikTok comment_replies 的参数分别是什么意思?

url必填
评论所在的 TikTok 视频链接(https://www.tiktok.com/@用户/video/<数字>),或视频 ID。
comment_id必填
顶层评论的 ID(tiktok.comments 行里的 id),纯数字;返回这条评论下的回复。
page_token可选
翻页令牌:把上一次响应里的 next_page_token 原样传回,拿下一页;不传从第一页开始。令牌 24 小时有效,每页算一次调用。每页最多 20 条回复。
TikTok 返回字段与含义(6)
author_name
评价人名字(shop_product_reviews),平台已打码,如 n**h。
is_reply
是否为回复。
reply_to_id
被回复评论 ID。
liked_by_author
评论是否被作者点赞。
reply_to_reply_id
这条回复是回给哪条回复的(comment_replies);直接回顶层评论的没有这个字段。
video_id
评论所在视频的 ID(comment_replies)。

怎么调用 TikTok 商城热销榜 API?

shop_hot_products

使用 platform="tiktok"、action="shop_hot_products" 调用“商城热销榜”能力;返回列表,默认 20 条、单次最多 100 条,主要包含 rank、id、url、name、price、original_price 等 15 个字段。

查看完整接口文档:参数、代码示例、响应样例与健康状态

TikTok shop_hot_products 的参数分别是什么意思?

country可选
商城地区代码:ID、JP、MX、MY(默认)、PH、SG、TH、VN。美国、英国、巴西站没有热销榜,传了会在扣费前被拒。
TikTok 返回字段与含义(5)
shop_name
小店名称(TikTok Shop 用)。
sold_count
销量。
original_price
原价。
rank
名次,从 1 起(music_chart / shop_hot_products)。
shop_id
店铺 ID(shop_products),可以直接传给 shop_products 的 shop_id。

怎么调用 TikTok 商城类目商品 API?

shop_category_products

使用 platform="tiktok"、action="shop_category_products" 调用“商城类目商品”能力;返回列表,每次一页、固定 15 条,更多用 next_page_token 翻页,主要包含 id、url、name、price、original_price、currency 等 15 个字段。

查看完整接口文档:参数、代码示例、响应样例与健康状态

TikTok shop_category_products 的参数分别是什么意思?

category_id必填
TikTok Shop 类目 ID,纯数字,如 601450(美妆个护);一级、二级、三级类目都可以。
country可选
商城地区代码:US(默认)、SG、MY、PH、TH、VN、ID、JP、MX。
page_token可选
翻页令牌:把上一次响应里的 next_page_token 原样传回,拿下一页;不传从第一页开始。令牌 24 小时有效,每页算一次调用。每页约 15 个商品。
TikTok 返回字段与含义(4)
shop_name
小店名称(TikTok Shop 用)。
sold_count
销量。
original_price
原价。
shop_id
店铺 ID(shop_products),可以直接传给 shop_products 的 shop_id。

怎么调用 TikTok 关注列表 API?

following

使用 platform="tiktok"、action="following" 调用“关注列表”能力;返回列表,每次一页、固定 20 条,更多用 next_page_token 翻页,主要包含 user_id、username、display_name、url、sec_uid、bio 等 16 个字段。

查看完整接口文档:参数、代码示例、响应样例与健康状态

TikTok 官方 Research API 按 username 返回这个账号关注的账号(显示名和用户名),每次最多 100 个,按开始关注的时间往前翻页。可证明「一个账号的关注列表」是官方定义的对象;官方接口只开放给获批的研究者,本接口每页 20 个、用自己的令牌翻页,关注列表设成不公开的账号取不到。官方来源:TikTok Research API:查询账号的关注列表(Query User Following)来源核查:

TikTok following 的参数分别是什么意思?

username必填
要看关注列表的 TikTok 账号:@短名(如 zachking,可带 @)、主页链接 https://www.tiktok.com/@<短名>,或账号的 sec_uid(账号搜索、主页资料返回的那串长 ID)。
page_token可选
翻页令牌:把上一次响应里的 next_page_token 原样传回,拿下一页;不传从第一页开始。令牌 24 小时有效,每页算一次调用。每页最多 20 个账号。
TikTok 返回字段与含义(3)
video_count
视频数。
sec_uid
账号的 secUid(user_search),TikTok 网页接口里长期不变的账号标识。
verified_label
认证说明(user_search),如 Verified account;没认证的没有这个字段。

怎么调用 TikTok 视频下载链接 API?

video_download

使用 platform="tiktok"、action="video_download" 调用“视频下载链接”能力;返回单个对象,主要包含 id、url、text、author_username、duration_seconds、duration_sec 等 21 个字段。

查看完整接口文档:参数、代码示例、响应样例与健康状态

TikTok video_download 的参数分别是什么意思?

url必填
要取下载链接的 TikTok 视频:带视频 ID 的链接(https://www.tiktok.com/@用户/video/<数字>,图文帖的 /photo/<数字> 也认),或 15–21 位纯数字视频 ID;vm.tiktok.com 这类短链认不出,先在浏览器打开换成完整链接。
TikTok 返回字段与含义(12)
cover_image_url
视频封面图链接(带签名,会过期)。
is_slideshow
是否图文轮播(不是视频)。
audio_url
试听音频链接(music_search / music_chart),多为 60 秒片段,带签名、会过期。
video_url
无水印视频文件地址(video_download,mp4)。不用 Cookie、不限 IP,到 expires_at 失效;图文作品没有。
video_backup_urls
同一个文件的备用地址(video_download),video_url 打不开时换用。
size_bytes
video_url 那个文件的大小,字节(video_download)。
hd_video_url
更清晰的一档(video_download),通常 1080p;没有比 video_url 更清晰的就没有这个字段。
hd_width
hd_video_url 的宽度,像素(video_download)。
hd_size_bytes
hd_video_url 的文件大小,字节(video_download)。
watermarked_video_url
带 TikTok 水印的下载地址(video_download);部分视频没有。
image_urls
图文(轮播)作品的每张图片地址(video_download);只有图文作品有。
expires_at
下载地址的失效时间(video_download,ISO,约在调用后 6 小时);过了要重新调用。

怎么调用 TikTok 直播间 API?

live_room

使用 platform="tiktok"、action="live_room" 调用“直播间”能力;返回单个对象,主要包含 username、display_name、user_id、is_live、room_id、url 等 17 个字段。

查看完整接口文档:参数、代码示例、响应样例与健康状态

TikTok live_room 的参数分别是什么意思?

username必填
要看直播间的 TikTok 账号:@短名(如 zachking,可带 @)或主页链接 https://www.tiktok.com/@<短名>;不收 sec_uid。没在直播时返回一行 is_live=false。
TikTok 返回字段与含义(8)
cover_image_url
视频封面图链接(带签名,会过期)。
product_count
带货商品数。
is_live
账号此刻是否在直播(user_search)。
room_id
直播间 ID(live_room);没在播的没有这个字段。
viewer_count
调用那一刻的在线观众数(live_room)。
peak_viewer_count
本场直播的在线峰值(live_room)。
total_viewer_count
本场直播累计进入人次(live_room)。
stream_url
直播拉流地址(live_room,FLV,带签名、会过期);没在播、在别人直播间连麦时没有。

怎么调用 TikTok 店铺商品 API?

shop_products

使用 platform="tiktok"、action="shop_products" 调用“店铺商品”能力;返回列表,主要包含 id、url、name、price、original_price、currency 等 15 个字段。

查看完整接口文档:参数、代码示例、响应样例与健康状态

TikTok 官方 Research API 按 shop_id 分页列出店铺里的商品(商品名、ID、价格、销量、评价数、各星级评分数)。可证明「一个店铺的商品列表」由店铺 ID 定位;官方接口只给在欧盟销售的商品、只开放给获批的研究者,本接口覆盖的美国、东南亚等商城不在其范围内,不能据此证明字段口径一致。官方来源:TikTok Research API:按 shop_id 查店铺商品来源核查:

TikTok shop_products 的参数分别是什么意思?

shop_id必填
TikTok Shop 店铺 ID(商品行里的 shop_id),纯数字;或 shop.tiktok.com 的 /store/ 店铺链接。
country可选
店铺所在商城地区代码:US(默认)、SG、MY、PH、TH、VN、ID、JP、MX。
page_token可选
翻页令牌:把上一次响应里的 next_page_token 原样传回,拿下一页;不传从第一页开始。令牌 24 小时有效,每页算一次调用。每页最多 30 个商品。
TikTok 返回字段与含义(4)
shop_name
小店名称(TikTok Shop 用)。
sold_count
销量。
original_price
原价。
shop_id
店铺 ID(shop_products),可以直接传给 shop_products 的 shop_id。

怎么调用 TikTok 商品评价 API?

shop_product_reviews

使用 platform="tiktok"、action="shop_product_reviews" 调用“商品评价”能力;返回列表,默认 20 条、单次最多 20 条,主要包含 id、rating、rating_scale、text、posted_at、variant 等 14 个字段。

查看完整接口文档:参数、代码示例、响应样例与健康状态

TikTok 官方 Research API 按 product_id 分页列出商品评价(正文、星级、点赞数、发布时间)。可证明「一个商品的评价」由商品 ID 定位;官方接口只给在欧盟销售的商品、只开放给获批的研究者,不证明本接口的排序、星级筛选或美国、东南亚商城的覆盖。官方来源:TikTok Research API:按 product_id 查商品评价来源核查:

TikTok shop_product_reviews 的参数分别是什么意思?

product_id必填
TikTok Shop 商品 ID,纯数字;或 shop.tiktok.com 的 /pdp/ 商品链接。
country可选
商品所在商城地区代码:US(默认)、SG、MY、PH、TH、VN、ID、JP、MX。
page_token可选
翻页令牌:把上一次响应里的 next_page_token 原样传回,拿下一页;不传从第一页开始。令牌 24 小时有效,每页算一次调用。每页最多 20 条,条数按 limit 给(不传为 20,大于 20 也按 20)。
rating可选
只看几星的评价:1 到 5;不传看全部。
查看全部 5 个允许值

12345

sort可选
排序:newest(默认)或 recommended。目前两个值返回的顺序可能相同,不保证最新的在前;要看时间先后,请根据每条评价的 posted_at 自行排序。
查看全部 2 个允许值

newestrecommended

TikTok 返回字段与含义(5)
author_name
评价人名字(shop_product_reviews),平台已打码,如 n**h。
image_urls
图文(轮播)作品的每张图片地址(video_download);只有图文作品有。
variant
买家买的规格(shop_product_reviews),如颜色、香型。
is_verified_purchase
是否确认购买后写的评价(shop_product_reviews)。
is_incentivized
是否带激励的评价(shop_product_reviews),如晒图返券。
TikTok search 调用流程一次 TikTok search 调用的全过程:向 POST /api/v1/social 发送 platform="tiktok"、action="search",以及必填参数 keyword;返回结构化 JSON,含 id、url、text、author_name、author_username 等字段;返回列表,单次最多 200 条,计费 $0.56 / 千次,失败与空结果不计费。1 · 请求POST /api/v1/socialplatform: "tiktok"action: "search"keywordEveryInfra$0.56 / 千次2 · 响应 · 列表idurltextauthor_nameauthor_username
一次 TikTok search 调用的全过程:向 POST /api/v1/social 发送 platform="tiktok"、action="search",以及必填参数 keyword;返回结构化 JSON,含 id、url、text、author_name、author_username 等字段;返回列表,单次最多 200 条,计费 $0.56 / 千次,失败与空结果不计费。

TikTok 原始字段名

EveryInfra 统一字段名

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

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

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

  • is_slideshow
  • has_shop_product
  • author_is_private
  • author_is_seller
  • friend_count
  • pinned_by_author
  • has_transcript
  • avg_views
  • album
  • is_commercial
  • sec_uid
  • verified_label
  • video_backup_urls
  • size_bytes
  • hd_video_url
  • hd_width
  • hd_size_bytes
  • watermarked_video_url

返回字段含义

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

id
该记录在原平台上的唯一标识。仅在同一平台内唯一,跨平台可能重复。
url
该记录在原平台上的可访问链接。
text
正文内容,已去除 HTML 标签,全文返回、不截断(个别平台的列表结果本身只有摘要,以该平台的字段说明为准)。
author_name
评价人名字(shop_product_reviews),平台已打码,如 n**h。
author_username
作者用户名(@handle),通常可用于拼 URL。
like_count
点赞数。null 表示该平台或该接口不公开此数据,不等于 0。
comment_count
评论数。null 表示不公开,不等于 0。
share_count
分享/转发数。null 表示不公开,不等于 0。
view_count
浏览/播放数。null 表示不公开,不等于 0。
posted_at
发布时间,ISO 8601 格式、UTC 时区(如 2026-08-07T12:34:56+00:00)。平台只给非标准字符串时原样透传,解析前建议做容错。null 表示平台未公开。
collect_count
收藏数。null 表示不公开,不等于 0。
repost_count
转发数。
duration_seconds
时长,单位秒。非视频/音频内容为 null。
cover_image_url
视频封面图链接(带签名,会过期)。
language
内容语言代码(如 zh、en),由平台判定,可能不准。
country
国家或地区。可能是全称也可能是 ISO 代码,取决于平台,未归一。
hashtags
正文里的话题标签数组,按出现顺序;没有时不出现这个字段。
music
背景音乐:id、title(曲名)、author、is_original(是否原声)、play_url(音频地址,会过期)、cover_url。
is_ad
是否广告视频。
is_pinned
是否在作者主页置顶。
is_sponsored
是否含赞助内容。
is_slideshow
是否图文轮播(不是视频)。
has_shop_product
视频是否挂了 TikTok Shop 商品;没有这个键表示无法判定。
author_id
作者在原平台的唯一 ID。
author_url
作者在原平台的主页链接。
author_avatar_url
作者头像图片链接(多数平台带签名、会过期)。
author_is_private
作者是否私密账号。
author_is_seller
作者是否 TikTok Shop 卖家。
author_follower_count
作者粉丝数。null 表示不公开。
platform
数据来源平台标识,与请求里的 platform 一致(如 xiaohongshu、tiktok)。
user_id
用户在原平台的唯一 ID。
username
用户名(@handle)。
display_name
显示名,可能与 username 不同。
bio
个人简介,账号自己填写的文本。可能含换行和 emoji。
external_url
主页外链。
follower_count
粉丝数。null 表示不公开,不等于 0。
following_count
关注数。null 表示不公开,不等于 0。
video_count
视频数。
friend_count
好友数。
is_verified
是否为平台认证账号(蓝V等)。null 表示无法判定。
is_private
是否私密账号。
avatar_url
头像图片链接。部分平台给的是带尺寸参数的 CDN 链接,可能有时效。
created_at
创建时间,格式同 posted_at。
reply_count
回复数,通常用于评论的子回复。null 表示不公开。
reply_to_id
被回复评论 ID。
is_reply
是否为回复。
liked_by_author
评论是否被作者点赞。
pinned_by_author
评论是否被作者置顶。
post_count
发布内容总数。null 表示不公开,不等于 0。
connection_count
关联数。
precision
数据精确度标记。
segments
字幕分段(带时间戳的文本)。
has_transcript
是否有字幕可提取。
name
名称。用于账号/商品/商家类能力,指该对象本身的名字。
price
价格数值,不含货币符号;币种见 currency。
original_price
原价。
currency
价格币种代码(如 CNY、USD)。price 存在但 currency 为 null 时不要假定币种。
sold_count
销量。
rating
评分。分制随平台而异,同一行的 rating_scale 给出该平台满分 (多数是 5,Booking/豆瓣/爱奇艺/NAVER 是 10)。跨平台比较前必须先按 rating_scale 换算。直接比数字会得出反的结论。
rating_scale
上一列 rating 的满分。5 表示五星制、10 表示十分制。只在该行有 rating 时出现。
review_count
评价条数,用于商品/商家类能力。null 表示不公开,不等于 0。
category
分类名称,取值为原平台的分类体系,未做跨平台归一。
shop_name
小店名称(TikTok Shop 用)。
image_url
图片链接。多图能力可能返回 image_urls 数组。
categories
分类。
product_count
带货商品数。
avg_views
平均播放量。衡量达人真实水位:粉丝数会造假,均播难。
hashtag_id
话题 ID(hashtag_search、trending_hashtags)。
hashtag_name
话题名,不带 #(hashtag_search、trending_hashtags)。
description
简介或描述,通常比 text 短。
title
标题。平台无标题概念时(如纯文本帖)为 null。
album
专辑名(music_search / music_chart);原声、没登记专辑的没有这个字段。
use_count
用过这首音乐的视频数(music_search / music_chart)。
is_commercial
是否 TikTok 商用曲库里的音乐(music_search / music_chart)。
released_at
音乐发行日期(music_search / music_chart);原声、没登记发行日期的没有这个字段。
audio_url
试听音频链接(music_search / music_chart),多为 60 秒片段,带签名、会过期。
rank
名次,从 1 起(music_chart / shop_hot_products)。
sec_uid
账号的 secUid(user_search),TikTok 网页接口里长期不变的账号标识。
verified_label
认证说明(user_search),如 Verified account;没认证的没有这个字段。
is_live
账号此刻是否在直播(user_search)。
reply_to_reply_id
这条回复是回给哪条回复的(comment_replies);直接回顶层评论的没有这个字段。
video_id
评论所在视频的 ID(comment_replies)。
shop_id
店铺 ID(shop_products),可以直接传给 shop_products 的 shop_id。
video_url
无水印视频文件地址(video_download,mp4)。不用 Cookie、不限 IP,到 expires_at 失效;图文作品没有。
video_backup_urls
同一个文件的备用地址(video_download),video_url 打不开时换用。
size_bytes
video_url 那个文件的大小,字节(video_download)。
hd_video_url
更清晰的一档(video_download),通常 1080p;没有比 video_url 更清晰的就没有这个字段。
hd_width
hd_video_url 的宽度,像素(video_download)。
hd_size_bytes
hd_video_url 的文件大小,字节(video_download)。
watermarked_video_url
带 TikTok 水印的下载地址(video_download);部分视频没有。
image_urls
图文(轮播)作品的每张图片地址(video_download);只有图文作品有。
expires_at
下载地址的失效时间(video_download,ISO,约在调用后 6 小时);过了要重新调用。
room_id
直播间 ID(live_room);没在播的没有这个字段。
viewer_count
调用那一刻的在线观众数(live_room)。
peak_viewer_count
本场直播的在线峰值(live_room)。
total_viewer_count
本场直播累计进入人次(live_room)。
stream_url
直播拉流地址(live_room,FLV,带签名、会过期);没在播、在别人直播间连麦时没有。
variant
买家买的规格(shop_product_reviews),如颜色、香型。
is_verified_purchase
是否确认购买后写的评价(shop_product_reviews)。
is_incentivized
是否带激励的评价(shop_product_reviews),如晒图返券。
trend
这段时间里每天的热度(trending_hashtags):[{date, value}],value 0–100,最热那天是 100。

当前目录另列出 duration_sec · author_bio · author_is_verified · author_following_count · author_like_count · author_video_count · next_page_token · is_original · width · height · started_at · product_id,这些字段尚无逐项释义;请先核对 TikTok 对应接口的用例与实际响应,不按字段名猜测类型或含义。

请求填写示例

这里使用视频主题词;视频文稿和作者资料的目标格式不同。

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

tiktok_search.sh
curl -X POST https://api.everyinfra.com/api/v1/social \
  -H "Authorization: Bearer $EVERYINFRA_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"platform":"tiktok","action":"search","params":{"keyword":"urban gardening"}}'

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

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

fields.preview.json
{
  "id": null,
  "url": null,
  "text": null,
  "author_name": null,
  "author_username": null,
  "like_count": null,
  "comment_count": null,
  "share_count": null,
  "view_count": null,
  "posted_at": null,
  "collect_count": null,
  "repost_count": null,
  "duration_sec": null,
  "duration_seconds": null,
  "cover_image_url": null,
  "language": null,
  "country": null,
  "hashtags": null,
  "music": null,
  "is_ad": null,
  "is_pinned": null,
  "is_sponsored": null,
  "is_slideshow": null,
  "has_shop_product": null,
  "author_id": null,
  "author_url": null,
  "author_avatar_url": null,
  "author_bio": null,
  "author_is_verified": null,
  "author_is_private": null,
  "author_is_seller": null,
  "author_follower_count": null,
  "author_following_count": null,
  "author_like_count": null,
  "author_video_count": null,
  "platform": null
}

常见用例

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

TikTok 话题搜索 API 如何按关键词找话题?

用 hashtag_search 按关键词找 TikTok 话题,带话题 ID、视频数和播放量。

查看 hashtag_search 的 keyword 参数
  • keyword 填词,如 fitness,开头的 # 会去掉;一页 20 个,next_page_token 原样传回取下一页。
  • video_count 是话题下的视频数,view_count 是累计播放量;要看话题下的视频,把 hashtag_name 传给 hashtag。

TikTok 音乐搜索 API 如何按歌名或歌手找声音?

用 music_search 在 TikTok 音乐库里按歌名、歌手搜声音,带使用人数和是否商用曲库。

查看 music_search 的 keyword 参数
  • keyword 填歌名或歌手,如 taylor swift;一页 20 首。
  • use_count 是用这首声音的视频数;is_original 表示用户原声,is_commercial 表示商用曲库里的音乐;id 可以传给 sound_videos。

TikTok 音乐榜 API 如何读 Top 50 和 Viral 50?

用 music_chart 一次读完整张 50 首的 TikTok 音乐榜,按名次排。

查看 music_chart 的 chart 参数
  • chart 填 top50(默认)或 viral50。
  • rank 是名次;use_count 是用这首声音的视频数;id 可以传给 sound_videos 看用了它的视频。

TikTok 账号搜索 API 如何按关键词找创作者?

用 user_search 按关键词搜 TikTok 账号,顺序同 TikTok 搜索,带粉丝数和 sec_uid。

查看 user_search 的 keyword 参数
  • keyword 填词,如 cooking;一页 20 个,next_page_token 原样传回取下一页。
  • username 是 @短名,sec_uid 是长期不变的账号标识;follower_count 是粉丝数,is_verified 表示认证账号。

TikTok 声音视频 API 如何找用了某首音乐的视频?

用 sound_videos 按声音 ID 列出用了这首音乐或原声的视频。

查看 sound_videos 的 music_id 参数
  • music_id 填 music_search、music_chart 结果里的 id,也可以填声音页链接;一页约 20 条。
  • 每条视频带文案、作者、发布时间、播放、点赞、评论、分享和收藏数;is_ad 表示广告视频。

TikTok 评论回复 API 如何读一条评论下的回复?

用 comment_replies 按视频链接和评论 ID 读这条评论下的全部回复。

查看 comment_replies 的 comment_id 参数
  • url 填视频链接,comment_id 填 comments 结果里那条顶层评论的 id;一页最多 20 条。
  • liked_by_author 表示视频作者点过赞;reply_to_reply_id 表示回的是哪条回复。

TikTok Shop 热销榜 API 如何读东南亚站热销商品?

用 shop_hot_products 读一个站的 TikTok Shop 热销榜,按名次排。

查看 shop_hot_products 的 country 参数
  • country 填 ID、JP、MX、MY(默认)、PH、SG、TH、VN;美国、英国、巴西站没有热销榜,扣费前就会被拒。
  • sold_count 是已售件数;shop_id 可以传给 shop_products 看这家店的全部商品。

TikTok Shop 类目商品 API 如何按类目列商品?

用 shop_category_products 按类目 ID 列 TikTok Shop 商品,带价格、销量和评分。

查看 shop_category_products 的 category_id 参数
  • category_id 填类目 ID,如 601450(美妆个护),一二三级类目都可以;country 选站,默认 US;一页约 15 个。
  • rating 是 5 分制评分,review_count 是评价数,shop_id 是店铺 ID。

TikTok 关注列表 API 如何看一个账号关注了谁?

用 following 列出一个 TikTok 账号关注的账号,带粉丝数和认证。

查看 following 的 username 参数
  • username 填 @短名,如 zachking,也可以填 sec_uid;一页 20 个。
  • 账号把关注列表设成不公开时返回空列表,不是出错。

TikTok 视频下载 API 如何拿无水印下载链接?

用 video_download 按视频链接拿无水印视频地址,带清晰度、文件大小和失效时间。

查看 video_download 的 url 参数
  • url 填视频链接或视频 ID,不收 vt.tiktok.com 短链。
  • video_url 到 expires_at(约调用后 6 小时)失效,过了要重新调用;图文作品没有视频地址,给 image_urls。

TikTok 直播间 API 如何看账号是否在直播?

用 live_room 看一个 TikTok 账号此刻是否在直播,在播时带在线人数、峰值、点赞和拉流地址。

查看 live_room 的 username 参数
  • username 填 @短名或主页链接。
  • 没在播时只返回一行,is_live 为 false;viewer_count 是调用那一刻的在线人数,stream_url 带签名、会过期。

TikTok 趋势话题 API 如何按国家和行业看热门话题?

用 trending_hashtags 读一个国家的 TikTok 趋势话题榜,可按行业和 7、30、90 天看。

查看 trending_hashtags 的 country 参数
  • country 默认 US,只有 27 个国家有榜,别的扣费前拒;time_window 填 7d、30d、90d;industry 选行业,如 beauty。
  • trend 是这段时间每天的热度,0–100,最热那天是 100;一页 20 个,整榜 100 个。

TikTok Shop 店铺商品 API 如何列一家店的全部商品?

用 shop_products 按店铺 ID 列出一家 TikTok Shop 店的商品,带价格、销量和评分。

查看 shop_products 的 shop_id 参数
  • shop_id 填商品行里的 shop_id 或店铺链接;country 填店铺所在站,默认 US;一页最多 30 个。
  • sold_count 是已售件数,rating 是 5 分制评分。

TikTok Shop 商品评价 API 如何读买家评价?

用 shop_product_reviews 按商品 ID 读 TikTok Shop 买家评价,可按星级筛。

查看 shop_product_reviews 的 product_id 参数
  • product_id 填商品 ID 或商品链接,如马来西亚站 1730991511457465439;country 填商品所在站。
  • rating 是星级;variant 是买的规格;author_name 是平台打过码的买家名字。

怎样按关键词发现 TikTok 视频,而不是商品或用户?

search 的 keyword 用于发现公开视频;先按视频对象整理内容与互动,再决定是否读取单视频详情。

查看 search 的 content_type 参数
  • 默认搜索视频,content_type=video 与当前视频字段匹配;目录也接受 profile、top,但当前结果仍按视频对象取字段,不能以此作为完整的账号搜索或综合搜索结果。它也不是 TikTok Shop 商品搜索。
  • author_username 是作者短名,author_name 是显示名称;view_count、like_count、comment_count、share_count 分别是播放、点赞、评论和分享量。sort 映射作者列表排序,不能当作已验证的视频搜索排序;min_likes 不代表最低作者粉丝数。

怎样用 TikTok 用户短名核对账号资料?

profile 用 username 定位账号,区分用户 ID、@短名、显示昵称和主页统计。

查看 profile 的 username 参数
  • username 可带 @,不要填抖音 secUid、显示昵称或完整个人主页 URL。返回 user_id 是另一种账号标识,display_name 是昵称;TikTok 改短名会改变主页链接,因此留存记录时应同时保留 user_id、username 与 url。
  • follower_count、following_count、video_count 分别是粉丝数、关注数和视频数,like_count 是账号侧累计指标,不等于某条视频点赞。资料来自可取得内容所关联的作者信息,没有可用作者信息可能为空;is_private 不是读取私密内容的权限,min_likes 等视频筛选也不是账号条件。

怎样读取一条 TikTok 视频的文案和互动快照?

video 接收具体 TikTok 视频 url,返回单个视频对象,适合从发现列表进入内容核对。

查看 video 的 url 参数
  • url 应为具体视频页面,不是个人主页、话题页或 TikTok Shop 商品链接。结果位于外层 results 单对象中;外层 id 是请求标识,results.id 才是视频标识。
  • text 是视频页面文案,不是语音转写;视频语音文稿应另用 transcript。当前字段不含媒体下载地址、时长或字幕,comment_count 只是计数;共享 content_type、sort、min_likes、until 不构成已验证的单视频筛选能力。

TikTok 评论 API 如何区分顶层评论、回复和作者互动?

comments 以视频 url 定位讨论,结合评论 ID、被回复 ID 和作者互动标记整理实际取得的评论。

查看 comments 的 url 参数
  • url 使用具体视频链接;reply_to_id 是被回复评论的标识,is_reply 仅表示存在回复指向,不是视频作者身份。reply_count 是回复数量,不保证等于本次取得的回复条数;每个顶层评论当前最多请求两条回复,不承诺完整对话树。
  • liked_by_author 与 pinned_by_author 分别是作者点赞和置顶标记,与普通 like_count 不同。目录里的 min_likes 不是已验证的评论点赞门槛,sort 也不能直接作为评论最新、最早或热门排序的保证。

怎样只查询 TikTok 粉丝数量而不误读成粉丝名单?

followers 用 username 读取账号粉丝数快照,适合对照账号规模,不返回关注该账号的个人列表。

查看 followers 的 username 参数
  • username 推荐填 @短名或不带 @ 的短名;可选 channel 是低优先级兼容输入,不能替代目录要求的 username。此处 id 与 username 来自账号短名,不应当作 profile.user_id 那样的稳定数字用户标识。
  • follower_count、following_count、post_count 与 like_count 是不同计数;precision 如有返回,只保留其精度标记,不自行发明级别或保证绝对精确。单次快照不提供新增粉丝、粉丝画像、名单、互动质量或历史增减趋势。

怎样读取 TikTok 文稿并保留字幕时间轴?

transcript 建议每次只传一个视频 url,读取可解析文稿的 text、segments 和 has_transcript。

查看 transcript 的 url 参数
  • results 是单个对象,results.id/url 才对应视频。虽有 urls 数组并会覆盖 url,当前多目标按数量计费但结果只保留第一条,没有逐视频 partial/missed;在兼容性修复返回前不要用它批量转写。
  • segments 中每段实际包含 start、end、text,时间是 WEBVTT 格式字符串,不是秒数;这些子字段尚未在目录单独列出。合并 text 是全文,不截断;has_transcript=false 表示未解析出文稿段落,不能推断视频没有语音;单对象或 HTTP 成功也不等于转写成功。

按 TikTok 作者整理视频

用账号短名读取 user_videos,比较作者的视频内容与互动。

查看 user_videos 的 username 参数
  • username 可带 @,不是抖音 secUid;结合 text、posted_at、view_count 与 share_count 整理结果。
  • 这是指定作者的视频列表,不是粉丝名单,也不是 TikTok Shop 商品目录。

TikTok 话题参与内容观察

按 hashtag 获取话题相关视频,整理参与者与内容方向。

查看 hashtag 的 hashtag 参数
  • hashtag 可带或不带 #,结合 author_username、text 与 posted_at 识别实际返回的视频。
  • 话题不等于全文关键词搜索;也不能据此计算全体参与者人数或完整活动覆盖。

TikTok Shop 商品选品调研

用 shop_search 搜索商品,区分商城地区和视频内容检索。

查看 shop_search 的 country 参数
  • keyword 是商品搜索词,country 是商城地区;结合 name、price、currency 与 shop_name 核对商品。
  • country 不是视频作者国籍筛选;价格缺币种时不要自行换算,也不把 sold_count 当作销售额。

TikTok Shop 带货达人初筛

按账号和商城地区查询带货达人资料,建立待核对的合作清单。

查看 shop_creator 的 username 参数
  • shop_creator 使用 username 与可选 country,结合 categories、product_count、sold_count 和 avg_views 查看返回指标。
  • 这些指标不是 GMV、佣金报价或成交保证;缺失值不代表零销量,统计周期也不能自行假定。

TikTok 教程与实战

先在本页核对 action、参数和字段,再按你的任务看下面的完整步骤或相关做法。文章里的示例和边界说明只作参考,以本页的参数和字段为准。

指南

TikTok 达人数据 API:用主页与视频样本完成有据可查的初筛

TikTok 达人数据 API:profile、user_videos 每次 $0.000556;分开账号与视频快照,写清互动率公式,处理缺失值和取样偏差。

阅读完整文章
Blog

创作者数据怎么做成投放前尽调:别用粉丝数代替受众证据

创作者数据产品不应输出说不清来由的真假分。本文讨论公开指标、授权分析、内容与品牌匹配、广告披露要求、小额测试和投后反馈如何组成有据可查的达人尽调。

阅读完整文章
指南

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

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

阅读完整文章

TikTok API 常见问题

TikTok API 怎么调用?

调用 POST /api/v1/social,请求体传 platform="tiktok"、action 和 params。以 search 为例,必填 keyword,可选 content_type。这里使用视频主题词;视频文稿和作者资料的目标格式不同。 TikTok 共 24 个 action,鉴权用 Authorization: Bearer <API Key>,同一把 Key 通 106 个平台。

TikTok API 怎么收费?

每千次 $0.56 起,按能力不同(清单里逐条标了)。按本页最高能力单价、每次单目标估算,$1 免费额度约可用于 1,240 次 TikTok 调用。费用按所选能力与目标数量计算,多目标请求不要按单目标估算;参数错误、鉴权失败和空结果不计费。

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

TikTok 有 17 个列表接口,包括 search、user_videos、comments、hashtag、shop_search、hashtag_search、music_search、music_chart、user_search、sound_videos、comment_replies、shop_hot_products、shop_category_products、following、shop_products、shop_product_reviews、trending_hashtags。其余 7 个接口返回单个对象;对象内仍可能包含数组。数量参数要逐接口区分目标数、页数和记录数,不能将目录数值直接当作保证返回的条数;具体限制见对应参数与用例,不保证完整历史。

TikTok API 返回哪些字段?

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

TikTok 话题搜索 API 如何按关键词找话题?

用 hashtag_search 按关键词找 TikTok 话题,带话题 ID、视频数和播放量。 keyword 填词,如 fitness,开头的 # 会去掉;一页 20 个,next_page_token 原样传回取下一页。 video_count 是话题下的视频数,view_count 是累计播放量;要看话题下的视频,把 hashtag_name 传给 hashtag。

TikTok 音乐搜索 API 如何按歌名或歌手找声音?

用 music_search 在 TikTok 音乐库里按歌名、歌手搜声音,带使用人数和是否商用曲库。 keyword 填歌名或歌手,如 taylor swift;一页 20 首。 use_count 是用这首声音的视频数;is_original 表示用户原声,is_commercial 表示商用曲库里的音乐;id 可以传给 sound_videos。

TikTok 音乐榜 API 如何读 Top 50 和 Viral 50?

用 music_chart 一次读完整张 50 首的 TikTok 音乐榜,按名次排。 chart 填 top50(默认)或 viral50。 rank 是名次;use_count 是用这首声音的视频数;id 可以传给 sound_videos 看用了它的视频。

TikTok 账号搜索 API 如何按关键词找创作者?

用 user_search 按关键词搜 TikTok 账号,顺序同 TikTok 搜索,带粉丝数和 sec_uid。 keyword 填词,如 cooking;一页 20 个,next_page_token 原样传回取下一页。 username 是 @短名,sec_uid 是长期不变的账号标识;follower_count 是粉丝数,is_verified 表示认证账号。

可以先免费试用 TikTok API 吗?

可以。注册免费,在 GitHub 给 everyinfra/everyinfra-agent-plugins 和 everyinfra/seo-skills 两个仓库都点星,就能在控制台「余额与充值」领取 $1 额度(≈720 次数据调用),直接进赠送余额,不用输码,24 小⁠时内有效。请先选择 TikTok 的目标接口,用单目标请求核对结果;实际可调用次数取决于能力价格与目标数量,不保证覆盖全部 24 个能力。无需信用卡。

开始调用 TikTok API

在 GitHub 给两个仓库点星领 $1 额度,注册后在控制台领取,24 小⁠时内有效,先选一个 TikTok 接口验证结果。

免费开始

自有访问统计常开;Google Analytics 仅在你点「同意分析」后启用。 隐私政策