Search
eBay search — accepted parameters and what comes back.
GET|POST /v1/ebay/searchPrice $0.001 per call. List price; the rate steps down above 1,000 calls a day.
| Parameter | Type | Required | Notes |
|---|---|---|---|
query | string | yes | Keywords to search for. Required here: eBay's keyword search cannot be asked anything without words — to list a category with no keyword, use browse. |
brands | string list | Brand names as the marketplace spells them, e.g. brands=Nike,Adidas. | |
categoryId | string | Narrow to one category, by the marketplace's own id. Opaque and per-marketplace; take it from Product.category[].id or from a result's facets. | |
condition | enum | Item condition. new used refurbished | |
facets | string | object list | Narrowings taken from a result's facets, e.g. facets=Color:Black. The escape hatch for filters the typed vocabulary has no word for; prefer a typed parameter where one exists. | |
freeShipping | boolean | enum | Only listings the marketplace itself advertises as shipping free. | |
page | integer | 1-based page number. eBay pages by number, so there is no cursor; each page is charged separately. | |
pageSize | integer | Results per page: 60, 120 or 240 only, the three page sizes eBay offers. Larger pages take longer to return (about 5 s for 240 items), but a page of any size costs one call. | |
priceMax | number ≥ 0 | Highest price to return, in decimal major units. | |
priceMin | number ≥ 0 | Lowest price to return, in decimal major units. | |
region | string | Buyer country as ISO 3166-1 alpha-2; sets availability, shipping and price. | |
sort | enum | Result ordering. price_asc/price_desc are eBay's price-plus-shipping sorts rather than its bare-price ones, and ending_soonest orders by auction close. best_match ending_soonest newly_listed price_asc price_desc |
curl "https://gateway.apinoa.com/v1/ebay/search?query=running+shoes&brands=Nike&condition=new&freeShipping=true&sort=price_asc" \
-H "x-api-key: YOUR_API_KEY"pageSize snaps to three buckets server-side (25/50/60 → 60, 100/120 → 120, 200/240 → 240), so only
those three are accepted; anything else would be taken and ignored.
Larger pages take longer (about 5 s for 240) but cost one call.
No cursor — paging is by number. No ratingMin — eBay's results carry no rating refinement.
No inStock — a listing that cannot be bought is not listed.
No currency. Currency follows region. Accepting a currency we cannot honour would be worse
than refusing it.