# eBay API

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

Page: https://docs.toolzerhub.com/reference/ebay

## Category

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

- [Get a category tree](https://docs.toolzerhub.com/reference/ebay/category/get-e-bay-category-tree.md): `GET /v1/ebay/category/tree`. Returns 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.
- [List category items](https://docs.toolzerhub.com/reference/ebay/category/get-e-bay-category-products.md): `GET /v1/ebay/category/products`. Returns 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.

## Deals

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

- [List deals](https://docs.toolzerhub.com/reference/ebay/deals/get-e-bay-deals.md): `GET /v1/ebay/deals`. Returns 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.

## Item

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

- [Get item details](https://docs.toolzerhub.com/reference/ebay/item/get-e-bay-item-detail.md): `GET /v1/ebay/item/detail`. Returns 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.

## Search

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

- [Search suggestions](https://docs.toolzerhub.com/reference/ebay/search/get-e-bay-search-autocomplete.md): `GET /v1/ebay/search/autocomplete`. Returns eBay's autosuggest completions for a partial keyword.

## Shop

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

- [Get a seller storefront](https://docs.toolzerhub.com/reference/ebay/shop/get-e-bay-storefront.md): `GET /v1/ebay/shop/storefront`. Returns 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.