查竞品
按关键词或精确 ASIN 列表查询 Amazon 竞品,返回商品、销量、价格、评分和 Listing 数据。
API 数据样例
直接查看该接口实际使用的请求体和完整响应结构。
{
"marketplace": "US",
"keyword": "wireless charger",
"match_type": "broad",
"include_variations": false,
"page": 1,
"size": 20
}{
"request_id": "8fb43e59-4ff9-4dc8-a4b7-2ed164e45ab8",
"data": {
"guestId": null,
"pages": 8644,
"page": 1,
"size": 1,
"total": 8644,
"took": 754,
"url": null,
"order": {
"field": "",
"desc": true
},
"items": [
{
"asin": "B0DGVP84B5",
"brand": "Apple",
"brandUrl": "https://www.amazon.com/s?k=Apple",
"imageUrl": "https://images-na.ssl-images-amazon.com/images/I/61886B78v4L._AC_US200_.jpg",
"title": "Apple Watch Series 10 [GPS + Cellular 46mm] with Natural Titanium Case with Stone Grey Sport Band - S/M. Fitness Tracker, ECG App, Always-On Retina Display, Water Resistant with AppleCare+ (2 Years)",
"parent": "B0FH2CCLPX",
"nodeLabelPath": null,
"nodeIdPath": null,
"nodeId": null,
"bsrId": null,
"bsr": 4,
"bsrCv": -3,
"bsrCr": -300,
"amzUnit": null,
"amzUnitDate": null,
"amzSales": null,
"units": 167539,
"unitsGr": null,
"revenue": 123276872,
"price": 728.99,
"averagePrice": 735.81,
"primePrice": -1,
"profit": 98.52,
"fba": 10.75,
"ratings": 8707,
"ratingsRate": 0.66,
"rating": 4.7,
"ratingsCv": 1103,
"ratingDelta": 0,
"availableDate": 1726012800000,
"fulfillment": "AMZ",
"variations": 84,
"sellers": 1,
"sellerName": "Amazon",
"sellerId": null,
"sellerNation": "US",
"lqs": null,
"weight": "4.8 ounces",
"dimension": "24 x 7.7 x 3 inches",
"pkgDimensions": null,
"pkgDimensionType": null,
"pkgWeight": null,
"sku": "Color: Natural Titanium Case with Stone Grey Sport Band | Size: 46mm case + Small/Medium band | Style: GPS + Cellular | Configuration: With AppleCare+ (2 Years)",
"dimensionsType": "LB",
"deliveryPrice": -1,
"badge": {
"bestSeller": "#1 Best Seller in Smartwatches",
"amazonChoice": "N",
"newRelease": "N",
"ebc": "Y",
"video": "Y"
},
"subcategories": [
{
"code": "14130292011",
"rank": 1,
"label": "Smartwatches"
}
]
}
],
"terminal": null,
"hasNextPage": null,
"guestVisited": false
}
}可用状态:已开放
该接口已进入 v1 网关、OpenAPI 和订阅权限目录,成功调用一次消耗 1 个计费单位。
POST /v1/amazon/product/competitor-lookup
下方请求和响应字段已与当前公开契约核对。
接口对应关系
| 项目 | 内容 |
|---|---|
| MCP Code | competitor_lookup |
| 原始 REST 方法 | POST |
| 原始 REST 路径 | /v1/product/competitor-lookup |
| 原始 API 文档 | 打开官方 API 文档 |
历史路径仍可调用,但已弃用:
/v1/amazon/products/search。兼容请求会返回Deprecation: true和指向规范路径的Link响应头。
快速调用
先创建 API 密钥,再将密钥写入服务端环境变量:
export ECOMMERCE_DATA_API_KEY="your_api_key"curl --request POST \
--url https://ecommercedataapi.com/v1/amazon/product/competitor-lookup \
--header "Content-Type: application/json" \
--header "X-API-Key: ${ECOMMERCE_DATA_API_KEY}" \
--data '{
"marketplace": "US",
"keyword": "wireless charger",
"match_type": "broad",
"include_variations": false,
"page": 1,
"size": 20
}'使用 AI CLI 接入
复制给 AI CLI
粘贴到 Codex、Claude Code、Gemini CLI 或其他编程智能体中直接完成接入。
请直接在当前代码库中接入 Ecommerce Data API 的「查竞品」接口,不要只给示例代码。
接口文档:https://ecommercedataapi.com/zh/docs/amazon/product/competitor-lookup
请求接口:POST https://ecommercedataapi.com/v1/amazon/product/competitor-lookup
API 密钥环境变量:ECOMMERCE_DATA_API_KEY
请求示例:
{
"marketplace": "US",
"keyword": "wireless charger",
"match_type": "broad",
"include_variations": false,
"page": 1,
"size": 20
}
请按以下要求执行:
1. 先阅读接口文档,并检查当前项目使用的语言、框架、HTTP 客户端、目录结构和环境变量约定。
2. 优先复用项目现有的 API 客户端和错误处理方式;如果没有,再创建最小可复用的 Ecommerce Data API 客户端与该接口调用封装。
3. 从服务端环境变量 ECOMMERCE_DATA_API_KEY 读取密钥,发送 Content-Type: application/json 和 X-API-Key 请求头。绝不能把真实密钥写入源码、前端代码、日志、测试快照或 Git。
4. 如果环境变量不存在,提示我自行设置 ECOMMERCE_DATA_API_KEY;不要索取、输出或猜测真实密钥,并继续完成不依赖真实请求的代码与测试。
5. 根据接口文档实现请求与响应类型,处理非 2xx 响应、request_id、error.code、error.message 和 429 限流。
6. 添加一个符合当前项目习惯的最小调用示例或测试。如果密钥已配置且当前环境允许外部请求,再执行一次最小真实调用;否则使用 mock 或静态验证。
7. 运行相关格式化、类型检查和测试,最后汇报修改文件、调用方法、验证结果以及仍需我配置的环境变量。还没有 API 密钥?创建 API 密钥
在 Postman 中打开当前请求
下载当前接口的预配置 Collection,再通过 Postman Import 导入。
导入后在 Collection Variables 中填写 apiKey。创建 API 密钥
Node.js 示例
const response = await fetch(
'https://ecommercedataapi.com/v1/amazon/product/competitor-lookup',
{
method: 'POST',
headers: {
'Content-Type': 'application/json',
'X-API-Key': process.env.ECOMMERCE_DATA_API_KEY,
},
body: JSON.stringify({
marketplace: 'US',
keyword: 'wireless charger',
match_type: 'broad',
include_variations: false,
page: 1,
size: 20,
}),
}
);
const result = await response.json();
if (!response.ok) {
throw new Error(`${result.error?.code}: ${result.error?.message}`);
}
console.log(result.data);Python 示例
import os
import requests
response = requests.post(
"https://ecommercedataapi.com/v1/amazon/product/competitor-lookup",
headers={
"Content-Type": "application/json",
"X-API-Key": os.environ["ECOMMERCE_DATA_API_KEY"],
},
json={
"marketplace": "US",
"keyword": "wireless charger",
"match_type": "broad",
"include_variations": False,
"page": 1,
"size": 20,
},
timeout=30,
)
response.raise_for_status()
print(response.json()["data"])请求参数
请求体直接发送下表字段,不要再包裹额外对象;未定义字段会被拒绝。
必须且只能传入 keyword 或 asins 其中一个。
| 字段 | 类型 | 必填 | 说明 | 示例 |
|---|---|---|---|---|
marketplace | 字符串 | 否 | 市场编码 支持的市场编码见 OpenAPI 枚举 可选值:US、UK、DE、FR、IT、ES、MX、CA、AU、JP、IN、AE、BR。 默认值:"US"。 | US |
keyword | 字符串 | 否 | 关键字 | wireless charger |
asins | 数组 | 否 | asin 的 list 字符串 最多支持40个ASIN 至少 1 项。 最多 40 项。 | ["B08CK5Z5Q1"] |
match_type | 字符串 | 否 | 关键词匹配方式 1:词组匹配,2:模糊匹配,3:精准匹配;默认:2 可选值:broad、phrase、exact。 默认值:"broad"。 | 1:词组匹配,2:模糊匹配,3:精准匹配;默认:2 |
include_variations | 布尔值 | 否 | 是否查询变体ASIN N: 含变体, Y: 不含变体 默认值:false。 | false |
page | 整数 | 否 | 页码 默认: 1 默认值:1。 最小值:1。 最大值:100。 | 1 |
size | 整数 | 否 | 每页条数 默认:50,最大: 100 默认值:50。 最小值:1。 最大值:200。 | 50 |
返回结构
| 字段 | 类型 | 说明 |
|---|---|---|
request_id | 字符串 | 本次请求的唯一标识。 |
data | 对象 | 接口业务数据。 |
下表字段位于 data 内。数组接口描述的是单个数组元素,分页接口描述的是 items[] 中的单条记录。
返回字段
| 字段 | 类型 | 说明 | 示例 |
|---|---|---|---|
asin | 字符串 | asin | B078J8VPVW |
brand | 字符串 | 品牌 | Pampers |
brandUrl | 字符串 | 品牌 URL | https://www.amazon.com/s?k=HP |
imageUrl | 字符串 | 图片 URL | https://images-na.ssl-images-amazon.com/images/I/51axlzme6aL .AC_US200.jpg |
title | 字符串 | 商品标题 | Diapers Size …… |
parent | 字符串 | 父体 | B081RGNL17 |
nodeId | 整数 | 节点 id | 3741281 |
nodeIdPath | 字符串 | 节点 id 路径字符串 | 2619525011:3741271:3741281 |
nodeLabelPath | 字符串 | 类目 | Baby Products:Diapering:Disposable Diapers |
symbol | 字符串 | 是否畅销 | Y |
bsrId | 字符串 | BSRid | office-products |
bsr | 整数 | BSR 排名 | 1 |
bsrCr | 数字 | BSR 增长率 | 926.67 |
bsrCv | 整数 | BSR 增长数 | 10 |
units | 整数 | 月销量(父体) | 26289 |
unitsGr | 数字 | 月销量增长率(父体) | -46.3 |
amzUnit | 整数 | 子体近30日销量 | 4000 |
amzSales | 数字 | 销售额(子体) | 235000 |
amzUnitDate | 整数 | 子体销量更新日期 | 1702476590000 |
revenue | 数字 | 月销售额(父体) | 1693537.4 |
price | 数字 | 价格 | 64.42 |
primePrice | 数字 | prime价格,-1表示没有 | 42 |
profit | 数字 | 利润率 | 63.92 |
fba | 数字 | fba 运费 | 13.58 |
ratings | 整数 | 评分数 | 32004 |
ratingsRate | 数字 | 留评率 | 40.57 |
rating | 数字 | 评分 | 4.8 |
ratingsCv | 整数 | 月度增长数 | 10666 |
ratingDelta | 整数 | 留评数:近 30 天新增评论数 | 0 |
lqs | 数字 | listing质量得分 | - |
availableDate | 整数 | 上架时间 | 1454083200000 |
fulfillment | 字符串 | 配送方式 | AMZ or FBA or FBM |
variations | 整数 | 变体数 | 7 |
sellers | 整数 | 卖家数 | 7 |
sellerId | 字符串 | BuyBox 卖家 id | A1Y8BVAASXO4R7 |
sellerName | 字符串 | BuyBox 卖家 | Amazon |
sellerNation | 字符串 | BuyBox 卖家国籍 | 见表 1.5 |
badge | 对象 | 标识 | 包括了下面 5 个标识 |
badge.bestSeller | 字符串 | Best Seller 标识 | Y / N |
badge.amazonChoice | 字符串 | amazon choice 标识 | Y / N |
badge.newRelease | 字符串 | release 标识 | Y / N |
badge.ebc | 字符串 | A+页面 | Y / N |
badge.video | 字符串 | 视频介绍 | Y / N |
weight | 字符串 | 重量 | 8.88 pounds |
dimension | 字符串 | 尺寸 | 13.3 x 15.8 x 10.6 inches |
dimensionsType | 字符串 | 尺寸类型 | ST,0V |
pkgDimensions | 字符串 | 包装尺寸 | 14.3 x 16.8 x 12.6 inches |
pkgDimensionType | 字符串 | 包装尺寸类型 | - |
pkgWeight | 字符串 | 包装重量 | 18.88 pounds |
sku | 字符串 | sku | ["Color: Beige","Size: 47 inches"] |
subcategories | 数组 | 子类目 | - |
subcategories.code | 字符串 | 类目code | 1063242 |
subcategories.rank | 整数 | 排名 | 1 |
subcategories.label | 字符串 | 名称 | Bath Rugs |
deliveryPrice | 数字 | 卖家运费,-1表示没有 | 4 |
返回示例
{
"request_id": "8fb43e59-4ff9-4dc8-a4b7-2ed164e45ab8",
"data": {
"guestId": null,
"pages": 8644,
"page": 1,
"size": 1,
"total": 8644,
"took": 754,
"url": null,
"order": {
"field": "",
"desc": true
},
"items": [
{
"asin": "B0DGVP84B5",
"brand": "Apple",
"brandUrl": "https://www.amazon.com/s?k=Apple",
"imageUrl": "https://images-na.ssl-images-amazon.com/images/I/61886B78v4L._AC_US200_.jpg",
"title": "Apple Watch Series 10 [GPS + Cellular 46mm] with Natural Titanium Case with Stone Grey Sport Band - S/M. Fitness Tracker, ECG App, Always-On Retina Display, Water Resistant with AppleCare+ (2 Years)",
"parent": "B0FH2CCLPX",
"nodeLabelPath": null,
"nodeIdPath": null,
"nodeId": null,
"bsrId": null,
"bsr": 4,
"bsrCv": -3,
"bsrCr": -300,
"amzUnit": null,
"amzUnitDate": null,
"amzSales": null,
"units": 167539,
"unitsGr": null,
"revenue": 123276872,
"price": 728.99,
"averagePrice": 735.81,
"primePrice": -1,
"profit": 98.52,
"fba": 10.75,
"ratings": 8707,
"ratingsRate": 0.66,
"rating": 4.7,
"ratingsCv": 1103,
"ratingDelta": 0,
"availableDate": 1726012800000,
"fulfillment": "AMZ",
"variations": 84,
"sellers": 1,
"sellerName": "Amazon",
"sellerId": null,
"sellerNation": "US",
"lqs": null,
"weight": "4.8 ounces",
"dimension": "24 x 7.7 x 3 inches",
"pkgDimensions": null,
"pkgDimensionType": null,
"pkgWeight": null,
"sku": "Color: Natural Titanium Case with Stone Grey Sport Band | Size: 46mm case + Small/Medium band | Style: GPS + Cellular | Configuration: With AppleCare+ (2 Years)",
"dimensionsType": "LB",
"deliveryPrice": -1,
"badge": {
"bestSeller": "#1 Best Seller in Smartwatches",
"amazonChoice": "N",
"newRelease": "N",
"ebc": "Y",
"video": "Y"
},
"subcategories": [
{
"code": "14130292011",
"rank": 1,
"label": "Smartwatches"
}
]
}
],
"terminal": null,
"hasNextPage": null,
"guestVisited": false
}
}错误响应、请求追踪和限流头说明见错误与限流。