tiktok-shop/
search-suggestions

输入购物搜索词的开头并选择市场,获取 TikTok Shop 给出的搜索联想,返回最多 20 个从 1 开始排名的关键词,以及对应的 query 和 region。

TikTok Shop Search Suggestions API

搜索词开头输入
最多 20 个联想词
从 1 开始排名
每次请求 0.5 积分
等待提交
等待提交

填写参数并发送请求,任务状态和标准化结果会显示在这里。

README

由 SocQ 维护 · 更新于

TikTok Shop Search Suggestions

TikTok Shop 搜索联想词是买家在商城搜索框里打字时弹出的补全建议,每条都是一个完整的关键词,带有它在列表中的位置和所属市场。这些短语来自用户真实的搜索,能挖出值得写进商品标题、广告和内容里的款式变体、适配型号和购买角度。

TikTok Shop Search Suggestions API 主要特性

  • 补全不完整的搜索query 填入搜索词的开头,例如 phone case,每行返回买家补全后的更长短语,例如 phone cases 17 pro max。
  • 沿用 TikTok Shop 的联想顺序rank 按 TikTok Shop 展示的顺序从 1 开始编号,每个 query 最多 20 条。
  • 按市场返回联想词region 可选 US、SG、MY、PH、TH、VN、ID、JP 和 MX,默认 US,每行都带上对应的 query 和 region,结果可以追溯。

TikTok Shop Search Suggestions API 参数

参数必填描述
query必填要补全的购物搜索词开头,例如 phone case。
region可选搜索市场:US、SG、MY、PH、TH、VN、ID、JP 或 MX,默认 US。

如何使用 TikTok Shop Search Suggestions API

提交购物搜索词的开头,按排名读取联想词。

  1. 向 /v1/tiktok-shop/search-suggestions 发送 {"query": "phone case", "region": "US"}。
  2. 轮询 GET /v1/tasks/{task_id},直到 status 为 succeeded。
  3. 从 results.items 读取 keyword 和 rank;has_more 为 true 时,用 results.next_cursor 取回剩余结果。
curl -X POST "https://api.socq.ai/v1/tiktok-shop/search-suggestions" \
  -H "Authorization: Bearer $SOCQ_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"query":"phone case","region":"US"}'

TikTok Shop Search Suggestions API 最佳使用场景

  • 为商品标题选词: 挑出包含型号、尺寸或款式的关键词,写进商品标题和描述。
  • 整理广告和内容词表: 汇总多个种子词返回的 keyword,形成广告、视频文案和内容规划要用的关键词集合。
  • 跟踪联想词变化: 定期用相同的 query 和 region 重跑,按 keyword 对比 rank,看哪些短语上升、下降或新出现。
  • 对比不同市场的补全方式: 把同一个 query 发到多个 region,并排比较各市场的关键词列表,看不同市场的买家如何补全同样的词。

TikTok Shop Search Suggestions API 使用建议

  • 用简短的词根做种子,不要用完整短语,因为联想是在 query 开头的基础上延伸,短语太长就没有多少可补全的空间。
  • 把返回的 keyword 再作为新的 query 提交,就能往下多挖一层,把一个种子词扩展成一棵更长短语的词树。
  • 多个种子词的结果按 keyword 去重(keyword 同时也是每行的 id),相近的词根可能返回相同的短语。
  • 把看中的 keyword 连同相同的 region 传给 TikTok Shop Search,就能看到这个联想词背后的商品。

除了 TikTok Shop Search Suggestions API,需要其他类型的 TikTok Shop 公开数据时,可以使用以下 API。

  • TikTok Shop Search API — 按关键词和市场地区搜索公开 TikTok Shop 商品,返回卖家、价格、媒体、评分、评价数和已售数量。
  • TikTok Shop Products API — 通过一个公开 TikTok Shop 店铺 URL 采集商品,返回卖家、价格、媒体、分类、SKU、评分、评价数和已售数量。
  • TikTok Shop Product API — 通过一个公开 TikTok Shop PDP URL 获取商品详情,返回卖家、价格、媒体、分类、SKU、评分、评价数和已售数量。
  • TikTok Shop Product Reviews API — 通过一个 TikTok Shop PDP URL 采集公开评价,返回文本、评分、评价者、图片、SKU、国家和购买标记字段。
  • TikTok Shop Hot Products API — 按市场代码获取 TikTok Shop 热卖商品,按排名顺序返回售价、币种、销量、评分和店铺。
  • TikTok Shop Categories API — 按市场获取 TikTok Shop 完整类目树,返回类目 ID、名称、英文标识、层级、上级类目和路径。

探索其他平台

还可以将 TikTok Shop 数据与其他已支持社交平台的公开数据结合使用。

TikTok Shop Search Suggestions API — 常见问题

TikTok Shop Search Suggestions API 是一个用于获取 TikTok Shop 在某个市场中为购物搜索开头给出的联想补全的 API。它最多返回 20 个联想关键词,每个都带有排名、原始 query 和 region。

每次请求只接收一个 query。要覆盖多个种子词,就为每个种子词各提交一次请求,再按 keyword 合并结果。

每次调用计 0.5 积分,最多返回 20 个联想词;按次计费,与返回的联想词条数无关。