keepa_get_variations

获取某个变体家族的全部变体基本信息：标题、颜色、尺寸、主图、当前价、月销、评分、UPC 等。

用途

• 传家族内任意 ASIN（父或子均可），自动解析父 ASIN 并展开全部变体（可达数百个）；建议优先传子 ASIN——父 ASIN 在 Keepa 偶尔没有商品记录，届时返回"未找到该 ASIN 的产品数据"
• 变体级对比选品：哪个颜色 / 尺寸在卖、价格多少、月销多少、评分如何
• 拿变体的 UPC / EAN（做站外匹配、库存对账等）

Keepa 官方 API 没有等价能力，本工具为 Keepamore 独有。

计费

场景	units
正常返回变体列表	5 units / 次
该 ASIN 无变体（单品）	1 unit（自动退回 4 units）

detailLevel 不额外计费；翻页 / 不同 detailLevel 视为不同请求独立计费（1 小时缓存期内也照常计费，与 product / bestseller 一致，按需取页）；5 分钟内完全相同参数的请求不重复计费（dedup）。

参数

名称	类型	必填	默认	说明
country	enum	✅	—	见 站点枚举
asin	string	✅	—	变体家族内任意 ASIN（父或子均可）
🛠 detailLevel	enum		summary	summary（stats 投影成命名字段）/ lite / full
🛠 page	integer		0	变体列表分页页码，从 0 开始
🛠 perPage	integer		50	每页变体数，1–4000；AI 上下文有限，建议 ≤1000（400 变体家族一次全拿可用 summary 级）

返回结构（摘要）

{
	"success": true,
	"data": {
		"country": "us",
		"domainId": 1,
		"inputAsin": "B0H2HG3P8J",
		"parentAsin": "B0HFRJ21Z5",
		"isStandalone": false,
		"variationsCount": 400,
		"variations": [
			{
				"asin": "B0H2HG3P8J",
				"title": "Miracase Silicone & Magnetic for iPhone 15 Pro Max Case, Glass Blue",
				"color": "Glass Blue",
				"size": "iPhone 15 Pro Max",
				"imagesCSV": "41aH4MDfVBL.jpg",
				"stats": { "price": 2099, "listPrice": 2299, "buyboxPrice": 2099, "bsr": 15, "rating": 45, "reviewCount": 84208, "countNew": 1 },
				"monthlySold": 50,
				"upcList": ["1983524252012"]
			}
		],
		"_pagination": { "page": 0, "perPage": 50, "total": 400, "totalPages": 8 },
		"responseShape": { "detailLevel": "summary" }
	}
}

• variationsCount 是全量变体总数；variations 是当前页（默认 50 条），一页装不下时附 _pagination
• isStandalone: true = 该 ASIN 无变体（单品），variations 为空、parentAsin 为 null，仅计 1 unit
• summary 级 stats 为投影命名字段（价格为分、日本站为日元、rating 为评分×10、-1=无数据）：price 新品最低价 / amazonPrice / listPrice / buyboxPrice / bsr / reviewCount / countNew 在售 offer 数
• 图片文件名拼完整 URL：https://m.media-amazon.com/images/I/<文件名>
• detailLevel 三级差异：summary（默认）白名单摘要 + stats 投影；lite 保留全部字段但删除 csv、reviews 只留最新一组；full 原始数据原样（体积大，慎用）

推荐使用模式

场景	入参示例
变体对比选品	{ "country": "us", "asin": "B0H2HG3P8J" }（默认 summary + 前 50 条）
看全量变体概览	{ "country": "us", "asin": "B0H2HG3P8J", "perPage": 1000 }
需要价格历史做分析	{ "country": "us", "asin": "B0H2HG3P8J", "detailLevel": "full", "perPage": 10 }（逐页拿）

和 HTTP API 的对应

• HTTP：GET | POST /api/keepa/variations