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,再读取该类目下的商品。
- 向 /v1/tiktok-shop/category-products 发送 {"category_id": "601450", "region": "US", "results_limit": 30}。
- 轮询 GET /v1/tasks/{task_id},status 为 succeeded 时商品就绪。
- 从 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 作为商品主键,同一件商品采到两次也只算一次。
相关 API
除了 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、名称、英文标识、层级、上级类目和路径。