Amazon 商品排名概览（实时）

POST /v3/dataforseo_labs/amazon/product_rank_overview/live

接口说明

该接口用于获取目标商品在 Amazon 自然结果与广告结果中的排名概览数据。返回结果针对请求中传的 asins 生效，可用于批量分析指定商品的排名分布。

数据按周更新，最新更新时间可通过 /v3/dataforseo_labs/status/ 查询。

• 请求方式：POST
• 接口地址：https://api.seermartech.cn/v3/dataforseo_labs/amazon/product_rank_overview/live
• 请求体格式：JSON 数组 [{ ... }]
• 调用频率：最高 2000 次/分钟
• 最大并发：30
• 计费说明：按请求计费，扣费以响应头 X-SeerMarTech-Charge-CNY 为准

请求参数

以下为单个任务对象支持的字段说明。

字段名	类型	说明
asins	array	需要查询排名数据的商品 ID 列表。填。最多可传 1000 个 ASIN。ASIN 中所有字母为大写。示例：["B01LW2SL7R"]
location_name	string	地区名。未传 location_code 时填。可通过 /v3/dataforseo_labs/locations_and_languages 获取支持的地区列表。当前支持：美国、埃及、沙特阿拉伯、阿联。示例：United States
location_code	integer	地区编码。未传 location_name 时填。可通过 /v3/dataforseo_labs/locations_and_languages 获取。当前支持：美国、埃及、沙特阿拉伯、阿联。示例：2840
language_name	string	语言名。未传 language_code 时填。可通过 /v3/dataforseo_labs/locations_and_languages 获取。示例：English
language_code	string	语言代码。未传 language_name 时填。可通过 /v3/dataforseo_labs/locations_and_languages 获取。示例：en
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	任务唯一标识，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[] 字段

字段名	类型	说明
se_type	string	搜索引擎类型
location_code	integer	请求中的地区编码；如无数据则为 null
language_code	string	请求中的语言代码；如无数据则为 null
total_count	integer	数据库中与请求的结果总量
items_count	integer	items 数组中的返回条数
items	array	商品排名概览数据

items[] 字段

字段名	类型	说明
se_type	string	搜索引擎类型
asin	string	商品的 ASIN 标识
metrics	object	商品平均排名数据
amazon_serp	object	Amazon 自然搜索结果中的排名数据
amazon_paid	object	Amazon 广告搜索结果中的排名数据

amazon_serp / amazon_paid 字段

自然结果与广告结果对象字段结构一致：

字段名	类型	说明
pos_1	integer	排名第 1 位的 SERP 数量
pos_2_3	integer	排名第 2-3 位的 SERP 数量
pos_4_10	integer	排名第 4-10 位的 SERP 数量
pos_11_100	integer	排名第 11-100 位的 SERP 数量
count	integer	含该商品的 SERP 总数
search_volume	integer	对应排名的总搜索量

请求示例

cURL

curl --location --request POST "https://api.seermartech.cn/v3/dataforseo_labs/amazon/product_rank_overview/live" \
--header "Authorization: Bearer smt_live_YOUR_KEY" \
--header "Content-Type: application/json" \
--data-raw '[
 {
 "asins": [
 "B001TJ3HUG",
 "B01LW2SL7R"
 ],
 "language_name": "English",
 "location_code": 2840
 }
]'

Python

import requests

url = "https://api.seermartech.cn/v3/dataforseo_labs/amazon/product_rank_overview/live"
headers = {
 "Authorization": "Bearer smt_live_YOUR_KEY",
 "Content-Type": "application/json"
}
data = [
 {
 "asins": [
 "B001TJ3HUG",
 "B01LW2SL7R"
 ],
 "location_name": "United States",
 "language_name": "English"
 }
]

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

TypeScript

import axios from "axios";

const postArray = [
 {
 asins: ["B001TJ3HUG", "B01LW2SL7R"],
 language_name: "English",
 location_code: 2840
 }
];

axios({
 method: "post",
 url: "https://api.seermartech.cn/v3/dataforseo_labs/amazon/product_rank_overview/live",
 headers: {
 Authorization: "Bearer smt_live_YOUR_KEY",
 "Content-Type": "application/json"
 },
 data: postArray
})
 .then((response) => {
 // 处理返回结果
 console.log(response.data);
 })
 .catch((error) => {
 console.error(error);
 });

响应示例

{
 "version": "0.1.20220216",
 "status_code": 20000,
 "status_message": "Ok.",
 "time": "0.1460 sec.",
 "cost": 0.0102,
 "tasks_count": 1,
 "tasks_error": 0,
 "tasks": [
 {
 "data": {
 "api": "dataforseo_labs",
 "function": "product_rank_overview",
 "se_type": "amazon",
 "language_name": "English",
 "location_code": 2840,
 "asins": [
 "B001TJ3HUG",
 "B01LW2SL7R"
 ]
 },
 "result": [
 {}
 ]
 }
 ]
}

状态码与错误处理

• 20000：请求成功
• 状态码：表示请求参数错误、认证失败、额度不足或处理异常等

建议在接时同时处理两层状态：

1. 顶层 status_code：判断整个请求是否成功
2. tasks[].status_code：判断每个任务是否成功

完整错误码说明请参考 /v3/appendix/errors。

使用说明

• asins 最多支持 1000 个值，适合批量对比多个商品的排名表现
• ASIN 中的字母大写
• 地区支持美国、埃及、沙特阿拉伯、阿联
• 若同时传 location_name 和 location_code，建议优保持二一致
• 若无结果，location_code 或 language_code 可能返回 null

实用场景

• 对比竞品排名分布：批量传自家与竞品 ASIN，快速判断谁在更多下占据前 1、前 3、前 10 位置。
• 评估广告与自然流量结构：分别查看 amazon_serp 与 amazon_paid 数据，识别商品更依赖自然排名还是广告。
• 筛选高潜力商品：结合 search_volume 与排名区间分布，优找出已备搜索需求但仍有提升空间的商品。
• 监控市场地区表现：按不同国家站点查询同一批 ASIN，比较商品在不同市场的搜索差异。
• 支持选品与投放决策：根据商品在自然与付费结果中的覆盖，判断是否需要加强 Listing 优化或增加广告预算。