关键词选品
按搜索需求、增长、竞争、转化和 PPC 等指标筛选 Amazon 关键词。
API 数据样例
直接查看该接口实际使用的请求体和完整响应结构。
{
"keywords": "child",
"marketplace": "US",
"month": "202507",
"page": 1,
"size": 1
}{
"request_id": "8fb43e59-4ff9-4dc8-a4b7-2ed164e45ab8",
"data": {
"guestId": null,
"pages": 1239,
"page": 1,
"size": 1,
"total": 1239,
"took": 15,
"url": null,
"order": {
"field": "",
"desc": true
},
"items": [
{
"marketplace": "US",
"keywords": "child",
"searches": 17702,
"purchases": 2436,
"growth": -19.83153,
"purchaseRate": 0.1376,
"products": 364623,
"supplyDemandRatio": 0.05,
"searchDepartments": [
{
"code": "hpc",
"label": "Health, Household & Baby Care",
"total": 2725,
"ratio": 0.15393741
}
],
"month": "2025.07",
"supplement": "N",
"searchMonthlyCv": -12649,
"searchMonthlyCr": -41.68,
"searchNearlyCv": -4379,
"searchNearlyCr": -19.83,
"currency": "$",
"avgPrice": 17.97,
"avgRatings": 25985,
"avgRating": 4.8,
"relationAsinList": [
{
"asin": "B06XSCPJZK",
"imageUrl": "https://m.media-amazon.com/images/I/41dfAc5LCkL._AC_US200_.jpg",
"price": 26.59,
"ratings": 6816,
"rating": 4.4
}
],
"bidMin": 0.91,
"bidMax": 1.4,
"bid": 1.26,
"araAsinList": [
{
"asin": "B07HQ2JS3L",
"title": null,
"imageUrl": null,
"clickRate": 0.28,
"conversionShareRate": 0
}
],
"araClickRate": 0.6205,
"araShareRate": 0,
"goodsValue": 0.0701,
"marketPeriod": "S9,S10",
"brand": null,
"hasBrandWord": false,
"keywordCn": "孩子",
"brands": [
"Majosta"
],
"categories": [
"Digital_Video_Download"
],
"titleDensityExact": 3
}
],
"terminal": null,
"hasNextPage": null,
"guestVisited": false
}
}可用状态:已开放
该接口已进入 v1 网关、OpenAPI 和订阅权限目录,成功调用一次消耗 1 个计费单位。
POST /v1/amazon/keyword-research
下方请求和响应字段已与当前公开契约核对。
接口对应关系
| 项目 | 内容 |
|---|---|
| MCP Code | keyword_research |
| 原始 REST 方法 | POST |
| 原始 REST 路径 | /v1/keyword-research |
| 原始 API 文档 | 打开官方 API 文档 |
历史路径仍可调用,但已弃用:
/v1/amazon/keywords/research。兼容请求会返回Deprecation: true和指向规范路径的Link响应头。
快速调用
先创建 API 密钥,再将密钥写入服务端环境变量:
export ECOMMERCE_DATA_API_KEY="your_api_key"curl --request POST \
--url https://ecommercedataapi.com/v1/amazon/keyword-research \
--header "Content-Type: application/json" \
--header "X-API-Key: ${ECOMMERCE_DATA_API_KEY}" \
--data '{
"keywords": "child",
"marketplace": "US",
"month": "202507",
"page": 1,
"size": 1
}'使用 AI CLI 接入
复制给 AI CLI
粘贴到 Codex、Claude Code、Gemini CLI 或其他编程智能体中直接完成接入。
请直接在当前代码库中接入 Ecommerce Data API 的「关键词选品」接口,不要只给示例代码。
接口文档:https://ecommercedataapi.com/zh/docs/amazon/keyword-research
请求接口:POST https://ecommercedataapi.com/v1/amazon/keyword-research
API 密钥环境变量:ECOMMERCE_DATA_API_KEY
请求示例:
{
"keywords": "child",
"marketplace": "US",
"month": "202507",
"page": 1,
"size": 1
}
请按以下要求执行:
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/keyword-research',
{
method: 'POST',
headers: {
'Content-Type': 'application/json',
'X-API-Key': process.env.ECOMMERCE_DATA_API_KEY,
},
body: JSON.stringify({
keywords: 'child',
marketplace: 'US',
month: '202507',
page: 1,
size: 1,
}),
}
);
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/keyword-research",
headers={
"Content-Type": "application/json",
"X-API-Key": os.environ["ECOMMERCE_DATA_API_KEY"],
},
json={
"keywords": "child",
"marketplace": "US",
"month": "202507",
"page": 1,
"size": 1,
},
timeout=30,
)
response.raise_for_status()
print(response.json()["data"])请求参数
请求体直接发送下表字段,不要再包裹额外对象;未定义字段会被拒绝。
| 字段 | 类型 | 必填 | 说明 | 示例 |
|---|---|---|---|---|
departments | 数组 | 否 | 查询类目,见关键词选品类目接口,传递code | ["automotive","baby-products"] |
excludeKeywords | 字符串 | 否 | 排除的关键字 | portable |
keywords | 字符串 | 否 | 关键词 | N95 |
marketPeriod | 字符串 | 否 | 市场周期 见表1.7 | Market period |
marketplace | 字符串 | 是 | 市场 支持的市场编码见 OpenAPI 枚举 可选值:US、UK、DE、FR、IT、ES、MX、CA、AU、JP、IN、AE、BR。 | US |
maxAraClickRate | 数字 | 否 | 最大点击集中度 | 56.4 |
maxAvgPrice | 数字 | 否 | 最大均价 | 30.3 |
maxBid | 数字 | 否 | 最大PPC竞价 | 10.6 |
maxGoodsValue | 数字 | 否 | 最大货流值 | 41.1 |
maxProducts | 整数 | 否 | 最大商品数 | 90 |
maxPurchaseRate | 数字 | 否 | 最大购买率 | 10.5 |
maxPurchases | 整数 | 否 | 最大购买量 | 500 |
maxRating | 数字 | 否 | 最大评分值 | 4.1 |
maxRatings | 整数 | 否 | 最大评分数 | 3000 |
maxSearchMonthCr | 数字 | 否 | 最大月搜索量同比增长率 | 30.1 |
maxSearchMonthCv | 整数 | 否 | 最大月搜索量同比增长值 | 3000 |
maxSearchNearlyCr | 数字 | 否 | 最大月搜索量近3个月增长率 | 20.4 |
maxSearchNearlyCv | 整数 | 否 | 最大月搜索量近3个月增长值 | 20000 |
maxSearches | 整数 | 否 | 最大月搜索量 | 300 |
maxSearchesCr | 数字 | 否 | 最大月搜索量增长率 | 50.8 |
maxSupplyDemandRatio | 数字 | 否 | 最大供需比 | 10.4 |
maxWordCount | 整数 | 否 | 最大单词个数 | 3 |
minAraClickRate | 数字 | 否 | 最小点击集中度 | 20.1 |
minAvgPrice | 数字 | 否 | 最小均价 | 20 |
minBid | 数字 | 否 | 最小PPC竞价 | 6.2 |
minGoodsValue | 数字 | 否 | 最小货流值 | 10.1 |
minProducts | 整数 | 否 | 最小商品数 | 10 |
minPurchaseRate | 数字 | 否 | 最小购买率 | 3.2 |
minPurchases | 整数 | 否 | 最小购买量 | 100 |
minRating | 数字 | 否 | 最小评分值 | 3.2 |
minRatings | 整数 | 否 | 最小评分数 | 2000 |
minSearchMonthCr | 数字 | 否 | 最小月搜索量同比增长率 | 5.3 |
minSearchMonthCv | 整数 | 否 | 最小月搜索量同比增长值 | 1000 |
minSearchNearlyCr | 数字 | 否 | 最小月搜索量近3个月增长率 | 10.3 |
minSearchNearlyCv | 整数 | 否 | 最小月搜索量近3个月增长值 | 6000 |
minSearches | 整数 | 否 | 最小月搜索量 | 100 |
minSearchesCr | 数字 | 否 | 最小月搜索量增长率 | 10 |
minSupplyDemandRatio | 数字 | 否 | 最小供需比 | 5.6 |
minWordCount | 整数 | 否 | 最小单词个数 | 1 |
month | 字符串 | 否 | 筛选日期,yyyyMM格式,支持近24个月的 | 202203 |
order | 对象 | 否 | 排序 | {} |
order.desc | 布尔值 | 否 | true为降序 false为升序 默认降序 | true |
order.field | 字符串 | 否 | 排序字段 见表1.8 | searches |
page | 整数 | 否 | 页码,从 1 开始 默认:1 最小值:1。 | 1 |
returnFields | 字符串 | 否 | 可选的返回字段选择字符串;不传时返回标准字段。 | marketplace,keywords,searches |
size | 整数 | 否 | 每页条数,默认15 最大:15 最小值:1。 | 20 |
withYearlyGrowth | 布尔值 | 否 | 新细分市场 false | false |
返回结构
| 字段 | 类型 | 说明 |
|---|---|---|
request_id | 字符串 | 本次请求的唯一标识。 |
data | 对象 | 接口业务数据。 |
下表字段位于 data 内。数组接口描述的是单个数组元素,分页接口描述的是 items[] 中的单条记录。
返回字段
| 字段 | 类型 | 说明 | 示例 |
|---|---|---|---|
marketplace | 字符串 | 市场 | US |
keywords | 字符串 | 关键词 | polaroid cameras |
searches | 整数 | 搜索量 | 141356 |
clicks | 字符串 | 点击量 | 在某个关键词搜索结果页中被点击的总次数非单个ASIN在关键词下的点击量 |
impressions | 字符串 | 展示量 | 在某个关键词搜索结果页中所有ASIN的总展示次数非单个ASIN在关键词下的曝光量 |
purchases | 整数 | 月购买量 | 4029 |
growth | 数字 | 增长率 | -25.482092 |
purchaseRate | 数字 | 月购买率 | 0.0285 |
products | 整数 | 产品数 | 173 |
supplyDemandRatio | 数字 | 供需比 | 817.09 |
searchDepartments | 数组 | 类目 | - |
searchDepartments.code | 字符串 | 类目代码 | electronics |
searchDepartments.label | 字符串 | 类目名称 | Electronics |
searchDepartments.total | 整数 | 类目总计 | 141356 |
searchDepartments.ratio | 数字 | 类目占比 | 1 |
month | 字符串 | 查询月份 | 2022.01 |
supplement | 字符串 | 是否属于补充关键词 | N |
searchMonthlyCv | 整数 | 关键词同比增长 | 139749 |
searchMonthlyCr | 数字 | 关键词同比增长率 | 8696.27 |
searchNearlyCv | 整数 | 关键词近3个月增长值 | -48338 |
searchNearlyCr | 数字 | 关键词近3个月增长率 | -25.48 |
currency | 字符串 | 货币 | $ |
avgPrice | 数字 | 平均价格 | 116.24 |
avgRatings | 整数 | 平均评分数 | 2584 |
avgRating | 数字 | 平均评论数 | 4.5 |
relationAsinList | 数组 | 关键词关联asin | 4.8 |
relationAsinList.price | 数字 | 价格 | 59.95 |
relationAsinList.ratings | 整数 | 评分数 | 20115 |
relationAsinList.rating | 数字 | 评分 | 4.7 |
bidMin | 数字 | bid最小价格 | 0.987 |
bidMax | 数字 | bid最大价格 | 2.54 |
bid | 数字 | bid价格 | 1.26 |
araClickRate | 数字 | 点击垄断率 | 0.2633 |
araShareRate | 数字 | 共享转化率 | 0.2633 |
araAsinList | 数组 | 点击前三ASIN | - |
araAsinList.asin | 字符串 | asin | B099VDRGG1 |
araAsinList.title | 字符串 | title | Fujifilm Instax Mini 9 |
araAsinList.imageUrl | 字符串 | 图片 | https://m.media-amazon.com/images/I/51aZiZaicYL._AC_US200_.jpg |
araAsinList.clickRate | 数字 | 点击率 | 0.116 |
araAsinList.conversionShareRate | 数字 | 转化率 | 0.1217 |
goodsValue | 数字 | 货流值 | 0.0108 |
brands | 数组 | TOP3 品牌 | ["LEGO","Jorumo","Nifeliz"] |
categories | 数组 | TOP3 类目 | ["Toys","Home","Mobile_Apps"] |
titleDensityExact | 字符串 | 标题密度首页商品包含该关键词的数量(不含广告位) | 21 |
marketPeriod | 字符串 | 市场周期 | S11,S12 |
brand | 字符串 | 品牌 | Fujifilm |
hasBrandWord | 布尔值 | 是否存在品牌词 | false |
keywordCn | 字符串 | 中文翻译 | 宝丽来相机 |
返回示例
{
"request_id": "8fb43e59-4ff9-4dc8-a4b7-2ed164e45ab8",
"data": {
"guestId": null,
"pages": 1239,
"page": 1,
"size": 1,
"total": 1239,
"took": 15,
"url": null,
"order": {
"field": "",
"desc": true
},
"items": [
{
"marketplace": "US",
"keywords": "child",
"searches": 17702,
"purchases": 2436,
"growth": -19.83153,
"purchaseRate": 0.1376,
"products": 364623,
"supplyDemandRatio": 0.05,
"searchDepartments": [
{
"code": "hpc",
"label": "Health, Household & Baby Care",
"total": 2725,
"ratio": 0.15393741
}
],
"month": "2025.07",
"supplement": "N",
"searchMonthlyCv": -12649,
"searchMonthlyCr": -41.68,
"searchNearlyCv": -4379,
"searchNearlyCr": -19.83,
"currency": "$",
"avgPrice": 17.97,
"avgRatings": 25985,
"avgRating": 4.8,
"relationAsinList": [
{
"asin": "B06XSCPJZK",
"imageUrl": "https://m.media-amazon.com/images/I/41dfAc5LCkL._AC_US200_.jpg",
"price": 26.59,
"ratings": 6816,
"rating": 4.4
}
],
"bidMin": 0.91,
"bidMax": 1.4,
"bid": 1.26,
"araAsinList": [
{
"asin": "B07HQ2JS3L",
"title": null,
"imageUrl": null,
"clickRate": 0.28,
"conversionShareRate": 0
}
],
"araClickRate": 0.6205,
"araShareRate": 0,
"goodsValue": 0.0701,
"marketPeriod": "S9,S10",
"brand": null,
"hasBrandWord": false,
"keywordCn": "孩子",
"brands": ["Majosta"],
"categories": ["Digital_Video_Download"],
"titleDensityExact": 3
}
],
"terminal": null,
"hasNextPage": null,
"guestVisited": false
}
}错误响应、请求追踪和限流头说明见错误与限流。
可组合使用的 AI Skills 与 Agents
从业务任务出发,查看这些能力如何使用当前 API,并在安装前审阅来源与权限。
Ecommerce Data API Agent Skill
在支持的 AI 编程 Agent 中发现、检查并调用实时 Amazon 商品、关键词、市场、流量、评论和商标 API。
Amazon 关键词研究 Skill
挖掘长尾词、比较关键词机会,并整理 Amazon 多站点的需求、竞争和季节性证据。
Amazon Listing 优化 Skill
结合商品事实、关键词覆盖、竞品背景、转化文案和八维审计,创建或优化 Amazon Listing。
Amazon 产品经理决策 Skill
将市场筛选、选品、单位经济、Listing、PPC、库存、发布、增长和止损决策连接成统一运营流程。