TikTok Shop Product
TikTok Shop 商品页包含商品身份、卖家、价格、媒体、分类、变体、评分、评价数和已售数量等公开信号。这些字段可用于商品补全、目录研究、商品呈现复核和时间点快照比较。
主要特性
- 单个 PDP 商品详情提交一个受支持的公开 TikTok Shop PDP URL，最多返回一条标准化商品记录，适合补全已知商品而不是发现商品。
- 卖家、价格与可见商品信号商品记录保留公开来源提供的卖家身份、售价、原价、币种、折扣、评分、评价数和已售数量，便于直接按字段判断。
- 媒体、分类与 SKU 上下文返回记录包含公开商品图及可用尺寸，并保留商品页提供的分类和 SKU 或变体结构。
参数
| 参数 | 必填 | 描述 |
|---|---|---|
url | 必填 | 必填公开 TikTok Shop URL，路径须匹配 /shop/pdp/{数字ID} 或 /shop/pdp/{slug}/{数字ID}；每个任务只接收一个商品。 |
region | 可选 | 可选 TikTok Shop 市场地区，默认为 US；其它已接受地区的商品可用性可能不同。 |
如何使用
提交受支持的商品 URL，保存异步 task ID，并在任务成功后读取标准化商品。
- 向 /v1/tiktok-shop/product 发送 POST 请求，提供一个受支持的 PDP url 和可选 region。
- 保存返回的 task_id，并轮询 GET /v1/tasks/{task_id}，直到状态变为 succeeded 或 failed。
- 任务成功后读取 data.results.items；只有 has_more 为 true 时才继续使用 next_cursor。
curl -X POST "https://api.socq.ai/v1/tiktok-shop/product" \
-H "Authorization: Bearer $SOCQ_API_KEY" \
-H "Content-Type: application/json" \
-d '{"url":"https://www.tiktok.com/shop/pdp/example-product/1729587769570529799","region":"US"}'
# 轮询 GET /v1/tasks/{task_id}
# status 变为 succeeded 后读取 data.results.items最佳使用场景
- 补全搜索或店铺目录结果： 通过已知 PDP URL，为选定的搜索或店铺目录商品补充卖家、价格、评分、媒体、分类和 SKU 字段。
- 比较商品信号快照： 对比不同时间点商品记录中的售价、原价、折扣、评分、评价数和已售数量。
- 复核分类与变体结构： 检查公开分类、图片和 SKU 结构，了解商品在公开页面中的组织与呈现方式。
使用建议
- 提交前确认输入为带数字商品 ID 的完整 tiktok.com PDP URL，避免请求因 URL 格式错误被拒绝。
- 除非商品属于其它已接受市场，否则保留默认 region US；非 US 结果为空时应考虑地区可用性边界。
- 不要发送 results_limit：每个任务只接收一个商品 URL，最多返回一条标准化记录。
- 将可空的卖家、价格、指标、媒体、分类和 SKU 字段视为公开页面快照，并在任务成功但无商品时避免生成占位记录。
相关 API
需要其他类型的 TikTok Shop 公开数据时，可以使用以下 API。
- TikTok Shop Search API — 按关键词和市场地区搜索公开 TikTok Shop 商品，返回卖家、价格、媒体、评分、评价数和已售数量。
- TikTok Shop Products API — 通过一个公开 TikTok Shop 店铺 URL 采集商品，返回卖家、价格、媒体、分类、SKU、评分、评价数和已售数量。
- TikTok Shop Product Reviews API — 通过一个 TikTok Shop PDP URL 采集公开评价，返回文本、评分、评价者、图片、SKU、国家和购买标记字段。
- TikTok Shop User Showcase API — 按一个 TikTok username 采集公开 Showcase 商品，返回价格、卖家、媒体、评分、评价数、已售数量和地区上下文。