关键词转化率
查询 Amazon 关键词的搜索、点击和转化指标。
API 数据样例
直接查看该接口实际使用的请求体和完整响应结构。
{
"marketplace": "US",
"keyword": "lunch box",
"timeType": "WEEK",
"minSearches": 100,
"maxSearches": 100000
}{
"request_id": "8fb43e59-4ff9-4dc8-a4b7-2ed164e45ab8",
"data": {
"guestId": null,
"pages": 0,
"page": 1,
"size": 2,
"total": 2394,
"took": 0,
"url": null,
"order": {
"field": "",
"desc": true
},
"items": [
{
"keyword": "lunch box",
"keywordCn": "午餐盒",
"keywordJp": "弁当箱",
"searches": 349991,
"clicks": 91282,
"purchases": 5412,
"searchConvRate": 0.0155,
"clickConvRate": 0.0593,
"searchesTrend": null,
"clickTrend": null,
"purchaseTrend": null,
"phrasePpc": {
"value": 0.7,
"min": 0.49,
"max": 0.79
},
"exactPpc": {
"value": 0.58,
"min": 0.45,
"max": 0.65
},
"broadPpc": {
"value": 0.71,
"min": 0.49,
"max": 0.79
},
"phraseCpa": {
"value": 11.8044,
"min": 8.2631,
"max": 13.3221
},
"exactCpa": {
"value": 9.7808,
"min": 7.5885,
"max": 10.9612
},
"broadCpa": {
"value": 11.973,
"min": 8.2631,
"max": 13.3221
},
"avgProductPrice": {
"value": 22.99,
"min": 6.99,
"max": 66.99
},
"phraseBudget": {
"value": 18.9,
"min": 13.23,
"max": 21.33
},
"exactBudget": {
"value": 15.66,
"min": 12.15,
"max": 17.55
},
"broadBudget": {
"value": 19.17,
"min": 13.23,
"max": 21.33
},
"phraseAcos": {
"value": 0.5135,
"min": 1.6888,
"max": 0.1762
},
"exactAcos": {
"value": 0.4254,
"min": 1.3993,
"max": 0.146
},
"broadAcos": {
"value": 0.5208,
"min": 1.7129,
"max": 0.1787
},
"clickingRate": 0.1976,
"conversionRate": 0.1329,
"top3Asins": [
{
"asin": "B0GDZLL8BK",
"imageUrl": "https://m.media-amazon.com/images/I/41p2Jl7uYAL._AC_US200_.jpg",
"clickRate": 0.0912,
"conversionRate": 0.0271
}
],
"top10Asins": [
{
"station": "US",
"keyword": "lunch box",
"categoryId": null,
"maxPage": null,
"asin": "B0DBDKT4QC",
"asinUrl": "HOTOR Insulated Lunch Box for Men & Women - Leak-Proof Cooler Lunch Bag with 4 Pockets, Adjustable Strap, Ideal for Work, Picnic, Travel - Medium, Black, 10.2\"×6.9\"×8.5\"",
"asinImage": "https://m.media-amazon.com/images/I/41w24kLyRVL._AC_US200_.jpg",
"bigAsinImage": null,
"asinPrice": 8.99,
"asinReviews": 7423,
"asinRating": 4.5,
"asinBrand": null,
"asinTitle": "HOTOR Insulated Lunch Box for Men & Women - Leak-Proof Cooler Lunch Bag with 4 Pockets, Adjustable Strap, Ideal for Work, Picnic, Travel - Medium, Black, 10.2\"×6.9\"×8.5\"",
"rank": null,
"rankPage": 1,
"rankPagesize": 56,
"rankIndex": 4,
"position": 4,
"products": 30639,
"sku": null,
"maxRankPage": null,
"ad": null,
"amazonChoice": null,
"badges": "AC",
"handledImageUrl": true
}
],
"phraseCount": 2
}
],
"terminal": null,
"hasNextPage": null,
"guestVisited": false
}
}可用状态:已开放
该接口已进入 v1 网关、OpenAPI 和订阅权限目录,成功调用一次消耗 1 个计费单位。
POST /v1/amazon/keyword/conversion
下方请求和响应字段已与当前公开契约核对。
接口对应关系
| 项目 | 内容 |
|---|---|
| MCP Code | keyword_conversion |
| 原始 REST 方法 | POST |
| 原始 REST 路径 | /v1/keyword/conversion |
| 原始 API 文档 | 打开官方 API 文档 |
快速调用
先创建 API 密钥,再将密钥写入服务端环境变量:
export ECOMMERCE_DATA_API_KEY="your_api_key"curl --request POST \
--url https://ecommercedataapi.com/v1/amazon/keyword/conversion \
--header "Content-Type: application/json" \
--header "X-API-Key: ${ECOMMERCE_DATA_API_KEY}" \
--data '{
"marketplace": "US",
"keyword": "lunch box",
"timeType": "WEEK",
"minSearches": 100,
"maxSearches": 100000
}'使用 AI CLI 接入
复制给 AI CLI
粘贴到 Codex、Claude Code、Gemini CLI 或其他编程智能体中直接完成接入。
请直接在当前代码库中接入 Ecommerce Data API 的「关键词转化率」接口,不要只给示例代码。
接口文档:https://ecommercedataapi.com/zh/docs/amazon/keyword/conversion
请求接口:POST https://ecommercedataapi.com/v1/amazon/keyword/conversion
API 密钥环境变量:ECOMMERCE_DATA_API_KEY
请求示例:
{
"marketplace": "US",
"keyword": "lunch box",
"timeType": "WEEK",
"minSearches": 100,
"maxSearches": 100000
}
请按以下要求执行:
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/conversion',
{
method: 'POST',
headers: {
'Content-Type': 'application/json',
'X-API-Key': process.env.ECOMMERCE_DATA_API_KEY,
},
body: JSON.stringify({
marketplace: 'US',
keyword: 'lunch box',
timeType: 'WEEK',
minSearches: 100,
maxSearches: 100000,
}),
}
);
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/conversion",
headers={
"Content-Type": "application/json",
"X-API-Key": os.environ["ECOMMERCE_DATA_API_KEY"],
},
json={
"marketplace": "US",
"keyword": "lunch box",
"timeType": "WEEK",
"minSearches": 100,
"maxSearches": 100000,
},
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 |
keyword | 字符串 | 是 | 关键词 | wireless charger |
timeType | 字符串 | 否 | 时间类型 WEEK: 按周;90D:近90天 | WEEK: 按周;90D:近90天 |
minSearches | 整数 | 否 | 最小搜索量 | 1 |
maxSearches | 整数 | 否 | 最大搜索量 | 1 |
minClicks | 整数 | 否 | 最小点击量 | 1 |
maxClicks | 整数 | 否 | 最大点击量 | 1 |
minPurchases | 整数 | 否 | 最小购买量 | 1 |
maxPurchases | 整数 | 否 | 最大购买量 | 1 |
minSearchConvRate | 数字 | 否 | 最小搜索转化率 | 1 |
maxSearchConvRate | 数字 | 否 | 最大搜索转化率 | 1 |
minClickConvRate | 数字 | 否 | 最小点击转化率 | 1 |
maxClickConvRate | 数字 | 否 | 最大点击转化率 | 1 |
minPpc | 数字 | 否 | 最小PPC竞价 | 1 |
maxPpc | 数字 | 否 | 最大PPC竞价 | 1 |
minCpa | 数字 | 否 | 最小CPA | 1 |
maxCpa | 数字 | 否 | 最大CPA | 1 |
minProductPrice | 数字 | 否 | 最小产品均价 | 1 |
maxProductPrice | 数字 | 否 | 最大产品均价 | 1 |
minAcos | 数字 | 否 | 最小ACOS | 1 |
maxAcos | 数字 | 否 | 最大ACOS | 1 |
minClickingRate | 数字 | 否 | 最小前三点击率 | 1 |
maxClickingRate | 数字 | 否 | 最大前三点击率 | 1 |
minConversionRate | 数字 | 否 | 最小前三转化率 | 1 |
maxConversionRate | 数字 | 否 | 最大前三转化率 | 1 |
minPhraseCount | 整数 | 否 | 最小词组数 | 1 |
maxPhraseCount | 整数 | 否 | 最大词组数 | 1 |
minBudget | 数字 | 否 | 最小广告预算 | 1 |
maxBudget | 数字 | 否 | 最大广告预算 | 1 |
matchType | 整数 | 否 | 包含词匹配方式 | 1 |
includeKeywords | 数组 | 否 | 包含词 | ["Include keywords"] |
excludeKeywords | 数组 | 否 | 排除词 | ["Exclude keywords"] |
customAvgProductPrice | 数字 | 否 | 自定义均价 | 1 |
返回结构
| 字段 | 类型 | 说明 |
|---|---|---|
request_id | 字符串 | 本次请求的唯一标识。 |
data | 对象 | 接口业务数据。 |
下表字段位于 data 内。数组接口描述的是单个数组元素,分页接口描述的是 items[] 中的单条记录。
返回字段
| 字段 | 类型 | 说明 | 示例 |
|---|---|---|---|
keyword | 字符串 | 关键词 | - |
keywordCn | 字符串 | 中文关键词 | - |
keywordJp | 字符串 | 日文关键词 | - |
searches | 整数 | 搜索量 | - |
clicks | 整数 | 点击量 | - |
purchases | 整数 | 购买量 | - |
searchConvRate | 数字 | 搜索转化率 | - |
clickConvRate | 数字 | 点击转化率 | - |
searchesTrend | 字符串 | 搜索量趋势 | - |
clickTrend | 字符串 | 点击量趋势 | - |
purchaseTrend | 字符串 | 购买量趋势 | - |
clickingRate | 数字 | 前三点击率 | - |
conversionRate | 数字 | 前三转化率 | - |
phraseCount | 整数 | 词组数量 | - |
phrasePpc | 字符串 | 词组PPC竞价 | - |
phrasePpc.min | 数字 | 最小 | - |
phrasePpc.max | 数字 | 最大 | - |
phrasePpc.value | 数字 | 中位数 | - |
exactPpc | 字符串 | 精确PPC竞价 | - |
exactPpc.min | 数字 | 最小 | - |
exactPpc.max | 数字 | 最大 | - |
exactPpc.value | 数字 | 中位数 | - |
broadPpc | 字符串 | 广泛PPC竞价 | - |
broadPpc.min | 数字 | 最小 | - |
broadPpc.max | 数字 | 最大 | - |
broadPpc.value | 数字 | 中位数 | - |
phraseCpa | 字符串 | 词组CPA | - |
phraseCpa.min | 数字 | 最小 | - |
phraseCpa.max | 数字 | 最大 | - |
phraseCpa.value | 数字 | 中位数 | - |
exactCpa | 字符串 | 精确CPA | - |
exactCpa.min | 数字 | 最小 | - |
exactCpa.max | 数字 | 最大 | - |
exactCpa.value | 数字 | 中位数 | - |
broadCpa | 字符串 | 广泛CPA | - |
broadCpa.min | 数字 | 最小 | - |
broadCpa.max | 数字 | 最大 | - |
broadCpa.value | 数字 | 中位数 | - |
phraseBudget | 字符串 | 词组广告预算 | - |
phraseBudget.min | 数字 | 最小 | - |
phraseBudget.max | 数字 | 最大 | - |
phraseBudget.value | 数字 | 中位数 | - |
exactBudget | 字符串 | 精确广告预算 | - |
exactBudget.min | 数字 | 最小 | - |
exactBudget.max | 数字 | 最大 | - |
exactBudget.value | 数字 | 中位数 | - |
broadBudget | 字符串 | 广泛广告预算 | - |
broadBudget.min | 数字 | 最小 | - |
broadBudget.max | 数字 | 最大 | - |
broadBudget.value | 数字 | 中位数 | - |
phraseAcos | 字符串 | 词组ACOS | - |
phraseAcos.min | 数字 | 最小 | - |
phraseAcos.max | 数字 | 最大 | - |
phraseAcos.value | 数字 | 中位数 | - |
exactAcos | 字符串 | 精确ACOS | - |
exactAcos.min | 数字 | 最小 | - |
exactAcos.max | 数字 | 最大 | - |
exactAcos.value | 数字 | 中位数 | - |
broadAcos | 字符串 | 广泛ACOS | - |
broadAcos.min | 数字 | 最小 | - |
broadAcos.max | 数字 | 最大 | - |
broadAcos.value | 数字 | 中位数 | - |
avgProductPrice | 字符串 | 产品均价 | - |
avgProductPrice.min | 数字 | 最小 | - |
avgProductPrice.max | 数字 | 最大 | - |
avgProductPrice.value | 数字 | 中位数 | - |
top3Asins | 数组 | 前三ASIN列表 | - |
top10Asins | 数组 | 前10ASIN列表 | - |
返回示例
{
"request_id": "8fb43e59-4ff9-4dc8-a4b7-2ed164e45ab8",
"data": {
"guestId": null,
"pages": 0,
"page": 1,
"size": 2,
"total": 2394,
"took": 0,
"url": null,
"order": {
"field": "",
"desc": true
},
"items": [
{
"keyword": "lunch box",
"keywordCn": "午餐盒",
"keywordJp": "弁当箱",
"searches": 349991,
"clicks": 91282,
"purchases": 5412,
"searchConvRate": 0.0155,
"clickConvRate": 0.0593,
"searchesTrend": null,
"clickTrend": null,
"purchaseTrend": null,
"phrasePpc": {
"value": 0.7,
"min": 0.49,
"max": 0.79
},
"exactPpc": {
"value": 0.58,
"min": 0.45,
"max": 0.65
},
"broadPpc": {
"value": 0.71,
"min": 0.49,
"max": 0.79
},
"phraseCpa": {
"value": 11.8044,
"min": 8.2631,
"max": 13.3221
},
"exactCpa": {
"value": 9.7808,
"min": 7.5885,
"max": 10.9612
},
"broadCpa": {
"value": 11.973,
"min": 8.2631,
"max": 13.3221
},
"avgProductPrice": {
"value": 22.99,
"min": 6.99,
"max": 66.99
},
"phraseBudget": {
"value": 18.9,
"min": 13.23,
"max": 21.33
},
"exactBudget": {
"value": 15.66,
"min": 12.15,
"max": 17.55
},
"broadBudget": {
"value": 19.17,
"min": 13.23,
"max": 21.33
},
"phraseAcos": {
"value": 0.5135,
"min": 1.6888,
"max": 0.1762
},
"exactAcos": {
"value": 0.4254,
"min": 1.3993,
"max": 0.146
},
"broadAcos": {
"value": 0.5208,
"min": 1.7129,
"max": 0.1787
},
"clickingRate": 0.1976,
"conversionRate": 0.1329,
"top3Asins": [
{
"asin": "B0GDZLL8BK",
"imageUrl": "https://m.media-amazon.com/images/I/41p2Jl7uYAL._AC_US200_.jpg",
"clickRate": 0.0912,
"conversionRate": 0.0271
}
],
"top10Asins": [
{
"station": "US",
"keyword": "lunch box",
"categoryId": null,
"maxPage": null,
"asin": "B0DBDKT4QC",
"asinUrl": "HOTOR Insulated Lunch Box for Men & Women - Leak-Proof Cooler Lunch Bag with 4 Pockets, Adjustable Strap, Ideal for Work, Picnic, Travel - Medium, Black, 10.2\"×6.9\"×8.5\"",
"asinImage": "https://m.media-amazon.com/images/I/41w24kLyRVL._AC_US200_.jpg",
"bigAsinImage": null,
"asinPrice": 8.99,
"asinReviews": 7423,
"asinRating": 4.5,
"asinBrand": null,
"asinTitle": "HOTOR Insulated Lunch Box for Men & Women - Leak-Proof Cooler Lunch Bag with 4 Pockets, Adjustable Strap, Ideal for Work, Picnic, Travel - Medium, Black, 10.2\"×6.9\"×8.5\"",
"rank": null,
"rankPage": 1,
"rankPagesize": 56,
"rankIndex": 4,
"position": 4,
"products": 30639,
"sku": null,
"maxRankPage": null,
"ad": null,
"amazonChoice": null,
"badges": "AC",
"handledImageUrl": true
}
],
"phraseCount": 2
}
],
"terminal": null,
"hasNextPage": null,
"guestVisited": false
}
}错误响应、请求追踪和限流头说明见错误与限流。
可组合使用的 AI Skills 与 Agents
从业务任务出发,查看这些能力如何使用当前 API,并在安装前审阅来源与权限。
Amazon 广告策略 Skill
规划 Sponsored Products、Sponsored Brands、Sponsored Display、预算分配、ACoS 优化和效果复核。
Amazon 品牌分析 Skill
解释搜索频率、购物篮、商品比较和人群证据,支持 Amazon 品牌决策。
Amazon 否定关键词 Skill
分析 Amazon 搜索词、识别浪费、估算节省空间,并提出带复核保护的否定关键词规则。
Amazon PPC 广告活动 Skill
创建或审计 Amazon PPC 结构、关键词分组、竞价、否定词、ACoS 目标和逐周优化动作。