查流量来源(关键词流向)
查询 Amazon ASIN 或关键词的流量来源与关键词流向。
API 数据样例
直接查看该接口实际使用的请求体和完整响应结构。
{
"marketplace": "US",
"page": 1,
"size": 1,
"q": "Q"
}{
"request_id": "8fb43e59-4ff9-4dc8-a4b7-2ed164e45ab8",
"data": {
"guestId": null,
"pages": 0,
"page": 1,
"size": 1,
"total": 9,
"took": 0,
"url": null,
"order": {
"field": "",
"desc": true
},
"items": [
{
"keywords": 1128,
"searchKeywords": 1037,
"acKeywords": 0,
"editorialKeywords": 0,
"fourStarsKeywords": 0,
"hrKeywords": 13,
"adKeywords": 225,
"videoKeywords": 9,
"brandKeywords": 0,
"badgeDetails": {
"AD": [
"SPONSOR_VIDEO"
],
"SEARCH": [
"NATURAL_SEARCHING"
]
},
"badgeLabels": [
"SEARCH"
],
"asinInfo": {
"asin": "B07Z82895W",
"asinUrl": "https://www.amazon.com/dp/B07Z82895W?psc=1",
"currency": null,
"price": 9.99,
"rating": 4.5,
"reviews": 68849,
"sku": "Color: BLACK",
"title": "LISEN Cell Phone Stand Adjustable for iPhone Phone Holder for Desk, Office Desk Accessories Computer PC for iPhone Stand Gaming Essentials Fit Otterbox Case Phones Switch Kindle iPad Air Tablet 4-10in",
"variations": 9,
"category1Id": null,
"category1Name": null,
"nodeId": 23690036011,
"nodeIdPath": "2335752011:2407755011:23690036011",
"nodeLabelPath": "Cell Phones & Accessories:Accessories:Stands",
"bsrRank": 422,
"bsrId": "wireless",
"bsrLabel": "Cell Phones & Accessories"
}
}
],
"terminal": null,
"hasNextPage": null,
"guestVisited": false
}
}可用状态:已开放
该接口已进入 v1 网关、OpenAPI 和订阅权限目录,成功调用一次消耗 1 个计费单位。
POST /v1/amazon/traffic/source
下方请求和响应字段已与当前公开契约核对。
接口对应关系
| 项目 | 内容 |
|---|---|
| MCP Code | traffic_source |
| 原始 REST 方法 | POST |
| 原始 REST 路径 | /v1/traffic/source |
| 原始 API 文档 | 打开官方 API 文档 |
历史路径仍可调用,但已弃用:
/v1/amazon/traffic/sources。兼容请求会返回Deprecation: true和指向规范路径的Link响应头。
快速调用
先创建 API 密钥,再将密钥写入服务端环境变量:
export ECOMMERCE_DATA_API_KEY="your_api_key"curl --request POST \
--url https://ecommercedataapi.com/v1/amazon/traffic/source \
--header "Content-Type: application/json" \
--header "X-API-Key: ${ECOMMERCE_DATA_API_KEY}" \
--data '{
"marketplace": "US",
"page": 1,
"size": 1,
"q": "Q"
}'使用 AI CLI 接入
复制给 AI CLI
粘贴到 Codex、Claude Code、Gemini CLI 或其他编程智能体中直接完成接入。
请直接在当前代码库中接入 Ecommerce Data API 的「查流量来源(关键词流向)」接口,不要只给示例代码。
接口文档:https://ecommercedataapi.com/zh/docs/amazon/traffic/source
请求接口:POST https://ecommercedataapi.com/v1/amazon/traffic/source
API 密钥环境变量:ECOMMERCE_DATA_API_KEY
请求示例:
{
"marketplace": "US",
"page": 1,
"size": 1,
"q": "Q"
}
请按以下要求执行:
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/source',
{
method: 'POST',
headers: {
'Content-Type': 'application/json',
'X-API-Key': process.env.ECOMMERCE_DATA_API_KEY,
},
body: JSON.stringify({
marketplace: 'US',
page: 1,
size: 1,
q: 'Q',
}),
}
);
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/source",
headers={
"Content-Type": "application/json",
"X-API-Key": os.environ["ECOMMERCE_DATA_API_KEY"],
},
json={
"marketplace": "US",
"page": 1,
"size": 1,
"q": "Q",
},
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 |
month | 字符串 | 否 | 筛选日期,yyyyMM格式 | 202203 |
order | 对象 | 否 | 排序 | {} |
order.desc | 布尔值 | 否 | true为降序 false为升序 默认降序 | true |
order.field | 字符串 | 否 | 排序字段 见表2.4 | searches |
page | 整数 | 否 | 页码,从 1 开始 默认:1 最小值:1。 | 1 |
q | 字符串 | 是 | asin 或者 关键词 | B07Z82895W |
returnFields | 字符串 | 否 | 可选的返回字段选择字符串;不传时返回标准字段。 | keywords,searchKeywords,acKeywords |
size | 整数 | 否 | 每页条数 默认:50最大: 100 最小值:1。 | 50 |
返回结构
| 字段 | 类型 | 说明 |
|---|---|---|
request_id | 字符串 | 本次请求的唯一标识。 |
data | 对象 | 接口业务数据。 |
下表字段位于 data 内。数组接口描述的是单个数组元素,分页接口描述的是 items[] 中的单条记录。
返回字段
| 字段 | 类型 | 说明 | 示例 |
|---|---|---|---|
keywords | 整数 | 全部流量词 | 1 |
searchKeywords | 整数 | 自然搜索词 | 12 |
acKeywords | 字符串 | AC推荐词 | 13 |
editorialKeywords | 整数 | ER推荐词 | 13 |
fourStarsKeywords | 整数 | 4星推荐词 | 14 |
hrKeywords | 整数 | HR推荐词 | 1 |
adKeywords | 整数 | SP广告词 | 3 |
videoKeywords | 整数 | 视频广告词 | 4 |
brandKeywords | 整数 | 品牌广告词 | 5 |
badgeLabels | 数组 | 流量来源概览 | [“SEARCH”, “OFFICIAL”, “AD”] |
badgeDetails | 字符串 | 流量来源明细 | {“SEARCH”: [“NATURAL_SEARCHING”],”OFFICIAL”: [“AMAZON_CHOICE”],”AD”: [“SPONSOR_BRAND”,”SPONSOR_VIDEO”,”HIGHLY_RATED”,”ADS”]} |
asinInfo | 对象 | Asin相关信息 | - |
asinInfo.asin | 字符串 | asin | B078J8VPVW |
asinInfo.asinUrl | 字符串 | 该asin对应亚马逊地址 | https://www.amazon.com/dp/B08GHW4TBS |
asinInfo.currency | 字符串 | 货币code | $ |
asinInfo.price | 数字 | 价格 | 23 |
asinInfo.rating | 数字 | 评分 | 234 |
asinInfo.reviews | 整数 | 评分数 | 23 |
asinInfo.title | 字符串 | 标题 | Diapers Size 2, 186 Count - Pampers Swaddlers Disposable Baby Diapers, ONE MONTH SUPPLY |
asinInfo.sku | 字符串 | sku | ["Color: Beige","Size: 47 inches"] |
asinInfo.variations | 整数 | 变体数 | 2 |
asinInfo.nodeId | 整数 | 类目ID | 12097479011 |
asinInfo.nodeIdPath | 字符串 | 类目ID路径 | 172282:24046923011:172541:12097479011 |
asinInfo.nodeLabelPath | 字符串 | 类目路径 | Electronics:Headphones, Earbuds & Accessories:Headphones & Earbuds:Over-Ear Headphones |
asinInfo.bsrRank | 整数 | 大类排名(BSR) | 175204 |
返回示例
{
"request_id": "8fb43e59-4ff9-4dc8-a4b7-2ed164e45ab8",
"data": {
"guestId": null,
"pages": 0,
"page": 1,
"size": 1,
"total": 9,
"took": 0,
"url": null,
"order": {
"field": "",
"desc": true
},
"items": [
{
"keywords": 1128,
"searchKeywords": 1037,
"acKeywords": 0,
"editorialKeywords": 0,
"fourStarsKeywords": 0,
"hrKeywords": 13,
"adKeywords": 225,
"videoKeywords": 9,
"brandKeywords": 0,
"badgeDetails": {
"AD": ["SPONSOR_VIDEO"],
"SEARCH": ["NATURAL_SEARCHING"]
},
"badgeLabels": ["SEARCH"],
"asinInfo": {
"asin": "B07Z82895W",
"asinUrl": "https://www.amazon.com/dp/B07Z82895W?psc=1",
"currency": null,
"price": 9.99,
"rating": 4.5,
"reviews": 68849,
"sku": "Color: BLACK",
"title": "LISEN Cell Phone Stand Adjustable for iPhone Phone Holder for Desk, Office Desk Accessories Computer PC for iPhone Stand Gaming Essentials Fit Otterbox Case Phones Switch Kindle iPad Air Tablet 4-10in",
"variations": 9,
"category1Id": null,
"category1Name": null,
"nodeId": 23690036011,
"nodeIdPath": "2335752011:2407755011:23690036011",
"nodeLabelPath": "Cell Phones & Accessories:Accessories:Stands",
"bsrRank": 422,
"bsrId": "wireless",
"bsrLabel": "Cell Phones & Accessories"
}
}
],
"terminal": null,
"hasNextPage": null,
"guestVisited": false
}
}错误响应、请求追踪和限流头说明见错误与限流。
可组合使用的 AI Skills 与 Agents
从业务任务出发,查看这些能力如何使用当前 API,并在安装前审阅来源与权限。
Ecommerce Data API Agent Skill
在支持的 AI 编程 Agent 中发现、检查并调用实时 Amazon 商品、关键词、市场、流量、评论和商标 API。
Amazon 广告策略 Skill
规划 Sponsored Products、Sponsored Brands、Sponsored Display、预算分配、ACoS 优化和效果复核。
Amazon 竞品分析 Skill
从 Listing、价格、评论、广告、定位和产品弱点等维度比较 Amazon 竞品。
跨平台电商 PPC 策略 Skill
根据利润、盈亏平衡 ROAS、预算约束、漏斗阶段和已有广告结果规划 Google、Meta 与 TikTok 广告。