关键词反查(流量词列表)
反查 Amazon ASIN 的流量词列表、自然和广告排名、搜索需求、PPC 与流量占比。
API 数据样例
直接查看该接口实际使用的请求体和完整响应结构。
{
"marketplace": "US",
"asin": "B08CK5Z5Q1",
"month": "202507",
"page": 1,
"size": 20
}{
"request_id": "8fb43e59-4ff9-4dc8-a4b7-2ed164e45ab8",
"data": {
"marketplace": "US",
"asin": "B07Z82895W",
"total": 1023,
"items": [
{
"keyword": "phone accessory",
"keywordCn": "手机配件",
"searches": 530,
"products": 144065,
"purchases": 3,
"purchaseRate": 0.007,
"bid": 0.77,
"bidMax": 0.96,
"bidMin": 0.58,
"badges": [
"naturalSearching"
],
"rankPosition": {
"page": 3,
"pageSize": 17,
"index": 4,
"position": 52,
"updatedTime": 1753349221000
},
"adPosition": {
"page": 3,
"pageSize": 20,
"index": 20,
"position": 73,
"updatedTime": 1752120219000
},
"updatedTime": 1753349221000,
"searchesRank": 2443672,
"searchesRankTimeFrom": 1752940800000,
"searchesRankTimeTo": 1753459200000,
"latest1daysAds": 0,
"latest7daysAds": 48,
"latest30daysAds": 170,
"supplyDemandRatio": 0,
"trafficPercentage": 0,
"trafficKeywordType": null,
"conversionKeywordType": null,
"calculatedWeeklySearches": 0,
"titleDensity": 1,
"spr": 1,
"monopolyClickRate": 0.2307,
"top3ClickingRate": 0.2307,
"top3ConversionRate": 0,
"clicks": 229,
"impressions": 13957,
"naturalRatio": 0.98009,
"adRatio": 0.01991,
"topAsins": null,
"searchesTrend": null
}
],
"stats": [
{
"keywords": "phone",
"total": 1
}
]
}
}可用状态:已开放
该接口已进入 v1 网关、OpenAPI 和订阅权限目录,成功调用一次消耗 1 个计费单位。
POST /v1/amazon/traffic/keyword
下方请求和响应字段已与当前公开契约核对。
接口对应关系
| 项目 | 内容 |
|---|---|
| MCP Code | traffic_keyword |
| 原始 REST 方法 | POST |
| 原始 REST 路径 | /v1/traffic/keyword |
| 原始 API 文档 | 打开官方 API 文档 |
历史路径仍可调用,但已弃用:
/v1/amazon/keywords/reverse-lookup。兼容请求会返回Deprecation: true和指向规范路径的Link响应头。
快速调用
先创建 API 密钥,再将密钥写入服务端环境变量:
export ECOMMERCE_DATA_API_KEY="your_api_key"curl --request POST \
--url https://ecommercedataapi.com/v1/amazon/traffic/keyword \
--header "Content-Type: application/json" \
--header "X-API-Key: ${ECOMMERCE_DATA_API_KEY}" \
--data '{
"marketplace": "US",
"asin": "B08CK5Z5Q1",
"month": "202507",
"page": 1,
"size": 20
}'使用 AI CLI 接入
复制给 AI CLI
粘贴到 Codex、Claude Code、Gemini CLI 或其他编程智能体中直接完成接入。
请直接在当前代码库中接入 Ecommerce Data API 的「关键词反查(流量词列表)」接口,不要只给示例代码。
接口文档:https://ecommercedataapi.com/zh/docs/amazon/traffic/keyword
请求接口:POST https://ecommercedataapi.com/v1/amazon/traffic/keyword
API 密钥环境变量:ECOMMERCE_DATA_API_KEY
请求示例:
{
"marketplace": "US",
"asin": "B08CK5Z5Q1",
"month": "202507",
"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/traffic/keyword',
{
method: 'POST',
headers: {
'Content-Type': 'application/json',
'X-API-Key': process.env.ECOMMERCE_DATA_API_KEY,
},
body: JSON.stringify({
marketplace: 'US',
asin: 'B08CK5Z5Q1',
month: '202507',
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/traffic/keyword",
headers={
"Content-Type": "application/json",
"X-API-Key": os.environ["ECOMMERCE_DATA_API_KEY"],
},
json={
"marketplace": "US",
"asin": "B08CK5Z5Q1",
"month": "202507",
"page": 1,
"size": 20,
},
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"。 | US |
asin | 字符串 | 是 | asin 格式需匹配 ^[A-Z0-9]{10}$。 | B07Z82895W |
month | 字符串 | 否 | 历史月份,不传默认最近30天 格式需匹配 ^\d{6}$。 | 202308 |
page | 整数 | 否 | 当前页 默认1 默认值:1。 最小值:1。 最大值:100。 | 1 |
size | 整数 | 否 | 每页显示多少条 默认50,最大100,最多查询2000条数据 默认值:100。 最小值:1。 最大值:100。 | 50 |
返回结构
| 字段 | 类型 | 说明 |
|---|---|---|
request_id | 字符串 | 本次请求的唯一标识。 |
data | 对象 | 接口业务数据。 |
下表字段位于 data 内。数组接口描述的是单个数组元素,分页接口描述的是 items[] 中的单条记录。
返回字段
| 字段 | 类型 | 说明 | 示例 |
|---|---|---|---|
marketplace | 字符串 | 市场编码 | 见表 1.2 |
asin | 字符串 | asin | B07Z82895W |
total | 整数 | 总条数 | 2685 |
items | 数组 | 词条 | 1848 |
items.keyword | 字符串 | 关键词 | 该ASIN近30天或某个自然月进入过亚马逊搜索结果前3页的词 |
items.keywordCn | 字符串 | 关键词中文翻译 | 手机支架 |
items.searches | 字符串 | 月搜索量 | 指的是一个自然月的月搜索量,比如2025年8月,该关键词在亚马逊站内的搜索总次数 |
items.products | 字符串 | 商品数 | 指搜索该关键词后出现了多少个相关的产品 |
items.purchases | 字符串 | 月购买量 | 在亚马逊站内搜索该关键词后产生购买的次数,比如:某用户搜索iphone charger,然后1次购买了1个iphone充电器,2条数据线(关联推荐的商品),则购买量=1 |
items.purchaseRate | 字符串 | 购买率 | 指买家输入该搜索词并点击此细分市场中的任意商品后,买家的购买次数占买家输入该搜索词总次数的比例 |
items.bid | 字符串 | PPC竞价 | 亚马逊站内广告Bid价格,系统提供【词组匹配】的Bid建议价格以及范围 |
items.bidMax | 数字 | PPC竞价范围 | - |
items.bidMin | 数字 | PPC竞价范围 | - |
items.badges | 数组 | 曝光位置 | ASIN在对应关键词的搜索结果下曝光的具体位置, 见表1.10 |
items.rankPosition | 字符串 | 自然排名 | - |
items.rankPosition.page | 整数 | 第几页 | 3 |
items.rankPosition.pageSize | 整数 | 每页多少条数据 | 60 |
items.rankPosition.index | 整数 | 当前页排第几 | 10 |
items.rankPosition.position | 整数 | 总结果中排第几 | 106 |
items.rankPosition.updatedTime | 整数 | 排名时间 | - |
items.adPosition | 字符串 | 广告排名 | - |
items.adPosition.page | 整数 | 第几页 | 2 |
items.adPosition.pageSize | 整数 | 每页多少条数据 | 63 |
items.adPosition.index | 整数 | 当前页排第几 | 37 |
items.adPosition.position | 整数 | 总结果中排第几 | 85 |
items.adPosition.updatedTime | 整数 | 排名时间 | - |
items.searchesRank | 字符串 | 周搜索量排名 | 数据来源于亚马逊ABA数据的关键词搜索频率排名(Search Frequency Rank),数字越小表示排名越靠前,搜索量越高 |
items.searchesRankTimeFrom | 整数 | 周搜索量排名时间范围 | - |
items.searchesRankTimeTo | 整数 | searchesRankTimeTo | - |
items.latest1daysAds | 字符串 | 最近1天广告竞品数 | 表示近1天内进入过该关键词搜索结果前3页的广告产品总数,包括SP广告、HR广告、品牌广告和视频广告 |
items.latest7daysAds | 字符串 | 最近7天广告竞品数 | 表示近7天内进入过该关键词搜索结果前3页的广告产品总数,包括SP广告、HR广告、品牌广告和视频广告 |
items.latest30daysAds | 字符串 | 最近30天广告竞品数 | 表示近30天内进入过该关键词搜索结果前3页的广告产品总数,包括SP广告、HR广告、品牌广告和视频广告 |
items.supplyDemandRatio | 字符串 | 供需比 | 搜索量(需求) / 商品数(供应),在同类市场中,需供比值越高,则代表该市场需求越强劲 |
items.trafficPercentage | 字符串 | 流量占比 | 指的是产品通过不同流量词获得的曝光量占比 |
items.trafficKeywordType | 字符串 | 流量占比类型 | 见表2.0 |
items.conversionKeywordType | 字符串 | 转换效果类型 | 见表2.1 |
items.calculatedWeeklySearches | 字符串 | 预估周曝光量 | 指的是该关键词本周内给产品带来的预估曝光量,非该词在亚马逊的总搜索量 |
items.impressions | 字符串 | 展示量 | 指一个自然月,比如2024年3月,在某个关键词搜索结果页中所有ASIN的总展示次数,非单个ASIN在关键词下的曝光量 |
items.updatedTime | 整数 | 更新时间 | - |
items.clicks | 字符串 | 点击量 | 指一个自然月,比如2024年3月,在某个关键词搜索结果页中被点击的总次数,非单个ASIN在关键词下的点击量 |
items.naturalRatio | 数字 | 流量分布-自然占比 | 0.9312 |
items.adRatio | 数字 | 流量分布-广告占比 | 0.0688 |
stats | 数组 | 高频词 | - |
stats.keywords | 字符串 | 词 | phone |
stats.total | 整数 | 总条数 | 90 |
stats.total.page | 整数 | 第几页 | 2 |
stats.total.pageSize | 整数 | 每页多少条数据 | 63 |
stats.total.index | 整数 | 当前页排第几 | 37 |
stats.total.position | 整数 | 总结果中排第几 | 85 |
stats.total.updatedTime | 整数 | 排名时间 | - |
返回示例
{
"request_id": "8fb43e59-4ff9-4dc8-a4b7-2ed164e45ab8",
"data": {
"marketplace": "US",
"asin": "B07Z82895W",
"total": 1023,
"items": [
{
"keyword": "phone accessory",
"keywordCn": "手机配件",
"searches": 530,
"products": 144065,
"purchases": 3,
"purchaseRate": 0.007,
"bid": 0.77,
"bidMax": 0.96,
"bidMin": 0.58,
"badges": ["naturalSearching"],
"rankPosition": {
"page": 3,
"pageSize": 17,
"index": 4,
"position": 52,
"updatedTime": 1753349221000
},
"adPosition": {
"page": 3,
"pageSize": 20,
"index": 20,
"position": 73,
"updatedTime": 1752120219000
},
"updatedTime": 1753349221000,
"searchesRank": 2443672,
"searchesRankTimeFrom": 1752940800000,
"searchesRankTimeTo": 1753459200000,
"latest1daysAds": 0,
"latest7daysAds": 48,
"latest30daysAds": 170,
"supplyDemandRatio": 0,
"trafficPercentage": 0,
"trafficKeywordType": null,
"conversionKeywordType": null,
"calculatedWeeklySearches": 0,
"titleDensity": 1,
"spr": 1,
"monopolyClickRate": 0.2307,
"top3ClickingRate": 0.2307,
"top3ConversionRate": 0,
"clicks": 229,
"impressions": 13957,
"naturalRatio": 0.98009,
"adRatio": 0.01991,
"topAsins": null,
"searchesTrend": null
}
],
"stats": [
{
"keywords": "phone",
"total": 1
}
]
}
}错误响应、请求追踪和限流头说明见错误与限流。
可组合使用的 AI Skills 与 Agents
从业务任务出发,查看这些能力如何使用当前 API,并在安装前审阅来源与权限。
Amazon 关键词研究 Skill
挖掘长尾词、比较关键词机会,并整理 Amazon 多站点的需求、竞争和季节性证据。
Amazon Listing 优化 Skill
结合商品事实、关键词覆盖、竞品背景、转化文案和八维审计,创建或优化 Amazon Listing。
Amazon 后台搜索词 Skill
在规定字节限制和相关性约束内,排序、去重并格式化 Amazon 后台搜索词。
Amazon 否定关键词 Skill
分析 Amazon 搜索词、识别浪费、估算节省空间,并提出带复核保护的否定关键词规则。