keepa_category_search

按关键词搜索 Amazon 分类。对应 Keepa /search 接口（type=category）。

用途

• 想给 Product Finder 的 categories_include 传分类 ID 时，用这个工具先定位 ID
• 模糊查找类目树里某个关键词匹配的分类列表

参数

名称	类型	必填	默认	约束	说明
country	enum	✅	—	—	Amazon 站点代码
term	string	✅	—	非空	搜索关键词

计费

• 1 unit / 次

使用示例

{ "country": "us", "term": "earbuds" }

返回结构

{
	"code": "0000",
	"data": {
		"country": "us",
		"term": "earbuds",
		"categories": [{ "catId": 12097479011, "name": "Earbud Headphones" }]
	}
}

典型工作流

1. keepa_category_search 找到 catId
2. keepa_category_lookup 查子分类
3. keepa_product_finder 用 categories_include: [catId] 做筛选

和 HTTP API 的对应

• HTTP：GET /api/keepa/categorysearch
• 返回的分类对象完整字段见 Category Object