ASIN 详情及优惠趋势
一次获取 Amazon ASIN 详情及历史优惠趋势。
API 数据样例
直接查看该接口实际使用的请求体和完整响应结构。
{
"marketplace": "US",
"asin": "B08CK5Z5Q1"
}{
"request_id": "8fb43e59-4ff9-4dc8-a4b7-2ed164e45ab8",
"data": {
"asin": {
"asin": "B0DXTMS9NF",
"asinUrl": "https://www.amazon.com/dp/B0DXTMS9NF?psc=1",
"availableDate": 1739894400000,
"brand": "GENIMO",
"brandUrl": "/stores/GENIMO/page/12D14CF3-B1E6-420E-AC38-482CB1196FE5?is_byline_deeplink=true&deeplink=1F6F837F-A35B-480E-BC90-8ABF05FFA421&redirect_store_id=12D14CF3-B1E6-420E-AC38-482CB1196FE5&lp_asin=B0DXTMS9NF&ref_=ast_bln&store_ref=bl_ast_dp_brandLogo_sto",
"bsrId": "home-garden",
"bsrLabel": "Home & Kitchen",
"bsrRank": 56437,
"subcategories": [
{
"rank": 837,
"code": "684541011",
"label": "Area Rugs"
}
],
"createdTime": null,
"dimensions": "120\"L x 96\"W",
"firstRatingDate": 1752768000000,
"imageUrl": "https://m.media-amazon.com/images/I/61AExXWK1NL._AC_US200_.jpg",
"lqs": 96,
"nodeId": 684541011,
"nodeIdPath": "1055398:1063278:21487702011:684541011",
"nodeLabelPath": "Home & Kitchen:Home Décor Products:Rugs, Pads & Protectors:Area Rugs",
"nodeLabelPathLocale": null,
"parent": "B0DXVJ2MKT",
"price": 62.99,
"primePrice": -1,
"deliveryPrice": -1,
"coupon": "",
"questions": null,
"rating": 4.4,
"ratings": 130,
"reviews": null,
"variantRatings": null,
"variantReviews": null,
"sellerId": "A99G8HR4ZW1GV",
"sellerName": "GENIMO Direct",
"fulfillment": "FBA",
"sellers": 2,
"marketplace": "US",
"title": "GENIMO 8x10 Area Rugs for Living Room, Machine Washable Rug Non Slip, Boho Vintage Distressed Chenille Print Carpet, Low Pile Thin Lightweight Rugs for Bedroom, Dining Room, Home, Office, Grey/Brown",
"updatedTime": 1757732283000,
"variations": 60,
"weight": "17.75 Pounds",
"zoomImageUrl": "https://m.media-amazon.com/images/I/61AExXWK1NL._AC_US600_.jpg",
"skuList": [
"Color: Grey & Brown"
],
"variationList": [
{
"asin": "B0DXV7S864",
"attribute": "Color: Orange | Size: 6' x 9' (Rectangular)"
}
],
"features": [
"Well-Crafted and High-Quality: Our 8X10 rug is made from high-quality chenille materials, ensuring durability and resistance to wear, fading, stains, and shedding. Featuring a symmetrical central design with intricate plant elements like flowers, leaves, and vines, the large a..."
],
"overviews": "{\"Brand\":\"GENIMO\",\"Size\":\"8' x 10' (Rectangular)\",\"Material\":\"Polypropylene\",\"Weave Type\":\"Machine Made\",\"Item Weight\":\"17.75 Pounds\"}",
"badge": {
"bestSeller": "N",
"amazonChoice": "N",
"newRelease": "N",
"ebc": "Y",
"video": "Y"
}
},
"couponTrends": [
{
"marketplace": "US",
"asin": "B0DXTMS9NF",
"date": "2025-09-09",
"type": "M",
"asinPrice": 62.99,
"couponPrice": 6,
"finalPrice": 56.99
}
]
}
}可用状态:已开放
该接口已进入 v1 网关、OpenAPI 和订阅权限目录,成功调用一次消耗 1 个计费单位。
POST /v1/amazon/asin/with-coupon-trend
下方请求和响应字段已与当前公开契约核对。
接口对应关系
| 项目 | 内容 |
|---|---|
| MCP Code | asin_detail_with_coupon_trend |
| 原始 REST 方法 | GET |
| 原始 REST 路径 | /v1/asin/{marketplace}/{asin}/with-coupon-trend |
| 原始 API 文档 | 打开官方 API 文档 |
历史路径仍可调用,但已弃用:
/v1/amazon/products/details-with-coupon-trends。兼容请求会返回Deprecation: true和指向规范路径的Link响应头。
快速调用
先创建 API 密钥,再将密钥写入服务端环境变量:
export ECOMMERCE_DATA_API_KEY="your_api_key"curl --request POST \
--url https://ecommercedataapi.com/v1/amazon/asin/with-coupon-trend \
--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 的「ASIN 详情及优惠趋势」接口,不要只给示例代码。
接口文档:https://ecommercedataapi.com/zh/docs/amazon/asin/with-coupon-trend
请求接口:POST https://ecommercedataapi.com/v1/amazon/asin/with-coupon-trend
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/asin/with-coupon-trend',
{
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/asin/with-coupon-trend",
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 |
returnFields | 字符串 | 否 | 可选的返回字段选择字符串;不传时返回标准字段。 | asin,couponTrends |
返回结构
| 字段 | 类型 | 说明 |
|---|---|---|
request_id | 字符串 | 本次请求的唯一标识。 |
data | 对象 | 接口业务数据。 |
下表字段位于 data 内。数组接口描述的是单个数组元素,分页接口描述的是 items[] 中的单条记录。
返回字段
| 字段 | 类型 | 说明 | 示例 |
|---|---|---|---|
asin | 对象 | Asin Object | - |
asin.asin | 字符串 | asin | B08GHW4TBS |
asin.asinUrl | 字符串 | asin url | https://www.amazon.com/dp/B08GHW4TBS |
asin.availableDate | 整数 | 上架日期 | 1609059137000 |
asin.badge | 对象 | 标识 | 包括了下面 5 个标识 |
asin.badge.bestSeller | 字符串 | Best Seller 标识 | Y 或者 N |
asin.badge.amazonChoice | 字符串 | amazon choice 标识 | Y 或者 N |
asin.badge.newRelease | 字符串 | release 标识 | Y 或者 N |
asin.badge.ebc | 字符串 | A+页面 | Y 或者 N |
asin.badge.video | 字符串 | 视频介绍 | Y 或者 N |
asin.brand | 字符串 | 品牌 | mermaker |
asin.brandUrl | 字符串 | 品牌 URL | /stores/Mermaker/page/984A6448-1C68-4CCA-AD5A-D574EA2D65D5?ref_=ast_bln |
asin.bsrId | 字符串 | bsr id | home-garden |
asin.bsrLabel | 字符串 | bsr 标签 | Home & Kitchen |
asin.bsrRank | 整数 | bsr 排名 | 1006 |
asin.createdTime | 整数 | 创建时间 | 1606467137000 |
asin.dimensions | 字符串 | 尺寸 | 7 x 6 x 0.6 inches |
asin.firstRatingDate | 整数 | 第一次评论时间 | 1609059137000 |
asin.imageUrl | 字符串 | 图片链接 | https://images-na.ssl-images-amazon.com/images/I/412616zl5YL .AC_US200.jpg |
asin.lqs | 整数 | Listing 页面质量得分 | 97 |
asin.nodeId | 字符串 | 节点 id | 1063280 |
asin.nodeIdPath | 字符串 | 节点 id 串 | 1055398:1063252:1063280 |
asin.nodeLabelPath | 字符串 | 类目名称串 | Home & Kitchen:Bedding:Blankets & Throws |
asin.nodeLabelPathLocale | 字符串 | 类目名称串中文 | 家居厨房用品:床上用品:毯子、盖毯 |
asin.parent | 字符串 | 父 asin | B07V5GB9B5 |
asin.price | 数字 | 价格 | 21.99 |
asin.questions | 整数 | 问题数量 | 5 |
asin.rating | 数字 | 评分 | 4.8 |
asin.ratings | 整数 | 评分数 | 29229 |
asin.reviews | 整数 | 评论数 | 9229 |
asin.variantRatings | 整数 | 子体评分数 | 12454 |
asin.variantReviews | 整数 | 子体评论数 | 3211 |
asin.sellerId | 字符串 | 卖家 id | A13AJ1GXFINAZ |
asin.sellerName | 字符串 | 卖家名称 | Mermaker |
asin.fulfillment | 字符串 | 配送方式 | FBA |
asin.sellers | 整数 | 卖家数 | 1 |
asin.skuList | 数组 | sku | ["Color: Beige","Size: 47 inches"] |
asin.marketplace | 字符串 | String | 见表 1.2 |
asin.title | 字符串 | 标题 | mermaker Burritos Tortilla Blanket 2.0 Double Sided 47 inches for Adult and Kids,Giant Funny Realistic Food Throw Blanket,285 GSM Novelty Soft Flannel Taco Blanket (Yellow Blanket-Double Sided) |
asin.features | 数组 | 五点描述 | - |
asin.overviews | 字符串 | 详情,json格式字符串 | - |
asin.updatedTime | 整数 | 更新时间 | 1609059137000 |
asin.variationList | 数组 | 变体 | [{"asin":"B07V5GB9B5","attribute":"Beige"},{"asin":"B08H86SSSF","attribute":"Cookie"}] |
asin.variations | 整数 | 变体数量 | 14 |
asin.weight | 字符串 | 重量 | 15.2 ounces |
asin.zoomImageUrl | 字符串 | 大图 URL | https://images-na.ssl-images-amazon.com/images/I/412616zl5YL .AC_US600.jpg |
asin.subcategories | 对象 | 子类目信息 | - |
asin.subcategories.rank | 整数 | 子类目排名 | 1 |
asin.subcategories.code | 字符串 | 子类目code | 17874234011 |
asin.subcategories.label | 字符串 | 子类目标签 | Kids' Throw Blankets |
asin.deliveryPrice | 数字 | 卖家运费,-1表示没有 | 4 |
asin.primePrice | 数字 | prime价格,-1表示没有 | 42 |
asin.coupon | 字符串 | 优惠卷 | [save $20] |
couponTrends | 数组 | Coupon Trends | - |
couponTrends.marketplace | 字符串 | marketplace | 见表 1.2 |
couponTrends.asin | 字符串 | asin | B08GHW4TBS |
couponTrends.date | 字符串 | 日期 | - |
couponTrends.type | 字符串 | 优惠类型 | M: 减免金额, P: 百分比折扣 |
couponTrends.asinPrice | 数字 | ASIN价格 | - |
couponTrends.couponPrice | 数字 | 优惠金额 | - |
couponTrends.finalPrice | 数字 | 实际价格 | - |
返回示例
{
"request_id": "8fb43e59-4ff9-4dc8-a4b7-2ed164e45ab8",
"data": {
"asin": {
"asin": "B0DXTMS9NF",
"asinUrl": "https://www.amazon.com/dp/B0DXTMS9NF?psc=1",
"availableDate": 1739894400000,
"brand": "GENIMO",
"brandUrl": "/stores/GENIMO/page/12D14CF3-B1E6-420E-AC38-482CB1196FE5?is_byline_deeplink=true&deeplink=1F6F837F-A35B-480E-BC90-8ABF05FFA421&redirect_store_id=12D14CF3-B1E6-420E-AC38-482CB1196FE5&lp_asin=B0DXTMS9NF&ref_=ast_bln&store_ref=bl_ast_dp_brandLogo_sto",
"bsrId": "home-garden",
"bsrLabel": "Home & Kitchen",
"bsrRank": 56437,
"subcategories": [
{
"rank": 837,
"code": "684541011",
"label": "Area Rugs"
}
],
"createdTime": null,
"dimensions": "120\"L x 96\"W",
"firstRatingDate": 1752768000000,
"imageUrl": "https://m.media-amazon.com/images/I/61AExXWK1NL._AC_US200_.jpg",
"lqs": 96,
"nodeId": 684541011,
"nodeIdPath": "1055398:1063278:21487702011:684541011",
"nodeLabelPath": "Home & Kitchen:Home Décor Products:Rugs, Pads & Protectors:Area Rugs",
"nodeLabelPathLocale": null,
"parent": "B0DXVJ2MKT",
"price": 62.99,
"primePrice": -1,
"deliveryPrice": -1,
"coupon": "",
"questions": null,
"rating": 4.4,
"ratings": 130,
"reviews": null,
"variantRatings": null,
"variantReviews": null,
"sellerId": "A99G8HR4ZW1GV",
"sellerName": "GENIMO Direct",
"fulfillment": "FBA",
"sellers": 2,
"marketplace": "US",
"title": "GENIMO 8x10 Area Rugs for Living Room, Machine Washable Rug Non Slip, Boho Vintage Distressed Chenille Print Carpet, Low Pile Thin Lightweight Rugs for Bedroom, Dining Room, Home, Office, Grey/Brown",
"updatedTime": 1757732283000,
"variations": 60,
"weight": "17.75 Pounds",
"zoomImageUrl": "https://m.media-amazon.com/images/I/61AExXWK1NL._AC_US600_.jpg",
"skuList": ["Color: Grey & Brown"],
"variationList": [
{
"asin": "B0DXV7S864",
"attribute": "Color: Orange | Size: 6' x 9' (Rectangular)"
}
],
"features": [
"Well-Crafted and High-Quality: Our 8X10 rug is made from high-quality chenille materials, ensuring durability and resistance to wear, fading, stains, and shedding. Featuring a symmetrical central design with intricate plant elements like flowers, leaves, and vines, the large a..."
],
"overviews": "{\"Brand\":\"GENIMO\",\"Size\":\"8' x 10' (Rectangular)\",\"Material\":\"Polypropylene\",\"Weave Type\":\"Machine Made\",\"Item Weight\":\"17.75 Pounds\"}",
"badge": {
"bestSeller": "N",
"amazonChoice": "N",
"newRelease": "N",
"ebc": "Y",
"video": "Y"
}
},
"couponTrends": [
{
"marketplace": "US",
"asin": "B0DXTMS9NF",
"date": "2025-09-09",
"type": "M",
"asinPrice": 62.99,
"couponPrice": 6,
"finalPrice": 56.99
}
]
}
}错误响应、请求追踪和限流头说明见错误与限流。