---
title: "Scrape eBay search listings"
method: POST
path: "/marketplace/ebay-search"
tags: ["Plugins"]
---

# Scrape eBay search listings

`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`

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.

## Query parameters

- `keyword` string, required: Search phrase, e.g. 'iphone 13' or a part number like '1K0953519A'.
- `marketplace` string: 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.
- `page` integer: 1-based page number.
- `page_size` integer: Listings per page - eBay's own page sizes: 60, 120, 240.
- `condition` string, nullable: Item condition filter: new, open_box, refurbished, used, for_parts. Omit for every condition.
- `sort` string: Ordering: best_match, newly_listed, ending_soon, price_asc, price_desc. Default 'best_match'.
- `listing_type` string: Listing format: all, buy_it_now, auction. Default 'all'.
- `min_price` number, nullable: Lowest price to include, in the marketplace's currency.
- `max_price` number, nullable: Highest price to include, in the marketplace's currency.
- `free_shipping` boolean: Only listings eBay marks as free delivery.
- `seller` string, nullable: Restrict the search to one seller's username.
- `category` string, nullable: eBay category id to search inside, e.g. '131090' for vehicle parts and accessories.
- `proxy_country` string, nullable: Proxy country the request is sent from (ISO-2, e.g. 'US', 'DE'). Defaults to a country chosen for the marketplace.

## Response `200`

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

## Other responses

- `400`: Invalid search parameters.
- `422`: Validation Error
- `502`: Blocked by eBay, no results page returned, or the call did not finish in time.

---

[API](https://skmtc.dev/scrapeunblocker/apis/scrapeunblocker-api.md) · [All operations](https://skmtc.dev/scrapeunblocker/apis/scrapeunblocker-api/llms.txt) · [OpenAPI document](https://skmtc.dev/scrapeunblocker/apis/scrapeunblocker-api/revisions/c02f1254cc47?raw)