选市场-商品集中度 API 文档

可用状态：已开放

该接口已进入 v1 网关、OpenAPI 和订阅权限目录，成功调用一次消耗 1 个计费单位。

POST /v1/amazon/market/goods

下方请求和响应字段已与当前公开契约核对。

接口对应关系

项目	内容
MCP Code	`market_product_concentration`
原始 REST 方法	`POST`
原始 REST 路径	`/v1/market/goods`
原始 API 文档	打开官方 API 文档

历史路径仍可调用，但已弃用：/v1/amazon/markets/product-concentration。兼容请求会返回 Deprecation: true 和指向规范路径的 Link 响应头。

快速调用

先创建 API 密钥，再将密钥写入服务端环境变量：

export ECOMMERCE_DATA_API_KEY="your_api_key"

curl --request POST \
  --url https://ecommercedataapi.com/v1/amazon/market/goods \
  --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/goods
请求接口：POST https://ecommercedataapi.com/v1/amazon/market/goods
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/goods',
  {
    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/goods",
    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"])

请求参数

请求体直接发送下表字段，不要再包裹额外对象；未定义字段会被拒绝。

字段	类型	必填	说明	示例
`asins`	数组	否	过滤asin 至少 1 项。最多 40 项。	["B00P19MFYE"]
`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`	字符串	否	可选的返回字段选择字符串；不传时返回标准字段。	title,asin,asinUrl
`topN`	整数	否	头部Listing数量	10

返回结构

字段	类型	说明
`request_id`	字符串	本次请求的唯一标识。
`data`	数组	接口业务数据。

下表字段位于 data 内。数组接口描述的是单个数组元素，分页接口描述的是 items[] 中的单条记录。

返回字段

字段	类型	说明	示例
`title`	字符串	标题	Pilot G2, Dr. Grip Gel/Ltd, ExecuGel G6, Q7 Rollerball Gel Ink Pen Refills, 0.7mm, Fine Point, Black Ink, 3 Packs of 2
`asin`	字符串	asin	B00P19MFYE
`asinUrl`	字符串	asin链接	https://www.amazon.com/dp/B00P19MFYE
`imageUrl`	字符串	图片链接	https://images-na.ssl-images-amazon.com/images/I/51hxvoxGnjL._AC_US200_.jpg
`ranking`	整数	排名	1
`brand`	字符串	品牌	PILOT
`sellerName`	字符串	卖家名称	JA Wholesale LLC
`sellerType`	字符串	卖家类型	FBA
`price`	数字	价格	6.19
`shelfDate`	字符串	上架时间	2014-10-30
`ratings`	整数	评分数	5695
`reviews`	整数	评论数	133
`rating`	数字	评论值	4.8
`newFlag`	整数	是否新品 1新品，0非新品	0
`totalUnits`	整数	总销量	2515
`totalRevenue`	数字	总销额	18837.35
`totalUnitsRatio`	数字	总销量占比	0.4478
`totalRevenueRatio`	数字	总销额占比	0.3052

返回示例

{
  "request_id": "8fb43e59-4ff9-4dc8-a4b7-2ed164e45ab8",
  "data": [
    {
      "title": "POCOCO Realistic Constellation-1 Series Discs, 5K Resolution, Realistic Patterns, 6 Pieces",
      "asin": "B0B6G28SXP",
      "asinUrl": "https://www.amazon.com/dp/B0B6G28SXP",
      "imageUrl": "https://images-na.ssl-images-amazon.com/images/I/71qOlP597lL._AC_US200_.jpg",
      "ranking": 1,
      "brand": "POCOCO",
      "sellerName": "POCOCO Direct",
      "sellerType": "FBA",
      "price": 53.99,
      "shelfDate": "2022-09-21",
      "ratings": 684,
      "reviews": 29,
      "rating": 4.3,
      "newFlag": 0,
      "totalUnits": 2067,
      "totalRevenue": 111597.34,
      "totalUnitsRatio": 0.4646,
      "totalRevenueRatio": 0.6737
    },
    {
      "title": "Starlink Mini Case, IP67 Waterproof Hard Case with with Custom Fit Foam, Portable Travel & Camping Storage for Starlink Mini Dish & Accessories, Perfect for Outdoor Use",
      "asin": "B0DQPT7F25",
      "asinUrl": "https://www.amazon.com/dp/B0DQPT7F25",
      "imageUrl": "https://images-na.ssl-images-amazon.com/images/I/71jsNg3xngL._AC_US200_.jpg",
      "ranking": 2,
      "brand": "Accecraft",
      "sellerName": "NEX001US",
      "sellerType": "FBA",
      "price": 35.99,
      "shelfDate": "2025-03-03",
      "ratings": 105,
      "reviews": 0,
      "rating": 4.7,
      "newFlag": 0,
      "totalUnits": 599,
      "totalRevenue": 21558.01,
      "totalUnitsRatio": 0.1346,
      "totalRevenueRatio": 0.1301
    }
  ]
}

错误响应、请求追踪和限流头说明见错误与限流。

可用状态：已开放

该接口已进入 v1 网关、OpenAPI 和订阅权限目录，成功调用一次消耗 1 个计费单位。

POST /v1/amazon/market/goods

下方请求和响应字段已与当前公开契约核对。

接口对应关系

项目	内容
MCP Code	`market_product_concentration`
原始 REST 方法	`POST`
原始 REST 路径	`/v1/market/goods`
原始 API 文档	打开官方 API 文档

历史路径仍可调用，但已弃用：/v1/amazon/markets/product-concentration。兼容请求会返回 Deprecation: true 和指向规范路径的 Link 响应头。

快速调用

先创建 API 密钥，再将密钥写入服务端环境变量：

export ECOMMERCE_DATA_API_KEY="your_api_key"

curl --request POST \
  --url https://ecommercedataapi.com/v1/amazon/market/goods \
  --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/goods
请求接口：POST https://ecommercedataapi.com/v1/amazon/market/goods
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/goods',
  {
    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/goods",
    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"])

请求参数

请求体直接发送下表字段，不要再包裹额外对象；未定义字段会被拒绝。

字段	类型	必填	说明	示例
`asins`	数组	否	过滤asin 至少 1 项。最多 40 项。	["B00P19MFYE"]
`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`	字符串	否	可选的返回字段选择字符串；不传时返回标准字段。	title,asin,asinUrl
`topN`	整数	否	头部Listing数量	10

返回结构

字段	类型	说明
`request_id`	字符串	本次请求的唯一标识。
`data`	数组	接口业务数据。

下表字段位于 data 内。数组接口描述的是单个数组元素，分页接口描述的是 items[] 中的单条记录。

返回字段

字段	类型	说明	示例
`title`	字符串	标题	Pilot G2, Dr. Grip Gel/Ltd, ExecuGel G6, Q7 Rollerball Gel Ink Pen Refills, 0.7mm, Fine Point, Black Ink, 3 Packs of 2
`asin`	字符串	asin	B00P19MFYE
`asinUrl`	字符串	asin链接	https://www.amazon.com/dp/B00P19MFYE
`imageUrl`	字符串	图片链接	https://images-na.ssl-images-amazon.com/images/I/51hxvoxGnjL._AC_US200_.jpg
`ranking`	整数	排名	1
`brand`	字符串	品牌	PILOT
`sellerName`	字符串	卖家名称	JA Wholesale LLC
`sellerType`	字符串	卖家类型	FBA
`price`	数字	价格	6.19
`shelfDate`	字符串	上架时间	2014-10-30
`ratings`	整数	评分数	5695
`reviews`	整数	评论数	133
`rating`	数字	评论值	4.8
`newFlag`	整数	是否新品 1新品，0非新品	0
`totalUnits`	整数	总销量	2515
`totalRevenue`	数字	总销额	18837.35
`totalUnitsRatio`	数字	总销量占比	0.4478
`totalRevenueRatio`	数字	总销额占比	0.3052

返回示例

{
  "request_id": "8fb43e59-4ff9-4dc8-a4b7-2ed164e45ab8",
  "data": [
    {
      "title": "POCOCO Realistic Constellation-1 Series Discs, 5K Resolution, Realistic Patterns, 6 Pieces",
      "asin": "B0B6G28SXP",
      "asinUrl": "https://www.amazon.com/dp/B0B6G28SXP",
      "imageUrl": "https://images-na.ssl-images-amazon.com/images/I/71qOlP597lL._AC_US200_.jpg",
      "ranking": 1,
      "brand": "POCOCO",
      "sellerName": "POCOCO Direct",
      "sellerType": "FBA",
      "price": 53.99,
      "shelfDate": "2022-09-21",
      "ratings": 684,
      "reviews": 29,
      "rating": 4.3,
      "newFlag": 0,
      "totalUnits": 2067,
      "totalRevenue": 111597.34,
      "totalUnitsRatio": 0.4646,
      "totalRevenueRatio": 0.6737
    },
    {
      "title": "Starlink Mini Case, IP67 Waterproof Hard Case with with Custom Fit Foam, Portable Travel & Camping Storage for Starlink Mini Dish & Accessories, Perfect for Outdoor Use",
      "asin": "B0DQPT7F25",
      "asinUrl": "https://www.amazon.com/dp/B0DQPT7F25",
      "imageUrl": "https://images-na.ssl-images-amazon.com/images/I/71jsNg3xngL._AC_US200_.jpg",
      "ranking": 2,
      "brand": "Accecraft",
      "sellerName": "NEX001US",
      "sellerType": "FBA",
      "price": 35.99,
      "shelfDate": "2025-03-03",
      "ratings": 105,
      "reviews": 0,
      "rating": 4.7,
      "newFlag": 0,
      "totalUnits": 599,
      "totalRevenue": 21558.01,
      "totalUnitsRatio": 0.1346,
      "totalRevenueRatio": 0.1301
    }
  ]
}

错误响应、请求追踪和限流头说明见错误与限流。

选市场-商品集中度

API 数据样例

接口对应关系

快速调用

使用 AI CLI 接入

复制给 AI CLI

在 Postman 中打开当前请求

Node.js 示例

Python 示例

请求参数

返回结构

返回字段

返回示例

本页内容

选市场-商品集中度

API 数据样例

接口对应关系

快速调用

使用 AI CLI 接入

复制给 AI CLI

在 Postman 中打开当前请求

Node.js 示例

Python 示例

请求参数

返回结构

返回字段

返回示例

本页内容