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
选好国家、周期和排名指标,读取榜单。
- 向 /v1/tiktok-creative-center/top-videos 发送 {"country": "US", "period": "daily", "results_limit": 20}。
- 轮询 GET /v1/tasks/{task_id},直到 status 变成 succeeded。
- 从 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。
相关 API
除了 TikTok Creative Center Top Videos API,需要其他类型的 TikTok Creative Center 公开数据时,可以使用以下 API。
- TikTok Creative Center Top Ads API — 按关键词和时间范围浏览热门广告,返回文案、点击率、点赞数和广告视频。
- TikTok Creative Center Ad Analysis API — 按秒拆解一条热门广告的点击曲线和留存曲线。
- TikTok Creative Center Trending Hashtags API — 获取某个国家或地区的趋势话题榜,包含发帖数、播放量和热度曲线。
- TikTok Creative Center Hashtag Insights API — 深入查看单个趋势话题的热度曲线、热门地区和示例视频。
- TikTok Creator Marketplace API — 获取创作者市场资料卡,包含粉丝画像、播放中位数和起步报价。