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

Keyword search across 13 sites Send a query and an optional domain (com, co.uk, de, com.au, ca, fr, it, es, nl, at, ch, ie, pl) to get active listings priced in that marketplace's currency.
Price range in local currency price_min and price_max bound the result by price in the marketplace currency, so a query can be limited to listings under a target figure.
Condition and listing-format filters Restrict to new, open_box, refurbished, used or for_parts items, and to fixed-price (buy_it_now), auction or best_offer listings, to keep each scan to one segment.
Shipping, returns and offer filters free_shipping and returns_accepted narrow results to listings with free delivery or an accepted-returns policy, which helps compare landed offers.
Item location and local pickup location follows the site's own item-location filter, and pickup_postcode with pickup_distance finds UK listings available for collection in person (domain co.uk).
Sort orders including newly listed sort supports best_match, newly_listed, ending_soonest, price_low and price_high, so the same query can drive a fresh-listings feed or a cheapest-first scan.
Deep paging up to 240 per page max_results returns up to 240 cards per page and page walks deeper; the notes measured full distinct pages up to page 450. Stop when meta.pagination.has_more is false.
Cards that link to follow-up lookups Every card has item_id, url, price, buying_format, shipping text and image, so the IDs can be passed straight to item-detail or items-batch for full listing records.

Live API Demo

POST /api/project/ebay/search

Request cost is temporarily unavailable. No price is assumed.

View pricing

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>"}'
📢
Need Help?
If you encounter API issues or need other API requirements, please contact us.
Contact Us

Use Cases

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.

Related operations

Guides

View Subscription Plans →