HTTP API 概览

Keepamore 封装完整的 HTTP API，可以方便、快速的调用 Keepa 数据。

基础地址

https://mcp.keepamore.com/api

鉴权、计费、缓存、错误码与 MCP 完全一致，共享套餐，使用同一个API Key 。

接口总览

方法	路径	用途	典型场景	消耗请求额度 units
`GET`	`/api/token`	查询当前额度	调用前自检余量、后台监控、自适应限速	0（免费）
`GET` / `POST`	`/api/keepa/product`	按 ASIN 查产品	拿 ASIN 详情 / 价格历史 / 评分 / Buy Box，最高频接口	1 × 去重后 ASIN 数（最少 1）
`GET`	`/api/keepa/productsearch`	关键词搜索产品	输关键词扫一遍前 1000 条 ASIN（10 页 × 100）	5
`GET` / `POST`	`/api/keepa/productfinder`	多字段选品筛选	按价格区间 / 排名 / 评分 / 历史新低等数十字段联合选品	1 + 每 100 结果 1
`GET`	`/api/keepa/bestseller`	Best Seller 榜单	拉某类目热销 ASIN 排名；`category=0` 时探索根分类	10
`GET`	`/api/keepa/seller`	卖家信息 / 店铺 ASIN	查卖家评分 / 反馈数；或拉单卖家的 storefront ASIN 列表	1 × N 或 10（storefront）
`GET`	`/api/keepa/topseller`	Most Rated Sellers	找站点评价数最多的头部卖家做竞品调研	50
`GET`	`/api/keepa/category`	类目详情	按 catId 查类目层级 / 子分类	1
`GET`	`/api/keepa/categorysearch`	类目搜索	用关键词模糊定位 catId（Product Finder 前的入口）	1
`GET`	`/api/keepa/lightningdeal`	Lightning Deals	查某 ASIN 是否在做秒杀，或拉站点全量秒杀列表	1（单 ASIN）/ 500（全量）
`GET` / `POST`	`/api/keepa/deal`	Browse Deals	Keepa 综合打折追踪：历史新低、降价幅度、跌价趋势	5
`GET`	`/api/keepa/graphimage`	价格历史图 PNG	在对话 / 报告中直接展示某 ASIN 的价格走势图	1
`GET`	`/api/keepa/charturl`	拼接 Keepa 图表链接	给用户一个跳转 Keepamore 站内 Keepa 图表页的 URL	0（免费）
`GET`	`/api/aba/countries`	ABA 站点列表	查看各站点 ABA 数据新鲜度	0（免费）
`GET`	`/api/aba/rank`	ABA 周榜单排名	多维筛选关键词排名，发现机会词	ceil(limit/1000)
`GET`	`/api/aba/search`	ABA 关键词搜索	搜索关键词字典，获取 word_id	1
`GET`	`/api/aba/word/:id`	ABA 关键词详情	查关键词属性 + 52 周排名历史 + Top3 ASIN	1
`POST`	`/api/aba/asin-reverse`	ASIN 反查	查某个 ASIN 出现在哪些 ABA 关键词下，竞品流量来源分析	1 × ASIN 数

完整索引见接口列表。

超时建议

部分接口耗时较长，建议把 HTTP 客户端的超时时间设置为 ≥ 180 秒，避免请求还在处理时客户端先断开。常用客户端默认值参考：

客户端	默认超时	建议改为
`axios` (Node)	无	`timeout: 180000`
`requests` (Python)	无	`timeout=180`
`fetch` (浏览器)	浏览器决定	用 `AbortController` 设 180s
`curl`	无	`--max-time 180`

选API还是MCP

选 HTTP API：

你的程序不是 AI Agent，不需要走 MCP 协议
想用最熟悉的 curl / axios / requests 直连
想走服务端到服务端（MCP 协议更适合 AI 客户端会话）

选 MCP：

希望让 AI 直接调用 Keepa 数据
使用支持 MCP 的客户端（Cherry Studio / Cursor / Cline 等）

两者共享套餐额度。

快速尝试

bash

curl "https://mcp.keepamore.com/api/token" \
  -H "X-API-Key: 你的apikey(km_开头)"

或者直接在浏览器访问：

text

https://mcp.keepamore.com/api/token?key=你的apikey

json

{
	"code": "0000",
	"msg": "查询成功",
	"data": {
		/* ... */
	}
}

HTTP API 概览 ​

基础地址 ​

接口总览 ​

超时建议 ​

选API还是MCP ​

快速尝试 ​