Taxonomy API：获取 eBay 类目树

Taxonomy API 是 eBay 开放平台中最基础也最实用的 API 之一，用于获取 eBay 各站点的完整类目树结构和类目属性定义。

核心功能

获取类目树：返回指定站点的完整类目层级结构
获取单个类目：根据类目 ID 获取详情
获取类目属性：查看某个类目下商品必须填写的属性字段
搜索类目：根据关键词查找匹配的类目

获取完整类目树

GET https://api.ebay.com/commerce/taxonomy/v1/category_tree/get

请求头：

Authorization: Bearer ACCESS_TOKEN
X-EBAY-C-MARKETPLACE-ID: EBAY-US
Accept-Language: zh-CN

请求参数：

category_tree_id - 美国站 0，英国站 3，德国站 77，澳洲站 15

搜索类目

GET https://api.ebay.com/commerce/taxonomy/v1/category_tree/TREE_ID/get_category_suggestions?q=KEYWORD

Node.js 代码示例

import axios from 'axios';

async function getCategoryTree() {
  const response = await axios.get(
    'https://api.ebay.com/commerce/taxonomy/v1/category_tree/get',
    {
      headers: {
        'Authorization': 'Bearer ' + accessToken,
        'X-EBAY-C-MARKETPLACE-ID': 'EBAY-US',
        'Accept-Language': 'zh-CN',
      },
      params: { category_tree_id: 0 },
    }
  );

  const tree = response.data.rootCategoryNode;
  console.log('根类目:', tree.categoryName);
  console.log('节点数:', tree.childCategoryIds ? tree.childCategoryIds.length : 0);
}

返回数据结构

每个类目节点包含：

categoryId - 类目唯一 ID（上架商品时必须使用）
categoryName - 类目名称
childCategoryIds - 子类目 ID 数组
leafCategory - 是否为叶子类目（可直接上架）

💡 实用建议：

类目树数据变化频率低，建议拉取后缓存到本地
拉取完整类目树耗时约 2-5 秒，建议构建时一次性拉取
只有叶子类目（leafCategory=true）可以直接上架商品

声明：本文为非官方中文教程。最新官方文档请访问 developer.ebay.com。