选市场-统计
获取 Amazon 类目市场的核心统计指标。
API 数据样例
直接查看该接口实际使用的请求体和完整响应结构。
{
"marketplace": "US",
"nodeIdPath": "172282:281407"
}{
"request_id": "8fb43e59-4ff9-4dc8-a4b7-2ed164e45ab8",
"data": {
"marketplace": "US",
"nodeIdPath": "172282:281407",
"nodeLabelPath": "Electronics:Accessories & Supplies",
"nodeLabelPathLocale": "电子产品:辅料",
"countryCode": "US",
"currency": "USD",
"totalProducts": null,
"products": 38,
"brands": 34,
"sellers": 34,
"avgBsr": 126168,
"baseAvgVolume": 2213.5,
"avgVolume": 135.08,
"baseAvgWeight": 418.77,
"avgWeight": 0.9232,
"avgProfit": 66.89,
"avgUnits": 138,
"avgRevenue": 5032,
"avgPrice": 42.5,
"avgRatingsCv": 3,
"avgRatings": 571,
"avgRating": 4.3,
"avgSellers": 1.2,
"hlProducts": 10,
"hlAvgBsr": 29988,
"hlAvgUnits": 444,
"hlAvgRevenue": 16564.99,
"hlAvgPrice": 23.03,
"hlAvgRatingsCv": 6,
"hlAvgRatings": 455,
"hlAvgRating": 4.3,
"newProducts": 1,
"newProductProportion": 2.63,
"newAvgPrice": 16.99,
"newAvgRatings": 15,
"minNewRatings": 15,
"maxNewRatings": 15,
"newAvgRating": 3.7,
"newAvgUnits": 121,
"newAvgRevenue": 2055.79,
"firstShelfDate": "2012-06-24",
"lastShelfDate": "2025-07-13"
}
}可用状态:已开放
该接口已进入 v1 网关、OpenAPI 和订阅权限目录,成功调用一次消耗 1 个计费单位。
POST /v1/amazon/market/statistics
下方请求和响应字段已与当前公开契约核对。
接口对应关系
| 项目 | 内容 |
|---|---|
| MCP Code | market_research_statistics |
| 原始 REST 方法 | POST |
| 原始 REST 路径 | /v1/market/statistics |
| 原始 API 文档 | 打开官方 API 文档 |
历史路径仍可调用,但已弃用:
/v1/amazon/markets/statistics。兼容请求会返回Deprecation: true和指向规范路径的Link响应头。
快速调用
先创建 API 密钥,再将密钥写入服务端环境变量:
export ECOMMERCE_DATA_API_KEY="your_api_key"curl --request POST \
--url https://ecommercedataapi.com/v1/amazon/market/statistics \
--header "Content-Type: application/json" \
--header "X-API-Key: ${ECOMMERCE_DATA_API_KEY}" \
--data '{
"marketplace": "US",
"nodeIdPath": "172282:281407"
}'使用 AI CLI 接入
复制给 AI CLI
粘贴到 Codex、Claude Code、Gemini CLI 或其他编程智能体中直接完成接入。
请直接在当前代码库中接入 Ecommerce Data API 的「选市场-统计」接口,不要只给示例代码。
接口文档:https://ecommercedataapi.com/zh/docs/amazon/market/statistics
请求接口:POST https://ecommercedataapi.com/v1/amazon/market/statistics
API 密钥环境变量:ECOMMERCE_DATA_API_KEY
请求示例:
{
"marketplace": "US",
"nodeIdPath": "172282:281407"
}
请按以下要求执行:
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/market/statistics',
{
method: 'POST',
headers: {
'Content-Type': 'application/json',
'X-API-Key': process.env.ECOMMERCE_DATA_API_KEY,
},
body: JSON.stringify({
marketplace: 'US',
nodeIdPath: '172282:281407',
}),
}
);
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/market/statistics",
headers={
"Content-Type": "application/json",
"X-API-Key": os.environ["ECOMMERCE_DATA_API_KEY"],
},
json={
"marketplace": "US",
"nodeIdPath": "172282:281407",
},
timeout=30,
)
response.raise_for_status()
print(response.json()["data"])请求参数
请求体直接发送下表字段,不要再包裹额外对象;未定义字段会被拒绝。
| 字段 | 类型 | 必填 | 说明 | 示例 |
|---|---|---|---|---|
marketplace | 字符串 | 是 | 站点编码 支持的市场编码见 OpenAPI 枚举 可选值:US、UK、DE、FR、IT、ES、MX、CA、AU、JP、IN、AE、BR。 | US |
month | 字符串 | 否 | 筛选日期,默认最近30天 按接口要求传入月份或日期 | 202507 |
newProduct | 整数 | 否 | 新品定义 | 6 |
nodeIdPath | 字符串 | 是 | 节点 id 路径字符串 | 1064954:1069242:1069784:1069820:1069838:1069828 |
returnFields | 字符串 | 否 | 可选的返回字段选择字符串;不传时返回标准字段。 | marketplace,currency,nodeIdPath |
topN | 整数 | 否 | 头部Listing数量 | 10 |
返回结构
| 字段 | 类型 | 说明 |
|---|---|---|
request_id | 字符串 | 本次请求的唯一标识。 |
data | 对象 | 接口业务数据。 |
下表字段位于 data 内。数组接口描述的是单个数组元素,分页接口描述的是 items[] 中的单条记录。
返回字段
| 字段 | 类型 | 说明 | 示例 |
|---|---|---|---|
marketplace | 字符串 | 市场标志 | US |
currency | 字符串 | 该市场的货币类型 | USD |
nodeIdPath | 字符串 | 节点ID路径 | 1064954:1069242:1069784:1069820:1069838:1069828 |
nodeLabelPath | 字符串 | 节点名称路径 | Office Products:Office & School Supplies:Writing & Correction Supplies:Pens & Refills:Rollerball Pens:Gel Ink Rollerball Pens |
nodeLabelLocale | 字符串 | 节点名称翻译 | 办公产品:办公室:写作:钢笔:滚珠笔:中性笔 |
countryCode | 字符串 | 国家二简码 | US |
totalProducts | 整数 | 商品总数 | 5127 |
products | 整数 | 样品商品数 | 100 |
brands | 整数 | 品牌数 | 4 |
sellers | 整数 | 卖家数 | 58 |
avgBsr | 整数 | 平均BSR | 41970 |
baseAvgVolume | 数字 | 平均体积(cm³) | 819942.68 |
avgVolume | 数字 | 平均体积(in³) | 50035.97 |
baseAvgWeight | 数字 | 平均重量(g) | 2460.95 |
avgWeight | 数字 | 平均重量(pound) | 5.4255 |
avgProfit | 数字 | 平均利润率 | 66.03 |
avgUnits | 整数 | 月均销量 | 26255 |
avgRevenue | 数字 | 月均销售额 | 344369 |
avgPrice | 数字 | 平均价格 | 13.91 |
avgRatingsCv | 整数 | 月评论平均增长数 | 0 |
avgRatings | 整数 | 平均评分数 | 19071 |
avgRating | 数字 | 平均星级 | 4.7 |
avgSellers | 数字 | 平均卖家数 | 5.2 |
hlProducts | 整数 | 头部Listing前N名商品样本数 | 5 |
hlAvgBsr | 整数 | 头部Listing前N名商品平均BSR | 13126 |
hlAvgUnits | 整数 | 头部Listing前N名商品月均销量 | 1123 |
hlAvgRevenue | 数字 | 头部Listing前N名商品月均销售额 | 12342.85 |
hlAvgPrice | 数字 | 头部Listing前N名商品平均价格 | 11.77 |
hlAvgRatingsCv | 整数 | 头部Listing前N名商品月评论平均增长数 | 0 |
hlAvgRatings | 整数 | 头部Listing前N名商品平均评论数 | 2794 |
hlAvgRating | 数字 | 头部Listing前N名商品平均星级 | 4.7 |
newProducts | 整数 | 新品数量 | 67 |
newProductProportion | 数字 | 新品数量占比 | 67 |
newAvgPrice | 数字 | 新品平均价格 | 14.14 |
newAvgRatings | 整数 | 新品平均评分数 | 24295 |
minNewRatings | 整数 | 最低新品评分数 | 24 |
maxNewRatings | 整数 | 最高新品评分数 | 6432 |
newAvgRating | 数字 | 新品平均星级 | 4.7 |
newAvgUnits | 整数 | 新品月均销量 | 26425 |
newAvgRevenue | 数字 | 新品月均销售额 | 350209.91 |
firstShelfDate | 字符串 | 商品首次上架日期 | 2014-10-30 |
lastShelfDate | 字符串 | 商品最新上架日期 | 2021-04-28 |
返回示例
{
"request_id": "8fb43e59-4ff9-4dc8-a4b7-2ed164e45ab8",
"data": {
"marketplace": "US",
"nodeIdPath": "172282:281407",
"nodeLabelPath": "Electronics:Accessories & Supplies",
"nodeLabelPathLocale": "电子产品:辅料",
"countryCode": "US",
"currency": "USD",
"totalProducts": null,
"products": 38,
"brands": 34,
"sellers": 34,
"avgBsr": 126168,
"baseAvgVolume": 2213.5,
"avgVolume": 135.08,
"baseAvgWeight": 418.77,
"avgWeight": 0.9232,
"avgProfit": 66.89,
"avgUnits": 138,
"avgRevenue": 5032,
"avgPrice": 42.5,
"avgRatingsCv": 3,
"avgRatings": 571,
"avgRating": 4.3,
"avgSellers": 1.2,
"hlProducts": 10,
"hlAvgBsr": 29988,
"hlAvgUnits": 444,
"hlAvgRevenue": 16564.99,
"hlAvgPrice": 23.03,
"hlAvgRatingsCv": 6,
"hlAvgRatings": 455,
"hlAvgRating": 4.3,
"newProducts": 1,
"newProductProportion": 2.63,
"newAvgPrice": 16.99,
"newAvgRatings": 15,
"minNewRatings": 15,
"maxNewRatings": 15,
"newAvgRating": 3.7,
"newAvgUnits": 121,
"newAvgRevenue": 2055.79,
"firstShelfDate": "2012-06-24",
"lastShelfDate": "2025-07-13"
}
}错误响应、请求追踪和限流头说明见错误与限流。
可组合使用的 AI Skills 与 Agents
从业务任务出发,查看这些能力如何使用当前 API,并在安装前审阅来源与权限。
Amazon 选产品 Skill
评估 Amazon 商品机会的需求、竞争、利润潜力、进入壁垒、供应链和上市假设。
跨境电商市场扩张 Skill
比较目标市场、履约模式、税务、支付偏好、本地化要求和分阶段国际扩张方案。
Amazon 全球开店规划 Skill
从需求、经济模型、税务、合规、物流、本地化、账号和发布门禁评估 Amazon 全球扩张。
Amazon 细分市场发现 Skill
通过比较需求、竞争、利润、增长、市场缺口和进入约束,发现 Amazon 未充分满足的细分市场。