TikTok Creative Center Trending Hashtags
创意中心的热门话题榜,对某个国家最近 7、30 或 90 天关注度增长最快的话题进行排名,每个话题都有名次、视频数、播放量和逐日的热度曲线。这份榜单能看出一个市场里哪些话题正在起势、每个话题涨得有多猛,以及哪些趋势值得趁上升期参与。
TikTok Creative Center Trending Hashtags API 主要特性
- 一个国家一份榜单country 填 US、GB、JP 这样的两位代码,每个市场单独排名。
- 7、30、90 天三种榜单time_range 选择榜单统计的时间窗口,每个窗口都是独立的一份榜单。
- 视频数和播放量metrics.posts_count 和 metrics.views_count 是创意中心给出的每个话题的体量数据。
- 每日热度曲线popularity_curve 每天一个带日期的 0 到 100 数值,名次和走势随榜单一次拿到。
- 名称、链接和 ID每条记录带不含 # 的 name、tiktok.com/tag 链接,以及可作为 hashtag_id 交给 Hashtag Insights 的 id。
TikTok Creative Center Trending Hashtags API 参数
| 参数 | 必填 | 描述 |
|---|---|---|
country | 可选 | 市场的两位国家代码,例如 US、GB 或 JP,默认 US。 |
time_range | 可选 | 榜单覆盖的时间段:7d(默认)、30d 或 90d。 |
results_limit | 可选 | 返回的话题数量,取值 1 到 100,默认 20。 |
如何使用 TikTok Creative Center Trending Hashtags API
选好国家和时间窗口,读取榜单。
- 向 /v1/tiktok-creative-center/trending-hashtags 发送 {"country": "US", "time_range": "7d", "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/trending-hashtags" \
-H "Authorization: Bearer $SOCQ_API_KEY" \
-H "Content-Type: application/json" \
-d '{"country":"US","time_range":"7d","results_limit":20}'
# 每条结果包含 rank、metrics 和带日期的 popularity_curve。TikTok Creative Center Trending Hashtags API 最佳使用场景
- 每日新上榜监测: 每天保存一份榜单和 collected_at,与前一天的快照比对话题 id,看哪些话题新上榜、哪些掉出了榜单。
- 分市场话题清单: 对每个目标国家用相同的 time_range 各取一份榜单,并排比较后为每个市场的本地化活动挑选话题。
- 区分一周爆发和长期有热度: 对同一个国家比较 7d 和 90d 榜单:只出现在短榜里的是一周内的爆发,在两份榜单里都靠前的话题已经持续了几个月。
TikTok Creative Center Trending Hashtags API 使用建议
- 每份快照都连同 country、time_range 和 collected_at 一起保存;名次只在它所属的那份榜单里才有意义。
- 把话题 id 交给 Hashtag Insights 时,沿用取榜单时的 country 和 time_range。
- 需要完整榜单时一次取满 100 条,在本地筛选,不要用不同的 results_limit 反复请求;每次请求都按实际返回的条数计费。
相关 API
除了 TikTok Creative Center Trending Hashtags API,需要其他类型的 TikTok Creative Center 公开数据时,可以使用以下 API。
- TikTok Creative Center Top Ads API — 按关键词和时间范围浏览热门广告,返回文案、点击率、点赞数和广告视频。
- TikTok Creative Center Ad Analysis API — 按秒拆解一条热门广告的点击曲线和留存曲线。
- TikTok Creative Center Hashtag Insights API — 深入查看单个趋势话题的热度曲线、热门地区和示例视频。
- TikTok Creative Center Top Videos API — 获取某个国家或地区的热门视频榜,包含播放量和互动率。
- TikTok Creator Marketplace API — 获取创作者市场资料卡,包含粉丝画像、播放中位数和起步报价。