亚马逊 ASIN 实时高级查询

接口说明

该接口用于获取某个商品下不同变体/修改版本对应的完整 ASIN 列表，并返回更丰富的商品信息，例如价格区间、评分、优惠券、分类、商品信息、评论等。

请求方式： POST接口地址： https://api.seermartech.cn/v3/merchant/amazon/asin/live/advanced

计费说明

该接口按任务提交计费在成功设置任务时扣费。

参考价约 ¥0.0480 / 次扣费以响应头 X-SeerMarTech-Charge-CNY 为准。

请求规则

所有 POST 数据使用 JSON（UTF-8 编码）
请求体格式为 JSON 数组：[{ ... }]
每次 Live 请求支持 1 个任务
频率上限：2000 次 API 调用/分钟

请求参数

任务级参数

字段	类型	说明
`asin`	string	商品唯一标识（Amazon ASIN）。填。可通过 `/v3/merchant/amazon/products/task_post/` 获取。
`location_name`	string	搜索位置完整名称。未传 `location_code` 或 `location_coordinate` 时填。传该字段后无需传另外两个位置字段。示例：`HA1,England,United Kingdom`
`location_code`	integer	搜索位置编码。未传 `location_name` 或 `location_coordinate` 时填。传该字段后无需传另外两个位置字段。可通过 `/v3/merchant/amazon/locations` 获取。示例：`9045969`
`location_coordinate`	string	GPS 坐标。未传 `location_name` 或 `location_code` 时填。格式：`latitude,longitude,radius`。经纬度最多 7 位小数，`radius` 最小值为 `199.9`。示例：`53.476225,-2.243572,200`
`language_name`	string	搜索语言完整名称。未传 `language_code` 时填。传该字段后无需传 `language_code`。可通过 `/v3/merchant/amazon/languages` 获取。示例：`English (United Kingdom)`
`language_code`	string	搜索语言编码。未传 `language_name` 时填。可通过 `/v3/merchant/amazon/languages` 获取。示例：`en_GB`
`se_domain`	string	搜索域名。可选。默认会根据位置和语言自动匹，也可手动指定，例如：`amazon.com`、`amazon.co.uk`、`amazon.fr`
`tag`	string	自定义任务标识。可选，最长 255 个字符。便于将响应结果与业务侧任务对应。返回时会出现在响应的 `data` 对象中。

返回结果说明

接口返回 JSON最外层 tasks 数组。

顶层字段

字段	类型	说明
`version`	string	当前 API 版本
`status_code`	integer	通用状态码。完整列表参考 `/v3/appendix/errors`
`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	商品结果数组

`items[]` 字段说明

items 中的类型为 amazon_product_info。

字段	类型	说明
`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 格式，例如 `USD`
`is_amazon_choice`	boolean	是否带有 “Amazon's choice” 标识
`is_newer_model_available`	boolean	是否存在更新型号
`is_prime_video`	boolean	是否属于 Amazon Prime Video 商品
`applicable_vouchers`	array	可用优惠券信息
`newer_model`	object	更新型号信息
`categories`	array	商品分类
`product_information`	array	商品详细信息区块
`product_images_list`	array	商品图片列表
`product_videos_list`	array	商品视频列表
`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	评分值
`votes_count`	integer	评论/投票数量
`rating_max`	string	当前评分体系下的最大值

优惠券对象 `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[]`

该字段用于承载页面中的扩展商品信息，可能多个区块与类型。

区块类型 1：`product_information_extended_item`

字段	类型	说明
`type`	string	固定为 `product_information_extended_item`
`section_name`	string	信息区块名称
`contents`	array	区块数组

`contents[]`

字段	类型	说明
`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

区块类型 2：`product_information_details_item`

字段	类型	说明
`type`	string	固定为 `product_information_details_item`
`section_name`	string	信息区块名称
`body`	object	区块主体

评论对象

top_local_reviews 与 top_global_reviews 结构一致，类型均为 amazon_review_item。

字段	类型	说明
`type`	string	素类型，固定为 `amazon_review_item`
`rank_group`	integer	同类型评论组排名
`rank_absolute`	integer	评论绝对排名
`position`	string	页面位置，通常为 `right`
`xpath`	string	评论 XPath
`verified`	boolean	是否带有 “Verified Purchase” 标记
`subtitle`	string	评论副标题
`helpful_votes`	integer	有帮助投票数
`images`	array	评论中附带的图片
`videos`	array	评论中附带的视频
`user_profile`	object	评论资料
`title`	string	评论标题
`url`	string	评论链接
`review_text`	string	评论正文
`publication_date`	string	评论发布时间，UTC 格式
`rating`	object	评论评分对象

评论图片对象 `images[]`

字段	类型	说明
`type`	string	固定为 `images_element`
`alt`	string	图片 alt 文本
`url`	string	图片页面地址
`image_url`	string	评论展示图片地址

评论视频对象 `videos[]`

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

评论对象 `user_profile`

字段	类型	说明
`name`	string	用户名
`avatar`	string	头像地址
`url`	string	用户主页地址
`reviews_count`	integer	用户评论数
`locations`	string	用户位置
`title`	string	用户标题信息

评论评分对象 `rating`

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

请求示例

cURL

bash

curl --location --request POST "https://api.seermartech.cn/v3/merchant/amazon/asin/live/advanced" \
--header "Authorization: Bearer smt_live_YOUR_KEY" \
--header "Content-Type: application/json" \
--data-raw '[
 {
 "location_name": "United States",
 "language_name": "English (United States)",
 "asin": "B0756FCPPN"
 }
]'

Python

python

import requests

url = "https://api.seermartech.cn/v3/merchant/amazon/asin/live/advanced"
headers = {
 "Authorization": "Bearer smt_live_YOUR_KEY",
 "Content-Type": "application/json"
}
data = [
 {
 "location_name": "United States",
 "language_name": "English (United States)",
 "asin": "B0756FCPPN"
 }
]

response = requests.post(url, json=data, headers=headers)
print(response.json)

TypeScript

typescript

import axios from "axios";

async function main {
 const response = await axios.post(
 "https://api.seermartech.cn/v3/merchant/amazon/asin/live/advanced",
 [
 {
 location_name: "United States",
 language_name: "English (United States)",
 asin: "B0756FCPPN",
 },
 ],
 {
 headers: {
 Authorization: "Bearer smt_live_YOUR_KEY",
 "Content-Type": "application/json",
 },
 }
 );

 // 输出接口响应
 console.log(response.data);
}

main.catch(console.error);

响应示例

json

{
 "version": "0.1.20200416",
 "status_code": 20000,
 "status_message": "Ok.",
 "time": "0.0998 sec.",
 "cost": 0.003,
 "tasks_count": 1,
 "tasks_error": 0,
 "tasks": [
 {
 "data": {
 "api": "merchant",
 "function": "asin",
 "se": "amazon",
 "language_code": "en_US",
 "location_code": 2840,
 "asin": "B0756FCPPN",
 "priority": 2,
 "se_type": "shopping",
 "device": "desktop",
 "os": "windows"
 },
 "result": null
 }
 ]
}

错误处理

建议对以下层级分别进行错误处理：

HTTP 状态码

检查接口是否成功接收请求

顶层状态码 status_code

20000 表示请求成功
状态请结合 /v3/appendix/errors 处理

任务级状态码 tasks[].status_code

单个任务可能失败，即使顶层请求成功
建议逐个检查任务状态并记录失败原因

常见处理建议：

缺少填参数时，检查 asin、位置参数、语言参数
若传了 location_name，无需再传 location_code 或 location_coordinate
若传了 language_name，无需再传 language_code
对 result 为 null 的，建议结合任务级状态码和状态信息重试或排查参数

实用场景

识别商品变体 ASIN：提取一个父商品下的 product_asins，用于变体归并、颜色/规格映射和选品库标准化。
监控商品页变化：定期抓取标题、价格区间、库存状态、优惠券与描述信息，及时发现商品信息变更并支持竞品跟踪。
分析评论口碑结构：读取本地与热门评论，提炼高频好评点、差评点和购买验证，为优化和产品改进提供依据。
识别新旧型号替代：通过 is_newer_model_available 与 newer_model 判断产品是否已被新版替代，投放、选品和库存策略调整。
构建类目与属性画像：利用 categories、product_information、评分和价格字段，建立商品属性标签体系，支持 SEO生成与电商数据分析。

亚马逊 ASIN 实时高级查询 ​

接口说明 ​

计费说明 ​

请求规则 ​

请求参数 ​

任务级参数 ​

返回结果说明 ​

顶层字段 ​

tasks[] 字段 ​

result[] 结果字段 ​

items[] 字段说明 ​

评分对象 rating ​

优惠券对象 applicable_vouchers[] ​

更新型号对象 newer_model ​

分类对象 categories[] ​

商品信息对象 product_information[] ​

区块类型 1：product_information_extended_item ​

contents[] ​

rows[] 可能类型 ​

区块类型 2：product_information_details_item ​

评论对象 ​

评论图片对象 images[] ​

评论视频对象 videos[] ​

评论对象 user_profile ​

评论评分对象 rating ​

请求示例 ​

cURL ​

Python ​

TypeScript ​

响应示例 ​

错误处理 ​

实用场景 ​