eBay
eBay search, category browse, visual search and product through the normalized schema — accepted parameters, condition filters, and which fields actually arrive.
Five operations, US marketplace, USD.
| endpoint | price | |
|---|---|---|
| search | GET|POST /v1/ebay/search | $0.001 |
| browse | GET|POST /v1/ebay/browse | $0.001 |
| categories | GET|POST /v1/ebay/categories | $0.001, +$0.001 below level 3 |
| image-search | POST /v1/ebay/image-search | $0.002 |
| product | GET|POST /v1/ebay/product | $0.001 |
No reviews: eBay's feedback belongs to the seller, not the listing. Serving it under reviews
would answer "how good is this merchant" to a caller asking "how good is this product".
eBay accepts the widest filter set of any marketplace here, because its narrowing parameters take values you already know rather than ids scoped to a query.
What actually arrives
search items
| Field | Fill |
|---|---|
title url | 100% |
price imageUrl delivery | ~95% |
delivery.estimate badges | ~90% |
condition | ~85% |
product
| Field | Fill |
|---|---|
title | 100% |
price seller.name delivery | ~95% |
attributes delivery.estimate returnsPolicy badges | ~90% |
condition media.images | ~65% |
brand | ~50% |
brand is the one to plan around: eBay listings are seller-written, and half of them never state a
brand field even when the title names one. If you need brand coverage, Walmart and Shopify are far
denser.
condition is the opposite — eBay is the only marketplace here that reliably says what condition a
listing is in, because most of its inventory is not new.
Filters, and the one thing eBay does not do
facets=Type:Complete Set narrows by any eBay aspect, and costs nothing extra.
What eBay does not return is a facet rail listing what is available: eBay responses carry no
facets rail, but facets=Name:Value still applies.
Take aspect names and values from eBay's own search UI, or from the attributes on items a previous
search returned.
Things specific to eBay
Shipping cost is a number, not prose. delivery.cost carries the figure where eBay states one, so a
$48 item with $19.95 shipping can be compared against a $55 item that ships free.
Auctions and fixed-price listings are both here. sort=ending_soonest orders by auction close.
An auction's price can change quickly, so pass fresh=1 if you are tracking one
near close.
Categories may arrive as an id with no name. eBay often states the leaf category as a number
only. The schema allows a category step with an id, a name, or both, rather than
inventing a name that would be a lie.