amazon/
reviews

通过受支持的 Amazon 商品 URL 采集公开商品评价,返回评价文本、评分、作者、商品引用、时间和媒体,并整理为标准化记录。

Amazon Reviews API

多个商品 URL
评价文本与评分
作者与商品信息
标准化评价记录
每条结果 0.15 积分
等待提交
等待提交

填写参数并发送请求,任务状态和标准化结果会显示在这里。

README

由 SocQ 维护 · 更新于

Amazon Reviews

Amazon 商品评价是公开的消费者反馈记录,包含文字内容、评分、作者、发布时间、商品引用和附带媒体。这些记录可用于研究商品反馈、比较评分、监测评价和补充带来源链接的商品数据。

Amazon Reviews API 主要特性

  • 多商品 URL 输入一个任务可提交一个或多个受支持的 Amazon 商品 URL,并用同一个结果上限控制最终保存的标准化评价。
  • 评价内容与作者每条记录可保留公开评价文本、数值评分、作者身份、发布时间,以及附带的图片或视频。
  • 商品关联记录标准化结果将商品 ID 和商品 URL 与评价身份及来源链接放在同一记录中,便于确认评价对应的商品。

Amazon Reviews API 参数

参数必填描述
urls必填必填的非空 Amazon 商品引用列表。每项解析后的 hostname 必须属于受支持的市场或其子域名;接受带 hostname 的任意 scheme 及协议相对引用。每项会转换为一条采集输入。
results_limit可选整个任务保存的标准化评价数量上限;默认为 100,可设置为 1 到 2,000 的整数。

如何使用 Amazon Reviews API

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

  1. 准备一个或多个受支持的 Amazon 商品 URL,并设置 1 到 2,000 的 results_limit。
  2. 向 /v1/amazon/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/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

Amazon Reviews API 最佳使用场景

  • 研究商品反馈: 结合评价文本、评分、作者和发布时间,研究已知商品返回的公开反馈。
  • 比较多商品评分: 提交多个商品 URL,再按 subject_id 或 subject_url 对返回评分分组,比较本次采集的评价记录。
  • 补充评价证据: 将来源链接、商品引用、作者、时间和评价媒体补充到已有商品数据集或监测记录中。

Amazon Reviews API 使用建议

  • 使用解析后 hostname 属于受支持 Amazon 市场的商品引用;其他主机上的短链接和未支持的地区域名无法通过校验。
  • 按所有输入 URL 合计需要保存的评价数设置 results_limit,再持续使用 next_cursor,直到 has_more 为 false,确保读取全部已保存结果页。
  • 评价 ID 存在时优先用它标识记录,并在按商品分组时保留 subject_id 或 subject_url。
  • 评价文本、作者、评分、时间、商品引用或媒体缺失时应视为未知,不要自行补造替代值。

除了 Amazon Reviews 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 公开卖家身份、简介、网站、评分、反馈、地点、来源和采集时间字段。
  • Amazon Storefront API — 根据店铺链接读取亚马逊达人店铺,包含达人资料、关联社媒账号、带商品数的清单、精选帖子,以及带价格的热门推荐。

探索其他平台

还可以将 Amazon 数据与其他已支持社交平台的公开数据结合使用。

Amazon Reviews API — 常见问题

Amazon Reviews API 是一个用于通过受支持 Amazon 商品 URL 采集公开商品评价的 API。它返回标准化评价文本、评分、作者、时间、商品引用、来源链接和媒体。

urls 必须是非空列表,每项解析后的 hostname 可以是 amazon.com、amazon.co.uk、amazon.de、amazon.fr、amazon.es、amazon.it、amazon.ca、amazon.com.au、amazon.in、amazon.co.jp 或其子域名;接受带 hostname 的任意 scheme 及协议相对引用。

results_limit 是整个任务保存的标准化评价数量上限,不保证每个 URL 都返回该数量。当公开返回的评价较少或重复记录被去除时,任务可以用更少记录成功完成。

任务成功后,从 data.results.items 读取评价,并在 has_more 为 true 时将 next_cursor 传给任务查询接口。每次查询可将页面 limit 设置为 1 到 500。

每条成功保存的评价消耗 0.15 SocQ 积分。请求按 results_limit 预留积分,再按实际结果数结算;空结果不产生结果费用。