获取 Amazon ASIN 高级结果（按任务 ID）

本接口用于根据任务 ID 获取 Amazon 商品及所有变体 ASIN 信息。返回通常商品标题、价格、评分、优惠券、分类路径、商品、图片/视频、是否可下单，以及本地与热门评论等高级数据。

接口说明

请求方式：GET
请求地址：https://api.seermartech.cn/v3/merchant/amazon/asin/task_get/advanced/{id}
计费说明：
在创建任务时扣费，获取结果本身在任务生成后的 30 天
实扣费以响应头 X-SeerMarTech-Charge-CNY 为准

路径参数

字段	类型	说明
`id`	string	任务唯一标识，UUID 格式。在本平台系统中创建后，可在 30 天随时用于查询该任务结果。

返回结构

接口返回 JSON 数据，顶层 tasks 数组，每个任务对象对应一次获取结果。

顶层字段

字段	类型	说明
`version`	string	当前 API 版本
`status_code`	integer	通用状态码
`status_message`	string	通用状态信息
`time`	string	接口执行时间，单位秒
`cost`	float	本次请求总成本，单位 USD
`tasks_count`	integer	`tasks` 数组中的任务数
`tasks_error`	integer	返回错误的任务数
`tasks`	array	任务结果数组

建议在接时做好状态码与异常处理逻辑。错误码含义请参考错误码附录。

`tasks` 数组字段

字段	类型	说明
`id`	string	任务 ID，UUID 格式
`status_code`	integer	任务状态码，范围通常为 `10000-60000`
`status_message`	string	任务状态信息
`time`	string	任务执行时间，单位秒
`cost`	float	该任务成本，单位 USD
`result_count`	integer	`result` 数组中的结果数量
`path`	array	URL 路径
`data`	object	与创建任务时相同的请求参数
`result`	array	结果数组

`result` 数组字段

字段	类型	说明
`asin`	string	创建任务时传的商品 ASIN
`type`	string	搜索引擎类型，固定为 `shopping`
`se_domain`	string	Amazon 目标站点域名
`location_code`	integer	地区代码
`language_code`	string	语言代码
`check_url`	string	Amazon 结果直达链接，可用于人工核验结果准确性
`datetime`	string	抓取时间，UTC 格式：`yyyy-mm-dd hh-mm-ss +00:00`
`spell`	object	搜索引擎自动纠错信息
`item_types`	array	结果中出现的类型
`items_count`	integer	`items` 数组中的数量
`items`	array	商品结果数组

`item_types` 可能值

amazon_product_info

`items` 数组字段

items 中的类型为 Amazon 商品对象。

字段	类型	说明
`type`	string	素类型，固定为 `amazon_product_info`
`rank_group`	integer	同类型的排名
`rank_absolute`	integer	绝对排名
`position`	string	素在页面中的位置，可能值：`left`、`right`
`xpath`	string	素 XPath
`title`	string	商品标题
`details`	string	商品规格及补信息
`image_url`	string	主商品图片 URL
`author`	string	品牌名或店铺名
`data_asin`	string	创建任务时传的 ASIN
`parent_asin`	string	商品父 ASIN
`product_asins`	array	当前识别到的变体 ASIN
`price_from`	float	商品价格区间下限，例如 `49.98`
`price_to`	float	商品价格区间上限，例如 `384.99`
`percentage_discount`	float	折扣百分比
`currency`	string	币种，ISO 4217 格式，例如 `USD`
`is_amazon_choice`	boolean	是否带有 “Amazon’s choice” 标识
`rating`	object	商品评分信息
`is_newer_model_available`	boolean	是否存在更新型号
`is_prime_video`	boolean	是否带有 Prime Video 标签
`applicable_vouchers`	array	可用优惠券信息
`newer_model`	object	更新型号信息
`categories`	array	商品分类路径
`product_information`	array	商品信息扩展
`product_images_list`	array	主图左侧展示的商品图片 URL
`product_videos_list`	array	主视频右侧展示的商品视频 URL
`description`	string	商品描述
`is_available`	boolean	是否可下单购买
`top_local_reviews`	array	目标地区热门评论
`top_global_reviews`	array	热门评论

`rating` 对象字段

字段	类型	说明
`type`	string	素类型，固定为 `rating_element`
`position`	string	页面位置，可能值：`left`、`right`
`rating_type`	string	评分类型，可能值：`Max5`、`Percents`、`CustomMax`
`value`	string / float	评分值
`votes_count`	integer	评价数量
`rating_max`	string / integer	评分上限

`applicable_vouchers` 字段说明

字段	类型	说明
`type`	string	素类型，固定为 `amazon_applicable_vouchers_item`
`text`	string	优惠券展示文案
`fixed_discount`	float	固定金额优惠值
`fixed_discount_currency`	string	固定优惠金额币种
`percentage_discount`	float	百分比优惠值；若为固定金额优惠，则该字段为 `null`
`important_details`	string	优惠券适用条件或重要说明

`newer_model` 字段说明

字段	类型	说明
`title`	string	更新型号商品标题
`newer_model_asin`	string	更新型号的 ASIN

`categories` 字段说明

字段	类型	说明
`category`	string	分类名称
`url`	string	分类 URL，对应 Amazon 的类目浏览路径及 browse node ID

`product_information` 字段说明

该字段用于返回商品页中的扩展信息，可能分区块文本、图片、视频等。

扩展信息区块：`product_information_extended_item`

字段	类型	说明
`type`	string	素类型，固定为 `product_information_extended_item`
`section_name`	string	当前信息区块名称
`contents`	array	当前区块下的列表

`contents` 中的 `product_information_rows`

字段	类型	说明
`type`	string	素类型，固定为 `product_information_rows`
`title`	string	在 Amazon 商品页中展示的分标题
`rows`	array	该标题下的行

`rows` 可能类型

文本行：`product_information_text_row`

字段	类型	说明
`type`	string	素类型，固定为 `product_information_text_row`
`text`	string	当前区块中的文本

图片行：`product_information_image_row`

字段	类型	说明
`type`	string	素类型，固定为 `product_information_image_row`
`alt`	string	图片替代文本
`url`	string	图片 URL

视频行：`product_information_video_row`

字段	类型	说明
`type`	string	素类型，固定为 `product_information_video_row`
`preview`	string	视频预览图 URL
`url`	string	视频 URL

明细区块：`product_information_details_item`

字段	类型	说明
`type`	string	素类型，固定为 `product_information_details_item`
`section_name`	string	明细区块名称
`body`	object	当前区块的详细

评论字段说明

top_local_reviews 和 top_global_reviews 字段结构一致，均为评论对象数组。

字段	类型	说明
`type`	string	素类型，固定为 `amazon_review_item`
`rank_group`	integer	同类型评论排名
`rank_absolute`	integer	评论绝对排名
`position`	string	页面位置，通常为 `right`
`xpath`	string	素 XPath
`verified`	boolean	是否为已验证购买
`subtitle`	string	评论副标题，如地区与日期
`helpful_votes`	integer	该评论获得的“有帮助”投票数
`images`	array	评论上传的商品图片
`image_url`	string	评论中展示的商品图片 URL
`videos`	array	评论上传的视频
`user_profile`	object	评论资料
`title`	string	评论标题
`url`	string	评论链接
`review_text`	string	评论正文
`publication_date`	string	评论发布时间，UTC 格式：`yyyy-mm-dd hh-mm-ss +00:00`
`rating`	object	评论评分

评论图片 `images`

字段	类型	说明
`type`	string	素类型，固定为 `images_element`
`alt`	string	图片 alt 文本
`url`	string	图片链接

评论视频 `videos`

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

`user_profile` 字段

字段	类型	说明
`name`	string	评论名称
`avatar`	string	评论头像 URL
`url`	string	评论主页 URL
`reviews_count`	integer	评论累计评论数
`locations`	string	评论所在国家/地区

评论评分 `rating`

字段	类型	说明
`rating_type`	string	评分类型，通常为 `Max5`
`value`	float	评分值
`votes_count`	integer	反馈数；此处通常为 `null`
`rating_max`	integer	评分上限，`Max5` 时为 `5`

沙箱测试

可通过以下沙箱地址获取模拟数据的完整字段结构，不会产生扣费：

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

请求示例

curl

bash

id="04171455-0696-0192-0000-4c69cc29b945"

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

Python

python

import requests

task_id = "02201115-0001-0066-0000-c06c8f23fce5"
url = f"https://api.seermartech.cn/v3/merchant/amazon/asin/task_get/advanced/{task_id}"

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

response = requests.get(url, headers=headers)
print(response.status_code)
print(response.text)

TypeScript

typescript

import axios from "axios";

const taskId = "02201115-0001-0066-0000-c06c8f23fce5";

axios({
 method: "get",
 url: `https://api.seermartech.cn/v3/merchant/amazon/asin/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);
 });

结合 tasks_ready 获取已完成任务

通常建议查询已完成任务列表，再逐个拉取高级结果：

GET /v3/merchant/amazon/asin/tasks_ready
GET /v3/merchant/amazon/asin/task_get/advanced/{id}

Python 示例：取已完成任务，再取

python

import requests

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

# 1. 获取已完成任务列表
ready_resp = requests.get(
 "https://api.seermartech.cn/v3/merchant/amazon/asin/tasks_ready",
 headers=headers
)

ready_data = ready_resp.json

results = []

if ready_data.get("status_code") == 20000:
 for task in ready_data.get("tasks", []):
 for item in task.get("result", []) or []:
 endpoint = item.get("endpoint_advanced")
 if endpoint:
 # 2. 拉取每个已完成任务的高级结果
 task_resp = requests.get(
 f"https://api.seermartech.cn{endpoint}",
 headers=headers
 )
 results.append(task_resp.json)

print(results)

响应示例

json

{
 "version": "0.1.20241101",
 "status_code": 20000,
 "status_message": "Ok.",
 "time": "0.0749 sec.",
 "cost": 0,
 "tasks_count": 1,
 "tasks_error": 0,
 "tasks": [
 {
 "data": {
 "se_type": "asin",
 "api": "merchant",
 "function": "asin",
 "se": "amazon",
 "language_code": "en_US",
 "location_code": 2840,
 "asin": "B016MAK38U",
 "device": "desktop",
 "os": "windows"
 },
 "result": [
 {
 "items_count": 1,
 "items": [
 {
 "title": "Redragon K552 Mechanical Gaming Keyboard, LED Gaming Keyboard with Red Switches, 87 Full Anti-ghosting Keys, Unique Metal Rim for Windows Gaming PC - Black",
 "image_url": "https://m.media-amazon.com/images/I/71FSIp+tDNL._AC_SY300_SX300_.jpg",
 "author": "Visit the Redragon Store",
 "data_asin": "B016MAK38U",
 "price_from": 29.59,
 "currency": "USD",
 "is_amazon_choice": true,
 "rating": {
 "type": "rating_element",
 "position": "left",
 "rating_type": "Max5",
 "value": 4.5,
 "votes_count": 53477,
 "rating_max": 5
 },
 "is_newer_model_available": true,
 "is_prime_video": false,
 "newer_model": {
 "title": "Redragon Mechanical Keyboard Wireless, Gaming Keyboard Wireless 3-Modes 94 Keys Mechanical Keyboard Hot-Swap Socket, RGB Creamy Gaming Keyboard Gasket Structure for PC/Tablet/Laptop/Xbox/PS4/PS5",
 "newer_model_asin": "B0CX8ZHJFT"
 },
 "description": "About this item ...",
 "is_available": true,
 "top_local_reviews": [
 {
 "type": "amazon_review_item",
 "verified": true,
 "subtitle": "Reviewed in the United States on November 21, 2024",
 "user_profile": {
 "name": "Cristiann Lozano",
 "locations": "US"
 },
 "title": "SIN EMPAQUE DE ENVIO",
 "url": "https://amazon.com/gp/customer-reviews/RON2CUO3DKZR0?ASIN=B016MAK38U",
 "review_text": "El teclado llegó en perfecto estado...",
 "publication_date": "2024-11-21 00:00:00 +00:00",
 "rating": {
 "rating_type": "Max5",
 "value": 3,
 "rating_max": 5
 }
 }
 ],
 "top_global_reviews": [
 {
 "type": "amazon_review_item",
 "verified": true,
 "subtitle": "Reviewed in Mexico on August 11, 2024",
 "user_profile": {
 "name": "Adrián Alexis",
 "locations": "MX"
 },
 "title": "excelente teclado",
 "review_text": "me gusto bastante...",
 "publication_date": "2024-08-11 00:00:00 +00:00",
 "rating": {
 "rating_type": "Max5",
 "value": 5,
 "rating_max": 5
 }
 }
 ]
 }
 ]
 }
 ]
 }
 ]
}

状态码与错误处理

顶层 status_code=20000 表示请求成功
任务级 status_code 用于判断单个任务是否成功
若任务状态码大于等于 40000，或 result 为空，建议按失败处理并记录 status_message
建议同时检查：
顶层 tasks_error
单任务 status_code
result_count
items_count

使用建议

通过创建任务接口创建 Amazon ASIN 查询任务。
使用 /v3/merchant/amazon/asin/tasks_ready 轮询已完成任务。
对每个已完成任务，使用本接口按 id 获取高级。
在 30 天可重复获取结果，无需再次为获取结果付费。
如需调试字段结构，优使用沙箱地址。

实用场景

监控商品页变化：定期抓取标题、价格、描述、是否可售与主图，及时发现商品页改动，支持运营巡检与异常预警。
**识别变体与父子 ASIN **：获取 parent_asin 与 product_asins，构建商品族谱，便于变体聚合分析和竞品矩阵整理。
分析评价口碑与地域差异：结合 top_local_reviews 与 top_global_reviews，比较不同国家/地区用户反馈，选品、文案优化和本地化运营。
跟踪新版替代商品：通过 is_newer_model_available 和 newer_model 判断旧款是否被新型号替代，帮助维护商品生命周期与投放策略。
提取商品富资产：获取商品图片、视频、扩展说明和类目路径，用于沉淀电商报数据，支持分析、竞品研究和结构化建库。

获取 Amazon ASIN 高级结果（按任务 ID） ​

接口说明 ​

路径参数 ​

返回结构 ​

顶层字段 ​

tasks 数组字段 ​

result 数组字段 ​

item_types 可能值 ​

items 数组字段 ​

rating 对象字段 ​

applicable_vouchers 字段说明 ​

newer_model 字段说明 ​

categories 字段说明 ​

product_information 字段说明 ​

扩展信息区块：product_information_extended_item ​

contents 中的 product_information_rows ​

rows 可能类型 ​

文本行：product_information_text_row ​

图片行：product_information_image_row ​

视频行：product_information_video_row ​

明细区块：product_information_details_item ​

评论字段说明 ​

评论图片 images ​

评论视频 videos ​

user_profile 字段 ​

评论评分 rating ​

沙箱测试 ​

请求示例 ​

curl ​

Python ​

TypeScript ​

结合 tasks_ready 获取已完成任务 ​