eBay search API

Searches an eBay marketplace and delivers each listing with item id, title, price and struck-through list price, condition, variant/brand chips, buying format (Buy It Now / auction), shipping and returns lines, location, sponsored flag, image and clean item URL. Optional filters for condition and Buy-It-Now-only. TLS tier, no browser.

$0.001 per delivered listing, up to 250 listings per run. Nothing delivered means nothing charged.

Inputs

• query (string, required) — What to search on eBay, e.g. "running shoes".
• condition (string) — Restrict to new or used listings.
• buy_it_now_only (boolean) — Exclude auctions.
• country (string) — ISO 3166-1 alpha-2 code — picks the local site AND the proxy exit (default us).
• max_results (integer) — How many listings to deliver at most (1–250). You pay only for delivered listings.

What one listing looks like

• rank (integer) — 1-based position across pages.
• page (integer) — Search page the row came from.
• item_id (string) — eBay item id.
• title (string) — Listing title.
• price (string, nullable) — Price as shown.
• price_value (number, nullable) — Numeric price.
• list_price (string, nullable) — Struck-through price when discounted.
• condition (string, nullable) — Condition chip (Brand New, Pre-Owned…).
• attributes (string[]) — Variant/brand chips shown under the title.
• format (string, nullable) — Buying format (Buy It Now, bids…).
• shipping (string, nullable) — Shipping/delivery line.
• location (string, nullable) — Seller location line.
• returns (string, nullable) — Returns line when shown.
• sponsored (boolean) — True for paid placements.
• image (string, nullable) — Thumbnail URL.
• url (string, nullable) — Listing URL.

FAQ

What does the eBay search API return?

Searches an eBay marketplace and delivers each listing with item id, title, price and struck-through list price, condition, variant/brand chips, buying format (Buy It Now / auction), shipping and returns lines, location, sponsored flag, image and clean item URL. Optional filters for condition and Buy-It-Now-only. TLS tier, no browser. Each row carries 16 fields, listed in full on this page.

What do I send it?

A semantic input, not a URL list: query are required. One run returns up to 250 listings.

How much does the eBay search API cost?

$0.001 per delivered listing. A run that delivers nothing is not billed, and the