TikTok Shop Hot Products
TikTok Shop 热卖商品是平台为某个市场排出的热销商品榜,每件商品带有标题、当地币种售价、销量、评分、评论数、店铺和商品图片。按排名顺序读取并逐周对比,就能看出哪些商品正在起量、热卖品集中在什么价位,以及哪些店铺反复上榜。
TikTok Shop Hot Products API 主要特性
- 只需一个市场代码在 region 中选择一个市场(ID、JP、MX、MY、PH、SG、TH 或 VN),不用准备关键词、类目或店铺链接就能拿到榜单。
- 保留 TikTok Shop 的排名顺序商品按 TikTok Shop 的排名顺序返回,每次最多 200 件,行的先后就是商品在榜单上的位置。
- 以当地币种计价price 拆分为数值 amount、币种代码 currency(如 MYR)和格式化价格 formatted,可直接排序或划分价格带。
- 销量与口碑信号每件商品都带有 sold_count、rating 和 reviews_count,能快速判断卖出了多少件、买家评价如何。
- 店铺与商品图片seller 给出商品所属店铺及其 id,media 列出商品图片及其宽高。
TikTok Shop Hot Products API 参数
| 参数 | 必填 | 描述 |
|---|---|---|
region | 必填 | 要读取榜单的市场:ID、JP、MX、MY、PH、SG、TH 或 VN。 |
results_limit | 可选 | 返回的排名商品数量,可填 1 到 200,默认 50。 |
如何使用 TikTok Shop Hot Products API
选定市场,决定要读到榜单第几名,然后提交任务。
- 向 /v1/tiktok-shop/hot-products 发送 {"region": "MY", "results_limit": 50},保存返回的 task_id。
- 轮询 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/hot-products" \
-H "Authorization: Bearer $SOCQ_API_KEY" \
-H "Content-Type: application/json" \
-d '{"region":"MY","results_limit":50}'TikTok Shop Hot Products API 最佳使用场景
- 按市场每周盯榜: 每周保存商品的 id、名次和 sold_count,对比前后两次结果,看哪些商品新上榜、名次上升或掉出榜单。
- 热卖价位对标: 在同一币种内按 price.amount 排序,找出该市场热卖品集中的价格带,再给自己的商品定价。
- 整理选品清单: 结合 title、media 图片、sold_count 和 rating 挑出值得采购或推广的商品,再通过 url 回到对应商品页。
- 店铺集中度分析: 统计每个 seller.id 在榜单前列出现的次数,判断一个市场是被少数店铺占据,还是分布较散。
TikTok Shop Hot Products API 使用建议
- 读取 results.items 时自己记录名次,并跨 cursor 分页连续计数,因为排名体现在行的先后顺序里,而不是某个名次字段。
- 跨市场比较价格前先按 price.currency 分组,计算时用 price.amount,不要用格式化后的文本。
- sold_count、rating 或 reviews_count 为 null 时按“未提供”处理,不要当成 0,平均值和排序才不会失真。
- 逐周对比时固定 region 和 results_limit,保证每次覆盖的榜单深度一致。
相关 API
除了 TikTok Shop Hot 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 Categories API — 按市场获取 TikTok Shop 完整类目树,返回类目 ID、名称、英文标识、层级、上级类目和路径。
- TikTok Shop Category Products API — 按类目 ID 和市场列出 TikTok Shop 某个类目下的商品,返回售价、销量、评分、评论数和店铺。