Taxonomy API
ebay · Commerce
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.
Authentication
Sample Requests
Note: The General Availability (GA) version of the Taxonomy API has been released. Developers currently using the Beta version should make plans to migrate to the new GA version, as the Beta version will be decommissioned on March 31, 2021. Until that date, the Beta version documentation set can be
Hover any highlighted part to learn what it does
curl -X GET "https://api.apis.guru/v2/specs/ebay.com/commerce-taxonomy/v1.0.0/get_default_category_tree_id?marketplace_id=example"
import requests
params = {
"marketplace_id": "example"
}
response = requests.get(
"https://api.apis.guru/v2/specs/ebay.com/commerce-taxonomy/v1.0.0/get_default_category_tree_id",
params=params,
)
print(response.json())const url = new URL('https://api.apis.guru/v2/specs/ebay.com/commerce-taxonomy/v1.0.0/get_default_category_tree_id');
url.searchParams.set('marketplace_id', 'example');
const response = await fetch(url);
const data = await response.json();
console.log(data);package main
import (
"fmt"
"io"
"net/http"
"net/url"
)
func main() {
baseURL, _ := url.Parse("https://api.apis.guru/v2/specs/ebay.com/commerce-taxonomy/v1.0.0/get_default_category_tree_id")
q := baseURL.Query()
q.Set("marketplace_id", "example")
baseURL.RawQuery = q.Encode()
targetURL := baseURL.String()
req, _ := http.NewRequest("GET", targetURL, nil)
client := &http.Client{}
resp, _ := client.Do(req)
defer resp.Body.Close()
body, _ := io.ReadAll(resp.Body)
fmt.Println(string(body))
}require "net/http"
require "json"
uri = URI("https://api.apis.guru/v2/specs/ebay.com/commerce-taxonomy/v1.0.0/get_default_category_tree_id")
uri.query = URI.encode_www_form({
"marketplace_id" => "example"
})
http = Net::HTTP.new(uri.host, uri.port)
http.use_ssl = uri.scheme == "https"
req = Net::HTTP::Get.new(uri)
res = http.request(req)
puts JSON.parse(res.body)<?php
$url = "https://api.apis.guru/v2/specs/ebay.com/commerce-taxonomy/v1.0.0/get_default_category_tree_id?" . http_build_query([
"marketplace_id" => "example"
]);
$opts = ["http" => [
"method" => "GET",
]];
$ctx = stream_context_create($opts);
$res = file_get_contents($url, false, $ctx);
print_r(json_decode($res, true));Note: The General Availability (GA) version of the Taxonomy API has been released. Developers currently using the Beta version should make plans to migrate to the new GA version, as the Beta version will be decommissioned on March 31, 2021. Until that date, the Beta version documentation set can be
Hover any highlighted part to learn what it does
curl -X GET "https://api.apis.guru/v2/specs/ebay.com/commerce-taxonomy/v1.0.0/category_tree/{category_tree_id}/get_category_subtree?category_id=example"import requests
params = {
"category_id": "example"
}
response = requests.get(
"https://api.apis.guru/v2/specs/ebay.com/commerce-taxonomy/v1.0.0/category_tree/{category_tree_id}/get_category_subtree",
params=params,
)
print(response.json())const url = new URL('https://api.apis.guru/v2/specs/ebay.com/commerce-taxonomy/v1.0.0/category_tree/{category_tree_id}/get_category_subtree');
url.searchParams.set('category_id', 'example');
const response = await fetch(url);
const data = await response.json();
console.log(data);package main
import (
"fmt"
"io"
"net/http"
"net/url"
)
func main() {
baseURL, _ := url.Parse("https://api.apis.guru/v2/specs/ebay.com/commerce-taxonomy/v1.0.0/category_tree/{category_tree_id}/get_category_subtree")
q := baseURL.Query()
q.Set("category_id", "example")
baseURL.RawQuery = q.Encode()
targetURL := baseURL.String()
req, _ := http.NewRequest("GET", targetURL, nil)
client := &http.Client{}
resp, _ := client.Do(req)
defer resp.Body.Close()
body, _ := io.ReadAll(resp.Body)
fmt.Println(string(body))
}require "net/http"
require "json"
uri = URI("https://api.apis.guru/v2/specs/ebay.com/commerce-taxonomy/v1.0.0/category_tree/{category_tree_id}/get_category_subtree")
uri.query = URI.encode_www_form({
"category_id" => "example"
})
http = Net::HTTP.new(uri.host, uri.port)
http.use_ssl = uri.scheme == "https"
req = Net::HTTP::Get.new(uri)
res = http.request(req)
puts JSON.parse(res.body)<?php
$url = "https://api.apis.guru/v2/specs/ebay.com/commerce-taxonomy/v1.0.0/category_tree/{category_tree_id}/get_category_subtree?" . http_build_query([
"category_id" => "example"
]);
$opts = ["http" => [
"method" => "GET",
]];
$ctx = stream_context_create($opts);
$res = file_get_contents($url, false, $ctx);
print_r(json_decode($res, true));Note: The General Availability (GA) version of the Taxonomy API has been released. Developers currently using the Beta version should make plans to migrate to the new GA version, as the Beta version will be decommissioned on March 31, 2021. Until that date, the Beta version documentation set can be
Hover any highlighted part to learn what it does
curl -X GET "https://api.apis.guru/v2/specs/ebay.com/commerce-taxonomy/v1.0.0/category_tree/{category_tree_id}/get_category_suggestions?q=test"import requests
params = {
"q": "test"
}
response = requests.get(
"https://api.apis.guru/v2/specs/ebay.com/commerce-taxonomy/v1.0.0/category_tree/{category_tree_id}/get_category_suggestions",
params=params,
)
print(response.json())const url = new URL('https://api.apis.guru/v2/specs/ebay.com/commerce-taxonomy/v1.0.0/category_tree/{category_tree_id}/get_category_suggestions');
url.searchParams.set('q', 'test');
const response = await fetch(url);
const data = await response.json();
console.log(data);package main
import (
"fmt"
"io"
"net/http"
"net/url"
)
func main() {
baseURL, _ := url.Parse("https://api.apis.guru/v2/specs/ebay.com/commerce-taxonomy/v1.0.0/category_tree/{category_tree_id}/get_category_suggestions")
q := baseURL.Query()
q.Set("q", "test")
baseURL.RawQuery = q.Encode()
targetURL := baseURL.String()
req, _ := http.NewRequest("GET", targetURL, nil)
client := &http.Client{}
resp, _ := client.Do(req)
defer resp.Body.Close()
body, _ := io.ReadAll(resp.Body)
fmt.Println(string(body))
}require "net/http"
require "json"
uri = URI("https://api.apis.guru/v2/specs/ebay.com/commerce-taxonomy/v1.0.0/category_tree/{category_tree_id}/get_category_suggestions")
uri.query = URI.encode_www_form({
"q" => "test"
})
http = Net::HTTP.new(uri.host, uri.port)
http.use_ssl = uri.scheme == "https"
req = Net::HTTP::Get.new(uri)
res = http.request(req)
puts JSON.parse(res.body)<?php
$url = "https://api.apis.guru/v2/specs/ebay.com/commerce-taxonomy/v1.0.0/category_tree/{category_tree_id}/get_category_suggestions?" . http_build_query([
"q" => "test"
]);
$opts = ["http" => [
"method" => "GET",
]];
$ctx = stream_context_create($opts);
$res = file_get_contents($url, false, $ctx);
print_r(json_decode($res, true));Postman Setup Guide
- See official documentation for authentication and setup.
What can you build with Taxonomy API?
Taxonomy API is a Commerce API. Developers commonly use commerce APIs for:
- syncing product catalogues and inventory levels
- building price comparison and deal-finder tools
- processing orders and tracking shipments
- managing customer wishlists and reviews
- automating abandoned-cart and promotional emails
No authentication required. This API is open — no signup or key needed. Ideal for quick prototypes and public-facing features. Taxonomy API is free to use, making it a low-risk choice to experiment with.
New to APIs? Read our beginner's guide · Learn about API keys · What is REST?