商品趋势详情(Keepa)
获取 Amazon ASIN 的历史价格、排名、评分和 Listing 快照趋势。
API 数据样例
直接查看该接口实际使用的请求体和完整响应结构。
{
"marketplace": "US",
"asin": "B08CK5Z5Q1"
}{
"request_id": "8fb43e59-4ff9-4dc8-a4b7-2ed164e45ab8",
"data": {
"marketplace": "US",
"asin": "B0DYL2DHVV",
"dataAsin": "B0DYL2DHVV",
"parentAsin": "B0DYL2DHVV",
"variationAsins": null,
"rootCategory": "283155",
"rootCategoryLabel": "Books",
"salesRankReference": "283155",
"salesRankReferenceHistory": [
{
"timePoint": 1754767200000,
"value": "283155"
}
],
"nodeIdPath": "283155:1000:48:5043:5045",
"nodeLabelPath": "Books:Subjects:Crafts, Hobbies & Home:Pets & Animal Care:Cats",
"productStatus": "STANDARD",
"availabilityAmazon": "3",
"title": "The BrownTrout Portrait Series: The Regal Cat | 2026 12 x 24 Inch (Hanging) Monthly Square Wall Calendar | Plastic-Free | Pet Kitten Feline",
"brand": null,
"asinUrl": "https://www.amazon.com/dp/B0DYL2DHVV",
"brandUrl": null,
"salesRankUrl": "https://www.amazon.com/b/?node=283155",
"imageUrl": "https://images-na.ssl-images-amazon.com/images/I/71G5e3fedaL._AC_US200_.jpg",
"zoomImageUrl": "https://images-na.ssl-images-amazon.com/images/I/71G5e3fedaL._AC_US600_.jpg",
"imageUrls": [
"https://images-na.ssl-images-amazon.com/images/I/71G5e3fedaL._AC_US200_.jpg"
],
"dimensions": "12 x 0.1 x 12 inches",
"dimensionsSize": [
305
],
"weight": "0.56 pounds",
"weightGram": 254,
"pkgDimensions": "12 x 12 x 0.1 inches",
"pkgDimensionsSize": [
305
],
"pkgWeight": "0.56 pounds",
"pkgWeightGram": 254,
"fbaFees": 3.43,
"fbaItems": "{\"pickAndPackFeeTax\":0,\"storageFee\":0,\"storageFeeTax\":0,\"pickAndPackFee\":3.43}",
"numberOfPages": 28,
"numberOfItems": 1,
"price": [
{
"timePoint": 1741427280000,
"value": 17.99
}
],
"dealPrice": [],
"buyBox": [],
"buyBoxSellerIdHistory": [],
"bsr": [
{
"timePoint": 1741427280000,
"value": -1
}
],
"subSalesRank": [
{
"nodeId": "5045",
"node": "Cats",
"ranks": [
{
"timePoint": 1741427280000,
"value": -1
}
]
}
],
"reviews": [],
"rating": [],
"sellers": [
{
"timePoint": 1741427280000,
"value": 1
}
]
}
}可用状态:已开放
该接口已进入 v1 网关、OpenAPI 和订阅权限目录,成功调用一次消耗 1 个计费单位。
POST /v1/amazon/keepa/detail
下方请求和响应字段已与当前公开契约核对。
接口对应关系
| 项目 | 内容 |
|---|---|
| MCP Code | keepa_info |
| 原始 REST 方法 | GET |
| 原始 REST 路径 | /v1/keepa/{marketplace}/{asin} |
| 原始 API 文档 | 打开官方 API 文档 |
历史路径仍可调用,但已弃用:
/v1/amazon/products/history。兼容请求会返回Deprecation: true和指向规范路径的Link响应头。
快速调用
先创建 API 密钥,再将密钥写入服务端环境变量:
export ECOMMERCE_DATA_API_KEY="your_api_key"curl --request POST \
--url https://ecommercedataapi.com/v1/amazon/keepa/detail \
--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 的「商品趋势详情(Keepa)」接口,不要只给示例代码。
接口文档:https://ecommercedataapi.com/zh/docs/amazon/keepa/detail
请求接口:POST https://ecommercedataapi.com/v1/amazon/keepa/detail
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/keepa/detail',
{
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/keepa/detail",
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}$。 | B08GHW4TBS |
startTimestamp | 整数 | 否 | Trend Data Start Timestamp | 1 |
endTimestamp | 整数 | 否 | Trend Data End Timestamp | 1 |
dailyLatest | 布尔值 | 否 | Only Get Daily Latest Data | false |
returnFields | 字符串 | 否 | 可选的返回字段选择字符串;不传时返回标准字段。 | marketplace,asin,dataAsin |
返回结构
| 字段 | 类型 | 说明 |
|---|---|---|
request_id | 字符串 | 本次请求的唯一标识。 |
data | 对象 | 接口业务数据。 |
下表字段位于 data 内。数组接口描述的是单个数组元素,分页接口描述的是 items[] 中的单条记录。
返回字段
| 字段 | 类型 | 说明 | 示例 |
|---|---|---|---|
marketplace | 字符串 | 市场 | 见表 1.2 |
asin | 字符串 | asin | B07V34QQ3C |
dataAsin | 字符串 | 实际返回Keepa数据的ASIN | B07V34QQ3C |
parentAsin | 字符串 | 父体ASIN | B0CWW9N7QW |
variationAsins | 数组 | 变体ASIN列表 | ["B0CN2PBVNS","B0BT4PMNY4","B0C6FYKC3D","B0CSLMG2TF","B0CGGPC6G3","B0BXG8L46Y","B0CRSZGN9L","B07V34QQ3C"] |
rootCategory | 字符串 | BSR大类节点ID | 172282 |
rootCategoryLabel | 字符串 | 跟类目 | Electronics |
salesRankReference | 字符串 | 排名节点ID | 541966 |
salesRankReferenceHistory | 数组 | 排名节点变动历史 | PairStrDto 趋势字符串数据结构 |
nodeIdPath | 字符串 | 上架类目全路径 | 172282:541966:13896617011:565098:13896597011 |
nodeLabelPath | 字符串 | 上架类目名称全路径 | Electronics:Computers & Accessories:Computers & Tablets:Desktops:Towers |
productStatus | 字符串 | 商品状态 | STANDARD:everything accessibleDOWNLOADABLE:no marketplace/3rd party price dataEBOOK:no price data and sales rank accessibleINACCESSIBLE:no data accessibleINVALID:invalid or deprecated asinVARIATION_PARENT:product is a parent ASINUNKNOWN:null of status |
availabilityAmazon | 字符串 | 亚马逊跟卖转态 | -1 |
title | 字符串 | 标题 | iBUYPOWER Gaming PC Computer Desktop Element 9260 (Intel Core i7-9700F 3.0Ghz, NVIDIA GeForce GTX 1660 Ti 6GB, 16GB DDR4, 240GB SSD, 1TB HDD, Wi-Fi & Windows 10 Home) Black |
brand | 字符串 | 品牌 | iBUYPOWER |
asinUrl | 字符串 | ASIN链接 | https://www.amazon.com/dp/B07V34QQ3C |
brandUrl | 字符串 | 品牌链接 | https://www.amazon.com/s?k=iBUYPOWER |
salesRankUrl | 字符串 | 销售排名链接 | https://www.amazon.com/b/?node=541966 |
imageUrl | 字符串 | 商品缩略图200*200 | https://images-na.ssl-images-amazon.com/images/I/711nEj5l5SL._AC_US200_.jpg |
zoomImageUrl | 字符串 | 商品大图600*600 | https://images-na.ssl-images-amazon.com/images/I/711nEj5l5SL._AC_US600_.jpg |
imageUrls | 数组 | 商品图片列表 | ["https://images-na.ssl-images-amazon.com/images/I/711nEj5l5SL.AC_US200.jpg","https://images-na.ssl-images-amazon.com/images/I/61bpfnvHjqL.AC_US200.jpg",......] |
dimensions | 字符串 | 净尺寸 | 97 |
weight | 字符串 | 净重量 | 1063280 |
weightGram | 字符串 | 净重数值 单位统一为:克(g) | 1055398:1063252:1063280 |
pkgDimensions | 字符串 | 打包尺寸 | 22 x 19.9 x 12.4 inches |
pkgDimensionsSize | 数组 | 打包尺寸 长/宽/高 单位统一为:厘米(cm) | [558,506,316] |
pkgWeight | 字符串 | 打包重量 | 0.11 pounds |
pkgWeightGram | 整数 | 打包重量数值 单位统一为:克(g) | 13660 |
fbaFees | 数字 | FBA总费用 | 26.11 |
fbaItems | 字符串 | FBA费用项明细JSON串,包含:仓储费,仓储费税,运送打包费,运送打包费税 | "{"pickAndPackFeeTax":0,"storageFee":0,"storageFeeTax":0,"pickAndPackFee":26.11}" |
numberOfPages | 整数 | 在第几页 | -1 |
numberOfItems | 整数 | 在第几个 | 1 |
price | 数组 | 价格趋势 | 见 PairNumberDto 趋势数字数据结构 |
dealPrice | 数组 | 成交价趋势 | 见 PairNumberDto 趋势数字数据结构 |
buyBox | 数组 | 黄金购物车价格趋势 | 见 PairNumberDto 趋势数字数据结构 |
priceList | 数组 | 划线价格 | 见 PairNumberDto 趋势数字数据结构 |
buyBoxSellerIdHistory | 数组 | 黄金购物车卖家Id历史趋势 | PairStrDto 趋势字符串数据结构 |
bsr | 数组 | 大类BSR排名历史趋势 | 见 PairNumberDto 趋势数字数据结构 |
subSalesRank | 数组 | 小类排名趋势数据 | 见 SubRankTrendDto 小类排名趋势 |
reviews | 数组 | 评分数趋势数据 | 见 PairNumberDto 趋势数字数据结构 |
rating | 数组 | 评分值趋势数据 | 见 PairNumberDto 趋势数字数据结构 |
sellers | 数组 | 卖家数趋势数据 | 见 PairNumberDto 趋势数字数据结构 |
返回示例
{
"request_id": "8fb43e59-4ff9-4dc8-a4b7-2ed164e45ab8",
"data": {
"marketplace": "US",
"asin": "B0DYL2DHVV",
"dataAsin": "B0DYL2DHVV",
"parentAsin": "B0DYL2DHVV",
"variationAsins": null,
"rootCategory": "283155",
"rootCategoryLabel": "Books",
"salesRankReference": "283155",
"salesRankReferenceHistory": [
{
"timePoint": 1754767200000,
"value": "283155"
}
],
"nodeIdPath": "283155:1000:48:5043:5045",
"nodeLabelPath": "Books:Subjects:Crafts, Hobbies & Home:Pets & Animal Care:Cats",
"productStatus": "STANDARD",
"availabilityAmazon": "3",
"title": "The BrownTrout Portrait Series: The Regal Cat | 2026 12 x 24 Inch (Hanging) Monthly Square Wall Calendar | Plastic-Free | Pet Kitten Feline",
"brand": null,
"asinUrl": "https://www.amazon.com/dp/B0DYL2DHVV",
"brandUrl": null,
"salesRankUrl": "https://www.amazon.com/b/?node=283155",
"imageUrl": "https://images-na.ssl-images-amazon.com/images/I/71G5e3fedaL._AC_US200_.jpg",
"zoomImageUrl": "https://images-na.ssl-images-amazon.com/images/I/71G5e3fedaL._AC_US600_.jpg",
"imageUrls": [
"https://images-na.ssl-images-amazon.com/images/I/71G5e3fedaL._AC_US200_.jpg"
],
"dimensions": "12 x 0.1 x 12 inches",
"dimensionsSize": [305],
"weight": "0.56 pounds",
"weightGram": 254,
"pkgDimensions": "12 x 12 x 0.1 inches",
"pkgDimensionsSize": [305],
"pkgWeight": "0.56 pounds",
"pkgWeightGram": 254,
"fbaFees": 3.43,
"fbaItems": "{\"pickAndPackFeeTax\":0,\"storageFee\":0,\"storageFeeTax\":0,\"pickAndPackFee\":3.43}",
"numberOfPages": 28,
"numberOfItems": 1,
"price": [
{
"timePoint": 1741427280000,
"value": 17.99
}
],
"dealPrice": [],
"buyBox": [],
"buyBoxSellerIdHistory": [],
"bsr": [
{
"timePoint": 1741427280000,
"value": -1
}
],
"subSalesRank": [
{
"nodeId": "5045",
"node": "Cats",
"ranks": [
{
"timePoint": 1741427280000,
"value": -1
}
]
}
],
"reviews": [],
"rating": [],
"sellers": [
{
"timePoint": 1741427280000,
"value": 1
}
]
}
}错误响应、请求追踪和限流头说明见错误与限流。
可组合使用的 AI Skills 与 Agents
从业务任务出发,查看这些能力如何使用当前 API,并在安装前审阅来源与权限。
浏览完整 AI 能力库