keepa_get_top_sellers

获取指定站点的 Most Rated Sellers（评价数最多的卖家）榜单。对应 Keepa /topseller 接口。

用途

• 快速扫描某站点评价数最多的头部卖家
• 做竞品卖家调研的起点

拿到 Seller ID 后传给 keepa_get_seller 即可拉详情。

参数

名称	类型	必填	默认	约束	说明
country	enum	✅	—	—	Amazon 站点代码
page	integer	✅	0	≥ 0	0-indexed 页码
perPage	integer	✅	1000	1–10000	每页条目数

计费

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

使用示例

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

返回结构

{
	"success": true,
	"data": {
		"sellerIdList": ["A1PA6795UKMFR9", "ATVPDKIKX0DER", "..."],
		"_pagination": {
			"page": 0,
			"perPage": 100,
			"total": 10000,
			"totalPages": 100
		},
		"fromCache": false
	}
}

• sellerIdList：当前页的 Seller ID 数组
• _pagination：🛠 Keepamore 在上游全量返回基础上做的服务端切片元信息；total 为切片前完整列表长度
• fromCache：本地 Redis 缓存命中标识（24 小时窗口）

拿到 sellerIdList 后，把单个 / 一组 ID 传给 keepa_get_seller（含字段定义跳转 Seller Object）即可获取完整卖家档案。

和 HTTP API 的对应

• HTTP：GET /api/keepa/topseller