# eBay search: `POST /v1/retail/ebay/search`

Cost: 8 credits (8 per page (an empty page and failed requests are free)). Docs: https://scrapercompany.com/docs/reference/ebay-search

One page (up to 60) of eBay listings on the market's eBay site.

Each listing carries the price (or price range) in the site's currency,
the crossed-out price, auction bids and time left, best offer, delivery
cost, item location, units sold, watchers and the seller with their
feedback. Sold listings are not offered: eBay sends a signed-out visitor
to its sign-in page for them.

Request body (JSON):

- `q` (string; required; min length 1, max length 200): Search terms, as typed into eBay.
- `market` (string; optional; default US; pattern ^(US|GB|DE|AU|CA|FR|IT|ES)$): Which eBay site: US (ebay.com), GB, DE, AU, CA, FR, IT or ES. Prices are in that site's currency.
- `page` (integer; optional; default 1; min 1, max 100): Result page.
- `sort` (string; optional; default best_match; pattern ^(best_match|price_low|price_high|newly_listed|ending_soonest)$): best_match, price_low, price_high, newly_listed or ending_soonest.
- `condition` (string | null; optional; pattern ^(new|used)$): new or used.
- `buying_format` (string | null; optional; pattern ^(auction|buy_it_now)$): auction or buy_it_now.
- `min_price` (number | null; optional; min 0): Minimum price.
- `max_price` (number | null; optional; min 0): Maximum price.

Base URL: `https://api.scrapercompany.com`. Auth: send your key in the `x-api-key` header. A failed request (4xx or 5xx) or an empty result costs 0 credits.

- [Full API reference as one Markdown file](https://scrapercompany.com/llms-full.txt)
- [OpenAPI spec](https://scrapercompany.com/openapi.json)