获取 Amazon 商品评论结果（高级版）

接口说明

该接口用于根据任务 id 获取 Amazon 商品评论抓取结果。返回面向指定 asin，可：

商品标题
商品图片
商品评分与评论总量
评论正文
评论资料信息
评论发布时间
评论附带图片/视频
是否为“已验证购买”等信息

本接口返回的是此前通过 POST 创建任务后生成的结果数据。系统会尽可能高精度模拟任务设置时的请求参数，因此返回结果应尽量贴近对应参数下的页面结果。

你也可以使用响应中的 check_url 在浏览器无痕模式下自行核验结果。需要注意的是，个性化因素（如用户偏好、历史记录等）不会纳模拟，因此不会反映在结果中。

请求方式

GET https://api.seermartech.cn/v3/merchant/amazon/reviews/task_get/advanced/$id

计费说明

该接口本身不单独计费；费用只在创建任务时扣除。任务创建后，可在 30 天多次获取结果。

如需核算成本，请以响应中的 cost 字段为准。

路径参数

参数名	类型	说明
`id`	string	任务唯一标识，UUID 格式。在本平台系统中唯一，可在任务创建后 30 天用于随时获取结果。

Sandbox

可使用以下沙箱地址查看该接口可返回的字段结构（为模拟数据，不扣费）：

https://api.seermartech.cn/v3/merchant/amazon/reviews/task_get/advanced/00000000-0000-0000-0000-000000000000

沙箱响应会 Amazon Reviews Advanced 接口支持的主要字段，并填示例值，适合联调与结构验证。

返回结构

API 返回 JSON 数据，顶层 tasks 数组。

顶层字段

字段名	类型	说明
`version`	string	当前 API 版本。
`status_code`	integer	通用状态码。完整错误码请参考 `/v3/appendix/errors`。建议在接时设计完善的异常处理机制。
`status_message`	string	通用状态信息。完整信息列表请参考 `/v3/appendix/errors`。
`time`	string	接口执行耗时，单位秒。
`cost`	float	本次请求涉及的总任务成本，单位 USD。对于该结果获取接口，通常为 0。
`tasks_count`	integer	`tasks` 数组中的任务数量。
`tasks_error`	integer	`tasks` 数组中返回错误的任务数量。
`tasks`	array	任务结果数组。

tasks[] 字段

字段名	类型	说明
`id`	string	任务唯一标识，UUID 格式。
`status_code`	integer	任务状态码，范围通常为 `10000-60000`。完整状态码请参考 `/v3/appendix/errors`。
`status_message`	string	任务状态说明。
`time`	string	该任务执行耗时，单位秒。
`cost`	float	该任务成本，单位 USD。
`result_count`	integer	`result` 数组中的结果数量。
`path`	array	请求路径。
`data`	object	与创建任务时提交的参数一致。
`result`	array	结果数组。

result[] 字段

字段名	类型	说明
`asin`	string	POST 创建任务时传的商品 ASIN。
`type`	string	POST 中指定的搜索引擎类型。
`se_domain`	string	POST 中指定的搜索引擎域名。
`location_code`	integer	POST 中指定的位置编码。
`language_code`	string	POST 中指定的语言编码。
`check_url`	string	结果页面直达链接，可用于人工核验结果准确性。
`datetime`	string	结果抓取时间，UTC 格式：`yyyy-mm-dd hh-mm-ss +00:00`。例如：`2019-11-15 12:57:46 +00:00`
`spell`	object	搜索引擎自动纠错信息；本场景下通常为 `null`。
`title`	string	商品标题，即当前评论所属商品标题。
`image`	object	商品主图信息。
`rating`	object	商品整体评分信息。
`item_types`	array	当前结果中的结果项类型。可能值：`amazon_review_item`
`items_count`	integer	返回的评论数量。若需要更多评论，应在创建任务时提高 `depth` 参数。
`items`	array	评论列表。

image 对象字段

字段名	类型	说明
`type`	string	素类型，固定为 `images_element`。
`alt`	string	图片 `alt` 文本。
`url`	string	页面链接。
`image_url`	string	商品图片 URL。

rating 对象字段（商品整体评分）

字段名	类型	说明
`type`	string	素类型，固定为 `rating_element`。
`position`	string	素在 Amazon 结果页中的位置。可能值：`left`、`right`
`rating_type`	string	评分类型。可能值：`Max5`、`Percents`、`CustomMax`
`value`	float	基于评论计算出的平均评分。
`votes_count`	integer	投票数。
`rating_max`	integer	对应 `rating_type` 的最大分值。
`reviews_count`	integer	评论总数。

items[] 字段（单条评论）

字段名	类型	说明
`type`	string	评论类型，固定为 `amazon_review_item`。
`rank_group`	integer	在同类中的位置。不同 `type` 的不会计该排序。
`rank_absolute`	integer	评论在评论列表中的绝对位置。
`position`	string	评论在结果页中的位置，当前可能值为 `right`。
`xpath`	string	素的 XPath。
`verified`	boolean	是否带有“Verified Purchase（已验证购买）”标记。
`subtitle`	string	评论副标题，通常国家/地区与评论日期信息。
`helpful_votes`	integer	“Helpful” 按钮的投票数。
`images`	array	评论上传的商品图片。
`videos`	array	评论上传的商品视频。
`user_profile`	object	评论资料。
`title`	string	评论标题。
`url`	string	评论 URL。
`review_text`	string	评论正文。
`publication_date`	string	评论发布时间，UTC 格式：`yyyy-mm-dd hh-mm-ss +00:00`。
`rating`	object	评论给出的评分。

items[].images[] 字段

字段名	类型	说明
`type`	string	素类型，固定为 `images_element`。
`alt`	string	图片 `alt` 文本。
`url`	string	链接。
`image_url`	string	评论图片 URL。

items[].videos[] 字段

字段名	类型	说明
`type`	string	素类型，固定为 `video_element`。
`source`	string	视频源地址。
`preview`	string	视频预览图地址。

user_profile 对象字段

字段名	类型	说明
`name`	string	评论名称。
`avatar`	string	评论头像 URL。
`url`	string	评论个人主页 URL。
`reviews_count`	integer	评论提交的评论总数。
`locations`	string	评论所在国家或地区。

items[].rating 字段（单条评论评分）

字段名	类型	说明
`rating_type`	string	评分类型。当前可能值：`Max5`
`value`	float	评分值。
`votes_count`	integer	反馈数量；该场景下通常为 `null`。
`rating_max`	integer	对应评分类型的最大值；`Max5` 的最大值为 `5`。

请求示例

cURL

bash

id="04011058-0696-0199-0000-2196151a15cb"

curl --location --request GET "https://api.seermartech.cn/v3/merchant/amazon/reviews/task_get/advanced/${id}" \
--header "Authorization: Bearer smt_live_YOUR_KEY" \
--header "Content-Type: application/json"

Python

python

import requests

task_id = "06141103-2692-0309-1000-980b778b6d25"
url = f"https://api.seermartech.cn/v3/merchant/amazon/reviews/task_get/advanced/{task_id}"

headers = {
 "Authorization": "Bearer smt_live_YOUR_KEY",
 "Content-Type": "application/json"
}

response = requests.get(url, headers=headers)
data = response.json

print(data)

TypeScript

typescript

import axios from "axios";

const taskId = "02231934-2604-0066-2000-570459f04879";

axios({
 method: "get",
 url: `https://api.seermartech.cn/v3/merchant/amazon/reviews/task_get/advanced/${taskId}`,
 headers: {
 Authorization: "Bearer smt_live_YOUR_KEY",
 "Content-Type": "application/json"
 }
})
 .then((response) => {
 // 输出结果数据
 console.log(response.data);
 })
 .catch((error) => {
 console.error(error);
 });

响应示例

json

{
 "version": "0.1.20220407",
 "status_code": 20000,
 "status_message": "Ok.",
 "time": "0.1642 sec.",
 "cost": 0,
 "tasks_count": 1,
 "tasks_error": 0,
 "tasks": [
 {
 "data": {
 "se_type": "reviews",
 "api": "merchant",
 "function": "reviews",
 "se": "amazon",
 "language_code": "en_US",
 "location_code": 2840,
 "asin": "B0773ZY26F",
 "priority": 2,
 "depth": 10,
 "device": "desktop",
 "os": "windows"
 },
 "result": [
 {
 "items_count": 10,
 "items": [
 {
 "type": "amazon_review_item",
 "verified": true,
 "subtitle": "Reviewed in the United States on May 16, 2018",
 "helpful_votes": 364,
 "images": null,
 "videos": [],
 "user_profile": {
 "name": "Krassodo",
 "avatar": "https://images-na.ssl-images-amazon.com/images/S/amazon-avatars-global/9838d2ea-3833-4fff-b106-73ad2f27501d._CR0,0,500,500_SX48_.jpg",
 "url": "https://amazon.com/gp/profile/amzn1.account.AFY4NJGGBIHRJE3A773RXALIYYPA/ref=cm_cr_arp_d_gw_btm?ie=UTF8",
 "reviews_count": null,
 "locations": null
 },
 "title": "I like it but I don't love it....for good reasons",
 "url": "https://amazon.com/gp/customer-reviews/R1B458N58WNZA8/ref=cm_cr_arp_d_rvw_ttl?ie=UTF8&ASIN=B0773ZY26F",
 "review_text": "The monitor is great for pc and console gaming...",
 "publication_date": "2018-05-16 00:00:00 +00:00",
 "rating": {
 "rating_type": "Max5",
 "value": 3,
 "votes_count": null,
 "rating_max": 5
 }
 }
 ]
 }
 ]
 }
 ]
}

状态码与错误处理

顶层 status_code 表示整个请求的处理状态
tasks[].status_code 表示任务状态
若 tasks[].status_code >= 40000，通常表示任务级错误
错误码与消息请参考 /v3/appendix/errors

建议处理逻辑：

检查 HTTP 状态码是否为 200
再检查顶层 status_code 是否为 20000
遍历 tasks，检查每个任务的 status_code
若 result 为空，结合 status_message 判断任务是否尚未完成或已失败

使用说明

通常工作流程如下：

通过对应的 POST 接口创建 Amazon 评论采集任务
获取返回的任务 id
轮询已完成任务列表，或直接通过本接口按 id 获取结果
在 30 天可重复获取该任务结果，不会重复计费

如果希望返回更多评论项，请在创建任务时设置更高的 depth。

实用场景

监控商品口碑变化：按 ASIN 定期拉取评论，跟踪评分、差评比例和评论文本变化，及时发现商品体验问题。
提炼用户痛点：分析 review_text、title、helpful_votes 等字段，快速识别高频负面反馈，为产品改进和客服话术提供依据。
识别优质买家反馈：基于 verified、评论评分、点赞数筛选高价值评论，用于沉淀真实用户卖点和营销素材。
对比竞品评论结构：抓取不同 ASIN 的评论、发布时间和评分分布，分析竞品在质量、价格、、售后等维度的优劣势。
追踪评论媒体：利用评论中的 images、videos 字段识别用户晒单与使用场景，为运营和视觉优化提供素材线索。

获取 Amazon 商品评论结果（高级版） ​

接口说明 ​

请求方式 ​

计费说明 ​

路径参数 ​

Sandbox ​

返回结构 ​

顶层字段 ​

tasks[] 字段 ​

result[] 字段 ​

image 对象字段 ​

rating 对象字段（商品整体评分） ​

items[] 字段（单条评论） ​

items[].images[] 字段 ​

items[].videos[] 字段 ​

user_profile 对象字段 ​

items[].rating 字段（单条评论评分） ​

请求示例 ​

cURL ​

Python ​

TypeScript ​

响应示例 ​

状态码与错误处理 ​

使用说明 ​

实用场景 ​