TikTok Shop Categories
TikTok Shop 类目是一个市场的商品分类体系,每个类目都有 ID、当地语言名称、英文标识、所在层级、上级类目以及上面各级的名称。把它们排成一棵树,就能看清这个市场如何给商品归类,也能拿这些 ID 对接自有品类体系、规划类目调研或单独浏览某个分支。
TikTok Shop Categories API 主要特性
- 一次调用拿到全部类目一次请求返回所选市场的整棵类目树,从一级类目一直到最深的子类目,每个类目各占一行。
- 上级、层级和末级标记parent_id 指向上一级类目,level 从顶层的 1 开始计算深度,is_leaf 标出没有下级的类目。
- path 中的上级名称path 从一级开始列出该类目以上各级的名称,不用遍历整棵树也能显示深层类目所处的位置。
- 可直接查商品的类目 ID每个 id 都可以作为 category_id 传给 TikTok Shop Category Products,列出归在该类目下的商品。
TikTok Shop Categories API 参数
| 参数 | 必填 | 描述 |
|---|---|---|
region | 可选 | 要获取类目树的市场:US、SG、MY、PH、TH、VN、ID、JP 或 MX,默认 US。 |
如何使用 TikTok Shop Categories API
请求一个市场的类目树,再用返回的行拼出整棵树。
- 向 /v1/tiktok-shop/categories 发送 {"region": "US"};不传 region 时返回 US 市场的类目树。
- 轮询 GET /v1/tasks/{task_id},直到任务成功。
- 收集 results.items 中的所有行,has_more 为 true 时用 results.next_cursor 继续读取,最后按 parent_id 嵌套。
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"}'TikTok Shop Categories API 最佳使用场景
- 还原类目导航: 按 parent_id 嵌套、按 level 排序,复原该市场的类目菜单,name 用作文字,cover_url 用作图标。
- 与自有品类体系对应: 把 name、slug 和 path 与你自己的商品分类逐一比对,建立两套分类之间的映射。
- 规划类目批量采集: 在选定的一级类目下筛出 is_leaf 为 true 的行,整理出要传给 TikTok Shop Category Products 的类目 ID 清单。
TikTok Shop Categories API 使用建议
- has_more 为 true 时,先用 results.next_cursor 读到最后一页再建树,漏掉一页会让部分子类目找不到上级。
- parent_id 为空、level 为 1 的行就是树的根节点,它们的 path 是空列表。
- 把类目 ID 传给 TikTok Shop Category Products 时,使用读取类目树时的同一个 region,因为每棵树只属于一个市场。
相关 API
除了 TikTok Shop Categories 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 User Showcase API — 按一个 TikTok username 采集公开 Showcase 商品,返回价格、卖家、媒体、评分、评价数、已售数量和地区上下文。
- TikTok Shop Hot Products API — 按市场代码获取 TikTok Shop 热卖商品,按排名顺序返回售价、币种、销量、评分和店铺。
- TikTok Shop Category Products API — 按类目 ID 和市场列出 TikTok Shop 某个类目下的商品,返回售价、销量、评分、评论数和店铺。