商品搜索 API 接收一个关键词，以 JSON 返回商品。听起来像是「去掉页面的亚马逊搜索结果」。它并不完全是，而这个差别决定了结果能不能用。
请求里有两件事比其他一切都重要：匹配方式，以及清楚结果是按什么排序的。
一个关键词，三种匹配方式
2026 年 10 月 12 日，我们在美国站用同一个关键词 pet water fountain 跑了三次，只改 match_type：
match_type | 匹配到的商品数 | 排在最前面的是什么 |
|---|---|---|
broad（默认值） | 265,533 | 瓶装水、保温水杯、婴儿湿巾 |
phrase | 1,880 | 宠物饮水机和替换滤芯，全部在宠物用品类目下 |
exact | 750 | 同一个类目，进一步收窄到标题包含这个词组的商品 |
模糊匹配的结果不是数据出了错。 模糊匹配只要命中其中任意一个词就算匹配，而「water」能命中目录里很大一部分商品。含有你某个词的最畅销商品排在最前面，前几名里没有一个是宠物饮水机。
所以做商品研究时，把 match_type 设成 phrase 或 exact，除非你确实想要某个词附近的所有商品。 保留默认值，是第一次测试时觉得结果不对的最常见原因。
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": "pet water fountain",
"match_type": "phrase",
"include_variations": false,
"page": 1,
"size": 20
}'结果按估算销量排序
三次测试里，商品都是按 units（月销量估算）从高到低返回的。词组匹配的前八个从 32,461 一路降到 6,290。
这不是买家看到的顺序。 亚马逊的结果页按它自己的相关性排序，还包含广告位。这个接口回答的是另一个问题：匹配这个关键词的商品里，哪些卖得最多。
估算一个关键词的市场规模，这是对的顺序。想知道谁占着第 3 位，这是错的顺序。
每个商品包含什么
| 字段 | 它告诉你什么 |
|---|---|
asin、parent、title、brand | 是哪个商品，以及它的父体 |
price、averagePrice | 当前价格和平均价格 |
bsr、subcategories | BSR 排名和小类排名 |
units、revenue | 月销量和销售额估算 |
rating、ratings | 星级和评分数 |
sellers、sellerNation、fulfillment | 卖家数量、卖家所在地、配送方式 |
nodeLabelPath | 类目路径，例如 Pet Supplies:Cats:Feeding & Watering Supplies:Fountains |
availableDate | 上架日期，毫秒时间戳 |
返回里还有 total 和 pages。page 最大 100，size 最大 200。
完整字段见 Amazon 商品搜索 API 页面。
拿到结果后要做的三件事
1. 先按类目筛，再统计。 即使用词组匹配，测试里饮水机旁边也返回了替换滤芯：配件的标题里带着主商品的关键词。先按 nodeLabelPath 和价格分组，再把这份列表当成一个市场。
2. 在正确的层级上读 units。 units 是父体的估算，所以变体多的商品看起来会比单变体的竞品大。include_variations 控制变体是否单独列出。哪些数字是合并的，见父 ASIN 和子 ASIN 的区别。
3. 看销量是怎么分布的。 如果前三个商品占了大部分销量，这个关键词是集中的；如果销量降得很慢，后面还有空间。怎么读这个分布，见关键词上首页。
什么时候你需要的是搜索排名
如果问题是「这个商品在这个关键词下排第几」，用反查，不要用商品搜索。流量词反查接口针对一个 ASIN，返回它有曝光的词，带着 rankPosition（自然位）和 adPosition（广告位）。怎么读见亚马逊 ASIN 反查关键词怎么做。
| 你想知道 | 用什么 |
|---|---|
| 一个关键词下哪些商品卖得最多 | 商品搜索，phrase 或 exact |
| 一批 ASIN 的价格、排名和销量 | 商品搜索传 asins（见 ASIN 查询） |
| 一个商品在它的关键词下排第几 | 反查 |
| 按条件筛出一个类目里的所有商品 | 选产品接口 |
这份数据做不到的事
它不复现买家看到的结果页。 没有广告位，没有个性化，没有页面布局。
units 和 revenue 是估算。 适合拿来给商品相互排序，不适合当作精确销量。见亚马逊销量数据能拿到什么、拿不到什么。
一次快照只代表一天。 上面的测试反映的是 2026 年 10 月 12 日，总数会变。
常见问题
这是 Amazon Product Advertising API 吗？ 不是。那个 API 是给做商品链接的联盟成员用的。这个接口返回估算销量、BSR 这类研究字段。
该用哪种匹配方式？
先用 phrase。如果词组匹配仍然带进太多关系不大的商品，用 exact；只有想要某个词附近的一切时才用 broad。
能用 ASIN 而不是关键词搜索吗？
可以。把 keyword 换成 asins，最多传 40 个 ASIN。两者只能传一个。
能拿到亚马逊的自然排名顺序吗？ 商品搜索拿不到。一个商品在某个词下的位置，用反查。