流量词统计
获取 Amazon ASIN 的流量词汇总统计数据。
API 数据样例
直接查看该接口实际使用的请求体和完整响应结构。
{
"marketplace": "US",
"asin": "B08CK5Z5Q1"
}{
"request_id": "8fb43e59-4ff9-4dc8-a4b7-2ed164e45ab8",
"data": {
"marketplace": "US",
"asin": "B0DXTMS9NF",
"keywords": 60,
"ranks": 9,
"ads": 52,
"badgeCount": {
"ns": 9,
"ac": null,
"er": null,
"fs": null,
"hr": null,
"sb": null,
"sv": null,
"ad": 52
},
"calcTime": 1757856276576
}
}可用状态:已开放
该接口已进入 v1 网关、OpenAPI 和订阅权限目录,成功调用一次消耗 1 个计费单位。
POST /v1/amazon/traffic/keyword/stat
下方请求和响应字段已与当前公开契约核对。
接口对应关系
| 项目 | 内容 |
|---|---|
| MCP Code | traffic_keyword_stat |
| 原始 REST 方法 | GET |
| 原始 REST 路径 | /v1/traffic/keyword/stat/{marketplace}/{asin} |
| 原始 API 文档 | 打开官方 API 文档 |
历史路径仍可调用,但已弃用:
/v1/amazon/keywords/traffic-stats。兼容请求会返回Deprecation: true和指向规范路径的Link响应头。
快速调用
先创建 API 密钥,再将密钥写入服务端环境变量:
export ECOMMERCE_DATA_API_KEY="your_api_key"curl --request POST \
--url https://ecommercedataapi.com/v1/amazon/traffic/keyword/stat \
--header "Content-Type: application/json" \
--header "X-API-Key: ${ECOMMERCE_DATA_API_KEY}" \
--data '{
"marketplace": "US",
"asin": "B08CK5Z5Q1"
}'使用 AI CLI 接入
复制给 AI CLI
粘贴到 Codex、Claude Code、Gemini CLI 或其他编程智能体中直接完成接入。
请直接在当前代码库中接入 Ecommerce Data API 的「流量词统计」接口,不要只给示例代码。
接口文档:https://ecommercedataapi.com/zh/docs/amazon/traffic/keyword/stat
请求接口:POST https://ecommercedataapi.com/v1/amazon/traffic/keyword/stat
API 密钥环境变量:ECOMMERCE_DATA_API_KEY
请求示例:
{
"marketplace": "US",
"asin": "B08CK5Z5Q1"
}
请按以下要求执行:
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/stat',
{
method: 'POST',
headers: {
'Content-Type': 'application/json',
'X-API-Key': process.env.ECOMMERCE_DATA_API_KEY,
},
body: JSON.stringify({
marketplace: 'US',
asin: 'B08CK5Z5Q1',
}),
}
);
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/stat",
headers={
"Content-Type": "application/json",
"X-API-Key": os.environ["ECOMMERCE_DATA_API_KEY"],
},
json={
"marketplace": "US",
"asin": "B08CK5Z5Q1",
},
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 |
asin | 字符串 | 是 | asin 格式需匹配 ^[A-Z0-9]{10}$。 | B07Z82895W |
month | 字符串 | 否 | 查询月份 | 202605 |
returnFields | 字符串 | 否 | 可选的返回字段选择字符串;不传时返回标准字段。 | marketplace,asin,keywords |
返回结构
| 字段 | 类型 | 说明 |
|---|---|---|
request_id | 字符串 | 本次请求的唯一标识。 |
data | 对象 | 接口业务数据。 |
下表字段位于 data 内。数组接口描述的是单个数组元素,分页接口描述的是 items[] 中的单条记录。
返回字段
| 字段 | 类型 | 说明 | 示例 |
|---|---|---|---|
marketplace | 字符串 | 市场 | US |
asin | 字符串 | asin | B07Z82895W |
keywords | 整数 | 全部流量词条数 | 2685 |
ranks | 整数 | 自然流量词条数 | 1848 |
ads | 整数 | 广告流量词条数 | 1414 |
calcTime | 整数 | 最近计算时间 | - |
badgeCount | 对象 | 流量词类型统计 | - |
badgeCount.ns | 整数 | 自然搜索词数量 | 1070 |
badgeCount.ac | 整数 | AC推荐词数量 | 0 |
badgeCount.er | 整数 | ER推荐词数量 | 42 |
badgeCount.fs | 整数 | 4星推荐词数量 | 0 |
badgeCount.hr | 整数 | HR广告词数量 | 117 |
badgeCount.sb | 整数 | 品牌广告词数量 | 334 |
badgeCount.sv | 整数 | 视频广告词数量 | 208 |
badgeCount.ad | 整数 | SP广告词数量 | 764 |
返回示例
{
"request_id": "8fb43e59-4ff9-4dc8-a4b7-2ed164e45ab8",
"data": {
"marketplace": "US",
"asin": "B0DXTMS9NF",
"keywords": 60,
"ranks": 9,
"ads": 52,
"badgeCount": {
"ns": 9,
"ac": null,
"er": null,
"fs": null,
"hr": null,
"sb": null,
"sv": null,
"ad": 52
},
"calcTime": 1757856276576
}
}错误响应、请求追踪和限流头说明见错误与限流。
可组合使用的 AI Skills 与 Agents
从业务任务出发,查看这些能力如何使用当前 API,并在安装前审阅来源与权限。
Amazon 广告策略 Skill
规划 Sponsored Products、Sponsored Brands、Sponsored Display、预算分配、ACoS 优化和效果复核。
Amazon 否定关键词 Skill
分析 Amazon 搜索词、识别浪费、估算节省空间,并提出带复核保护的否定关键词规则。
Amazon PPC 广告活动 Skill
创建或审计 Amazon PPC 结构、关键词分组、竞价、否定词、ACoS 目标和逐周优化动作。
跨平台电商 PPC 策略 Skill
根据利润、盈亏平衡 ROAS、预算约束、漏斗阶段和已有广告结果规划 Google、Meta 与 TikTok 广告。