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.
category_tree
| Method Name | HTTP Method | Path | Summary | Samples |
|---|---|---|---|---|
| fetchItemAspects | GET | /category_tree/{category_tree_id}/fetch_item_aspects | Retrieves the item specifics for all leaf categories of an eBay marketplace. | View fetchItemAspects - /category_tree/{category_tree_id}/fetch_item_aspects |
| getDefaultCategoryTreeId | GET | /get_default_category_tree_id | Retrieves the category tree ID for a specific eBay marketplace. | View getDefaultCategoryTreeId - /get_default_category_tree_id |
| getCategoryTree | GET | /category_tree/{category_tree_id} | Retrieves the complete category hierarchy for a specific eBay marketplace. | View getCategoryTree - /category_tree/{category_tree_id} |
| getCategorySubtree | GET | /category_tree/{category_tree_id}/get_category_subtree | Retrieves a subset of a category hierarchy for a specific eBay marketplace. | View getCategorySubtree - /category_tree/{category_tree_id}/get_category_subtree |
| getCategorySuggestions | GET | /category_tree/{category_tree_id}/get_category_suggestions | Retrieves a subset of a category hierarchy for a specific eBay marketplace, starting with a specified category and returning all of that category's descendants. | View getCategorySuggestions - /category_tree/{category_tree_id}/get_category_suggestions |
| getItemAspectsForCategory | GET | /category_tree/{category_tree_id}/get_item_aspects_for_category | Retrieves all required, recommended, and optional item specifics and corresponding values for a specified leaf category. | View getItemAspectsForCategory - /category_tree/{category_tree_id}/get_item_aspects_for_category |
| getCompatibilityProperties | GET | /category_tree/{category_tree_id}/get_compatibility_properties | Retrieves an array of supported parts compatibility aspects for a specific eBay marketplace and category. | View getCompatibilityProperties - /category_tree/{category_tree_id}/get_compatibility_properties |
| getCompatibilityPropertyValues | GET | /category_tree/{category_tree_id}/get_compatibility_property_values | Retrieves an array of parts compatibility aspect values based on search criteria. | View getCompatibilityPropertyValues - /category_tree/{category_tree_id}/get_compatibility_property_values |
| getExpiredCategories | GET | /category_tree/{category_tree_id}/get_expired_categories | Retrieves the mappings of expired categories to their corresponding active categories. | View getExpiredCategories - /category_tree/{category_tree_id}/get_expired_categories |