Search active eBay listings by keyword with condition, price, format, shipping, location and pickup filters, returning paged listing cards.
View all eBay Product Listings & Seller Data endpoints →Searches active eBay listings by keyword and returns paged listing cards as JSON. query is the only required input. Optional filters are domain (13 verified sites), category (a numeric eBay category ID, which the categories operation can look up by name), condition (new, open_box, refurbished, used, for_parts), price_min and price_max in the marketplace currency, the boolean flags buy_it_now, auction, best_offer, free_shipping and returns_accepted, and location (domestic, us, uk, worldwide, north_america, european_union), whose choices follow the site's own item-location filter and therefore depend on domain. pickup_postcode with pickup_distance (miles, default 25) restricts results to UK collection in person and needs domain co.uk. sort accepts best_match, newly_listed, ending_soonest, price_low and price_high, and the option list also contains price_asc and price_desc. page and max_results control paging; max_results runs from 1 to 240 per page and larger values are capped at 240. The response is an ok/meta/data envelope: data.query echoes the search text and data.results[] holds item_id, title, price{value,currency,raw}, condition, buying_format, shipping, location, image and url, with sold_count, catalog_rating and best_offer present on some cards, while meta.pagination reports page and has_more. Observed in a live probe (query iphone 13 pro, domain com, max_results 5): HTTP 200, ok true, 5 cards, meta.record_count 5 and meta.pagination {page 1, has_more true}. Probe cards also carried buying_format_code (buy_it_now), in_stock, aspects[], sold_count text such as "42+ sold", catalog_rating{average,review_count} and a compact seller{username,positive_pct,feedback_count,top_rated_plus} object, with top_rated_plus missing on one card, although the operation notes say full seller data is available only on the item page. shipping is display text such as "Free delivery in 1-2 days" or "+$7.72 delivery", not a number. Filters other than domain and max_results were not exercised by the probe; the page depth of about 450 pages and the 240-per-page ceiling come from measurements in the operation notes (2026-08-07, query iphone 13 pro).
API Features
Live API Demo
🔒 Sign in to try it live
Log in to call this API with your own API key. New accounts get 100 free credits — no card required.
Log in / Sign upNo active API key found. Create one in your Dashboard, then reload this page. Dashboard →
/api/project/ebay/search API Response (JSON)
{} curl -X POST 'https://api.opendata-api.com/api/project/ebay/search?key=<API_KEY>' \
-H 'Content-Type: application/json' \
-d '{"query":"<query>"}' Query Result
Use Cases
- Run an arbitrage scanner with query, condition new, price_max and sort price_low, and alert when a card appears under a target price
- Poll a niche such as vintage cameras or trading cards with sort newly_listed and deduplicate by item_id to build a new-listings feed
- Compare the same query on com, co.uk and de with free_shipping and returns_accepted set to see which marketplace offers the best landed price
- Build a local pickup finder for bulky goods with pickup_postcode and pickup_distance on the co.uk domain
- Resolve a category ID with the categories operation, then page through that category at 240 results per page for market research
- Refresh the price and availability cards of roughly six known item IDs per call by sending them as an (id1,id2,...) query instead of fetching full records
- Track how many Buy It Now versus auction listings exist for a product by calling search twice with buy_it_now and auction set
Frequently asked questions
How do I page through all results for a query?
Increase page (1, 2, 3...) and keep max_results constant until meta.pagination.has_more is false. The probe returned page 1 with has_more true for 5 cards. The operation notes measured distinct full pages up to page 450 for the query iphone 13 pro and an empty page 470, so page until has_more ends rather than probing for the last page.
What is the largest page size?
240. max_results accepts 1 to 240, values above that are capped at 240, and the notes measured 60, 120, 200 and 240 being served exactly while 300 or 500 did not return more. Use page to go beyond 240 results.
How do I filter by eBay category?
Pass the numeric category ID in category, for example 9355 for Cell Phones & Smartphones as given in the parameter note. If you only know the name, call the categories operation first to look up the ID, then reuse it here. An empty category searches all categories.
Can I look up several known item IDs with one search call?
The operation notes describe a query of the form (id1,id2,id3), eBay's own OR syntax, that resolves about 6 IDs per call with a seventh dropped, returning card-level fields only. That is a cheaper route than full records; use items-batch when you need item specifics, seller details or return policy. This behavior comes from the notes, not from the probe.
Why does the location filter depend on the domain?
The location choices mirror each site's own Item location filter. domestic keeps items in the site's home country (US only on com, UK only on co.uk), uk is the same as domestic and needs domain co.uk, and the regional choice is North America on com and European Union on co.uk.
How does the local pickup filter work?
Set pickup_postcode to a UK postcode with domain co.uk to keep only listings available for collection in person nearby, and optionally set pickup_distance in miles. eBay offers 10, 25, 50, 100, 200 and 500 (default 25); other values act as the next option up, and a value of 7 returned exactly the 10-mile results according to the notes. pickup_distance is only used together with pickup_postcode.
What do shipping and condition look like on a result card?
shipping is display text, not a number: the probe returned values such as "Free delivery in 1-2 days" and "+$7.72 delivery". condition returned labels such as "Excellent - Refurbished" and "Pre-Owned" in the probe, but the documented example response shows some cards where condition holds seller subtitle text, so use the condition filter parameter for segmentation rather than exact string matching on cards.
Do search results include seller information?
The probe cards carried a compact seller object with username, positive_pct, feedback_count and sometimes top_rated_plus, but the operation notes state that full seller data is item-page-only, so do not rely on every card having every seller field. Use item-detail, items-batch or the seller profile operation when you need complete seller reputation.
Which sort values can I use?
The notes describe best_match, newly_listed, ending_soonest, price_low and price_high. The option list also contains price_asc and price_desc, whose behavior is not described in the notes and was not exercised by the probe.