接口参考

本分区列出每个 HTTP API 的参数、计费、示例。 所有接口共用的鉴权/错误码/响应结构请先读：

• 鉴权
• 错误码

通用约定

domain 映射

所有接口使用整数 domain（与 Keepa 官方一致）。部分接口兼容 domainId（历史保留）和 country 别名：

值	站点
1	Amazon.com（US）
2	Amazon.co.uk（UK）
3	Amazon.de（DE）
4	Amazon.fr（FR）
5	Amazon.co.jp（JP）
6	Amazon.ca（CA）
8	Amazon.it（IT）
9	Amazon.es（ES）
10	Amazon.in（IN）
11	Amazon.com.mx（MX）
12	Amazon.com.br（BR）

价格单位

Keepa 返回的价格单位为分（cents），如美国站100表示1美元。但日本除外，日本站，100表示100日元

评分单位

Keepa 评分 = 星数 × 10，45 = 4.5 星。

Keepa 时间

(keepaTime + 21564000) * 60000 = Unix时间戳（毫秒）。详见 时间换算工具。

接口索引

账号 / 额度

• GET /api/token — 查询当前额度（免费）

产品

• GET | POST /api/keepa/product — 按 ASIN 批量拉取产品（最常用）
• GET /api/keepa/productsearch — 关键词搜索
• GET | POST /api/keepa/productfinder — 多字段选品筛选

榜单 / 分类

• GET /api/keepa/bestseller — 类目畅销榜（按排名排）；category=0 时返回站点全部根分类
• GET /api/keepa/category — 类目详情（只返回类目信息，不含 ASIN）
• GET /api/keepa/categorysearch — 类目关键词搜索（Product Finder 前的入口）

卖家

• GET /api/keepa/seller — 卖家信息与店铺 ASIN（支持 storefront 模式）
• GET /api/keepa/topseller — Most Rated Sellers（评价数最多的头部卖家）

Deals

• GET /api/keepa/lightningdeal — Lightning Deals（Amazon 秒杀），支持单 ASIN 或站点全量
• GET | POST /api/keepa/deal — Browse Deals（Keepa 综合打折追踪：历史新低 / 降价幅度 / 跌价趋势）

可视化

• GET /api/keepa/graphimage — 价格历史图 PNG（直接嵌入对话 / 报告）
• GET /api/keepa/charturl — 拼接跳转 Keepamore 站内 Keepa 图表页的 URL（免费）

ABA 关键词（Amazon Brand Analytics）

数据来自 Amazon Brand Analytics 周榜单，覆盖 9 站点。数据源为自有数据库，不消耗 Keepa API token。

• GET /api/aba/countries — ABA 站点列表与最新日期（免费）
• GET /api/aba/rank — 周榜单排名查询（多维筛选 + Keyset 分页）
• GET /api/aba/search — 关键词字典全文搜索
• GET /api/aba/word/:wordId — 关键词详情 + 排名历史 + Top3 商品
• POST /api/aba/asin-reverse — ASIN 反查关键词（竞品流量分析）

响应头

所有成功响应都会额外带上响应头，便于可观测性：

Header	含义
X-Response-Time	服务端总耗时
X-Units-Consumed	本次扣减 units

PNG 响应（如 graphimage）还会带 X-Cache: HIT/MISS。