按名称查询 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 功能

类目名称转数字 ID 传入 cell phones 这样的 query,从 categories[] 读取 category_id;该 ID 可直接填入搜索接口的 category 参数,无需自己记忆 9355 之类的数字。
一级大类分组 data.groups[] 在返回匹配结果的同时给出一级大类名称;实测返回 18 个,包括 Electronics、Collectibles & Art、Home & Garden 和 Sporting Goods。
不区分大小写的名称与 slug 筛选 query 对类目名称或 slug 做子串匹配,与大小写无关;query 留空时返回完整的一级类目树,而不是筛选后的列表。
按站点区分的类目体系 domain 可选 13 个已验证的 eBay 站点,meta 会回传实际响应的站点,方便把保存的 ID 与其所属站点对应起来。
每个 ID 附带可读 slug 每个类目除 category_id 和 name 外还带有 URL 风格的 slug(实测为 Cell-Phones-Smart-Watches-Accessories),便于在自有数据表中标注或去重。
返回条数最高 240 max_results 可取 1 到 240,超过 240 会被截断为 240;query 为空时,一次调用即可取回类目树中较大的一段。

在线 API 演示

POST /api/project/ebay/categories

调用成本暂不可用,未假定任何价格。

查看价格

API 响应 (JSON)

{}
curl -X POST 'https://api.opendata-api.com/api/project/ebay/categories?key=<API_KEY>'
📢
需要帮助?
如遇接口异常,或需要其他接口需求,可联系我们
联系我们

使用场景

常见问题

如何根据类目名称查到类目 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,再按计划定期刷新即可。

相关接口

相关指南

查看订阅方案 →