TikTok Shop Search API

TikTok Shop Search

主要特性

• 关键词与市场控制将商品查询词与 16 个受支持地区之一配对，搜索目标公开市场目录。
• 限量去重采集可请求 20 至 2,000 条结果，并在逐页采集时按公开商品身份去重。
• 商品与卖家身份返回商品 ID、标题、说明、规范链接以及来源公开时的卖家或店铺信息。
• 价格与可见商业指标保留公开的售价、原价、币种、折扣、评分、评价数和已售数量。
• 媒体与商品上下文为每条记录保留公开图片、分类、SKU 结构、状态、搜索词、地区和采集时间。

参数

如何使用

选择具体商品短语和目标市场，再提交一次异步搜索请求。

1. 填写非空 query，选择受支持的 region，并把 results_limit 设为 20 至 2,000。
2. 把请求 POST 到 /v1/tiktok-shop/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-shop/search" \
  -H "Authorization: Bearer $SOCQ_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"query":"running shoes","results_limit":100,"region":"US"}'

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

最佳使用场景

• 区域商品发现： 在选定市场中查找与品类、需求、品牌或商品短语匹配的公开商品。
• 价格与折扣比较： 在返回商品之间比较可用的售价、原价、币种和折扣字段。
• 口碑与销量比较： 比较公开评分、评价数和已售数量，不把缺失指标转换为零。
• 商品及店铺候选筛选： 结合商品链接、卖家身份、图片、分类和 SKU 上下文筛选需要深入检查的候选。

使用建议

• 始终一起保存 query 与 region，因为同一短语在不同公开市场中可能得到不同目录。
• 按所需规模设置 results_limit，并持续读取 next_cursor，直到 has_more 为 false。
• 把缺失的价格、评分、评价数或已售数量视为不可用，而不是零。
• 为每条记录保留 search_query 与 collected_at，让区域快照可以复现。
• 需要最新详情级补全时，把选中的 PDP URL 传给 TikTok Shop Product API。

相关 API