API ReferenceeBayOverview

eBay API

Retrieve public eBay item details, category listings and trees, current deals, seller storefronts, and keyword suggestions.

6 endpoints

Get an API key Explore endpoints

Endpoints

Each endpoint links to its request parameters, response schema, and code examples.

Category

2 endpoints

Get a category treeReturns eBay's full category list (~1,300 categories) in one request, each with the (slug, category_id, bn_id) triple /ebay/category/products needs plus a display name where resolvable./v1/ebay/category/tree1 crGET
List category itemsReturns item ids for one page of an eBay category browse listing. Category is identified by the (slug, category_id, bn_id) triple published by /ebay/category/tree, not a single opaque id. Returns null for an invalid slug/category_id/bn_id combination./v1/ebay/category/products1 crGET

Deals

1 endpoint

List dealsReturns eBay's current deals listing. Most items carry full structured fields (title/price/currency/image); a field that is not published is omitted rather than guessed./v1/ebay/deals1 crGET

Item

1 endpoint

Get item detailsReturns item detail: title, price, condition, images, brand/mpn/gtin/model, breadcrumbs, and seller store name when present. Returns null for a removed or nonexistent item_id./v1/ebay/item/detail1 crGET

Search

1 endpoint

Search suggestionsReturns eBay's autosuggest completions for a partial keyword./v1/ebay/search/autocomplete1 crGET

Shop

1 endpoint

Get a seller storefrontReturns a seller's storefront item listing, with title (and price/image where available). store_name is the value returned as seller.store_name by the item detail endpoint. Returns null for an invalid or closed store name./v1/ebay/shop/storefront1 crGET

What you can build

Research listings within a product category.
Compare item details and available deals.

Make your first request

Replace the placeholders with your input values. The endpoint reference explains each input and the returned fields.

curl -X GET "https://api.toolzerhub.com/v1/ebay/search/autocomplete?keyword=<keyword>" -H "x-api-key: $TOOLZERHUB_API_KEY"

Open endpoint reference Read authentication

Need a key? Create an account, then review credits and responses and errors.

List video danmaku GET

Previous Page

Get a category tree GET

Next Page