TikTok Shop Product API

TikTok Shop Product

主要特性

• 单个 PDP 商品详情提交一个受支持的公开 TikTok Shop PDP URL，最多返回一条标准化商品记录，适合补全已知商品而不是发现商品。
• 卖家、价格与可见商品信号商品记录保留公开来源提供的卖家身份、售价、原价、币种、折扣、评分、评价数和已售数量，便于直接按字段判断。
• 媒体、分类与 SKU 上下文返回记录包含公开商品图及可用尺寸，并保留商品页提供的分类和 SKU 或变体结构。

参数

如何使用

提交受支持的商品 URL，保存异步 task ID，并在任务成功后读取标准化商品。

1. 向 /v1/tiktok-shop/product 发送 POST 请求，提供一个受支持的 PDP url 和可选 region。
2. 保存返回的 task_id，并轮询 GET /v1/tasks/{task_id}，直到状态变为 succeeded 或 failed。
3. 任务成功后读取 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