Best Sellers Object

某分类下按销量排名的 ASIN 榜单——结构极简（4 个字段），是选品工作流中「按品类抓爆款 → 拉产品详情」的入口对象。

对应 Keepa 官方：Best Sellers Object

何时返回

调用	Keepamore 响应位置	透传方式
/api/keepa/bestseller	data.bestSellersList	✅ 全字段透传 + 可选分页切片
别名 /api/keepa/bestsellers	data.bestSellersList	同上，计费 / 缓存共享

🛠 Keepamore 增强：当请求带 page 或 perPage 时，会在服务端对 asinList 做切片，并在对象内注入 _pagination 字段。详见下方分页字段。

响应示例

不分页（不传 page / perPage）

{
	"data": {
		"bestSellersList": {
			"domainId": 1,
			"lastUpdate": 7234567,
			"categoryId": 172282,
			"asinList": ["B0CHX1W1XY", "B09XS7JWHH", "B08H93ZRK9", "..."]
		},
		"fromCache": false
	}
}

启用分页（任一传了 page 或 perPage）

{
	"data": {
		"bestSellersList": {
			"domainId": 1,
			"lastUpdate": 7234567,
			"categoryId": 172282,
			"asinList": ["B0CHX1W1XY", "B09XS7JWHH", "..."],
			"_pagination": {
				"page": 0,
				"perPage": 100,
				"total": 9876,
				"totalPages": 99
			}
		},
		"fromCache": false
	}
}

字段表

上游原生字段

字段	类型	说明
domainId	int	站点 ID（1=com / 2=co.uk / 3=de / 4=fr / 5=co.jp / 6=ca / 8=it / 9=es / 10=in / 11=com.mx / 12=com.br）
lastUpdate	int	榜单上次刷新时间，单位 KeepaTime 分钟。换算 Unix 秒：(lastUpdate + 21564000) * 60
categoryId	long	请求时传入的类目节点 ID
asinList	string[]	按销量排序的 ASIN 列表，索引 0 = 最畅销（Sales Rank 最低）。最多 10000 条

分页字段（Keepamore 增强）

仅在请求带 page 或 perPage 时存在。

字段	类型	说明
_pagination.page	int	当前页号（从 0 起）
_pagination.perPage	int	每页条数（默认 1000，上限 10000）
_pagination.total	int	切片前 asinList 总长度（即上游返回的全量条数）
_pagination.totalPages	int	总页数 = Math.ceil(total / perPage)

切片只影响 asinList，domainId / lastUpdate / categoryId 仍是上游原值。

与 Best Sellers Rank 的区别

• 本对象：按 某个类目 列出畅销 ASIN（类目 → ASIN 反查）
• Sales Rank（Product Object 的 salesRanks）：按 某个 ASIN 给出它在各类目的实时排名（ASIN → 排名 正查）

选品工作流通常先用 Best Sellers Object 拿到 ASIN 列表，再批量调 /keepa/product 取详情与历史曲线。

上层 / 关联对象

• 上层端点：/keepa/bestseller
• 联动对象：Category Object（按类目特征筛 catId） / Product Object（拿 asinList 后批量查产品详情 + 历史）
• 公共约定：字段速查 · 公共约定（KeepaTime 换算）