tiktok/
hashtag-detail

一次请求最多查询 20 个 TikTok 话题的视频总数和总播放量,同时返回话题 ID 和话题页链接,方便并排比较。

TikTok Hashtag Views API

最多 20 个话题
话题总播放量
话题视频数
每条结果 0.5 积分
等待提交
等待提交

填写参数并发送请求,任务状态和标准化结果会显示在这里。

README

由 SocQ 维护 · 更新于

TikTok Hashtag Views

TikTok 的每个话题页都会把所有使用该标签的公开视频汇总成两个累计数字:用过这个话题的视频有多少条,这些视频一共被播放了多少次。把两个数字放在一起看,就能判断一个话题有多大、有多拥挤,再用总播放量除以视频数,还能大致看出这个话题下的内容平均能跑出多少播放。

TikTok Hashtag Views API 主要特性

  • 一次最多查 20 个话题传入 1 到 20 个话题名称,带不带 # 都可以,每个存在的话题返回一条记录。
  • 整数形式的累计数据metrics.posts_count 和 metrics.views_count 返回的是完整整数而不是带单位的缩写字符串,可以直接排序和相除。
  • 话题 ID 和话题页链接id 是 TikTok 的数字话题 ID,url 是话题页地址,可以作为跨批次对齐记录的主键。

TikTok Hashtag Views API 参数

参数必填描述
hashtags必填1 到 20 个话题名称,可带或不带 # 前缀。

如何使用 TikTok Hashtag Views API

发送一组话题,每个话题读到一条记录。

  1. 向 /v1/tiktok/hashtag-detail 发送 {"hashtags": ["cooking", "booktok"]}。
  2. 轮询 GET /v1/tasks/{task_id},直到 status 变成 succeeded。
  3. 从 results.items 读取每个话题的 name、metrics.posts_count 和 metrics.views_count。
curl -X POST "https://api.socq.ai/v1/tiktok/hashtag-detail" \
  -H "Authorization: Bearer $SOCQ_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"hashtags":["cooking","booktok"]}'

# metrics.posts_count 是视频数,metrics.views_count 是总播放量。

TikTok Hashtag Views API 最佳使用场景

  • 筛选活动话题: 把备选话题放进同一个请求,用 posts_count 看拥挤程度,用 views_count 看覆盖量,再决定最终用哪几个。
  • 品牌话题监测: 定时查询自家活动话题,把视频数和总播放量画成曲线,看每次投放之后涨了多少。
  • 话题体量调研: 查询能代表某个细分领域、某个热点或某个公共议题的一组话题,对比它们的累计数据,看相关内容主要集中在哪里。

TikTok Hashtag Views API 使用建议

  • 不要把多个话题的 views_count 加起来当作某个主题的总量,一条视频带了几个标签就会在每个标签下各算一次;并排比较,或者取最大的那个。
  • 只有 posts_count 存在且大于 0 时才用 views_count 除以它,得到的单条视频平均播放量更适合比较体量差距很大的话题。
  • 追踪某个话题时,每次结果都和 collected_at 一起存下来;每次请求返回的都是当前累计值,只有留住历史快照才看得出增长。
  • 按 name 或 id 把结果对应回输入列表,不要按位置对应,因为不存在的话题会被跳过,结果条数可能比输入少。

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

探索其他平台

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

TikTok Hashtag Views API — 常见问题

TikTok Hashtag Views API 是一个用于按名称批量查询最多 20 个 TikTok 话题累计数据的 API。它返回每个话题的 ID、话题页链接、视频总数和总播放量。

传入话题名称,从 metrics.views_count 读总播放量,从 metrics.posts_count 读使用该话题的视频数。两个数字都是整个话题的累计值。

每个话题的结果里 metrics.views_count 和 metrics.posts_count 并列返回;如果 TikTok 没有给出某个话题的某项数字,对应字段为 null。

最多 20 个,带不带 # 都行。每个存在的话题返回一条记录,一份备选清单可以在同一个结果里直接对比。

它会被排除在结果之外,也不收费,同一请求里的其他话题照常返回。如果所有话题都不存在,这次请求不产生费用。

接口只返回当前的累计值和 collected_at 时间,不提供历史。按固定频率运行并自己保存每次快照,就能画出增长曲线。

不能,这里只返回话题的累计数据和标识。要采集话题下的视频,请使用 TikTok Hashtags。

按存在的话题数量计费,每个 0.5 积分。一次查 20 个存在的话题是 10 积分,没有任何匹配的请求不扣费。