Amazon Reviews
Amazon 商品评价是公开的消费者反馈记录，包含文字内容、评分、作者、发布时间、商品引用和附带媒体。这些记录可用于研究商品反馈、比较评分、监测评价和补充带来源链接的商品数据。
主要特性
- 多商品 URL 输入一个任务可提交一个或多个受支持的 Amazon 商品 URL，并用同一个结果上限控制最终保存的标准化评价。
- 评价内容与作者每条记录可保留公开评价文本、数值评分、作者身份、发布时间，以及附带的图片或视频。
- 商品关联记录标准化结果将商品 ID 和商品 URL 与评价身份及来源链接放在同一记录中，便于确认评价对应的商品。
参数
| 参数 | 必填 | 描述 |
|---|---|---|
urls | 必填 | 必填的非空 Amazon 商品引用列表。每项解析后的 hostname 必须属于受支持的市场或其子域名；接受带 hostname 的任意 scheme 及协议相对引用。每项会转换为一条采集输入。 |
results_limit | 可选 | 整个任务保存的标准化评价数量上限；默认为 100，可设置为 1 到 2,000 的整数。 |
如何使用
提交受支持的商品 URL，跟踪异步任务，并通过 cursor 分页读取标准化评价记录。
- 准备一个或多个受支持的 Amazon 商品 URL，并设置 1 到 2,000 的 results_limit。
- 向 /v1/amazon/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/amazon/reviews" \
-H "Authorization: Bearer $SOCQ_API_KEY" \
-H "Content-Type: application/json" \
-d '{"urls":["https://www.amazon.com/dp/B0CHHSFMRL"],"results_limit":3}'
# 轮询 GET /v1/tasks/{task_id}
# 读取 data.results.items；has_more 为 true 时继续使用 next_cursor最佳使用场景
- 研究商品反馈： 结合评价文本、评分、作者和发布时间，研究已知商品返回的公开反馈。
- 比较多商品评分： 提交多个商品 URL，再按 subject_id 或 subject_url 对返回评分分组，比较本次采集的评价记录。
- 补充评价证据： 将来源链接、商品引用、作者、时间和评价媒体补充到已有商品数据集或监测记录中。
使用建议
- 使用解析后 hostname 属于受支持 Amazon 市场的商品引用；其他主机上的短链接和未支持的地区域名无法通过校验。
- 按所有输入 URL 合计需要保存的评价数设置 results_limit，再持续使用 next_cursor，直到 has_more 为 false，确保读取全部已保存结果页。
- 评价 ID 存在时优先用它标识记录，并在按商品分组时保留 subject_id 或 subject_url。
- 评价文本、作者、评分、时间、商品引用或媒体缺失时应视为未知，不要自行补造替代值。
相关 API
需要其他类型的 Amazon 公开数据时，可以使用以下 API。
- Amazon Best Sellers API — 从公开 Amazon Best Sellers 分类 URL 采集商品，返回标准化卖家、价格、口碑、销量、媒体、来源和时间字段。
- Amazon Product Details API — 通过已知 Amazon URL 采集商品详情，返回标题、描述、卖家、价格、评分、评价数、已售数量和媒体字段。
- Amazon Product Search API — 按商品短语搜索受支持的 Amazon 站点，返回可用的标准化商品、卖家、价格、评分、评价数、已售数量、媒体和来源字段。
- Amazon Seller Info API — 根据已知卖家 URL 采集 Amazon 公开卖家身份、简介、网站、评分、反馈、地点、来源和采集时间字段。