TikTok Hashtags API

TikTok Hashtags

主要特性

• 并行标签采集并行提交多个活动、品牌或社群 hashtag。
• 标准化标签输入自动统一 #campaign 与 campaign 两种标签写法。
• 单标签结果上限按标签分别应用 results_limit，清晰规划各组内容样本。
• 匹配标签来源通过 matched_hashtag 保留视频与输入标签之间的归属关系。
• 可比较的视频记录在同一结构中比较标签播放量、创作者、内容元素与视频互动。

参数

如何使用

列出要追踪的标签，为每个标签设定视频样本量，然后建立可分组的内容集合。

1. 整理活动、品牌或社群标签，统一 space 与 #space 的写法并去重。
2. 把 hashtags 和 results_limit POST 到 /v1/tiktok/hashtags，并保存返回的 task_id。
3. 轮询 /v1/tasks/{task_id}，直到任务成功或失败。
4. 从 data.results.items 读取视频；如果 has_more 为 true，则继续传入 next_cursor。

curl -X POST "https://api.socq.ai/v1/tiktok/hashtags" \
  -H "Authorization: Bearer $SOCQ_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"hashtags":["space","#astronomy"],"results_limit":100}'

# 轮询 GET /v1/tasks/{task_id}
# 读取 data.results.items，并在 has_more 为 true 时继续传入 next_cursor

最佳使用场景

• UGC 活动追踪： 按官方活动标签收集参与视频，观察创作者覆盖、内容方向与互动分布。
• 品牌标签资产盘点： 把品牌和产品标签下的视频整理成可检索内容库，支持市场与社媒团队复盘。
• 兴趣社群画像： 通过创作者、文案、音乐和互动特征理解特定兴趣标签下的内容文化。
• 标签组合对比： 并行采集多个标签，比较各组视频数量、创作者构成、创意元素和表现差异。

使用建议

• 先去掉 #、统一大小写并去重，让每个标签拥有清晰的样本组。
• 用标签数量乘以 results_limit 估算请求上限，不要把它当作保证返回的总数。
• 始终保留 matched_hashtag，视频同时命中多组采集时也能追踪各自来源。
• 比较标签时使用一致的 results_limit 和采集时点，减少样本条件差异。
• 把标签播放量和单条视频的互动指标视为两组独立的时间点数据。
• 用 Profiles 补全高频创作者资料，进一步分析每个标签吸引的创作者类型。

相关 API