亚马逊搜索 API：按关键词或 ASIN 查商品

亚马逊搜索 API，按关键词或 ASIN 列表返回 Amazon 商品的价格、BSR、预估月销量、评分和卖家信息等结构化 JSON，覆盖 13 个站点。

2026/09/14

亚马逊搜索 API 能拿到什么

商品搜索接口接收一个关键词或一组 ASIN，把匹配的 Amazon 商品以结构化记录返回。整页搜索结果可以直接拿来比较，不用再去抓页面。

items[] 里每一项是一个商品，最常用的字段：

字段	含义	文档示例值
`asin`、`parent`、`title`、`brand`	是哪个商品、属于哪个父体	`B0DGVP84B5`、`B0FH2CCLPX`
`price`、`averagePrice`	当前价格与均价	`728.99`、`735.81`
`bsr`、`subcategories`	大类 BSR 与各小类排名	`4`；`Smartwatches` 第 `1`
`units`、`revenue`	预估月销量（父体）与月销售额	`167539`、`123276872`
`rating`、`ratings`	星级与评分数	`4.7`、`8707`
`sellers`、`sellerName`、`sellerNation`、`fulfillment`	谁在卖、卖家所属地、配送方式	`1`、`Amazon`、`US`、`AMZ`
`availableDate`	上架时间（毫秒时间戳）	`1726012800000`
`badge`	Best Seller、Amazon's Choice、新品、A+ 与视频标识	`"ebc": "Y"`

这些示例值出自同一条返回：revenue = units × averagePrice（167539 × 735.81 ≈ 123276872）。完整字段见商品搜索接口文档。

先看看真实返回

以下是 2026-10-15 从线上接口真实采集的返回，不是实时查询。创建密钥后可以查询任意 ASIN 或关键词。

POST/v1/amazon/product/competitor-lookup200 OK

请求参数

{
  "marketplace": "US",
  "keyword": "wireless charger",
  "match_type": "phrase",
  "page": 1,
  "size": 10
}

响应数据

{
  "request_id": "392dfdcb-8c88-4c5b-b2f2-2115df573e3b",
  "data": {
    "total": 4615,
    "pages": 462,
    "page": 1,
    "size": 10,
    "items": [
      {
        "asin": "B0CNTH3F7P",
        "brand": "Ouotoo",
        "title": "3 in 1 Mag-Safe Wireless Charger Stand for iPhone Apple Watch AirPods",
        "nodeLabelPath": "Cell Phones & Accessories:Accessories:Chargers & Power Adapters:Wireless Chargers",
        "bsr": 45,
        "price": 21.99,
        "units": 44607,
        "revenue": 802479.94,
        "rating": 4.4,
        "ratings": 9018,
        "availableDate": 1702425600000,
        "fulfillment": "FBA",
        "sellers": 3,
        "sellerNation": "CN"
      },
      {
        "asin": "B0GGPBR4YP",
        "brand": "SMILE STATION",
        "title": "MagSafe 25W Wireless Charger for Apple Magnetic Fast Charging Pad",
        "nodeLabelPath": "Cell Phones & Accessories:Accessories:Chargers & Power Adapters:Wireless Chargers",
        "bsr": 42,
        "price": 13.92,
        "units": 44206,
        "revenue": 615347.5,
        "rating": 4.4,
        "ratings": 3610,
        "availableDate": 1768435200000,
        "fulfillment": "FBA",
        "sellers": 7,
        "sellerNation": "CN"
      },
      {
        "asin": "B0BFCC18FS",
        "brand": "Anlmz",
        "title": "Anlmz 3 in 1 Charging Station - Wireless Charger for Apple Multiple Devices",
        "nodeLabelPath": "Cell Phones & Accessories:Accessories:Chargers & Power Adapters:Charging Stations",
        "bsr": 59,
        "price": 15.29,
        "units": 35954,
        "revenue": 549736.7,
        "rating": 4.2,
        "ratings": 41555,
        "availableDate": 1664236800000,
        "fulfillment": "FBA",
        "sellers": 8,
        "sellerNation": "CN"
      }
    ]
  }
}

创建 API 密钥

请求示例

curl --request POST \
  --url https://ecommercedataapi.com/v1/amazon/product/competitor-lookup \
  --header "Content-Type: application/json" \
  --header "X-API-Key: ${ECOMMERCE_DATA_API_KEY}" \
  --data '{
    "marketplace": "US",
    "keyword": "wireless charger",
    "match_type": "phrase",
    "include_variations": false,
    "page": 1,
    "size": 20
  }'

keyword 和 asins 二选一。已经知道要比哪些商品时，用 asins 传数组，例如 ["B08CK5Z5Q1"]。
include_variations 决定结果里是否包含变体。
marketplace 可选 US、JP、UK、DE、FR、IT、ES、CA、IN、MX、BR、AU、AE。
用 page、size 分页（每页最多 200 条），返回里带 total 和 pages。asins 一次最多 40 个。

怎么选匹配方式

match_type 决定哪些商品算作匹配 keyword：

`match_type`	匹配规则	适用场景
`phrase`（默认）	标题包含完整词组	想看在同一个搜索词下竞争的商品
`broad`	标题包含其中任意一个词	在探索一个细分市场，想把周边商品都拉进来
`exact`	标题与关键词匹配	需要很窄的集合，例如只看某一种产品

先用 phrase。只有词组结果太少、不够比较时才换 broad，因为广泛匹配很快会混进不相关的商品。

一次关键词搜索长什么样

2026 年 10 月在美国站调用一次，参数是 "keyword": "wireless charger"、match_type 为 phrase、size 为 10，共匹配 4,615 个商品。前六个结果按预估月销量从高到低排列：

ASIN	末级类目	BSR	价格	预估月销量	评分（评分数）	上架日期
`B0CNTH3F7P`	Wireless Chargers	45	$21.99	44,607	4.4（9,018）	2023-12-13
`B0GGPBR4YP`	Wireless Chargers	42	$13.92	44,206	4.4（3,610）	2026-01-15
`B0BFCC18FS`	Charging Stations	59	$15.29	35,954	4.2（41,555）	2022-09-27
`B0C9JZHBXW`	Smartwatch Cables & Chargers	87	$7.99	29,211	4.6（5,500）	2023-08-21
`B0DLP157QH`	Wireless Chargers	113	$9.99	26,226	4.2（10,404）	2024-11-01
`B07FDXDB3W`	Solar Chargers	133	$29.99	26,173	4.2（47,739）	2018-08-07

这一张表已经能回答三个问题：

新品照样能赢。 第二名 2026 年 1 月才上架，评分数还不到第一名的一半，月销量却和第一名差不多。
一个词组横跨好几个类目。 前六名分布在四个末级类目里。比价格之前先按 nodeIdPath 分组，否则一根 $7.99 的手表充电线会把充电器的均价拉低。
评分数不是看上去那么高的门槛。 在这张表里，评分数超过 4 万的两个商品，月销量分别排第三和第六。

这里的数字都来自同一次返回；units 是模型估算，见下面的说明。

常见用法

把一页搜索结果读成一张表。 搜你想排上去的词，按 units 或 revenue 排序，看需求在头部几个 Listing 之间怎么分。要看什么见关键词怎么上首页。
建竞品集。 把自己的 ASIN 和主要竞品一起放进 asins，一次调用拿到同一组字段。怎么把这张表变成决策见竞品分析方法，用亚马逊评论 API 还能看到买家对每个竞品的抱怨。
筛候选商品。 从结果里留下价格带合适、评分数你追得上的商品，再用商品详情接口逐个核对。按类目整体筛选时，选产品接口支持区间条件而不需要关键词，见批量选品工作流。
替代爬虫。 结构化接口没有验证码、页面改版和代理费用的问题，两种方式的对比见抓取亚马逊的隐性成本。

需要知道的边界

units 和 revenue 是模型估算，不是 Amazon 自己的销量数据。用来给商品排序、互相比较是可靠的，不应当成精确销量来读，详见销量估算的边界。
商品没有的字段会返回 null 或 -1（例如 primePrice: -1），做计算前先判断。
badge 里的值要么是 N，要么是 Amazon 页面上显示的标签文字，例如 "#1 Best Seller in Cell Phone Wireless Chargers"。判断时用「不等于 N」，不要用「等于 Y」。
每次成功调用消耗 1 个计费单位。遇到 429 按错误与限流处理。

常见问题

这是 Amazon 的 Product Advertising API 吗？ 不是。Product Advertising API 面向联盟推广，不返回销量估算和 BSR 历史。这个接口为选品和市场研究而设计，不需要联盟账号。

一次调用能返回多少个商品？ 用 size 控制，每页最多 200 个，pages 告诉你这个关键词一共有多少页。

能只查一个 ASIN 吗？ 可以，放进 asins 即可。要看单个商品更完整的 Listing 信息，用亚马逊商品 API。

AI Agent 能直接调用吗？ 可以。这个接口已通过远程 MCP 服务作为工具提供，Claude Code、Cursor 等 MCP 客户端可以直接搜商品。