Amazon 商品竞品分析（Product Competitors）实时接口

接口说明

该接口用于返回与目标 asin 在 Amazon 搜索结果中存在交集的商品列表。你可以基于这些数据识别某个 Amazon 商品页的直接竞品。

返回结果与以下参数强：

• asin
• location
• language

也就是说，同一个商品在不同国家/地区、不同语言环境下，竞品结果可能不同。

数据更新频率

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

请求方式

POST https://api.seermartech.cn/v3/dataforseo_labs/amazon/product_competitors/live

计费说明

该接口按请求计费。

原文未提供固定单价，因此无法直接换算参考人民币价格。扣费以响应头 X-SeerMarTech-Charge-CNY 为准。

调用限制

• 每分钟最多 2000 次 API 调用
• 最多 30 个并发请求
• POST 请求体需使用 UTF-8 编码的 JSON
• 请求体格式为 JSON 数组：[{ ... }]

---

请求参数

以下为任务设置参数说明。

字段名	类型	说明
asin	string	商品 ID，填。Amazon 商品的唯一标识符（ASIN）。可通过商品查询接口获取。
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
limit	integer	返回结果中商品数量上限。可选，默认 100，最大 1000。
filters	array	结果过滤条件。可选。最多支持 8 个过滤条件，条件之间需使用逻辑运算符 and / or 连接。
order_by	array	排序规则。可选。支持使用与 filters 相同的字段进行排序。单次请求最多设置 3 条排序规则。
offset	integer	结果偏移量。可选，默认 0。例如设置为 10 时，将跳过前 10 个竞品，从后续结果开始返回。
tag	string	自定义任务标识。可选，最长 255 个字符。可用于将响应结果与业务任务，返回时会出现在响应的 data 对象中。

filters 支持的运算符

支持以下运算符：

• regex
• not_regex
• <
• <=
• >
• >=
• =
• <>
• in
• not_in
• ilike
• not_ilike
• like
• not_like
• match
• not_match

说明：

• like / not_like
• ilike / not_ilike

以上运算符支持使用 % 作为通符，匹任意长度字符（ 0 个字符）。

更多过滤语法可参考 /v3/dataforseo_labs/filters。

order_by 排序说明

排序方向支持：

• asc：升序
• desc：降序

多个排序规则之间使用逗号分隔。

---

返回结果说明

接口返回 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	任务结果数组

任务级字段

字段名	类型	说明
id	string	任务唯一标识，UUID 格式
status_code	integer	任务状态码，范围通常为 10000-60000
status_message	string	任务状态信息
time	string	任务执行耗时，单位秒
cost	float	当前任务成本，单位 USD
result_count	integer	result 数组中的数量
path	array	请求路径
data	object	与请求中提交参数一致的对象
result	array	实结果数组

result 字段说明

字段名	类型	说明
se_type	string	搜索引擎类型
asin	string	请求中的目标 ASIN
location_code	integer	请求中的地区编码；如无数据则为 null
language_code	string	请求中的语言代码；如无数据则为 null
total_count	integer	数据库中与本次请求匹的总结果数
items_count	integer	当前 items 数组返回的结果数量
items	array	识别出的 Amazon 竞品列表及数据

items 字段说明

字段名	类型	说明
se_type	string	搜索引擎类型
asin	string	竞品商品的 ASIN
avg_position	float	商品在 Amazon SERP 中的平均排名。注意：基于与目标商品存在交集的计算，因此同一商品相对于不同目标商品时，该值可能不同。
sum_position	integer	商品在 Amazon SERP 中的排名总和。注意：基于交集计算。
intersections	integer	与目标商品发生交集的数量
competitor_metrics	object	基于交集计算的竞品指标。这里的排名数据对应返回的竞品 ASIN。
full_metrics	object	基于该商品排名计算的完整指标概览。

competitor_metrics / full_metrics 结构

这两个对象结构一致，分别自然结果与广告结果中的排名统计。

amazon_serp

字段名	类型	说明
pos_1	integer	排名第 1 的自然结果次数
pos_2_3	integer	排名第 2-3 位的自然结果次数
pos_4_10	integer	排名第 4-10 位的自然结果次数
pos_11_100	integer	排名第 11-100 位的自然结果次数
count	integer	该商品出现在 Amazon 自然结果中的总次数
search_volume	integer	对应自然排名的总搜索量

amazon_paid

字段名	类型	说明
pos_1	integer	排名第 1 的广告结果次数
pos_2_3	integer	排名第 2-3 位的广告结果次数
pos_4_10	integer	排名第 4-10 位的广告结果次数
pos_11_100	integer	排名第 11-100 位的广告结果次数
count	integer	该商品出现在 Amazon 广告结果中的总次数
search_volume	integer	对应广告排名的总搜索量

---

请求示例

cURL

curl --location --request POST "https://api.seermartech.cn/v3/dataforseo_labs/amazon/product_competitors/live" \
--header "Authorization: Bearer smt_live_YOUR_KEY" \
--header "Content-Type: application/json" \
--data-raw '[
 {
 "asin": "019005476X",
 "language_name": "English",
 "location_code": 2840,
 "limit": 5
 }
]'

Python

import requests

url = "https://api.seermartech.cn/v3/dataforseo_labs/amazon/product_competitors/live"
headers = {
 "Authorization": "Bearer smt_live_YOUR_KEY",
 "Content-Type": "application/json"
}
data = [
 {
 "asin": "019005476X",
 "location_name": "United States",
 "language_name": "English",
 "limit": 5
 }
]

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

TypeScript

import axios from "axios";

const postData = [
 {
 asin: "019005476X",
 language_name: "English",
 location_code: 2840,
 limit: 5
 }
];

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

---

响应示例

原始文档中的示例响应存在截断，这里保留已知结构并按标准 JSON 形式整理。

{
 "version": "0.1.20220216",
 "status_code": 20000,
 "status_message": "Ok.",
 "time": "0.8135 sec.",
 "cost": 0.0105,
 "tasks_count": 1,
 "tasks_error": 0,
 "tasks": [
 {
 "data": {
 "api": "dataforseo_labs",
 "function": "product_competitors",
 "se_type": "amazon",
 "asin": "019005476X",
 "language_name": "English",
 "location_code": 2840,
 "limit": 5
 },
 "result": [
 {
 }
 ]
 }
 ]
}

---

状态码与错误处理

• 顶层 status_code 表示整次请求的处理状态
• 任务级 status_code 表示单个任务的执行状态
• 建议业务系统同时校验：
• HTTP 状态码
• 顶层 status_code
• tasks[].status_code

常见成功状态：

• 20000：成功

完整错误码体系可参考 /v3/appendix/errors。建议在接时设计完善的异常处理机制，例如：

• 认证失败
• 参数缺失或格式错误 -出并发/频率限制
• 平台数据暂不可用

---

使用建议

1. 优使用 location_code 和 language_code，便于程序稳定处理。
2. 当需要分页拉取更多竞品时，可结合 limit + offset 使用。
3. 若要筛选高重合度竞品，可对 intersections、avg_position、search_volume 等字段设置 filters。
4. 若要优查看核心竞争对手，可按 intersections desc 或 avg_position asc 排序。
5. competitor_metrics 适合分析与目标商品的直接竞争强度，full_metrics 适合评估竞品整体搜索表现。

实用场景

• 识别直接竞品：目标 ASIN，找出与搜索词最多的商品，快速定位真实搜索竞争对手。
• 筛选高威胁商品：结合 intersections、avg_position 与 amazon_paid 数据，识别同时在自然位和广告位表现强势的竞品。
• 制定广告拦截策略：分析竞品在 amazon_paid 中的覆盖范围和搜索量，判断是否需要针对重叠词加大投放。
• 评估市场拥挤度：通过竞品数量、交集规模和排名分布，判断某个 ASIN 所处细分类目的竞争激烈程度。
• 监控Listing优化效果：定期查询同一 ASIN 的竞品变化，观察优化标题、要点或广告策略后，搜索竞争格局是否发生变化。