Browse
eBay browse — accepted parameters and what comes back.
本页尚未翻译，以英文显示。代码示例在各语言版本中完全相同。
GET|POST /v1/ebay/browsePrice $0.001 per call. List price; the rate steps down above 1,000 calls a day.
| Parameter | Type | Required | Notes |
|---|---|---|---|
categoryId | string | yes | The eBay category to list, e.g. 183448 — the bare number from a category URL, where the slug and the bn_ node are decorative. An unknown id is a 404, and a category eBay serves as a navigation hub rather than a product river is a 400 CATEGORY_NOT_BROWSABLE. |
brands | string list | Brand names as the marketplace spells them, e.g. brands=Nike,Adidas. | |
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 |
Listing a category with no keyword at all. Same filters as search, minus the words.
curl "https://gateway.apinoa.com/v1/ebay/browse?categoryId=183448&condition=used&priceMax=50&sort=price_asc" \
-H "x-api-key: YOUR_API_KEY"categoryId is the bare category number from an eBay category URL — in
ebay.com/b/LEGO-R-Bricks-Pieces-Parts/183448/bn_16564827 it is 183448. The slug and the bn_ node
are decorative and you can ignore both.
No query. Sending one is a 400 rather than a silent drop. Use search when you have words.
An unknown category is a 404, not an empty page — you are told the id is wrong instead of being left to guess whether the category is simply empty.
A response carries no query key, and otherwise looks exactly like a search response.
One caveat that is eBay's own behaviour: a price band matches a listing whose range overlaps it,
while the result reports the low end. So priceMin=10 can legitimately return a row showing $4.90 —
a "$4.90 to $899.90" variation listing.