适用场景:竞品口碑分析、情感分析、差评预警、用户画像构建;接口入参主要依赖asin、marketplace站点编码、分页页码、每页条数、排序条件。
一、接口基础概述
接口标识:reviews‑v2021‑01‑01(亚马逊 SP‑API 官方评论接口) 鉴权方式:AWS SigV4 签名,LWA 授权获取 access_token 传输协议:HTTPS,返回 JSON 权限范围:仅可请求属于自己店铺的 ASIN 商品评论,无法直接获取第三方竞品商品评价;支持多站点(US/UK/DE/JP 等)切换 marketplaceIds 站点 ID。
amazon.item.reviews.get 为亚马逊平台商品评论接口,是电商口碑数据的核心数据源。商品详情接口只能拿到商品基础信息,真实用户评价、追评、晒图、差评痛点全部依赖本接口获取。
接口名称:amazon.item_review(taobaoapi2014 前往体验)
接口地址:o0b.cn/opandy (HTTPS,支持 GET/POST)
接口版本:v3(稳定正式版)
请求方式:GET / POST(推荐 POST,参数放 body 避免 URL 超长)
返回格式:标准 JSON
业务用途:根据商品 ID,全量获取商品评论基础评论信息、评论日期、图片、视频、评论者 ID、追评、追评内容、视频图文等完整商品评论内容数据。
顶层响应结构
表格
字段类型说明
codeint响应状态码,200 代表成功,非 200 为异常
msgstring返回提示信息,成功返回success,失败返回错误描述
dataobject业务数据主体
totalint评论总数量
pageint当前页码
page_sizeint单页返回条数
rating_summaryobject商品评分汇总统计
reviewsarray[object]评论列表数组,每一项为单条评论对象
rating_summary 评分汇总对象
表格
字段类型说明
average_ratingfloat商品平均星级,范围 1‑5
total_review_countint评论总条数
star_1int1 星评论数量
star_2int2 星评论数量
star_3int3 星评论数量
star_4int4 星评论数量
star_5int5 星评论数量
reviews [] 单条评论核心字段
表格
字段类型说明
review_idstring评论唯一 ID,可用于去重处理
asinstring对应商品 ASIN 编码
marketplacestring站点编码 US/CA/DE/UK/JP 等
ratingint评论星级 1‑5
titlestring评论标题
contentstring评论正文内容
review_datestring评论发布时间字符串
author_namestring评论者昵称
author_profile_urlstring评论者个人主页地址
verified_purchasebool是否真实购买,true 为已验证购买订单
helpful_votesint该评论被标记 “有帮助” 的票数
product_variantstring评论对应的商品变体信息(颜色、尺寸、型号),无变体返回空字符串GitHub
review_imagesarray[string]评论附图 URL 数组,无图为空数组
is_top_reviewbool是否为置顶热门评论