Skip to main content

  • Important: Due to EU & UK Payments regulatory requirements, an additional security verification via Digital Signatures is required for certain API calls that are made by EU/UK sellers. Please refer to Digital Signatures for APIs to learn more on the impacted APIs and the process to create signature to be included in the HTTP payload.

  • OpenAPI Specification - Version 2.0 for all of our RESTful APIs will no longer be available starting April 5, 2023. We will continue leveraging OpenAPI Specification - Version 3.0 for new features in our RESTful APIs.

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.


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