Plugins

Scrape eBay search listings

Searches any regional eBay marketplace for keyword and returns the listings as JSON: title, price + currency, condition (with a normalised conditionCode), seller (username, feedback percentage and score), shippingCost, sold, watchers, bids, image and a clean item url. Filter with condition, listing_type, min_price/max_price, free_shipping, seller or category, sort with sort, and page with page/page_size (60, 120 or 240 per page). Set marketplace to search a specific site - prices, currency and availability differ between ebay.com, ebay.de, ebay.co.uk and the rest.

When eBay finds no exact match it still serves a full page of its own loosely-related suggestions. That case is reported honestly: exactMatches is false and a notice explains it, so those listings are never mistaken for real matches.

post/marketplace/ebay-search

Request

  • Base URL: https://api.scrapeunblocker.com
  • URL: https://api.scrapeunblocker.com/marketplace/ebay-search
  • Auth: API key in header x-scrapeunblocker-key

Query parameters

keywordstring required

Search phrase, e.g. 'iphone 13' or a part number like '1K0953519A'.

marketplacestring

Regional eBay site to search. Prices, currency and availability differ per marketplace. One of: ebay.com, ebay.co.uk, ebay.de, ebay.fr, ebay.it, ebay.es, ebay.nl, ebay.pl, ebay.at, ebay.ch, ebay.be, ebay.ie, ebay.ca, ebay.com.au, ebay.in, ebay.ph, ebay.com.sg, ebay.com.my, ebay.com.hk.

pageinteger

1-based page number.

page_sizeinteger

Listings per page - eBay's own page sizes: 60, 120, 240.

conditionstring nullable

Item condition filter: new, open_box, refurbished, used, for_parts. Omit for every condition.

sortstring

Ordering: best_match, newly_listed, ending_soon, price_asc, price_desc. Default 'best_match'.

listing_typestring

Listing format: all, buy_it_now, auction. Default 'all'.

min_pricenumber nullable

Lowest price to include, in the marketplace's currency.

max_pricenumber nullable

Highest price to include, in the marketplace's currency.

free_shippingboolean

Only listings eBay marks as free delivery.

sellerstring nullable

Restrict the search to one seller's username.

categorystring nullable

eBay category id to search inside, e.g. '131090' for vehicle parts and accessories.

proxy_countrystring nullable

Proxy country the request is sent from (ISO-2, e.g. 'US', 'DE'). Defaults to a country chosen for the marketplace.

Response

JSON with a results array of listings. A search that genuinely matches nothing returns 200 with an empty array, and eBay's relaxed suggestions are flagged with exactMatches: false.

unknown required

Changes

No recorded changes to this operation across all 1 revision of this API.