Ebay Commerce Taxonomy
eBay Commerce Taxonomy is an eBay API for retrieving marketplace category trees and item classification metadata.
- Base URL:
https://api.ebay.com/commerce/taxonomy/v1 - Auth: OAuth 2.0 client-credentials — the tool fetches a token from
https://api.ebay.com/identity/v1/oauth2/tokenusing yourclientId/clientSecret, then calls the API.
Operations
getcategorytree— GET /category_tree/{category_tree_id} — Get a Category Treefetchitemaspects— GET /category_tree/{category_tree_id}/fetch_item_aspects — Get Aspects for All Leaf Categories in a Marketplacegetcategorysubtree— GET /category_tree/{category_tree_id}/get_category_subtree — Get a Category Subtreegetcategorysuggestions— GET /category_tree/{category_tree_id}/get_category_suggestions — Get Suggested Categoriesgetcompatibilityproperties— GET /category_tree/{category_tree_id}/get_compatibility_properties — Get Compatibility Propertiesgetcompatibilitypropertyvalues— GET /category_tree/{category_tree_id}/get_compatibility_property_values — Get Compatibility Property Values
Inputs
clientId/clientSecret— your ebay-commerce-taxonomy OAuth app credentialsscope— OAuth scopes (optional; defaults from the spec)operation— one of the operations above- path parameters when an operation's path contains
{...} query— optional JSON object of query paramsbody— JSON object for create/update ops
Example
operation: getcategorytree
clientId: <your client id>
clientSecret: <your client secret>
Publishes
The keys a later task may reference as {{taskName.key}}. Referencing anything not listed here resolves to nothing at run time.
erroroperationresultstatus
Input Properties
Every property this tool accepts, from its own tool.iml.
| Property | Type | Required | Default | Description |
|---|---|---|---|---|
clientId |
string | yes | — | OAuth client ID for ebay-commerce-taxonomy. |
clientSecret |
string | yes | — | OAuth client secret for ebay-commerce-taxonomy. |
operation |
string | yes | — | One of: getcategorytree, fetchitemaspects, getcategorysubtree, getcategorysuggestions, getcompatibilityproperties, getcompatibilitypropertyvalues |
scope |
string | no | https://api.ebay.com/oauth/api_scope https://api.ebay.com/oauth/api_scope/metadata.insights |
OAuth scopes (space-separated); default from the spec. |
category_tree_id |
string | no | — | Path parameter category_tree_id (required by some operations). |
query |
string | no | — | Optional query params as a JSON object string, e.g. {"limit": 10}. |