GET /api/keepa/category

按分类 ID 查询分类详情；也可用于一次性获取某站点的全部根分类（一级类目）。

对应 Keepa 官方接口：Category Lookup

接口

GET https://mcp.keepamore.com/api/keepa/category

计费

项目	units
任意一次成功调用	1

任何参数都不会改变本接口的计费金额。

参数（Query String）

名称	类型	必填	默认	约束	说明
domain	integer	✅	—	1–12	站点 ID，参见 domain 映射。也可用 domainId / country 别名
category	integer	✅	—	≥ 0	分类节点 ID；0 = 返回该站点的全部根分类
parents	boolean		false	—	true 时附带从根节点到当前分类的完整父级链

响应

{
	"code": "0000",
	"msg": "ok",
	"data": {
		"categories": {
			"172282": {
				"catId": 172282,
				"name": "Electronics",
				"children": [541966, 172456],
				"parent": 0
			}
		},
		"fromCache": false
	}
}

category=0 时 categories 下为所有根分类的映射表。每个分类对象的完整字段见 Category Object。

示例

cURL

# 请将 km_xxx 替换为你的 API Key
# 查具体分类（带父级链）
curl "https://mcp.keepamore.com/api/keepa/category?domain=1&category=172282&parents=1" \
  -H "X-API-Key: km_xxx"

# 列出美国站所有根分类
curl "https://mcp.keepamore.com/api/keepa/category?domain=1&category=0" \
  -H "X-API-Key: km_xxx"

JavaScript

// 请将 km_xxx 替换为你的 API Key
const r = await fetch(
	"https://mcp.keepamore.com/api/keepa/category?domain=1&category=172282&parents=1",
	{ headers: { "X-API-Key": "km_xxx" } },
);
console.log(await r.json());

Python

# 请将 km_xxx 替换为你的 API Key
import requests

resp = requests.get(
    "https://mcp.keepamore.com/api/keepa/category",
    params={"domain": 1, "category": 172282, "parents": 1},
    headers={"X-API-Key": "km_xxx"},
    timeout=60,
)
print(resp.json())

PHP

<?php
// 请将 km_xxx 替换为你的 API Key
require 'vendor/autoload.php';
use GuzzleHttp\Client;

$client = new Client();
$resp = $client->get('https://mcp.keepamore.com/api/keepa/category', [
    'headers' => ['X-API-Key' => 'km_xxx'],
    'query'   => ['domain' => 1, 'category' => 172282, 'parents' => 1],
    'timeout' => 60,
]);
echo $resp->getBody();

Java

// 请将 km_xxx 替换为你的 API Key（Java 11+ 标准库）
import java.net.URI;
import java.net.http.HttpClient;
import java.net.http.HttpRequest;
import java.net.http.HttpResponse;
import java.time.Duration;

HttpClient client = HttpClient.newHttpClient();
HttpRequest req = HttpRequest.newBuilder()
    .uri(URI.create("https://mcp.keepamore.com/api/keepa/category?domain=1&category=172282&parents=1"))
    .header("X-API-Key", "km_xxx")
    .timeout(Duration.ofSeconds(60))
    .GET()
    .build();
HttpResponse<String> resp = client.send(req, HttpResponse.BodyHandlers.ofString());
System.out.println(resp.body());

Go

// 请将 km_xxx 替换为你的 API Key（Go 标准库 net/http）
package main

import (
    "fmt"
    "io"
    "net/http"
    "time"
)

func main() {
    url := "https://mcp.keepamore.com/api/keepa/category?domain=1&category=172282&parents=1"
    req, _ := http.NewRequest("GET", url, nil)
    req.Header.Set("X-API-Key", "km_xxx")

    client := &http.Client{Timeout: 60 * time.Second}
    resp, err := client.Do(req)
    if err != nil { panic(err) }
    defer resp.Body.Close()

    body, _ := io.ReadAll(resp.Body)
    fmt.Println(string(body))
}

典型配方

场景	建议参数
浏览某站点的全部一级类目	category=0
查类目下属子分类（构建类目树）	category=<id>
取类目完整路径（面包屑显示）	category=<id>&parents=1

错误处理

通用错误码、metadata 字段定义见 错误码总览。常见情况：

• 缺少 category / domain，或参数取值非法 → HTTP 400，code 以 VALIDATION 开头
• 上游 Keepa 拒绝或不可达 → HTTP 502，code = UPSTREAM_ERROR，可携带 metadata.errorId 联系支持

对应 MCP 工具

keepa_category_lookup