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_aspectsRetrieve the aspects for all of the leaf categories that belong to an eBay marketplace.View fetchItemAspects - /category_tree/{category_tree_id}/fetch_item_aspects
getDefaultCategoryTreeIdGET/get_default_category_tree_idRetrieve the default category tree reference for a specific eBay marketplace.View getDefaultCategoryTreeId - /get_default_category_tree_id
getCategoryTreeGET/category_tree/{category_tree_id}Retrieve the complete category tree corresponding to a specified category tree ID.View getCategoryTree - /category_tree/{category_tree_id}
getCategorySubtreeGET/category_tree/{category_tree_id}/get_category_subtreeRetrieve all nodes of the category tree hierarchy (the subtree) below a specified category in a specified category tree.View getCategorySubtree - /category_tree/{category_tree_id}/get_category_subtree
getCategorySuggestionsGET/category_tree/{category_tree_id}/get_category_suggestionsReturn an array of suggested categories that eBay has determined correspond to keywords that describe an item.View getCategorySuggestions - /category_tree/{category_tree_id}/get_category_suggestions
getItemAspectsForCategoryGET/category_tree/{category_tree_id}/get_item_aspects_for_categoryRetrieve an array of aspects that are appropriate for describing items in a specified category.View getItemAspectsForCategory - /category_tree/{category_tree_id}/get_item_aspects_for_category
getCompatibilityPropertiesGET/category_tree/{category_tree_id}/get_compatibility_propertiesRetrieve an array of parts compatibility aspects that are used to describe compatible vehicles.View getCompatibilityProperties - /category_tree/{category_tree_id}/get_compatibility_properties
getCompatibilityPropertyValuesGET/category_tree/{category_tree_id}/get_compatibility_property_valuesRetrieve an array of parts compatibility aspect values that are used to describe compatible vehicles.View getCompatibilityPropertyValues - /category_tree/{category_tree_id}/get_compatibility_property_values