tiktok-shop/
category-products

通过类目 ID 和市场获取 TikTok Shop 某个类目下的商品,返回标题、售价和币种、销量、评分、评论数和店铺,每次最多 500 件。

TikTok Shop Category Products API

类目 ID 输入
9 个市场
最多 500 件商品
每条结果 0.5 积分
等待提交
等待提交

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

README

由 SocQ 维护 · 更新于

TikTok Shop Category Products

TikTok Shop 类目商品是某个市场里归在同一类目下的商品,每件都有标题、描述、售价和币种、销量、评分、评论数、店铺和图片。逐个类目拉取后,就能看清一个品类的价格带、畅销品和活跃店铺,以及它们在不同子类目之间的差别。

TikTok Shop Category Products API 主要特性

  • 按类目 ID 浏览,不靠关键词category_id 接收 TikTok Shop Categories 返回的数字 ID,直接读取该类目下的商品,不用猜测搜索词。
  • 九个市场,默认美国region 支持 US、SG、MY、PH、TH、VN、ID、JP 和 MX,不填时使用 US。
  • 每个类目最多 500 件results_limit 可填 1 到 500,默认 30,一次请求既能取少量样本,也能深入读取一个类目。
  • 每件商品都带电商字段每行包含 title、text、带 amount 和 currency 的 price、sold_count、rating、reviews_count、seller 和 media 图片,以及商品页 url。

TikTok Shop Category Products API 参数

参数必填描述
category_id必填从 TikTok Shop Categories 的 id 字段取得的数字类目 ID,例如 601450。
region可选类目所属市场:US、SG、MY、PH、TH、VN、ID、JP 或 MX,默认 US。
results_limit可选返回的商品数量,可填 1 到 500,默认 30。

如何使用 TikTok Shop Category Products API

从 TikTok Shop Categories 拿到类目 ID,再读取该类目下的商品。

  1. 向 /v1/tiktok-shop/category-products 发送 {"category_id": "601450", "region": "US", "results_limit": 30}。
  2. 轮询 GET /v1/tasks/{task_id},status 为 succeeded 时商品就绪。
  3. 从 results.items 读取商品;has_more 为 true 时,用 results.next_cursor 请求下一页。
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}'

TikTok Shop Category Products API 最佳使用场景

  • 比较子类目价格带: 对每个下级类目各发一次请求,比较 price.amount 的分布,看各子类目的商品定价落在哪里。
  • 跟踪类目畅销品: 定期重跑同一类目,按商品 id 跟踪 sold_count,找出销量持续增长的商品。
  • 梳理品类内的店铺: 按 seller.id 和 seller.name 汇总商品,找出某个类目里上架最多、卖得最好的店铺。

TikTok Shop Category Products API 使用建议

  • 使用在 TikTok Shop Categories 中读取该类目 ID 时的同一个 region,因为每个市场都有自己的类目树。
  • 保存商品时把发送的 category_id 一并记下,商品所属类目由你的请求决定,而不是来自商品行里的字段。
  • 合并多个类目或多次运行的结果时以 id 作为商品主键,同一件商品采到两次也只算一次。

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

  • 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 User Showcase API — 按一个 TikTok username 采集公开 Showcase 商品,返回价格、卖家、媒体、评分、评价数、已售数量和地区上下文。
  • TikTok Shop Hot Products API — 按市场代码获取 TikTok Shop 热卖商品,按排名顺序返回售价、币种、销量、评分和店铺。
  • TikTok Shop Categories API — 按市场获取 TikTok Shop 完整类目树,返回类目 ID、名称、英文标识、层级、上级类目和路径。

探索其他平台

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

TikTok Shop Category Products API — 常见问题

TikTok Shop Category Products API 是一个用于按类目 ID 和市场列出 TikTok Shop 某个类目下商品的 API。它返回每件商品的标题、描述、售价和币种、销量、评分、评论数、店铺、图片和商品页链接。

运行 TikTok Shop Categories,复制目标类目的 id 即可。ID 只由数字组成,例如 601450。

类目树中的任意 ID 都可以。“如何使用”里的示例请求传的 601450 就是一级类目 Beauty & Personal Care,传入更深层的 ID 则会把商品范围收窄到对应分支。

每件商品计 0.5 积分,默认 30 件计 15 积分,取满 500 件计 250 积分。