tiktok-shop/
categories

通过可选的市场代码获取 TikTok Shop 某个市场的完整商品类目树,每个类目一行,包含 ID、名称、英文标识、层级、上级类目和路径。

TikTok Shop Categories API

完整类目树
市场可选
上级与层级
类目 ID
每次请求 0.5 积分
等待提交
等待提交

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

README

由 SocQ 维护 · 更新于

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

请求一个市场的类目树,再用返回的行拼出整棵树。

  1. 向 /v1/tiktok-shop/categories 发送 {"region": "US"};不传 region 时返回 US 市场的类目树。
  2. 轮询 GET /v1/tasks/{task_id},直到任务成功。
  3. 收集 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,因为每棵树只属于一个市场。

除了 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 某个类目下的商品,返回售价、销量、评分、评论数和店铺。

探索其他平台

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

TikTok Shop Categories API — 常见问题

TikTok Shop Categories API 是一个用于按可选的市场代码获取 TikTok Shop 某个市场完整商品类目树的 API。它返回每个类目的 ID、名称、英文标识、上级类目、层级、是否末级、上级路径和图标地址。

region 可选 US、SG、MY、PH、TH、VN、ID、JP 和 MX,不填时默认 US。

筛选 parent_id 等于该类目 id 的行即可。is_leaf 为 true 的类目没有下级,就是所在分支的末端。

name 使用该市场的显示语言,slug 则为每个类目提供英文 URL 标识,阅读其他语言的市场时可以对照着看。

每次调用计 0.5 积分,无论类目树有多少行,都会返回该市场的全部类目。