# Taxonomy API API

> Taxonomy API API on Apizie: 8 endpoints (Get a Category Tree, Get Aspects for All Leaf Categories in a Marketplace, Get a Category Subtree, Get Suggested Categories, …) returned as clean JSON through one API key. Send your own provider key in the x-upstream-key header. Call it over REST at https://apizie.tech/v1/ecommerce:ebay-commerce-taxonomy/{endpoint} or from Claude, ChatGPT and Cursor through the Apizie MCP server. Free plan: 1,000 requests a month.

- Project key: `ecommerce:ebay-commerce-taxonomy`
- Category: E-commerce
- Status: byok
- Source: https://ebay.com
- Page: https://apizie.tech/api/ecommerce/ebay-commerce-taxonomy
- OpenAPI: https://apizie.tech/api/ecommerce/ebay-commerce-taxonomy/openapi.json

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…

## Endpoints

### Get a Category Tree
`GET https://apizie.tech/v1/ecommerce:ebay-commerce-taxonomy/get-category-tree` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| category_tree_id | string | yes | The unique identifier of the eBay category tree being requested. |

### Get Aspects for All Leaf Categories in a Marketplace
`GET https://apizie.tech/v1/ecommerce:ebay-commerce-taxonomy/fetch-item-aspects` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| category_tree_id | string | yes | The unique identifier of the eBay category tree being requested. |

### Get a Category Subtree
`GET https://apizie.tech/v1/ecommerce:ebay-commerce-taxonomy/get-category-subtree` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| category_id | string | yes | The unique identifier of the category at the top of the subtree being requested. Note: If the category_id submitted identifies the root… |
| category_tree_id | string | yes | The unique identifier of the eBay category tree from which a category subtree is being requested. |

### Get Suggested Categories
`GET https://apizie.tech/v1/ecommerce:ebay-commerce-taxonomy/get-category-suggestions` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| category_tree_id | string | yes | The unique identifier of the eBay category tree for which suggested nodes are being requested. |
| q | string | yes | A quoted string that describes or characterizes the item being offered for sale. The string format is free form, and can contain any… |

### Get Compatibility Properties
`GET https://apizie.tech/v1/ecommerce:ebay-commerce-taxonomy/get-compatibility-properties` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| category_tree_id | string | yes | This is the unique identifier of category tree. The following is the list of category_tree_id values and the eBay marketplaces that they… |
| category_id | string | yes | The unique identifier of an eBay category. This eBay category must be a valid eBay category on the specified eBay marketplace, and the… |

### Get Compatibility Property Values
`GET https://apizie.tech/v1/ecommerce:ebay-commerce-taxonomy/get-compatibility-property-values` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| category_tree_id | string | yes | This is the unique identifier of the category tree. The following is the list of category_tree_id values and the eBay marketplaces that… |
| compatibility_property | string | yes | One compatible vehicle property applicable to the specified eBay marketplace and eBay category is specified in this required filter.… |
| category_id | string | yes | The unique identifier of an eBay category. This eBay category must be a valid eBay category on the specified eBay marketplace, and the… |
| filter | string | no | One or more compatible vehicle property name/value pairs are passed in through this query parameter. The compatible vehicle property name… |

### Note: The General Availability (GA) version of the Taxonomy API has been released. Developers currently…
`GET https://apizie.tech/v1/ecommerce:ebay-commerce-taxonomy/get-item-aspects-for-category` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| category_id | string | yes | The unique identifier of the leaf category for which aspects are being requested. Note: If the category_id submitted does not identify a… |
| category_tree_id | string | yes | The unique identifier of the eBay category tree from which the specified category's aspects are being requested. |

### Get a Default Category Tree ID
`GET https://apizie.tech/v1/ecommerce:ebay-commerce-taxonomy/get-default-category-tree-id` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| Accept-Language | string | no | A header used to indicate the natural language the seller prefers for the response. This specifies the language that the seller wants to… |
| marketplace_id | string | yes | The ID of the eBay marketplace for which the category tree ID is being requested. For a list of supported marketplace IDs, see… |

## Example
```
curl "https://apizie.tech/v1/ecommerce:ebay-commerce-taxonomy/get-category-tree" \
  -H "x-api-key: $APIZIE_KEY" \
  -H "x-upstream-key: $PROVIDER_KEY"
```

## FAQ

### How do I call the Taxonomy API API?
Create a free Apizie key, then send GET https://apizie.tech/v1/ecommerce:ebay-commerce-taxonomy/get-category-tree with the header x-api-key. Every endpoint returns { project, data, timestamp }.

### Is the Taxonomy API API free on Apizie?
Yes. The Free plan includes 1,000 requests a month at 100 requests a minute, no credit card. Taxonomy API itself also needs your own key from ebay.com.

### Can AI agents use the Taxonomy API API?
Yes. Add the Apizie MCP server (https://apizie.tech/mcp) to Claude, ChatGPT, Cursor or VS Code, then ask in plain language. The agent calls run_scraper with project key ecommerce:ebay-commerce-taxonomy.

### What is the status of the Taxonomy API API?
Needs your own provider key (bring your own key)