TikTok Hashtags
TikTok Hashtags 是围绕共享短语、活动、事件或兴趣连接公开视频的主题标签，并带有创作者、内容、媒体、声音和互动信号。这些记录可用于趋势发现、主题监测、活动研究和受众分析。
主要特性
- 并行标签采集并行提交多个活动、品牌或社群 hashtag。
- 标准化标签输入自动统一 #campaign 与 campaign 两种标签写法。
- 单标签结果上限按标签分别应用 results_limit，清晰规划各组内容样本。
- 匹配标签来源通过 matched_hashtag 保留视频与输入标签之间的归属关系。
- 可比较的视频记录在同一结构中比较标签播放量、创作者、内容元素与视频互动。
参数
| 参数 | 必填 | 描述 |
|---|---|---|
hashtags | 必填 | 必填的 hashtag 列表，每个值都支持省略开头的 #。 |
results_limit | 可选 | 每个 hashtag 请求的视频上限，必须为正整数，默认值为 100。 |
如何使用
列出要追踪的标签，为每个标签设定视频样本量，然后建立可分组的内容集合。
- 整理活动、品牌或社群标签，统一 space 与 #space 的写法并去重。
- 把 hashtags 和 results_limit POST 到 /v1/tiktok/hashtags，并保存返回的 task_id。
- 轮询 /v1/tasks/{task_id}，直到任务成功或失败。
- 从 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
需要其他类型的 TikTok 公开数据时，可以使用以下 API。
- TikTok Profiles API — 按 username 获取公开主页身份、简介、账号标记和受众计数。
- TikTok Comments API — 采集公开顶级评论、作者、互动、提及和创作者互动标记。
- TikTok Videos API — 从视频 URL 获取创作者、文案、媒体、音乐、标签、提及和互动信息。
- TikTok Search API — 按关键词搜索公开视频，并支持排序和发布时间筛选。
- TikTok Comment Replies API — 使用 TikTok 视频 URL 和 comment_id 采集一条已知评论下的公开回复，返回作者、互动、时间和父评论上下文。
- TikTok Followers List API — 采集公开粉丝列表中可见的标准化资料，并保留来源上下文和支持的指标。
- TikTok Following List API — 采集 TikTok 账号公开可见的关注对象，返回标准化身份、简介、可见指标和来源账号信息。
- TikTok User Videos API — 按 username 采集公开个人资料视频，返回文案、创作者、媒体、时间、互动和来源账号上下文。
- TikTok Live Room Info API — 使用配对的直播间 ID 和主播 ID 查询一个已知直播间，返回状态、主播信息、封面和受众计数。
- TikTok Trending Feed API — 按 region 采集当前公开视频动态，返回创作者、文案、封面、时间和可见互动指标。
- TikTok Video Transcript API — 从公开视频 URL 提取可用字幕文本、语言、格式和来源上下文。