이베이 Browse

이 페이지는 아직 번역되지 않아 영어로 표시됩니다. 코드 예제는 모든 언어에서 동일합니다.

GET|POST /v1/ebay/browse

Price $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.