TikTok Search API

TikTok Search

主要特性

• 关键词视频发现把主题、品牌、产品或事件关键词转换成候选视频集合。
• 相关性与时效排序用 relevance、date 和 likes 切换相关内容、近期内容与高赞内容视角。
• 发布时间范围通过 day、week、month、three_months 和 six_months 控制研究时间范围。
• 内容与创作者字段通过一致的搜索结果结构返回视频、作者、互动、标签和音乐字段。
• 可追溯的搜索快照以 search_query 和 collected_at 记录每次搜索实验的条件与时点。

参数

如何使用

先写清研究问题，再选择关键词、排序目标和发布时间窗口。

1. 把研究主题整理成具体 query，并选择对应的 sort_by、published_within 和 results_limit。
2. 把请求 POST 到 /v1/tiktok/search，并保存返回的 task_id。
3. 轮询 /v1/tasks/{task_id}，直到任务进入 succeeded 或 failed 状态。
4. 从 data.results.items 读取视频；如果 has_more 为 true，则继续传入 next_cursor。

curl -X POST "https://api.socq.ai/v1/tiktok/search" \
  -H "Authorization: Bearer $SOCQ_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"query":"space exploration","results_limit":100,"sort_by":"relevance","published_within":"month"}'

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

最佳使用场景

• 市场与品类扫描： 用产品、品类和消费场景词快速建立 TikTok 内容版图与创作者样本。
• 事件热度追踪： 组合 date 与 day 或 week 窗口，观察事件、发布会或话题的近期内容变化。
• 高赞创意研究： 按 likes 排序收集高点赞视频，分析常见开场、文案、音乐和标签组合。
• 品牌提及观察： 定期运行品牌词与产品词查询，保存搜索快照供内容与传播团队复盘。

使用建议

• 把一个宽泛主题拆成品牌词、需求词、场景词和趋势词，分别运行查询后合并结果。
• 探索主题时选择 relevance，追踪新内容时选择 date，拆解热门创意时选择 likes。
• 用 published_within 保持研究样本处在相同时间尺度，例如周报统一使用 week。
• 把 query、sort_by、published_within 和 collected_at 一起保存，让搜索过程可复现。
• 按视频 id 合并多组关键词结果，并记录每条视频命中的 search_query。
• 定期重复核心查询，对比创作者、内容主题和互动表现的变化。

相关 API