Skip to content

Taxonomy API API

by ebay.com

OAuthHTTPSShopping
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
Spec updated
2020-11-23

Make a first request

Replace the placeholders; the documentation says exactly where credentials go.

cURL
curl -X GET "https://api.ebay.com/commerce/taxonomy/v1/get_default_category_tree_id" \
  -H "Accept: application/json" \
  -H "Authorization: Bearer YOUR_TOKEN"
JavaScript
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);
Python
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

MethodPathWhat it does
GET/category_tree/{category_tree_id}Get a Category Tree
GET/category_tree/{category_tree_id}/fetch_item_aspectsGet Aspects for All Leaf Categories in a Marketplace
GET/category_tree/{category_tree_id}/get_category_subtreeGet a Category Subtree
GET/category_tree/{category_tree_id}/get_category_suggestionsGet Suggested Categories
GET/category_tree/{category_tree_id}/get_compatibility_propertiesGet Compatibility Properties
GET/category_tree/{category_tree_id}/get_compatibility_property_valuesGet Compatibility Property Values
GET/category_tree/{category_tree_id}/get_item_aspects_for_categoryNote: 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_idGet 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.

Compare alternatives →

Listed from APIs.guru (CC0).