按名称查询 eBay 类目 ID,并列出指定站点的一级大类目录。
查看 eBay 商品与卖家数据 API 的全部接口 →以结构化 JSON 返回某个 eBay 站点的类目目录。可传入 query,按类目名称或 slug 做不区分大小写的子串筛选,把 cell phones 这类日常名称解析为搜索接口 category 参数所需的数字 category_id;query 留空则返回完整的一级类目树。domain 可选 13 个已验证的 eBay 站点(com、co.uk、de、com.au、ca、fr、it、es、nl、at、ch、ie、pl),max_results 控制返回的类目数量,最多 240 条。响应采用 ok/meta/data 外层结构:data.categories[] 包含 category_id、name 和 slug,data.groups[] 为一级大类(department)名称。实测示例(query 为 cell phones,domain 为 com,max_results 为 5):返回 1 个类目(category_id 15032,name 为 Cell Phones & Accessories,slug 为 Cell-Phones-Smart-Watches-Accessories),同时返回 18 个大类名称,如 Electronics、Collectibles & Art、Home & Garden,meta 中 domain 为 com、query 为 cell phones、record_count 为 1。
API 功能
在线 API 演示
未找到可用的 API Key,请前往控制台创建后刷新本页。 控制台 →
/api/project/ebay/categories API 响应 (JSON)
{} curl -X POST 'https://api.opendata-api.com/api/project/ebay/categories?key=<API_KEY>'
查询结果
使用场景
- 把 cell phones 之类的类目名称一次性解析为数字 ID,缓存后供定时搜索任务反复使用
- 根据 categories[] 与 groups[] 为内部搜索或比价提醒界面生成类目下拉框
- 分别在各个站点域名下,把内部商品分类体系映射到 eBay 类目 ID
- 以 groups[] 返回的一级大类为起点,搭建逐个大类扫描的采集任务
- 定期复核已保存的类目名称是否仍解析为同一个 category_id,再启动监控任务
常见问题
如何根据类目名称查到类目 ID?
发送 POST 请求,将 query 设为类目名称(例如 cell phones),并指定目标 domain,然后读取 data.categories[].category_id。实测中 Cell Phones & Accessories 对应的 category_id 为 15032,这类数值正是搜索接口 category 参数可以接受的值。
必须传 query 吗?
不必。domain、max_results 和 query 都是可选参数。query 为空时返回完整的一级类目树,data.groups[] 会列出一级大类名称(com 站点实测为 18 个)。
query 筛选是如何匹配的?
对类目名称或 slug 做不区分大小写的子串匹配,所以简短、通俗的词效果最好。实测 query 为 cell phones 时只匹配到一个类目,meta.record_count 为 1。
可以查询哪些站点?
domain 下拉框列出 13 个已验证站点:com、co.uk、de、com.au、ca、fr、it、es、nl、at、ch、ie 和 pl。com.sg、com.hk 等其他 eBay 站点据称可以接受,但不在已验证列表中,正式依赖前请先自行测试。
一次调用最多能返回多少个类目?
max_results 取值 1 到 240,超出会被截断为 240。实测请求 5 条,实际只返回了匹配 query 的那一个类目。
需要缓存结果吗?
建议缓存。类目 ID 很少变动,实测每次调用耗时约 1.5 秒。按站点解析一次名称,保存 category_id,再按计划定期刷新即可。