aba_reverse_asin

ASIN 反查：查询一个或多个 ASIN 在 ABA 周榜单中出现在哪些关键词下，以及对应的排名位置和点击/转化数据。

用途

• 竞品分析：发现竞争对手的 ASIN 在哪些关键词下获得曝光和转化
• 关键词机会发现：找到竞品 ASIN 排名靠前但你未覆盖的关键词
• Listing 优化参考：了解某个 ASIN 的自然搜索流量来源

参数

名称	类型	必填	默认	约束	说明
asins	string[]	✅	—	1–50 个	ASIN 列表
country	enum		—	—	限定站点。不传则查询所有 9 个站点
startDate	string		—	YYYY-MM-DD	起始报告日期
endDate	string		—	YYYY-MM-DD	结束报告日期
limit	integer		100	1–500	每个 ASIN 最多返回的关键词条数

计费

• 按 ASIN 数量计：N units（N = 去重后 ASIN 数量）

使用示例

查询单个 ASIN 在美国站的关键词：

{ "asins": ["B08N5WRWNW"], "country": "us" }

批量查询多个 ASIN（不限站点）：

{ "asins": ["B08N5WRWNW", "B09XS7JWHH", "B0CHX1W1XY"], "limit": 50 }

限定时间范围：

{
  "asins": ["B08N5WRWNW"],
  "country": "us",
  "startDate": "2026-01-01",
  "endDate": "2026-05-01"
}

返回结构

{
  "success": true,
  "data": {
    "asins": [
      {
        "asin": "B08N5WRWNW",
        "name": null,
        "first_seen_date": "2025-06-15",
        "last_seen_date": "2026-05-11",
        "total_words": 45,
        "top1_count": 12,
        "avg_rank": 3,
        "hits": [
          {
            "report_date": "2026-05-11",
            "country": "us",
            "position": 1,
            "click": 45000,
            "conversion": 3200,
            "word_id": "1234567890123456789",
            "word": "bluetooth speaker",
            "word_cn": "蓝牙音箱",
            "new_rank": 1
          }
        ]
      }
    ],
    "_total_hits": 45
  }
}

字段	说明
asin	ASIN 编号
first_seen_date	该 ASIN 首次出现在 ABA 榜单的日期
last_seen_date	该 ASIN 最近一次出现在 ABA 榜单的日期
total_words	该 ASIN 出现过的关键词总数（去重）
top1_count	该 ASIN 占据 Top1 位置的次数
avg_rank	该 ASIN 的平均关键词排名
hits	关键词匹配记录（按 report_date 倒序）
hits[].position	该 ASIN 在此关键词 Top3 中的位置（1-3）
hits[].click	点击量
hits[].conversion	转化量
hits[].new_rank	该关键词当期的排名
_total_hits	所有 ASIN 的 hits 总数

关于 name 字段：name 固定为 null（ASIN 商品名需用 keepa_get_product 获取）。

相关工具

• aba_get_word_detail —— 从返回的 word_id 深入分析关键词
• aba_get_rank_list —— 浏览榜单发现竞品 ASIN
• keepa_get_product —— 获取 ASIN 商品详情

和 HTTP API 的对应

• HTTP：POST /api/aba/asin-reverse