tiktok-creative-center/
top-videos

获取 TikTok 创意中心某个国家的热门视频榜,可按播放量、互动率或 6 秒完播率排序,返回自然播放量、累计播放量和创作者市场 ID。

TikTok Creative Center Top Videos API

分国家榜单
日榜、周榜或长期榜
播放量和互动率
每条结果 0.5 积分
等待提交
等待提交

填写参数并发送请求,任务状态和标准化结果会显示在这里。

README

由 SocQ 维护 · 更新于

TikTok Creative Center Top Videos

创意中心的热门视频榜是 TikTok 发布的各国表现最好的视频榜单,可按播放量、互动率或 6 秒完播率排序,每条显示文案、创作者、榜单周期内播放量、累计播放量和自然播放量。从榜单能看出一个市场里哪些视频在赢得关注、其中多少来自自然流量,以及哪些创作者反复上榜。

TikTok Creative Center Top Videos API 主要特性

  • 日榜、周榜和长期榜period 选择读取某个国家的哪一份榜单,系统自动取最新发布的一期。
  • 三种排序指标sort_by 按 views、engagement_rate 或 six_second_view_rate 给榜单排序。
  • 播放量三种口径metrics 区分榜单周期内播放量 views_count、自然播放量 organic_views_count 和累计播放量 lifetime_views_count,另有两个比率。
  • 视频和创作者标识每条记录带文案、url、cover_url 和 author,以及 creator_id——TikTok Creator Marketplace 接受的创作者市场 ID。

TikTok Creative Center Top Videos API 参数

参数必填描述
country可选市场的两位国家代码,例如 US、GB 或 JP,默认 US。
period可选要读取的榜单:daily(默认)、weekly 或 long_term。
sort_by可选排名指标:views(默认)、engagement_rate 或 six_second_view_rate。
results_limit可选返回的视频数量,取值 1 到 100,默认 20。

如何使用 TikTok Creative Center Top Videos API

选好国家、周期和排名指标,读取榜单。

  1. 向 /v1/tiktok-creative-center/top-videos 发送 {"country": "US", "period": "daily", "results_limit": 20}。
  2. 轮询 GET /v1/tasks/{task_id},直到 status 变成 succeeded。
  3. 从 results.items 按名次读取视频;has_more 为 true 时,带上 results.next_cursor 继续读取。
curl -X POST "https://api.socq.ai/v1/tiktok-creative-center/top-videos" \
  -H "Authorization: Bearer $SOCQ_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"country":"US","period":"daily","sort_by":"views","results_limit":20}'

# 每条结果的 creator_id 可用于 TikTok Creator Marketplace。

TikTok Creative Center Top Videos API 最佳使用场景

  • 开头钩子对标: 把某国榜单按 six_second_view_rate 排序,查看靠前视频的文案和封面,归纳出能让观众看过 6 秒的开头。
  • 区分自然流量和付费流量: 用 organic_views_count 除以 views_count,把靠自然流量增长的视频和主要靠付费投放撑起来的视频分开。
  • 分市场每周快照: 每周保存各国的周榜,按视频 id 比对,看哪些视频和创作者反复上榜、哪些内容形式在轮换。
  • 创作者候选名单: 从榜单记录里收集 creator_id,去重后交给 Creator Marketplace 查看受众画像和报价。

TikTok Creative Center Top Videos API 使用建议

  • engagement_rate 和 six_second_view_rate 都是 0 到 1 的小数,0.0265 表示 2.65%,不是 2.65。
  • rank 是所选 sort_by 下的名次,只有 country、period 和 sort_by 都相同的两次结果之间才能比较名次。
  • 同一个创作者可能占好几行,传给 Creator Marketplace 之前先对 creator_id 去重;它一次最多接受 20 个 ID。

除了 TikTok Creative Center Top Videos API,需要其他类型的 TikTok Creative Center 公开数据时,可以使用以下 API。

探索其他平台

还可以将 TikTok Creative Center 数据与其他已支持社交平台的公开数据结合使用。

TikTok Creative Center Top Videos API — 常见问题

TikTok Creative Center Top Videos API 是一个用于按国家、周期和排序指标获取 TikTok 创意中心热门视频榜的 API。它返回每条视频的名次、文案、创作者、榜单周期内播放量、自然播放量、累计播放量、互动率和 6 秒完播率。

views 按榜单周期内的触达量排序;engagement_rate 按互动数除以播放量排序,偏向容易引发互动的视频;six_second_view_rate 按观看满 6 秒的播放占比排序,更容易找出开头抓人的视频。

取的是最新发布的一期,通常比当前日期晚两天左右。周榜的截止日是周日。

两种触达都算在内。views_count 是榜单周期内的全部播放,organic_views_count 是其中来自非付费分发的部分,后者远小于前者,说明这条视频主要靠投放推起来。

author.id 是创作者的 TikTok 用户 ID。creator_id 是他的创作者市场 ID,也是 TikTok Creator Marketplace 接受的值。

views_count 只统计榜单周期内的播放,几个月前发布的视频只要还有人在看,就能上榜。lifetime_views_count 是它发布以来的累计播放。

不是每个市场的每种周期都有榜单。任务仍然成功,返回 0 条且不扣积分,可以放心换个周期或国家再试;有榜单时每条视频 0.5 积分。