tiktok-creative-center/
trending-hashtag-detail

用 TikTok 创意中心的话题 ID 查询单个热门话题,返回视频数和播放量、每日热度曲线、按得分排序的热门国家,以及示例视频 ID。

TikTok Creative Center Hashtag Insights API

话题 ID 输入
热门国家
示例视频
每次请求 0.5 积分
等待提交
README

由 SocQ 维护 · 更新于

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,读取它的洞察。

  1. 用 TikTok Creative Center Trending Hashtags 采集话题,复制其中一个的 id。
  2. 向 /v1/tiktok-creative-center/trending-hashtag-detail 发送 {"hashtag_id": "7155204034885287979", "country": "US", "time_range": "7d"}。
  3. 轮询 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 是相对国家规模的热度,小市场可能排在大市场前面。

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

探索其他平台

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

TikTok Creative Center Hashtag Insights API — 常见问题

TikTok Creative Center Hashtag Insights API 是一个用于通过创意中心话题 ID、国家和时间范围查询单个热门 TikTok 话题详情的 API。它返回视频数和播放量、每日热度曲线、按得分排序的热门国家和示例视频 ID。

取自 Trending Hashtags 结果里的 id 字段,并使用你要查询的那个国家的榜单。它是 5 到 32 位的数字字符串,其他格式会被以 400 错误拒绝。

这里不行,只接受数字 ID。想按名称查某个话题的视频数和总播放量,可以用 TikTok Hashtag Views API。

多了 top_countries 和 video_ids,这两项在榜单记录里是 null。这里的 rank 也是 null,名次属于榜单,请保留 Trending Hashtags 结果里的 rank。

它衡量话题在该国的热度相对于该国规模的高低,列表按得分从高到低排序,所以小市场可能排在大市场前面。

任务会失败并全额退款。请求成功时只计一次 0.5 积分,与返回多少个 video_ids 无关。