TikTok Shop Product Reviews API

TikTok Shop Product Reviews

主要特性

• 单个商品与地区范围提交一个受支持的公开 PDP URL 和市场 region，在请求上限内采集该商品公开提供的唯一评价。
• 评价内容、评分、作者与媒体每条标准化记录保留公开评价文本、数值评分、评价者身份、图片、发布时间、商品 URL 和采集时间。
• 商品、SKU、国家与购买信息评价记录保留商品与 SKU ID、变体规格、评价国家，以及来源明确提供的已验证购买或激励评价标记。

参数

如何使用

提交一个受支持的商品 URL，跟踪异步任务，并通过 cursor 分页读取标准化评价记录。

1. 准备一个受支持的 TikTok Shop PDP url、20 到 2,000 的 results_limit，以及商品所属市场的 region。
2. 向 /v1/tiktok-shop/product-reviews 发送 POST 请求，并保存返回的 task_id。
3. 轮询 GET /v1/tasks/{task_id}，直到任务成功或返回失败。
4. 从 data.results.items 读取记录，并在 has_more 为 true 时继续请求返回的 next_cursor。

curl -X POST "https://api.socq.ai/v1/tiktok-shop/product-reviews" \
  -H "Authorization: Bearer $SOCQ_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"url":"https://www.tiktok.com/shop/pdp/example-product/1729587769570529799","results_limit":100,"region":"US"}'

# 轮询 GET /v1/tasks/{task_id}
# 读取 data.results.items；has_more 为 true 时继续使用 next_cursor

最佳使用场景

• 分析商品反馈： 结合评价文本、数值评分、时间和商品身份，分析一个已知商品返回的公开反馈。
• 比较 SKU 与地区反馈： 按 SKU 规格或评价国家分组，再比较文本与评分，不为缺失字段推断数值。
• 检查购买信息与评价媒体： 查看消费者上传的图片，并在字段存在时按明确的已验证购买或激励评价标记划分记录。

使用建议

• 提交前确认输入为带数字商品 ID 的完整 tiktok.com PDP URL，因为资料、视频、店铺等其它 TikTok URL 会被拒绝。
• 选择与商品市场一致的 region；当所选市场未公开商品或评价源时，格式正确的 URL 也可能没有记录。
• 将 results_limit 设置在 20 到 2,000 之间以控制采集范围，再持续使用 next_cursor，直到 has_more 为 false，确保读取全部已保存结果页。
• 将缺失的评价文本、评价者身份、SKU 详情和购买状态标记视为未知；缺失布尔值不等于 false，只有评分的记录仍然有效。

相关 API