Sign in

v1

latestOpenAPI 3.1.02026-07-26180242448.0 KB
eBay Search

Search Listings

Search an eBay marketplace for active listings.

get/v1/ebay/search

Query parameters

querystring required

Search keywords.

domainstring

eBay marketplace domain TLD or alias (com, co.uk, de, fr, ...).

category_idstring

Restrict results to a category id.

pageinteger

Page number for paginated results.

per_pageinteger

Results per page. Clamped to 60, 120 or 240.

sort_by'best_match' | 'ending_soonest' | 'newly_listed' | 'price_low_to_high' | 'price_high_to_low'

Sort order for results.

condition'new' | 'open_box' | 'refurbished' | 'used' | 'for_parts'

Item condition filter.

buying_format'auction' | 'buy_it_now' | 'best_offer'

Buying format filter.

min_pricenumber

Minimum price filter in the marketplace's local currency.

max_pricenumber

Maximum price filter in the marketplace's local currency.

free_shippingboolean

Only return listings with free shipping.

Response

Active listings

querystring nullable
domainstring
category_idstring nullable
soldboolean
facetsobject
scraped_utcnumber nullable
scraped_atstring nullable

Example response

{
  "results": [
    {
      "sold_date": "2 Jul 2026",
      "sold_date_at": "2026-07-02"
    }
  ]
}