Deal Object

近 12 小时内有价格 / 排名变动的产品的「轻量摘要」对象——比 Product Object 紧凑得多，专为浏览 Deal 列表（Browsing Deals）设计。包含 ASIN 基本信息 + 跨多个 Date Range 的价格 / 排名变动指标。

对应 Keepa 官方：Deal Object

何时返回

调用	Keepamore 响应位置	透传方式
/api/keepa/deal (GET / POST)	data.deals.dr[]	✅ 全字段透传
别名 /api/keepa/deals	data.deals.dr[]	同上，计费 / 缓存共享（5 units / 次）

Keepamore 不裁剪 Deal 字段；仅在外层加 fromCache 标记。

响应示例

{
	"data": {
		"deals": {
			"dr": [
				{
					"asin": "B00M0QVG3W",
					"parentAsin": "B01D0MKH5V",
					"title": "Canon PowerShot SX400 Digital Camera",
					"rootCat": 562066,
					"categories": [569604],
					"image": [54, 49, 107, 51, 76, 97, 121, 55, 74, 85, 76, 46, 106, 112, 103],
					"current": [12999, -1, 8999, 1234, ...],
					"currentSince": [7234567, -1, 7234500, ...],
					"deltaLast": [-200, 0, -100, ...],
					"delta": [[100, 0, 50], [300, 0, 150], [500, 0, 200], [800, 0, 300]],
					"deltaPercent": [[0, 0, 0], [2, 0, 1], [4, 0, 2], [6, 0, 3]],
					"avg": [[13099, -1, 9049], [13299, -1, 9099], ...],
					"lastUpdate": 7234567,
					"creationDate": 7234500,
					"lightningEnd": 0,
					"warehouseCondition": 0,
					"warehouseConditionComment": null
				}
			]
		},
		"fromCache": false
	}
}

字段表

产品信息

字段	类型	说明
asin	string	产品 ASIN
parentAsin	string	父 ASIN（变体合并用）
title	string	标题。注意：极少数情况下可能含未转义 HTML 标记，渲染前请清洗
rootCat	long	根类目 ID。0 或 9223372036854775807 = 未知
categories	long[]	该产品所在的类目节点 ID 列表，可能为空
image	int[]	主图文件名的 ASCII 字符码数组（节省带宽）。JS 还原：String.fromCharCode.apply("", deal.image)。完整 URL：https://images-na.ssl-images-amazon.com/images/I/<name>

价格 / 排名变动

索引规则：current / currentSince / deltaLast 是一维数组，下标 = Price Type；delta / deltaPercent / avg 是二维数组：第一维 = Date Range，第二维 = Price Type。

字段	类型	说明
current	int[]	上次更新时各 Price Type 的当前价 / 排名（cents）。无 offer 时该项为 -1
currentSince	int[]	当前值生效的起始时间，单位 KeepaTime 分钟
creationDate	int	所请求 priceTypes 上次发生价格 / 值变化的时间。-1 = 从未采集
deltaLast	int[]	上一次 vs 当前的差值（- = 降价，+ = 涨价）。0 = 未变化或无法计算
delta	int[][]	各 Date Range 内 平均值 - 当前值，0 = 未变化或无法计算
deltaPercent	int[][]	同 delta，单位百分比
avg	int[][]	各 Date Range 的加权平均值。⚠ dr=0（day）实际是最近 48 小时的均值，不是 24 小时（与 Keepa Deal 计算逻辑一致）

Deal 元数据

字段	类型	说明
lastUpdate	int	Keepa 上次刷新该 Deal 的时间（KeepaTime 分钟）
lightningEnd	int	闪购结束时间（KeepaTime 分钟）；非闪购为 0
warehouseCondition	int	Warehouse Deal 最低价 offer 的成色：0 无 / 未知；2 Used – Like New；3 Used – Very Good；4 Used – Good；5 Used – Acceptable
warehouseConditionComment	string	该 Warehouse offer 的卖家备注；null = 无 Warehouse Deal

Date Range 索引

delta / deltaPercent / avg 第一维下标：

索引	名称	含义
0	day	最近 24 小时（实际 48 小时，见 avg 注）
1	week	最近 7 天
2	month	最近 31 天
3	90d	最近 90 天

闪购 / Prime 专享 / Warehouse 的 delta 特殊基准

LIGHTNING_DEAL (8) / PRIME_EXCL (33) / WAREHOUSE (9) 这三个 Price Type 的 deltaLast / delta / deltaPercent 用 AMAZON 价或 NEW 价作为参考价（不是同 Price Type 的上一价）。判读这三个下标的 delta 时务必注意。

上层 / 关联对象

• 上层端点：/keepa/deal（GET / POST 浏览 Deal）
• 关联对象：Lightning Deal Object（闪购的完整字段，比 Deal Object 的 lightningEnd 信息丰富） / Product Object（拿到 asin 后查完整产品 + 历史）
• 公共约定：KeepaTime / cents / Price Type 索引