keepa_category_lookup

按 Category ID 查询分类详情。对应 Keepa /category 接口。

用途

• 已知分类 ID，获取该分类的名称、父子关系、所含子分类列表
• category=0 时返回该站点的全部根分类（一级类目）
• 需要父级链时开启 parents: true

参数

名称	类型	必填	默认	约束	说明
country	enum	✅	—	—	Amazon 站点代码
category	integer	✅	—	≥ 0	Keepa category ID。0 = 返回所有根分类
parents	boolean		false	—	是否返回父级分类链

计费

• 1 unit / 次

使用示例

{ "country": "us", "category": 172282, "parents": true }

返回结构

{
	"success": true,
	"data": {
		"categories": {
			"172282": {
				"catId": 172282,
				"name": "Electronics",
				"parent": 0,
				"children": [541966, 172456, "..."]
			}
		},
		"fromCache": false
	}
}

categories 是 Map<catId, Category>：

• category=0 时，所有根类目都列在该 Map 下
• parents=true 时，从当前节点到根的父级链节点也并入同一个 Map（按 ID 取用即可，不是单独的 parents 数组）

每个分类对象的完整 27 项字段（productCount / avgBuyBox / topBrands 等）见 Category Object。

和 HTTP API 的对应

• HTTP：GET /api/keepa/category
• 返回的分类对象完整字段（productCount / avgBuyBox / topBrands 等共 27 项）见 Category Object