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
发送一组话题,每个话题读到一条记录。
- 向 /v1/tiktok/hashtag-detail 发送 {"hashtags": ["cooking", "booktok"]}。
- 轮询 GET /v1/tasks/{task_id},直到 status 变成 succeeded。
- 从 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 把结果对应回输入列表,不要按位置对应,因为不存在的话题会被跳过,结果条数可能比输入少。
相关 API
除了 TikTok Hashtag Views API,需要其他类型的 TikTok 公开数据时,可以使用以下 API。
- TikTok Hashtags API — 按指定标签采集公开视频、创作者、媒体、声音和互动指标。
- TikTok Search API — 按关键词搜索公开视频,并支持排序和发布时间筛选。
- TikTok Live Room Info API — 使用配对的直播间 ID 和主播 ID 查询一个已知直播间,返回状态、主播信息、封面和受众计数。
- TikTok Search Users API — 按关键词搜索 TikTok 公开账号。
- TikTok Top Search API — 按关键词查找视频和图片帖子,获取文案、创作者和互动计数。
- TikTok Trending Searches API — 按排名获取 TikTok 当天的热搜词。
- TikTok Profiles API
- TikTok Comments API
- TikTok Videos API
- TikTok Comment Replies API
- TikTok Followers List API
- TikTok Following List API
- TikTok User Videos API
- TikTok Trending Feed API
- TikTok Video Transcript API
- TikTok Song API
- TikTok Song Videos API
- TikTok Popular Songs API
- TikTok User Live API
- TikTok Audience Demographics API
- TikTok Similar Accounts API
- TikTok Reposts API
- TikTok Playlists API
- TikTok Sound Search API
- TikTok Live Search API
- TikTok Photo Search API
- TikTok Creator Search Insights API
- TikTok Live Ranking API
- TikTok Live Shopping API
- TikTok Fake Views Checker API
- TikTok Comment Keywords API