搜索「亚马逊评论 API」的开发者通常只想要一件事:传一个 ASIN,拿回 JSON 格式的评论原文。
亚马逊自己的 API 都做不到对任意商品这样取数。 它们返回的是和评论有关的东西:数量、评分、归纳后的话题,而且每一个都限定在某一类账号内。先分清哪个是哪个,可以省下一周去文档里找一个并不存在的字段。
每个官方 API 在评论方面返回什么
| API | 面向谁 | 评论方面返回什么 | 任意 ASIN 的评论原文 |
|---|---|---|---|
| Selling Partner API | 卖家和供应商,针对自己的账号 | 订单、商品信息、报告。其中的 Customer Feedback API 提供归纳后的评论话题,不是单条评论 | 没有 |
| 联盟 API(Product Advertising API 及其继任者 Creators API) | 做商品链接的联盟成员和创作者 | 用于生成链接的目录数据,包括评分信息 | 没有 |
| Amazon Ads API | 广告主,针对自己的广告活动 | 广告活动管理和报告 | 没有 |
对这张表补充三点。
Customer Feedback API 最接近,但它是摘要。 亚马逊文档对它的描述是:基于买家评论和退货的洞察,粒度是 ASIN 和类目节点,给出最正面和最负面的话题。它是亚马逊已经做完的分析,不是评论本身,而且需要申请权限。
联盟 API 是为生成链接而存在的。 它面向把买家导向亚马逊的网站。亚马逊文档现在把 Creators API 列为 Product Advertising API 5.0 的受支持继任者,在其中任何一个上面开发之前,先看当前的条款。
真正的限制是范围。 卖家 API 和广告 API 只管你自己的账号。竞品的评论在设计上就不在其中,不是权限没开。其他类型的数据也是同一条分界线,见亚马逊数据 API 怎么选。
取评论原文的请求是什么样子
这个缺口由第三方数据接口补上。下面这个接口接收一个 ASIN,分页返回它的评论:
curl --request POST \
--url https://ecommercedataapi.com/v1/amazon/review \
--header "Content-Type: application/json" \
--header "X-API-Key: ${ECOMMERCE_DATA_API_KEY}" \
--data '{
"marketplace": "US",
"asin": "B08CK5Z5Q1",
"page": 1,
"size": 20,
"stars": [1, 2, 3]
}'items[] 里每一项是一条评论:
| 字段 | 它告诉你什么 |
|---|---|
star、title、content | 星级和评论正文 |
date | 评论日期,毫秒时间戳 |
skus | 评论者购买的变体 |
likes | 有多少买家认为有帮助 |
verified、vine、free、experience | 评论的来源 |
image、video、images、videos | 是否带图片视频,以及链接 |
stars 按星级筛选,传 [1, 2, 3] 只返回中差评。返回里有 total 和 pages 用于翻页。
Amazon 评论数据 API 页面列出了支持的站点和常见用法。
代码里要处理的四件事
1. date 是时间戳,不是字符串。 按月分组之前先转换。把它存下来,就能比较商品改版前后的评论。
2. 按变体拆分靠 skus。 父体下的评论是所有变体合在一起的。先按 skus 分组,再判断是不是「这个商品」有问题;很多时候只是某个尺码或颜色有问题。哪些数据是合并的、哪些不是,见父 ASIN 和子 ASIN。
3. 四种来源分开统计。 Vine 评论和实际购买评论是不同的证据,要分开数,原因见亚马逊评论的四种来源。
4. 翻页要有计划。 每次成功调用消耗一个计费单位。对有几千条评论的商品,先决定你要全部,还是只要最近几个月的中差评。
评论数据做不到的事
它是愿意写评论的人的样本。 少见的抱怨会显得比实际更严重。数量要和 likes、日期一起看。
它指出问题,不说明原因。 五十条评论说「用不了了」,并不告诉你是哪个部件坏了。
它不能作为产品宣称的依据。 买家意见不是测试证据。
拿到评论之后怎么用,见亚马逊评论怎么分析;表格路线见把亚马逊评论导出成表格。按变体和主题拆分中差评的做法,见亚马逊差评怎么按变体归因。
常见问题
亚马逊有官方的评论 API 吗? 没有能返回任意商品评论原文的。Selling Partner API 向获批的开发者提供归纳后的评论话题;联盟 API 提供用于生成链接的评分信息。
能只取差评吗?
可以。传 "stars": [1, 2] 或 [1, 2, 3]。
能取竞品的评论吗? 可以。这个接口接受支持站点内的任意 ASIN。
能让 AI Agent 帮我读评论吗? 可以。同一个接口也是远程 MCP 服务上的一个工具,Agent 可以在一次对话里取评论并做总结。