亚马逊品牌分析（Brand Analytics）以排名的形式公布搜索词数据。每周每个搜索词得到一个名次，而这个名次背后有多少次搜索，平台并不公布。
这决定了它该怎么用。任何看起来像搜索量的数字，都是建立在排名之上的模型。排名本身，以及它怎么变化，才是能依靠的部分。这篇按能产出决策的顺序读ABA 周数据接口返回的一行：先看变化，再看点击掌握在谁手里，最后看进入要花多少成本。把词汇集成词库见搭建自己的关键词库；这篇讲的是怎么把一个词读对。
一行就是一个词在一周里的数据
周数据接口一个搜索词返回一行。两个参数决定周和范围：
date传该周的结束日期，而且必须是周六：文档示例20250802就是周六。留空则取最新一周；includeKeywords、excludeKeywords、departments用来缩小词的范围。
月数据接口按自然月返回相同结构；ABA 关键词趋势接口把一个词的 rank 和 searches 作为序列返回，timeGranularity 传 W 按周、M 按月。
curl --request POST \
--url https://ecommercedataapi.com/v1/amazon/aba/research/weekly \
--header "Content-Type: application/json" \
--header "X-API-Key: ${ECOMMERCE_DATA_API_KEY}" \
--data '{
"marketplace": "US",
"date": "20250802",
"includeKeywords": "screen protector",
"page": 1,
"size": 20
}'排名是数据，规模是模型
文档里「screen protector」这一行的 searchRank 是 9038。旁边有 searches（22012）、purchases（1035）、clicks（3403）和 impressions（451341）。排名是平台公布的；规模是在它之上建的估算，彼此内部是自洽的，但没有被独立验证过：purchases ÷ searches = 1035 ÷ 22012 = 0.047，正是同一行里 purchaseRate 的 0.047。
规模数字用来比较词和词之间的大小，不要拿去规划库存。不同工具对「搜索量」为什么说法不一，见关键词工具怎么选。
读变化，并且盯住符号
每一行带着当前排名和三个更早时间点的排名：
| 字段 | 含义 | 示例值 |
|---|---|---|
searchRank | 本周排名 | 9038 |
w1SearchRank | 1 周前排名 | 8300 |
w4SearchRank | 4 周前排名 | 7989 |
w12SearchRank | 12 周前排名 | 8738 |
每个后面还有变化量和变化率（w1RankGrowthValue、w1RankGrowthRate 等）。用示例数据反推，规则是：变化量 = 更早的排名 − 当前排名，变化率 = 变化量 ÷ 更早的排名。
| 对比 | 更早排名 | 变化量 | 变化率 |
|---|---|---|---|
| 1 周前 | 8300 | 8300 − 9038 = −738 | −738 ÷ 8300 = −0.0889 |
| 4 周前 | 7989 | 7989 − 9038 = −1049 | −1049 ÷ 7989 = −0.1313 |
| 12 周前 | 8738 | 8738 − 9038 = −300 | −300 ÷ 8738 = −0.0343 |
三项算出来都和示例给的一模一样。陷阱在符号上。排名数字越小，词越热，所以变化量为负说明这个词变冷了。 这里排名从 8300 变成 9038，变化量是 −738。把「增长 −0.0889」读作下降 8.9%，就读对了；把 −738 读作「排名下降了 738 位」，就读反了。
同一张表还能读出两件事。
只看一个对比点会误导。 对比 12 周前，这个词下降了 3.4%；对比 4 周前，下降了 13.1%。4 周前的 7989 是这四个点里最好的排名。真实的走势是先从 8738 升到 7989，再一路滑回 9038。三个锚点要一起看，或者用趋势接口拉整条序列。
变化率不对称。 它除以的是更早的排名，所以改善最多不会超过 +100%，而下降没有下限。文档里的月数据示例出现了 −1.1357：排名从 4548 变成了 9713，5165 ÷ 4548 就是 1.1357。如果把变化率升序排，看到的多半是下降的词，最大的数字也不是变动最大的词。
月数据的返回沿用了 w1、w4、w12 这些字段名。跨两个接口比较之前，先确认它们在月数据里各自对应哪个周期。
读点击掌握在谁手里
两个字段描述一个词有多集中：
clickShareRate是前三名商品拿走的点击份额，cvsShareRate是它们的转化份额；top3Brands给出品牌，top3AsinDtoList给出每个头部商品的clickRate和conversionRate。
示例里 clickShareRate 是 0.1489，cvsShareRate 是 0.0842：前三名只拿走约 15% 的点击和 8% 的转化，说明这个词比较分散，新来的也能分到一份。前三名占了两项大部分的词，则是另一回事。字段表里的示例是 54.2 和 43.5，而返回示例给的是小数，所以拿到第一份返回后先核对量纲，再去比较不同的词。排名值不值得追，取决于点击怎么分，见关键词怎么上首页。
读进入要花多少成本
三个字段给进入标上价格：
cprExact：大约 8 天内把这个词推上首页所需的销量，示例是 64。它是估算值；附录的排序表把同一个字段标为 SPR，请求里的筛选参数也叫minSPR和maxSPR；titleDensityExact：首页商品里标题精确包含该词的数量，示例是 50，说明首页已有很大一部分这样做了，自己标题里用这个词占不到什么优势；bid、bidMin、bidMax：商品推广的竞价和区间，示例是 3.36 和 2.52–4.2。之后怎么调整见关键词竞价。
排名在上升、点击分散、cprExact 低的词，进入成本低；三项反过来的词，成本就高，光看排名是看不出来的。
把它做成观察名单
同一个接口可以按排名、增长、点击和集中度筛选，所以一个观察名单就是每个类目一次请求：
curl --request POST \
--url https://ecommercedataapi.com/v1/amazon/aba/research/weekly \
--header "Content-Type: application/json" \
--header "X-API-Key: ${ECOMMERCE_DATA_API_KEY}" \
--data '{
"marketplace": "US",
"date": "20250802",
"includeKeywords": "protector",
"maxSearchRank": 50000,
"minRankGrowthRate": 0.1,
"order": { "field": "searchfrequencyrank", "desc": false },
"page": 1,
"size": 20
}'这个请求要的是：包含「protector」、排名在 50,000 以内、上周至少改善 10% 的词，按排名从好到差排列。数字只是示例。假设筛选条件和返回字段使用相同的符号，正的 minRankGrowthRate 选出的就是在上升的词；依赖它之前，先在第一页结果里确认一下。order.field 可选 searchfrequencyrank、cprExact、titleDensityExact 和 searches（表 2.4）。
searchModel 参数取 1 到 6，预设一种市场视角：热门市场、异动市场、持续增长市场、快速飙升市场、潜力市场和长尾市场。它的取值目前只在中文文档里有说明，把它当作捷径，并用你自己的筛选条件对照测试。
需要知道的边界
- 排名是平台公布的；所有带规模的数字（
searches、purchases、clicks、impressions）都是它之上的模型。用来比较词，不要当作计数来读； - 一周的数据有噪声。排名逐周波动的原因可能与需求无关，所以单周的变化是「去看序列」的提示，不是结论；
- 这份数据描述的是平台上的搜索行为，不知道一个词适不适合你的产品，这一步要你自己判断。
常见问题
这和卖家后台的品牌分析是同一份数据吗？ 它覆盖的是品牌分析所报告的同一类搜索词排名数据，以 JSON 形式返回。
排名更好，就意味着这个词能卖出我的产品吗？ 不是。排名说明这个词有多热，不说明搜这个词的买家会不会买你的产品。点击份额和进入成本这几个字段，比排名更能回答这个问题。
多久拉一次？ 每周固定同一天拉，并且每一周都留存。序列比任何一次单拉都更有用。
能让 AI Agent 来做吗？ 可以。这个接口已通过远程 MCP 服务提供，Agent 可以拉一个词并帮你读变化。