拓展流量词
根据 ASIN 列表和市场条件拓展 Amazon 流量词。
API 数据样例
直接查看该接口实际使用的请求体和完整响应结构。
{
"asinList": [
"B07Z82895W"
],
"historyDate": "202507",
"marketplace": "US",
"page": 1,
"size": 1,
"queryType": 1
}{
"request_id": "8fb43e59-4ff9-4dc8-a4b7-2ed164e45ab8",
"data": {
"guestId": null,
"pages": 1026,
"page": 1,
"size": 1,
"total": 1026,
"took": 41,
"url": null,
"order": {
"field": "",
"desc": true
},
"items": [
{
"keyword": "phone stand",
"keywordCn": "手机支架",
"searches": 230786,
"products": 109304,
"purchases": 8862,
"purchaseRate": 0.0384,
"bid": 1.49,
"bidMax": 1.86,
"bidMin": 1.12,
"badges": [
"R"
],
"rankPosition": null,
"adPosition": null,
"updatedTime": 1753237657000,
"searchesRank": 2096,
"searchesRankTimeFrom": 1752940800000,
"searchesRankTimeTo": 1753459200000,
"latest1daysAds": 0,
"latest7daysAds": 133,
"latest30daysAds": 841,
"supplyDemandRatio": 2.11,
"trafficPercentage": 0.1131,
"calculatedWeeklySearches": 53388.32,
"avgPrice": 9.99,
"avgReviews": 58501,
"avgRating": 4.8,
"titleDensity": 32,
"spr": null,
"monopolyClickRate": 0.2511,
"top3ClickingRate": 0.2511,
"top3ConversionRate": 0.1859,
"relationVariationsItems": [
{
"marketplace": "US",
"asin": "B07Z82895W",
"imageUrl": "https://m.media-amazon.com/images/I/417iJirME2L._AC_SR200,200_.jpg",
"trafficPercentage": 0.11315,
"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",
"price": 9.99,
"reviews": 8360,
"rating": 4.5
}
]
}
],
"terminal": null,
"hasNextPage": null,
"guestVisited": false
}
}可用状态:已开放
该接口已进入 v1 网关、OpenAPI 和订阅权限目录,成功调用一次消耗 1 个计费单位。
POST /v1/amazon/traffic/extend
下方请求和响应字段已与当前公开契约核对。
接口对应关系
| 项目 | 内容 |
|---|---|
| MCP Code | traffic_extend |
| 原始 REST 方法 | POST |
| 原始 REST 路径 | /v1/traffic/extend |
| 原始 API 文档 | 打开官方 API 文档 |
历史路径仍可调用,但已弃用:
/v1/amazon/keywords/expand。兼容请求会返回Deprecation: true和指向规范路径的Link响应头。
快速调用
先创建 API 密钥,再将密钥写入服务端环境变量:
export ECOMMERCE_DATA_API_KEY="your_api_key"curl --request POST \
--url https://ecommercedataapi.com/v1/amazon/traffic/extend \
--header "Content-Type: application/json" \
--header "X-API-Key: ${ECOMMERCE_DATA_API_KEY}" \
--data '{
"asinList": [
"B07Z82895W"
],
"historyDate": "202507",
"marketplace": "US",
"page": 1,
"size": 1,
"queryType": 1
}'使用 AI CLI 接入
复制给 AI CLI
粘贴到 Codex、Claude Code、Gemini CLI 或其他编程智能体中直接完成接入。
请直接在当前代码库中接入 Ecommerce Data API 的「拓展流量词」接口,不要只给示例代码。
接口文档:https://ecommercedataapi.com/zh/docs/amazon/traffic/extend
请求接口:POST https://ecommercedataapi.com/v1/amazon/traffic/extend
API 密钥环境变量:ECOMMERCE_DATA_API_KEY
请求示例:
{
"asinList": [
"B07Z82895W"
],
"historyDate": "202507",
"marketplace": "US",
"page": 1,
"size": 1,
"queryType": 1
}
请按以下要求执行:
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/extend',
{
method: 'POST',
headers: {
'Content-Type': 'application/json',
'X-API-Key': process.env.ECOMMERCE_DATA_API_KEY,
},
body: JSON.stringify({
asinList: ['B07Z82895W'],
historyDate: '202507',
marketplace: 'US',
page: 1,
size: 1,
queryType: 1,
}),
}
);
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/extend",
headers={
"Content-Type": "application/json",
"X-API-Key": os.environ["ECOMMERCE_DATA_API_KEY"],
},
json={
"asinList": [
"B07Z82895W",
],
"historyDate": "202507",
"marketplace": "US",
"page": 1,
"size": 1,
"queryType": 1,
},
timeout=30,
)
response.raise_for_status()
print(response.json()["data"])请求参数
请求体直接发送下表字段,不要再包裹额外对象;未定义字段会被拒绝。
| 字段 | 类型 | 必填 | 说明 | 示例 |
|---|---|---|---|---|
amazonChoice | 布尔值 | 否 | 亚马逊推荐词 TRUE | true |
asinList | 数组 | 是 | asin列表(最多20) 至少 1 项。 最多 40 项。 | ["B07Z82895W"] |
excludeKeywords | 数组 | 否 | 排除的词 | ["phone stand"] |
historyDate | 字符串 | 否 | 历史日期,yyyyMM格式,最近30天不传或传空字符串 | 202201 |
includeKeywords | 数组 | 否 | 包含的词 | ["phone stand"] |
marketplace | 字符串 | 是 | 市场,支持的市场编码见 OpenAPI 枚举 可选值:US、UK、DE、FR、IT、ES、MX、CA、AU、JP、IN、AE、BR。 | US |
maxAdProducts | 整数 | 否 | 最大广告竞品数 | 345 |
maxAvgPrice | 数字 | 否 | 最大均价 | 30.3 |
maxBid | 数字 | 否 | 最大ppc竞价 | 23.1 |
maxCompetitors | 整数 | 否 | 最大asin数 | 23 |
maxConversionRate | 数字 | 否 | 最大转化率 | 1.4 |
maxMonopolyClickRate | 数字 | 否 | 最大点击集中度 | 53.1 |
maxProducts | 整数 | 否 | 最大商品数 | 90 |
maxPurchaseRate | 数字 | 否 | 最大购买率 | 43 |
maxPurchases | 整数 | 否 | 最大购买量 | 34 |
maxSPR | 整数 | 否 | 最大SPR | 16 |
maxSearchRank | 整数 | 否 | 最大搜索排名 | 3223 |
maxSearches | 整数 | 否 | 最大月搜索量 | 300 |
maxSupplyDemandRatio | 数字 | 否 | 最大供需比 | 45.2 |
maxTitleDensity | 整数 | 否 | 最大标题密度 | 23 |
maxTrafficPercentage | 数字 | 否 | 最大流量占比 | 23 |
maxWordCount | 整数 | 否 | 最大单词个数 | 4 |
minAdProducts | 整数 | 否 | 最小广告竞品数 | 123 |
minAvgPrice | 数字 | 否 | 最小均价 | 20 |
minBid | 数字 | 否 | 最小ppc竞价 | 10.2 |
minCompetitors | 整数 | 否 | 最小asin数 | 4 |
minConversionRate | 数字 | 否 | 最小转化率 | 0.23 |
minMonopolyClickRate | 数字 | 否 | 最小点击集中度 | 23.4 |
minProducts | 整数 | 否 | 最小商品数 | 10 |
minPurchaseRate | 数字 | 否 | 最小购买率 | 3 |
minPurchases | 整数 | 否 | 最小购买量 | 6 |
minSPR | 整数 | 否 | 最小SPR | 2 |
minSearchRank | 整数 | 否 | 最小搜索排名 | 33 |
minSearches | 整数 | 否 | 最小月搜索量 | 100 |
minSupplyDemandRatio | 数字 | 否 | 最小供需比 | 11.2 |
minTitleDensity | 整数 | 否 | 最小标题密度 | 2 |
minTrafficPercentage | 数字 | 否 | 最小流量占比 | 45 |
minWordCount | 整数 | 否 | 最小单词个数 | 2 |
order | 对象 | 否 | 排序 | {} |
order.desc | 布尔值 | 否 | true为降序 false为升序 默认降序 | true |
order.field | 字符串 | 否 | 排序字段 见表2.5 | searches |
page | 整数 | 否 | 页码,从 1 开始 默认:1 最小值:1。 | 1 |
queryType | 整数 | 是 | 查询方式 0 所有变体 1畅销变体 2当前变体,默认2 | 2 |
returnFields | 字符串 | 否 | 可选的返回字段选择字符串;不传时返回标准字段。 | keyword,keywordCn,searches |
size | 整数 | 否 | 每页条数,最大50 默认:50 最小值:1。 | 50 |
返回结构
| 字段 | 类型 | 说明 |
|---|---|---|
request_id | 字符串 | 本次请求的唯一标识。 |
data | 对象 | 接口业务数据。 |
下表字段位于 data 内。数组接口描述的是单个数组元素,分页接口描述的是 items[] 中的单条记录。
返回字段
| 字段 | 类型 | 说明 | 示例 |
|---|---|---|---|
keyword | 字符串 | 关键字 | N95 |
keywordCn | 字符串 | 关键词中文翻译 | 用于录音的电话支架 |
searches | 整数 | 搜索量 | 21582 |
purchases | 整数 | 月购买量 | 1996 |
purchaseRate | 数字 | 月购买率 | 0.0925 |
products | 整数 | 商品数 | 1645 |
bidMin | 数字 | 最小PPC价格 | 1.34 |
bidMax | 数字 | 最大PPC价格 | 3.21 |
bid | 数字 | PPC价格 | 1.6 |
badges | 数组 | 流量词类型 | 见表1.10 |
updatedTime | 整数 | 更新时间 | - |
searchesRank | 整数 | 周搜索量排名 | 25 |
searchesRankTimeFrom | 整数 | 周搜索量排名时间范围 | - |
searchesRankTimeTo | 整数 | searchesRankTimeTo | - |
latest1daysAds | 整数 | 最近1天广告竞品数 | 70 |
latest7daysAds | 整数 | 最近7天广告竞品数 | 100 |
latest30daysAds | 整数 | 最近30天广告竞品数 | 280 |
supplyDemandRatio | 数字 | 供需比 | 3.8 |
trafficPercentage | 数字 | 流量占比 | 0.015 |
calculatedWeeklySearches | 数字 | 预估周搜索量 | 40 |
avgPrice | 数字 | 平均价格 | 36.14 |
avgRatings | 整数 | 平均评分数 | 12223 |
avgRating | 数字 | 平均评分值 | 4.5 |
titleDensity | 整数 | 标题密度 | 42.9 |
spr | 整数 | SPR | 6 |
monopolyClickRate | 数字 | 点击垄断率 | 0.3 |
top3ClickingRate | 数字 | 前三点击 | 0.0813 |
top3ConversionRate | 数字 | 前三转化 | 0.2011 |
relationVariationsItems | 数组 | 来自于哪些变体 | - |
relationVariationsItems.marketplace | 字符串 | 站点 | 3 |
relationVariationsItems.asin | 字符串 | asin | B08P6SC34B |
relationVariationsItems.imageUrl | 字符串 | 图片链接 | 10 |
relationVariationsItems.trafficPercentage | 数字 | 流量占比 | 54.6 |
relationVariationsItems.title | 字符串 | 标题 | - |
relationVariationsItems.price | 数字 | 价格 | 60 |
relationVariationsItems.reviews | 数字 | 评论数 | 10 |
relationVariationsItems.rating | 数字 | 评分 | 4.5 |
返回示例
{
"request_id": "8fb43e59-4ff9-4dc8-a4b7-2ed164e45ab8",
"data": {
"guestId": null,
"pages": 1026,
"page": 1,
"size": 1,
"total": 1026,
"took": 41,
"url": null,
"order": {
"field": "",
"desc": true
},
"items": [
{
"keyword": "phone stand",
"keywordCn": "手机支架",
"searches": 230786,
"products": 109304,
"purchases": 8862,
"purchaseRate": 0.0384,
"bid": 1.49,
"bidMax": 1.86,
"bidMin": 1.12,
"badges": ["R"],
"rankPosition": null,
"adPosition": null,
"updatedTime": 1753237657000,
"searchesRank": 2096,
"searchesRankTimeFrom": 1752940800000,
"searchesRankTimeTo": 1753459200000,
"latest1daysAds": 0,
"latest7daysAds": 133,
"latest30daysAds": 841,
"supplyDemandRatio": 2.11,
"trafficPercentage": 0.1131,
"calculatedWeeklySearches": 53388.32,
"avgPrice": 9.99,
"avgReviews": 58501,
"avgRating": 4.8,
"titleDensity": 32,
"spr": null,
"monopolyClickRate": 0.2511,
"top3ClickingRate": 0.2511,
"top3ConversionRate": 0.1859,
"relationVariationsItems": [
{
"marketplace": "US",
"asin": "B07Z82895W",
"imageUrl": "https://m.media-amazon.com/images/I/417iJirME2L._AC_SR200,200_.jpg",
"trafficPercentage": 0.11315,
"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",
"price": 9.99,
"reviews": 8360,
"rating": 4.5
}
]
}
],
"terminal": null,
"hasNextPage": null,
"guestVisited": false
}
}错误响应、请求追踪和限流头说明见错误与限流。
可组合使用的 AI Skills 与 Agents
从业务任务出发,查看这些能力如何使用当前 API,并在安装前审阅来源与权限。
浏览完整 AI 能力库