Taxonomy API
Use the Taxonomy API to discover the most appropriate eBay categories under which sellers can offer inventory items for sale, and the most likely categories…
Fork copies the collection into your workspace, without the publisher's secrets, so you can add your own key and send requests. Star saves it to your starred APIs (Account › Marketplace) and helps others find it.
Overview
Use the Taxonomy API to discover the most appropriate eBay categories under which sellers can offer inventory items for sale, and the most likely categories under which buyers can browse or search for items to purchase. In addition, the Taxonomy API provides metadata about the required and recommended category aspects to include in listings, and also has two operations to retrieve parts compatibility information.
Endpoints 8
category_tree
- GETGet a Category Tree
/category_tree/:category_tree_idNote: The General Availability (GA) version of the Taxonomy API has been released. Developers currently using the Beta version should make plans to migrate to… - GETGet Aspects for All Leaf Categories in a Marketplace
/category_tree/:category_tree_id/fetch_item_aspectsNote: The General Availability (GA) version of the Taxonomy API has been released. Developers currently using the Beta version should make plans to migrate to… - GETGet a Category Subtree
/category_tree/:category_tree_id/get_category_subtree?category_id=stringNote: The General Availability (GA) version of the Taxonomy API has been released. Developers currently using the Beta version should make plans to migrate to… - GETGet Suggested Categories
/category_tree/:category_tree_id/get_category_suggestions?q=stringNote: The General Availability (GA) version of the Taxonomy API has been released. Developers currently using the Beta version should make plans to migrate to… - GETGet Compatibility Properties
/category_tree/:category_tree_id/get_compatibility_properties?category_id=stringNote: The General Availability (GA) version of the Taxonomy API has been released. Developers currently using the Beta version should make plans to migrate to… - GETGet Compatibility Property Values
/category_tree/:category_tree_id/get_compatibility_property_values?compatibility_property=string&category_id=string&filter=stringNote: The General Availability (GA) version of the Taxonomy API has been released. Developers currently using the Beta version should make plans to migrate to… - GETgetItemAspectsForCategory
/category_tree/:category_tree_id/get_item_aspects_for_category?category_id=stringNote: The General Availability (GA) version of the Taxonomy API has been released. Developers currently using the Beta version should make plans to migrate to… - GETGet a Default Category Tree ID
/get_default_category_tree_id?marketplace_id=stringNote: The General Availability (GA) version of the Taxonomy API has been released. Developers currently using the Beta version should make plans to migrate to…
API details
- Base URL
https://api.ebay.com/commerce/taxonomy/v1- Authentication
- OAuth 2.0 (client credentials flow) with 2 scopes
- Operations
- 8 operations on 8 pathsGET 8
- Main resources
- category_tree 8
- Description format
- Swagger 2.0, API version
v1.0.0 - Links
- OpenAPI document
- Listed from
- APIs.guru OpenAPI Directory (CC0-1.0)
Source updated
How to test the Taxonomy API in Swastik Codes
- Open the APISelect “Fork & run in Swastik Codes” on this page. Sign in or create a free account if asked.
- Fork it into your workspaceChoose a workspace. You get your own copy of the Taxonomy API collection, without the publisher's secrets.
- Add your credentialsThis API uses OAuth 2.0 (client credentials flow) with 2 scopes. Add yours in the collection's variables or an environment; the requests already reference it.
- Send a requestPick an endpoint, for example “Get a Category Tree” (GET /category_tree/:category_tree_id), and press Send. Check the response, add tests and run the whole collection with the runner.
Frequently asked questions
What is the Taxonomy API?
Use the Taxonomy API to discover the most appropriate eBay categories under which sellers can offer inventory items for sale, and the most likely categories… It is listed under E-commerce and has 8 endpoints.
Who publishes the Taxonomy API?
It is listed from eBay's public API description (an OpenAPI document), not published by eBay on Swastik Codes. Anyone who controls ebay.com can claim the profile by adding a DNS TXT record.
What is the base URL of the Taxonomy API?
Requests go to https://api.ebay.com/commerce/taxonomy/v1. Endpoint paths are added to this base URL.
How do I authenticate with the Taxonomy API?
With OAuth 2.0 (client credentials flow) with 2 scopes.
How many endpoints does the Taxonomy API have?
8 operations on 8 paths (8 GET). The largest groups are category_tree.
Is forking the Taxonomy API free?
Yes. Forking copies the collection into your workspace for free. It has been starred 0 times and forked 0 times.