关键词反查(流量词列表)
反查 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 调用
| 项目 | 内容 |
|---|---|
| MCP Code | amazon_traffic_keyword |
历史路径仍可调用,但已弃用:
/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"。 详见表 1.2。 | US |
asin | 字符串 | 是 | asin 格式需匹配 ^[A-Z0-9]{10}$。 | B07Z82895W |
month | 字符串 | 否 | 历史月份,不传默认最近30天 格式需匹配 ^\d{6}$。 可用值(表 1.1):nearly、yyyyMM | 202308 |
page | 整数 | 否 | 当前页 默认1 默认值:1。 最小值:1。 最大值:100。 | 1 |
size | 整数 | 否 | 每页显示多少条 默认50,最大100,最多查询2000条数据 默认值:100。 最小值:1。 最大值:100。 | 50 |
返回结构
| 字段 | 类型 | 说明 |
|---|---|---|
request_id | 字符串 | 本次请求的唯一标识。 |
data | 对象 | 接口业务数据。 |
下表字段位于 data 内。数组接口描述的是单个数组元素,分页接口描述的是 items[] 中的单条记录。
返回字段
| 字段 | 类型 | 说明 | 示例 |
|---|---|---|---|
marketplace | 字符串 | 市场编码 可用值(表 1.2):US、JP、UK、DE、FR、IT、ES、CA、IN、MX、BR、AU、AE | US, JP, UK |
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 | 数组 | 曝光位置 可用值(表 1.10):naturalSearching、amazonChoice、editorialRecommendations、fourStar、highlyRated、sponsorBrand、sponsorVideo、ads | naturalSearching, amazonChoice, editorialRecommendations |
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):流量占比类型: primary、precise、preciseLongTail; 曝光位置: naturalSearching、amazonChoice、editorialRecommendations、fourStar、highlyRated、sponsorBrand、sponsorVideo、ads | primary, precise, preciseLongTail |
items.conversionKeywordType | 字符串 | 转换效果类型 可用值(表 2.1):excellent、stable、lost、invalid | excellent, stable, lost |
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
}
]
}
}错误响应、请求追踪和限流头说明见错误与限流。
能力概览、常见用法与 FAQ
Amazon 反查 ASIN API:查竞品的流量关键词
传入任意 Amazon ASIN,返回它获得排名和投放广告的关键词,附搜索量、购买率、自然位和广告位,以及流量占比,格式为 JSON。
可组合使用的 AI Skills 与 Agents
从业务任务出发,查看这些能力如何使用当前 API,并在安装前审阅来源与权限。
Amazon 关键词研究 Skill
挖掘长尾词、比较关键词机会,并整理 Amazon 多站点的需求、竞争和季节性证据。
Amazon Listing 优化 Skill
结合商品事实、关键词覆盖、竞品背景、转化文案和八维审计,创建或优化 Amazon Listing。
Amazon PPC 广告报表审计
审计 Amazon PPC 广告报表,重点分析 Sponsored Products Search Term Report,识别浪费支出、转化搜索词、出价机会、否定词和每周行动。
Amazon 后台搜索词 Skill
在规定字节限制和相关性约束内,排序、去重并格式化 Amazon 后台搜索词。