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
提交购物搜索词的开头,按排名读取联想词。
- 向 /v1/tiktok-shop/search-suggestions 发送 {"query": "phone case", "region": "US"}。
- 轮询 GET /v1/tasks/{task_id},直到 status 为 succeeded。
- 从 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,就能看到这个联想词背后的商品。
相关 API
除了 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、名称、英文标识、层级、上级类目和路径。