在 TikTok Shop 上选品,先要回答三个问题:某个市场在卖什么、一个类目里有什么、买家搜索时会输入什么。SocQ 早已支持商品搜索、店铺商品、商品详情、评论和达人橱窗,7 个最佳 TikTok Shop API 与数据抓取方案评测 对这些做了对比。2026-11-17,TikTok Shop 平台页 新增了 4 个接口,直接回答这三个问题。
本文说明每个接口返回什么、请求怎么写、价格多少,以及如何把它们串成一次类目扫描。
快速回答: 向
POST https://api.socq.ai/v1/tiktok-shop/<endpoint>发送 JSON 请求体。保存返回的task_id,轮询GET /v1/tasks/{task_id}直到status为succeeded,再读取data.results.items。
新的 TikTok Shop 接口
1 SocQ credit = $0.005。
| 接口 | 返回内容 | 价格 |
|---|---|---|
| TikTok Shop 热卖商品 API | 某市场的热卖商品,按 TikTok Shop 的顺序,含价格、销量、评分和店铺 | 每件商品 0.5 credits($0.0025) |
| TikTok Shop 类目 API | 某市场的完整类目树,每个类目一行,含 ID、层级和父类目 | 每次调用 0.5 credits($0.0025) |
| TikTok Shop 类目商品 API | 某个类目下的商品,含价格、销量、评分、评论数和店铺 | 每件商品 0.5 credits($0.0025) |
| TikTok Shop 搜索联想词 API | 搜索词开头对应的最多 20 个联想词,按排名 | 每次调用 0.5 credits($0.0025) |
支持的市场
| 接口 | region 取值 | 默认值 |
|---|---|---|
| 热卖商品 | ID、JP、MX、MY、PH、SG、TH、VN | 无,必填 |
| 类目、类目商品、搜索联想词 | US、SG、MY、PH、TH、VN、ID、JP、MX | US |
热卖商品不支持 US。做美国市场选品时,请使用类目和类目商品接口。
认证与异步任务流程
所有请求都用 API key 认证。提交、查询任务状态和读取结果使用同一个请求头:
Authorization: Bearer YOUR_API_KEY
Content-Type: application/json
每次采集都作为后台任务运行:
submit -> task_id -> queued -> running -> succeeded
\-> failed
提交请求会立即返回 data.task_id 和 data.status。用这个 ID 轮询任务:
curl "https://api.socq.ai/v1/tasks/$TASK_ID?limit=50" \
-H "Authorization: Bearer $SOCQ_API_KEY"
当 status 为 succeeded 时,响应包含 result_count、credits_amount,以及 data.results.items 中第一页标准化记录。limit 默认 50,最大 500。如果 results.has_more 为 true,把 results.next_cursor 作为 cursor 传入即可读取下一页。失败的任务带有 error_message。
每个接口都接受可选的 callback_url。任务结束后,SocQ 会发送一次带任务摘要的 POST;记录仍从任务接口读取。客户端超时不会取消任务,请用同一个任务 ID 继续读取,不要重新提交。402 表示账户余额不足,429 表示 key 触发了频率或额度限制。
热卖商品:某个市场在卖什么
热卖商品 API 按 TikTok Shop 的排名顺序返回某市场的热卖商品。每件商品含标题、price(金额、币种和格式化字符串)、sold_count、rating、reviews_count、seller、图片和商品页 url。region 必填。results_limit 默认 50,取值 1 到 200。(文档)
curl -X POST "https://api.socq.ai/v1/tiktok-shop/hot-products" \
-H "Authorization: Bearer $SOCQ_API_KEY" \
-H "Content-Type: application/json" \
-d '{"region": "MY", "results_limit": 50}'
适用场景: 每周给每个市场拍一次快照,发现爆款、对比价格,或挑选要采购和推广的商品。价格以当地币种返回,例如马来西亚为 MYR,跨市场比较前请先换算。
类目:完整类目树
类目 API 一次调用返回某市场的全部类目。每行含类目 id、name、英文 slug、level、parent_id、is_leaf、path(上级类目名称)、cover_url 和 region。一级类目的 parent_id 为 null、level 为 1,因此既可以重建成树,也可以当作扁平查找表。(文档)
curl -X POST "https://api.socq.ai/v1/tiktok-shop/categories" \
-H "Authorization: Bearer $SOCQ_API_KEY" \
-H "Content-Type: application/json" \
-d '{"region": "US"}'
适用场景: 每个市场调用一次,然后缓存结果。类目商品接口需要这些 ID,类目树也便于把 TikTok Shop 类目映射到你自己的商品目录。
类目商品:像买家一样浏览类目
类目商品 API 接收类目 API 返回的数字 category_id,返回该类目的商品,含标题、价格、销量、评分、评论数、店铺和图片。region 默认 US。results_limit 默认 30,取值 1 到 500。(文档)
curl -X POST "https://api.socq.ai/v1/tiktok-shop/category-products" \
-H "Authorization: Bearer $SOCQ_API_KEY" \
-H "Content-Type: application/json" \
-d '{"category_id": "601450", "region": "US", "results_limit": 30}'
适用场景: 比较子类目之间的价格带,或观察某个类目的畅销品随时间的变化。
搜索联想词:买家会输入什么
搜索联想词 API 在 query 中接收购物搜索的开头,按 TikTok Shop 给出的顺序返回最多 20 个联想词,排名从 1 开始。每行含 keyword、你发送的 query、rank 和 region。region 默认 US。(文档)
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"}'
适用场景: 为商品标题、广告和内容做关键词研究。在文档示例中,phone case 排第一的联想词是 phone cases 17 pro max,能看出买家在为哪些机型购买。把联想词交给 TikTok Shop 搜索,就能看到每个词下排在前面的商品。
三步完成一次类目扫描
针对一个市场的典型研究流程:
- 对该市场调用一次 类目,保存类目树(0.5 credits)。
- 选出你关心的末级类目(
is_leaf: true),逐个调用 类目商品。 - 用每个类目的核心商品词调用 搜索联想词,看买家如何表述搜索。
10 个类目、每个 30 件商品,共 300 件商品,即 150 credits。加上类目树(0.5)和 10 次联想词调用(5),整次扫描共 155.5 credits,约 $0.78。在热卖商品支持的市场,再加一次 50 件商品的快照需 25 credits($0.125)。
仔细阅读字段
三个商品接口的商品行使用相同的标准化结构。和 SocQ 的其他字段一样,来源没有提供的值为 null,而不是 0。在文档示例中,所示商品的 rating、reviews_count 和 sold_count 都是 null,所以在按这些字段给商品排序之前,请把缺失的销量或评分当作未知,而不是零。
要深入研究单个商品,把它的 url 交给 TikTok Shop 商品 API(目前仅支持美国地区)和 商品评论 API。获取 TikTok Shop 数据的其他方式,见 TikTok Shop API 替代方案。直播中销售的商品由 TikTok 直播带货商品 API 覆盖,见 TikTok 新接口指南。
常见问题
需要 TikTok Shop 卖家或合作伙伴账户吗?
不需要。这些接口读取公开的 TikTok Shop 数据,你用 SocQ API key 认证。
为什么热卖商品不接受 US?
US 不在它的 region 取值中。热卖商品覆盖 ID、JP、MX、MY、PH、SG、TH 和 VN。另外三个接口支持 US,并默认使用它。
类目 ID 从哪里来?
来自类目 API。每行的 id 就是类目商品接口在同一 region 下需要的 category_id。
每个接口如何计费?
类目和搜索联想词每次调用 0.5 credits,无论返回多少行。热卖商品和类目商品按返回的商品计费,每件 0.5 credits。
一个搜索词返回多少联想词?
最多 20 个,按 TikTok Shop 的顺序从 1 开始排名。