tiktok-creative-center/
trending-hashtags

获取 TikTok 创意中心某个国家的热门话题标签榜单,返回名次、视频数、播放量,以及 7、30 或 90 天的每日热度曲线。

TikTok Creative Center Trending Hashtags API

分国家排名
7、30 或 90 天
每日热度曲线
每条结果 0.5 积分
等待提交
README

由 SocQ 维护 · 更新于

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

选好国家和时间窗口,读取榜单。

  1. 向 /v1/tiktok-creative-center/trending-hashtags 发送 {"country": "US", "time_range": "7d", "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/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 反复请求;每次请求都按实际返回的条数计费。

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

探索其他平台

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

TikTok Creative Center Trending Hashtags API — 常见问题

TikTok Creative Center Trending Hashtags API 是一个用于获取某个国家 TikTok 创意中心 7、30 或 90 天热门话题标签榜单的 API。它返回每个话题的名次、视频数、播放量和每日热度曲线。

country 填两位国家代码,如 US、GB、JP,默认 US,每个市场有自己的榜单。创意中心没有发布榜单的市场会返回 0 条结果,也不扣积分。

想看眼下正在上升的话题用 7d,想找几个月里一直有热度的话题用 90d。每个窗口都是独立的榜单,同一个话题在不同窗口里的名次可能不一样。

每个国家和窗口最多 100 个,用 results_limit 控制,默认 20。按实际返回的条数计费,每条 0.5 积分,取满 100 条是 50 积分。

看 popularity_curve 的尾部,数值每天一个,范围 0 到 100。最后一天仍在上升说明还在涨,从前面的高点回落说明正在降温,和它的名次高低无关。

不能,请求只有 country、time_range 和 results_limit 三个参数。想找新上榜的话题,每天保存榜单,与前一天比对话题 id 即可。

TikTok 没有公布刷新时间表。热度曲线按天推进,每条记录都带 collected_at,每个国家每天请求一次就足以跟上变化。

不需要,只要有 SocQ API key 就行。