Skip to main content

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 NameHTTP MethodPathSummarySamples
fetchItemAspectsGET/category_tree/{category_tree_id}/fetch_item_aspectsRetrieves the item specifics for all leaf categories of an eBay marketplace.View fetchItemAspects - /category_tree/{category_tree_id}/fetch_item_aspects
getDefaultCategoryTreeIdGET/get_default_category_tree_idRetrieves the category tree ID for a specific eBay marketplace.View getDefaultCategoryTreeId - /get_default_category_tree_id
getCategoryTreeGET/category_tree/{category_tree_id}Retrieves the complete category hierarchy for a specific eBay marketplace.View getCategoryTree - /category_tree/{category_tree_id}
getCategorySubtreeGET/category_tree/{category_tree_id}/get_category_subtreeRetrieves a subset of a category hierarchy for a specific eBay marketplace.View getCategorySubtree - /category_tree/{category_tree_id}/get_category_subtree
getCategorySuggestionsGET/category_tree/{category_tree_id}/get_category_suggestionsRetrieves 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
getItemAspectsForCategoryGET/category_tree/{category_tree_id}/get_item_aspects_for_categoryRetrieves 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
getCompatibilityPropertiesGET/category_tree/{category_tree_id}/get_compatibility_propertiesRetrieves an array of supported parts compatibility aspects for a specific eBay marketplace and category.View getCompatibilityProperties - /category_tree/{category_tree_id}/get_compatibility_properties
getCompatibilityPropertyValuesGET/category_tree/{category_tree_id}/get_compatibility_property_valuesRetrieves an array of parts compatibility aspect values based on search criteria.View getCompatibilityPropertyValues - /category_tree/{category_tree_id}/get_compatibility_property_values
getExpiredCategoriesGET/category_tree/{category_tree_id}/get_expired_categoriesRetrieves the mappings of expired categories to their corresponding active categories.View getExpiredCategories - /category_tree/{category_tree_id}/get_expired_categories