Amazon 商品数据 API:ASIN 查询与商品详情

按 ASIN 查询任意 Amazon 商品,返回标题、价格、BSR、评分、卖家、变体、五点描述和 Listing 质量分的 JSON,支持单个或批量查询,覆盖 13 个站点。
2026/09/29

这个接口能拿到什么

商品详情接口接收一个 ASIN,把该商品的 Listing 数据作为一个 JSON 对象返回,不需要再从页面里解析。

最常用的字段:

字段含义文档示例值
asin、parent、title、brand是哪个商品、属于哪个父体B0DRVKZHK9、Yitrust
price、primePrice、deliveryPrice、coupon当前价、Prime 价、配送费和优惠券文案73.99、-1、-1、""
bsrRank、bsrLabel、subcategories大类 BSR、所属大类和各小类排名58102、Beauty & Personal Care、Hot-Air Hair Brushes 第 136
rating、ratings、reviews星级、评分数和评论数4.6、13、null
sellerName、sellerId、sellers、fulfillment谁在卖、卖家数、配送方式Yitrust、1、FBA
variations、skuList、variationList变体数量,以及每个变体的 ASIN2、["Color: Black"]
features、overviews、dimensions、weight五点描述、属性表和尺寸重量2.49 Pounds
badgeBest Seller、Amazon's Choice、新品、A+ 与视频标识"ebc": "Y"
lqsListing 质量分100
nodeIdPath、nodeLabelPath类目节点路径3760911:11057241:11058091:11058221

完整字段见商品详情接口文档。

请求示例

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"
  }'
  • asin 必填;marketplace 可选 US、JP、UK、DE、FR、IT、ES、CA、IN、MX、BR、AU、AE。
  • 接口接收的是 ASIN。没有 UPC、EAN 或 GTIN 参数,所以条码需要先换成 ASIN 再调用。ASIN 和 SKU、UPC、FNSKU 的区别见亚马逊 ASIN 是什么。

批量查询

详情接口一次调用返回一个商品。想在一个请求里比较很多 ASIN,用商品搜索接口的 asins 数组,它会为每个商品返回价格、BSR、预估月销量、评分和卖家数据。要看 Listing 本身(标题、五点、变体、属性)用详情,要一张对比表用搜索。

以下接口使用相同的 ASIN 输入:

常见用法

  1. 给商品清单补字段。 拿你已经在跟踪的 ASIN,补上标题、品牌、价格、BSR 和类目,让一张表格变成可用的数据表;
  2. 监控竞品。 每天拉同一个 ASIN,对比 price、bsrRank、rating 和 coupon。每天跑一次的任务见竞品价格与优惠券监控;
  3. 比较之前先核对 Listing。 把两个商品放在一起之前先看 variations 和 parent:父体的数字覆盖整个变体家族。见API 销量数据能说明什么、不能说明什么;
  4. 给 Listing 打分。 lqs、标识字段和 features 的长度,可以快速判断竞品的 Listing 做得完不完整。

需要知道的边界

  • 商品上不存在的字段会返回 null 或 -1。文档示例里就有 primePrice: -1、deliveryPrice: -1、reviews: null 和 questions: null,做计算前先判断;
  • overviews 是一个 JSON 字符串,需要再解析一次;
  • 每条记录都有毫秒时间戳 createdTime 和 updatedTime。依据价格做决定之前,先看 updatedTime;
  • 每次成功调用消耗 1 个计费单位。遇到 429 按错误与限流处理。

常见问题

这是 Amazon 的 Product Advertising API 吗? 不是。Product Advertising API 面向联盟推广;这个接口返回的是 BSR、Listing 质量分、变体这类研究数据,不需要联盟账号。

能按 UPC 或 EAN 查吗? 不能直接查。先把条码换成 ASIN,再调用接口。

AI Agent 能查商品吗? 可以。这个接口已通过远程 MCP 服务作为工具提供,Claude Code、Cursor 等 MCP 客户端可以在对话里直接取商品。