keepa_get_best_sellers

获取指定分类的 Best Seller 榜单。对应 Keepa /bestseller 接口。

用途

• 拉取特定分类下的热销 ASIN 排行
• 探索某个站点的分类结构：category=0 时返回该站点的全部根分类列表
• 支持 Sub-list（子榜单）、Variations（变体合并）

参数

名称	类型	必填	默认	约束	说明
country	enum	✅	—	—	Amazon 站点代码
category	integer	✅	—	≥ 0	Keepa category ID。0 = 返回该站点所有根分类列表；具体 ID = 返回该分类详情及子分类
range	integer		0	0/30/90/180	时间范围
variations	boolean		false	—	是否合并变体
sublist	boolean		false	—	是否拉取子榜单
page	integer	✅	0	≥ 0	0-indexed 页码
perPage	integer	✅	1000	1–10000	每页条目数

计费

• 10 units / 次（参数不影响计费）

使用示例

获取美国站"电子产品"分类 (172282) 前 100 条 Best Seller：

{ "country": "us", "category": 172282, "range": 0, "page": 0, "perPage": 100 }

探索美国站全部根分类：

{ "country": "us", "category": 0, "page": 0, "perPage": 100 }

返回结构

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

bestSellersList 是完整的 Best Sellers Object（4 个上游字段），asinList 已按 page/perPage 在服务端切片，并注入 Keepamore 增强的 _pagination 元信息。asinList 索引 0 = 该页内最畅销 ASIN。

完整字段定义（含 lastUpdate 的 KeepaTime 换算）见 Best Sellers Object。

相关工具

• keepa_category_lookup —— 按 ID 查分类详情
• keepa_category_search —— 按关键词搜分类

和 HTTP API 的对应

• HTTP：GET /api/keepa/bestseller
• 返回的 bestSellersList 完整字段（domainId / lastUpdate / categoryId / asinList + Keepamore 注入的 _pagination）见 Best Sellers Object