Open documentation ↗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.
Taxonomy API is a shopping API from ebay.com. Requests are authenticated with OAuth. It is served over HTTPS. Its OpenAPI description documents 8 endpoints.
At a glance
- Authentication
- OAuth
- HTTPS
- Yes
- CORS
- Unknown
- Category
- Shopping
- Base URL
https://api.ebay.com/commerce/taxonomy/v1- Version
- v1.0.0
- Endpoints
- 8
- OpenAPI
- Specification ↗
- Spec updated
- 2020-11-23
Make a first request
Replace the placeholders; the documentation says exactly where credentials go.
curl -X GET "https://api.ebay.com/commerce/taxonomy/v1/get_default_category_tree_id" \
-H "Accept: application/json" \
-H "Authorization: Bearer YOUR_TOKEN"const response = await fetch("https://api.ebay.com/commerce/taxonomy/v1/get_default_category_tree_id", {
method: "GET",
headers: {
"Accept": "application/json",
"Authorization": "Bearer YOUR_TOKEN",
},
});
const data = await response.json();
console.log(data);import requests
response = requests.request(
"GET",
"https://api.ebay.com/commerce/taxonomy/v1/get_default_category_tree_id",
headers={
"Accept": "application/json",
"Authorization": "Bearer YOUR_TOKEN",
},
timeout=30,
)
print(response.json())Endpoints
| Method | Path | What it does |
|---|---|---|
| GET | /category_tree/{category_tree_id} | Get a Category Tree |
| GET | /category_tree/{category_tree_id}/fetch_item_aspects | Get Aspects for All Leaf Categories in a Marketplace |
| GET | /category_tree/{category_tree_id}/get_category_subtree | Get a Category Subtree |
| GET | /category_tree/{category_tree_id}/get_category_suggestions | Get Suggested Categories |
| GET | /category_tree/{category_tree_id}/get_compatibility_properties | Get Compatibility Properties |
| GET | /category_tree/{category_tree_id}/get_compatibility_property_values | Get Compatibility Property Values |
| GET | /category_tree/{category_tree_id}/get_item_aspects_for_category | Note: The General Availability (GA) version of the Taxonomy API has been released. Developers currently using the Beta version should make plans to migrate to t |
| GET | /get_default_category_tree_id | Get a Default Category Tree ID |
Questions
Does the Taxonomy API API need an API key?
Yes. The Taxonomy API API uses OAuth authentication; the documentation explains how to get credentials.
Does the Taxonomy API API support HTTPS?
Yes, the Taxonomy API API is served over HTTPS.
How many endpoints does the Taxonomy API API have?
Its OpenAPI description lists 8 endpoints in version v1.0.0. All of them are shown on this page.
What are alternatives to the Taxonomy API API?
Other Shopping APIs include Etsy, eBay, Flipkart Marketplace, Inventory Management, Intel Product Catalogue Service.
Similar shopping APIs
Compare alternatives →Etsy
ShoppingManage shop and interact with listings
eBay
ShoppingSell and Buy on eBay
Flipkart Marketplace
ShoppingProduct listing management, Order Fulfilment in the Flipkart Marketplace
Inventory Management
ShoppingMaintaining up-to-date inventory for your items on Walmart.com ensures a great experience for your customers and greater sales opportunities for you.
Intel Product Catalogue Service
ShoppingThis is the documentation for PIM Micro services. In order to use this tool you need to have Basic Auth credentials and a client id. If you dont have one, please make sure to request one by sending an email to the PIM MS team: [[email protected]](mailto:[email protected]?subject=PIMServices)
Item API
ShoppingPlease make sure you use the correct version of the APIs for your use case. To find out the appropriate version, go to the API Docs drop down on the menu.
Listed from APIs.guru (CC0).