ASIN 反查关键词是一个操作：给一个 ASIN，拿回这个商品在搜索里的词。
它看起来足够简单，所以很少有人去确认返回的到底是什么。而这一步没确认清楚，后面所有基于这批词的判断都会偏。
先说清楚返回的是什么
反查接口的 items.keyword 字段，文档里的定义是：
该 ASIN 近 30 天或某个自然月进入过亚马逊搜索结果前 3 页的词
这句话里有两个限定，都很重要。
第一，它是"前 3 页"，不是"全部"。 一个词如果这个 ASIN 排在第 8 页，它不会出现在返回里。所以反查结果不是"这个商品相关的所有关键词"，是"这个商品有一定曝光的关键词"。
第二，它是一个时间窗内的快照。 不传 month 就是近 30 天，传 month（格式 yyyyMM）可以取某个历史自然月。
这两点合起来解释了一个常见困惑：新品或者排名弱的 Listing 反查出来词很少，这不是数据有问题。 它准确反映了一件事——这个商品目前拿到的曝光就是这么多。反过来，如果你拿一个成熟大卖的 ASIN 去查，返回上千个词也是正常的。
所以反查结果的数量本身就是一个指标。 竞品反查出 1800 个词而你只有 90 个，这个差距就是结论的一部分，不需要再分析别的。
一次请求需要什么
| 参数 | 必填 | 说明 |
|---|---|---|
asin | 是 | 单个 ASIN，格式为 10 位大写字母和数字 |
marketplace | 否 | 站点，不传默认 US |
month | 否 | 历史自然月 yyyyMM，不传为近 30 天 |
page | 否 | 页码，最大 100 |
size | 否 | 每页条数，最大 100 |
注意 asin 是单个而不是列表——批量反查是在你自己这边循环，这会影响你的调用量估算。20 个竞品就是至少 20 次调用，如果每个还要翻页，乘以页数。
分页有个上限，而且它会影响结论
接口最多可查询 2000 条数据。而返回里的 total 字段是符合条件的总词数，它可能大于 2000。
这两个数字不一致时，你拿到的是前 2000 条，不是全部。
这件事的实际影响是：你必须关心排序，因为被截断的是后面那部分。如果你的目的是找高价值词，被截掉的长尾影响不大；如果你想统计"这个 ASIN 一共覆盖多少词"，total 才是那个数，而不是你实际取回的条数。
把这两个数都记下来，比只记一个可靠。
排名字段怎么读
每个词带两组排名，rankPosition（自然排名）和 adPosition（广告排名），结构相同：
| 字段 | 含义 |
|---|---|
page | 第几页 |
pageSize | 该页有多少条 |
index | 在当前页里排第几 |
position | 在总结果里排第几 |
updatedTime | 这个排名是什么时候测的 |
做比较时用 position，不要用 page。 因为 pageSize 不是固定的——不同站点、不同搜索词的每页条数可能不同。第 2 页第 1 位和第 1 页第 60 位哪个靠前，只看页码答不出来，position 直接给出答案。
updatedTime 值得单独存一列。排名是会变的，一个没有时间戳的排名数字在两周后无法判断还能不能用。
另外，rankPosition 和 adPosition 同时存在意味着：这个词你既有自然位置也在投广告。 只有 adPosition 说明这个词的曝光是买来的。这个区别在亚马逊关键词怎么优化里有完整的处理方法。
badges：这个词把你放在哪里
badges 是一个数组，可选值包括 naturalSearching、amazonChoice、editorialRecommendations、fourStar、highlyRated、sponsorBrand、sponsorVideo、ads。
它回答的是"曝光来自什么位置"。同样是"这个词有曝光"，来自自然搜索结果和来自广告位，含义完全不同。做竞品分析时这一列尤其有用：对方在这个词上的位置是挣来的还是买来的，直接看 badges。
查自己和查竞品是同一个接口
反查不区分 ASIN 是不是你的。同一个接口，两种用法：
查自己，回答"我在为哪些词曝光"。这是优化的起点。
查竞品，回答"对方在哪些词上有位置"。常见做法是查 3 到 5 个同类竞品，把返回的词取并集，再减去你自己已有的词——差集就是你的盲区清单。
这个做法有一个前提要注意：竞品的词不一定适合你。 对方可能有你没有的变体、尺寸或认证，某些词对他相关而对你不相关。差集是候选清单，不是待办清单。
三个常见误解
误解一：反查返回的词就是竞品的后台搜索词。 不是。后台搜索词是卖家在后台填写的、只有对方账号能看的授权数据。反查给的是这个 ASIN 在公开搜索结果里实际出现过的词，两者来源完全不同，也不存在对应关系。
误解二：词越多说明产品越好。 词多只说明曝光面广。一个词如果从不出单，它在词表里的意义主要是"需要排除"。数量和质量要分开看。
误解三：一次反查就够了。
反查是快照。要判断趋势需要多个时间点——用 month 参数取几个连续的自然月，比单次结果能说明的问题多得多。
拿到词之后
反查本身只是取数。词拿到之后有两个方向：
- 要把这批词合并进一份可维护的词库，看搭建自己的关键词库
- 要决定每个词该怎么处理，看亚马逊关键词怎么优化
常见问题
能一次传多个 ASIN 吗？
关键词反查接口的 asin 是单个参数，批量需要在你这边循环。
父体和子体查出来的词一样吗？ 不一定。变体之间的曝光可以有差异，尤其是尺寸、颜色差异大的品类。要做严谨比较时，明确记录你查的是哪一个 ASIN，而不是笼统写"这个产品"。
为什么我查到的排名和我自己搜的不一样？
搜索结果受地理位置、登录状态、历史行为和时间影响，手动搜索几乎不可能复现接口的取样条件。用 updatedTime 判断数据新鲜度，而不是用手搜去"验证"。
历史数据能查多久？
month 参数接受自然月格式。具体可回溯的范围以接口文档为准，不要假设任意久远的月份都有数据。