TikTok Shop Product Reviews
TikTok Shop 商品评价是公开的消费者反馈记录，包含文本、评分、评价者名称、图片、时间、SKU 详情、国家和明确的购买状态标记。这些字段可用于分析商品反馈、比较变体与地区差异，并构建保留证据边界的评价工作流。
主要特性
- 单个商品与地区范围提交一个受支持的公开 PDP URL 和市场 region，在请求上限内采集该商品公开提供的唯一评价。
- 评价内容、评分、作者与媒体每条标准化记录保留公开评价文本、数值评分、评价者身份、图片、发布时间、商品 URL 和采集时间。
- 商品、SKU、国家与购买信息评价记录保留商品与 SKU ID、变体规格、评价国家，以及来源明确提供的已验证购买或激励评价标记。
参数
| 参数 | 必填 | 描述 |
|---|---|---|
url | 必填 | 必填公开 TikTok Shop URL，路径须匹配 /shop/pdp/{数字ID} 或 /shop/pdp/{slug}/{数字ID}；每个任务只接收一个商品。 |
results_limit | 可选 | 跨来源分页保存的唯一评价数量上限；默认为 100，可设置为 20 到 2,000 的整数。 |
region | 可选 | TikTok Shop 市场地区，默认为 US；其它已接受地区的公开商品或评价可用性可能不同。 |
如何使用
提交一个受支持的商品 URL，跟踪异步任务，并通过 cursor 分页读取标准化评价记录。
- 准备一个受支持的 TikTok Shop PDP url、20 到 2,000 的 results_limit，以及商品所属市场的 region。
- 向 /v1/tiktok-shop/product-reviews 发送 POST 请求，并保存返回的 task_id。
- 轮询 GET /v1/tasks/{task_id}，直到任务成功或返回失败。
- 从 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
需要其他类型的 TikTok Shop 公开数据时，可以使用以下 API。
- TikTok Shop Search API — 按关键词和市场地区搜索公开 TikTok Shop 商品，返回卖家、价格、媒体、评分、评价数和已售数量。
- TikTok Shop Products API — 通过一个公开 TikTok Shop 店铺 URL 采集商品，返回卖家、价格、媒体、分类、SKU、评分、评价数和已售数量。
- TikTok Shop Product API — 通过一个公开 TikTok Shop PDP URL 获取商品详情，返回卖家、价格、媒体、分类、SKU、评分、评价数和已售数量。
- TikTok Shop User Showcase API — 按一个 TikTok username 采集公开 Showcase 商品，返回价格、卖家、媒体、评分、评价数、已售数量和地区上下文。