ASIN 详情
获取 Amazon ASIN 的商品信息、价格、评分、类目、卖家、Listing 和变体数据。
API 数据样例
直接查看该接口实际使用的请求体和完整响应结构。
{
"marketplace": "US",
"asin": "B08CK5Z5Q1"
}{
"request_id": "8fb43e59-4ff9-4dc8-a4b7-2ed164e45ab8",
"data": {
"asin": "B0DRVKZHK9",
"asinUrl": "https://www.amazon.com/dp/B0DRVKZHK9?th=1",
"availableDate": 1710345600000,
"brand": "Yitrust",
"brandUrl": "/stores/Yitrust/page/3440BDBD-A6C1-4DA6-800B-4EDA16B2F347?ref_=ast_bln&store_ref=bl_ast_dp_brandLogo_sto",
"bsrId": "beauty",
"bsrLabel": "Beauty & Personal Care",
"bsrRank": 58102,
"subcategories": [
{
"rank": 136,
"code": "11058221",
"label": "Hot-Air Hair Brushes"
}
],
"createdTime": 1735855239000,
"dimensions": "1 x 1 x 1 inches",
"firstRatingDate": null,
"imageUrl": "https://m.media-amazon.com/images/I/4182p-TslhL._AC_US200_.jpg",
"lqs": 100,
"nodeId": 11058221,
"nodeIdPath": "3760911:11057241:11058091:11058221",
"nodeLabelPath": "Beauty & Personal Care:Hair Care:Styling Tools & Appliances:Hot-Air Brushes",
"nodeLabelPathLocale": null,
"parent": "B0DRVKZHK9",
"price": 73.99,
"primePrice": -1,
"deliveryPrice": -1,
"coupon": "",
"questions": null,
"rating": 4.6,
"ratings": 13,
"reviews": null,
"variantRatings": null,
"variantReviews": null,
"sellerId": "A3RB0UBY5ZAEAH",
"sellerName": "Yitrust",
"fulfillment": "FBA",
"sellers": 1,
"marketplace": "US",
"title": "6 in 1 Blow Dryer Brush, Hair Dryer with Diffuser for Curly Hair, Negative Ionic Hair Dryer Brush Set, Air Curling Iron Air Styler, Brush Blow Dryer Straight, Volumize, Drying Hair Styling Tool",
"updatedTime": 1740475874000,
"variations": 2,
"weight": "2.49 Pounds",
"zoomImageUrl": "https://m.media-amazon.com/images/I/4182p-TslhL._AC_US600_.jpg",
"skuList": [
"Color: Black"
],
"variationList": [
{
"asin": "B0CY5J4PKN",
"attribute": "Color: Black"
}
],
"features": [
"NEW UPDATE 6 IN 1 HAIR DRYER BRUSH: The hair dryer brush set new with diffuser for women comes with 6 interchangeable brush attachments that make 1*narrow hairdryer head, 2* left/right direction air hair wrapping curling iron, 1*hair straightener brush, 1* volumizing brush, 1*..."
],
"overviews": "{\"Brand\":\"Yitrust\",\"Color\":\"Black\",\"Material\":\"Plastic\",\"Wattage\":\"1000 watts\",\"Power Source\":\"Corded Electric\"}",
"badge": {
"bestSeller": "N",
"amazonChoice": "N",
"newRelease": "N",
"ebc": "Y",
"video": "Y"
}
}
}可用状态:已开放
该接口已进入 v1 网关、OpenAPI 和订阅权限目录,成功调用一次消耗 1 个计费单位。
POST /v1/amazon/asin/detail
下方请求和响应字段已与当前公开契约核对。
接口对应关系
| 项目 | 内容 |
|---|---|
| MCP Code | asin_detail |
| 原始 REST 方法 | GET |
| 原始 REST 路径 | /v1/asin/{marketplace}/{asin} |
| 原始 API 文档 | 打开官方 API 文档 |
历史路径仍可调用,但已弃用:
/v1/amazon/products/details。兼容请求会返回Deprecation: true和指向规范路径的Link响应头。
快速调用
先创建 API 密钥,再将密钥写入服务端环境变量:
export ECOMMERCE_DATA_API_KEY="your_api_key"curl --request POST \
--url https://ecommercedataapi.com/v1/amazon/asin/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 的「ASIN 详情」接口,不要只给示例代码。
接口文档:https://ecommercedataapi.com/zh/docs/amazon/asin/detail
请求接口:POST https://ecommercedataapi.com/v1/amazon/asin/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/asin/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/asin/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"。 | US |
asin | 字符串 | 是 | asin 格式需匹配 ^[A-Z0-9]{10}$。 | B08GHW4TBS |
返回结构
| 字段 | 类型 | 说明 |
|---|---|---|
request_id | 字符串 | 本次请求的唯一标识。 |
data | 对象 | 接口业务数据。 |
下表字段位于 data 内。数组接口描述的是单个数组元素,分页接口描述的是 items[] 中的单条记录。
返回字段
| 字段 | 类型 | 说明 | 示例 |
|---|---|---|---|
asin | 字符串 | asin | B08GHW4TBS |
asinUrl | 字符串 | asin url | https://www.amazon.com/dp/B08GHW4TBS |
availableDate | 整数 | 上架日期 | 1609059137000 |
badge | 对象 | 标识 | 包括了下面 5 个标识 |
badge.bestSeller | 字符串 | Best Seller 标识 | Y 或者 N |
badge.amazonChoice | 字符串 | amazon choice 标识 | Y 或者 N |
badge.newRelease | 字符串 | release 标识 | Y 或者 N |
badge.ebc | 字符串 | A+页面 | Y 或者 N |
badge.video | 字符串 | 视频介绍 | Y 或者 N |
brand | 字符串 | 品牌 | mermaker |
brandUrl | 字符串 | 品牌 URL | /stores/Mermaker/page/984A6448-1C68-4CCA-AD5A-D574EA2D65D5?ref_=ast_bln |
bsrId | 字符串 | bsr id | home-garden |
bsrLabel | 字符串 | bsr 标签 | Home & Kitchen |
bsrRank | 整数 | bsr 排名 | 1006 |
createdTime | 整数 | 创建时间 | 1606467137000 |
dimensions | 字符串 | 尺寸 | 7 x 6 x 0.6 inches |
firstRatingDate | 整数 | 第一次评论时间 | 1609059137000 |
imageUrl | 字符串 | 图片链接 | https://images-na.ssl-images-amazon.com/images/I/412616zl5YL .AC_US200.jpg |
lqs | 整数 | Listing 页面质量得分 | 97 |
nodeId | 字符串 | 节点 id | 1063280 |
nodeIdPath | 字符串 | 节点 id 串 | 1055398:1063252:1063280 |
nodeLabelPath | 字符串 | 类目名称串 | Home & Kitchen:Bedding:Blankets & Throws |
nodeLabelPathLocale | 字符串 | 类目名称串中文 | 家居厨房用品:床上用品:毯子、盖毯 |
parent | 字符串 | 父 asin | B07V5GB9B5 |
price | 数字 | 价格 | 21.99 |
questions | 整数 | 问题数量 | 5 |
rating | 数字 | 评分 | 4.8 |
ratings | 整数 | 评分数 | 29229 |
reviews | 整数 | 评论数 | 9229 |
variantRatings | 整数 | 子体评分数 | 12454 |
variantReviews | 整数 | 子体评论数 | 3211 |
sellerId | 字符串 | 卖家 id | A13AJ1GXFINAZ |
sellerName | 字符串 | 卖家名称 | Mermaker |
fulfillment | 字符串 | 配送方式 | FBA |
sellers | 整数 | 卖家数 | 1 |
skuList | 数组 | sku | ["Color: Beige","Size: 47 inches"] |
marketplace | 字符串 | String | 见表 1.2 |
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) |
features | 数组 | 五点描述 | - |
overviews | 字符串 | 详情,json格式字符串 | - |
updatedTime | 整数 | 更新时间 | 1609059137000 |
variationList | 数组 | 变体 | [{"asin":"B07V5GB9B5","attribute":"Beige"},{"asin":"B08H86SSSF","attribute":"Cookie"}] |
variations | 整数 | 变体数量 | 14 |
weight | 字符串 | 重量 | 15.2 ounces |
zoomImageUrl | 字符串 | 大图 URL | https://images-na.ssl-images-amazon.com/images/I/412616zl5YL .AC_US600.jpg |
subcategories | 对象 | 子类目信息 | - |
subcategories.rank | 整数 | 子类目排名 | 1 |
subcategories.code | 字符串 | 子类目code | 17874234011 |
subcategories.label | 字符串 | 子类目标签 | Kids' Throw Blankets |
deliveryPrice | 数字 | 卖家运费,-1表示没有 | 4 |
primePrice | 数字 | prime价格,-1表示没有 | 42 |
coupon | 字符串 | 优惠卷 | [save $20] |
coupon.amazonChoice | 字符串 | amazon choice 标识 | Y 或者 N |
返回示例
{
"request_id": "8fb43e59-4ff9-4dc8-a4b7-2ed164e45ab8",
"data": {
"asin": "B0DRVKZHK9",
"asinUrl": "https://www.amazon.com/dp/B0DRVKZHK9?th=1",
"availableDate": 1710345600000,
"brand": "Yitrust",
"brandUrl": "/stores/Yitrust/page/3440BDBD-A6C1-4DA6-800B-4EDA16B2F347?ref_=ast_bln&store_ref=bl_ast_dp_brandLogo_sto",
"bsrId": "beauty",
"bsrLabel": "Beauty & Personal Care",
"bsrRank": 58102,
"subcategories": [
{
"rank": 136,
"code": "11058221",
"label": "Hot-Air Hair Brushes"
}
],
"createdTime": 1735855239000,
"dimensions": "1 x 1 x 1 inches",
"firstRatingDate": null,
"imageUrl": "https://m.media-amazon.com/images/I/4182p-TslhL._AC_US200_.jpg",
"lqs": 100,
"nodeId": 11058221,
"nodeIdPath": "3760911:11057241:11058091:11058221",
"nodeLabelPath": "Beauty & Personal Care:Hair Care:Styling Tools & Appliances:Hot-Air Brushes",
"nodeLabelPathLocale": null,
"parent": "B0DRVKZHK9",
"price": 73.99,
"primePrice": -1,
"deliveryPrice": -1,
"coupon": "",
"questions": null,
"rating": 4.6,
"ratings": 13,
"reviews": null,
"variantRatings": null,
"variantReviews": null,
"sellerId": "A3RB0UBY5ZAEAH",
"sellerName": "Yitrust",
"fulfillment": "FBA",
"sellers": 1,
"marketplace": "US",
"title": "6 in 1 Blow Dryer Brush, Hair Dryer with Diffuser for Curly Hair, Negative Ionic Hair Dryer Brush Set, Air Curling Iron Air Styler, Brush Blow Dryer Straight, Volumize, Drying Hair Styling Tool",
"updatedTime": 1740475874000,
"variations": 2,
"weight": "2.49 Pounds",
"zoomImageUrl": "https://m.media-amazon.com/images/I/4182p-TslhL._AC_US600_.jpg",
"skuList": ["Color: Black"],
"variationList": [
{
"asin": "B0CY5J4PKN",
"attribute": "Color: Black"
}
],
"features": [
"NEW UPDATE 6 IN 1 HAIR DRYER BRUSH: The hair dryer brush set new with diffuser for women comes with 6 interchangeable brush attachments that make 1*narrow hairdryer head, 2* left/right direction air hair wrapping curling iron, 1*hair straightener brush, 1* volumizing brush, 1*..."
],
"overviews": "{\"Brand\":\"Yitrust\",\"Color\":\"Black\",\"Material\":\"Plastic\",\"Wattage\":\"1000 watts\",\"Power Source\":\"Corded Electric\"}",
"badge": {
"bestSeller": "N",
"amazonChoice": "N",
"newRelease": "N",
"ebc": "Y",
"video": "Y"
}
}
}错误响应、请求追踪和限流头说明见错误与限流。
可组合使用的 AI Skills 与 Agents
从业务任务出发,查看这些能力如何使用当前 API,并在安装前审阅来源与权限。
Amazon Listing 优化 Skill
结合商品事实、关键词覆盖、竞品背景、转化文案和八维审计,创建或优化 Amazon Listing。
Amazon 产品经理决策 Skill
将市场筛选、选品、单位经济、Listing、PPC、库存、发布、增长和止损决策连接成统一运营流程。
多平台商品描述生成 Skill
为 Amazon、Shopify、Etsy、TikTok Shop、Walmart 等渠道生成和优化商品标题、卖点、描述与后台词。
Amazon A+ Content 策划 Skill
基于已批准商品证据,规划 Amazon A+ 模块布局、说服性文案、对比表、图片 Brief 和转化复核。