TikTok Creative Center Hashtag Insights
创意中心的话题洞察把单个热门话题在一个市场里的样子摊开:视频数和播放量、逐日热度曲线、按市场规模折算后热度最高的国家,以及使用这个话题的示例视频。有了这些,就能判断趋势走势如何、还在哪些市场有共鸣、又是靠什么内容撑起来的。
TikTok Creative Center Hashtag Insights API 主要特性
- 按 ID 查单个话题hashtag_id 填热门话题榜结果里的 id,返回该话题在所选 country 和 time_range 下的一条记录。
- 时间窗口内的曲线和体量popularity_curve 每天一个 0 到 100 的带日期数值,旁边是 metrics.posts_count 和 metrics.views_count。
- 按得分排序的国家top_countries 列出 country_code 和 score,从高到低排列,score 是按国家规模折算的热度。
- 示例视频 IDvideo_ids 列出使用该话题的视频,可以看出这个趋势靠什么内容撑起来。
TikTok Creative Center Hashtag Insights API 参数
| 参数 | 必填 | 描述 |
|---|---|---|
hashtag_id | 必填 | 取自 TikTok Creative Center Trending Hashtags 结果的话题 ID。 |
country | 可选 | 市场的两位国家代码,例如 US、GB 或 JP,默认 US。 |
time_range | 可选 | 分析的时间段:7d(默认)、30d 或 90d。 |
如何使用 TikTok Creative Center Hashtag Insights API
从热门话题榜拿到话题 ID,读取它的洞察。
- 用 TikTok Creative Center Trending Hashtags 采集话题,复制其中一个的 id。
- 向 /v1/tiktok-creative-center/trending-hashtag-detail 发送 {"hashtag_id": "7155204034885287979", "country": "US", "time_range": "7d"}。
- 轮询 GET /v1/tasks/{task_id},直到 status 变成 succeeded,读取 results.items 中的那条记录。
curl -X POST "https://api.socq.ai/v1/tiktok-creative-center/trending-hashtag-detail" \
-H "Authorization: Bearer $SOCQ_API_KEY" \
-H "Content-Type: application/json" \
-d '{"hashtag_id":"7155204034885287979","country":"US","time_range":"7d"}'
# top_countries 是 {country_code, score} 列表;video_ids 是示例视频。TikTok Creative Center Hashtag Insights API 最佳使用场景
- 参与趋势前的判断: 决定把活动押在某个话题上之前,先看 popularity_curve 和 metrics 里的数据,确认曲线在最后一天是否仍在上升。
- 筛选出海目标市场: 用 top_countries 看本国正在热门的话题在哪些其他国家得分最高,列入本地化内容的候选名单。
TikTok Creative Center Hashtag Insights API 使用建议
- country 和 time_range 要与取 id 的那份榜单一致,这样看到的数据对应的是你选中这个话题时的那份榜单。
- 不要把 top_countries 当作按体量排序的榜单:score 是相对国家规模的热度,小市场可能排在大市场前面。
相关 API
除了 TikTok Creative Center Hashtag Insights 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 Top Videos API — 获取某个国家或地区的热门视频榜,包含播放量和互动率。
- TikTok Creator Marketplace API — 获取创作者市场资料卡,包含粉丝画像、播放中位数和起步报价。