# eBay Search API (https://www.socialcrawl.dev/platforms/ebay/search)

> Returns eBay listings matching a keyword, 60 per page, each with its item id, title, price, original price where the listing is discounted, currency, condition, image, seller handle, seller feedback percentage and count, units sold, buying format, and the listing URL. Sixty rows a call is the densest listing surface in this API. Feed a returned item id into GET /v1/ebay/product for the full listing including seller reputation depth. When crawling, note that the result total eBay reports is an estimate that changes between pages, so it is not returned here: paginate until a page comes back empty.

TL;DR: `GET /v1/ebay/search` costs 5 credits per call and returns SocialCrawl's unified JSON schema. Single x-api-key auth, 100 free credits on signup.

## Parameters

| Parameter | Required | Description |
| --- | --- | --- |
| `query` | yes | Free-text listing search, for example airpods pro or vintage seiko. |
| `country` | no | eBay marketplace as a two-letter country code: US (ebay.com, default), GB, AU, CA, DE, FR, IT, ES, IE, AT, CH, NL, BE, PL, SG, MY, PH, HK, or MX. The marketplace sets the listing pool, language, and currency. (US \| GB \| AU \| CA \| DE \| FR \| IT \| ES \| IE \| AT \| CH \| NL \| BE \| PL \| SG \| MY \| PH \| HK \| MX) |
| `page` | no | Page number, starting at 1. Prefer the universal cursor parameter. |
| `sort_by` | no | Result ordering: best_match (default), price_low, price_high, newly_listed, or ending_soonest. (best_match \| price_low \| price_high \| newly_listed \| ending_soonest) |
| `condition` | no | Restrict to one item condition: new, opened_box, refurbished, or used. (new \| opened_box \| refurbished \| used) |
| `buying_format` | no | Restrict to one sale type: auction, buy_it_now, or accepts_offers. (auction \| buy_it_now \| accepts_offers) |
| `show_only` | no | eBay refinement token taken from a previous response, for example free_shipping or sold_items. |
| `min_price` | no | Lowest price to include. Applied by eBay and approximate, so filter on product.price.current if you need a hard bound. |
| `max_price` | no | Highest price to include. Applied by eBay and approximate, so filter on product.price.current if you need a hard bound. |
| `aspects` | no | Category-specific item aspect filter taken from a previous response, for example Brand:Apple. |

## Code example

```bash
curl "https://www.socialcrawl.dev/v1/ebay/search?query=airpods%20pro" \
  -H "x-api-key: sc_YOUR_API_KEY"
```

## FAQ

### How many listings come back per call?

Sixty, the densest listing page in this API, which makes it the cheapest way to scan a marketplace at depth.

### Can I filter by item condition?

Yes: new, opened box, refurbished or used. You can also restrict to auction, buy it now or accepts offers with the buying format filter.

### Do search rows include the seller?

Yes, with the seller handle, feedback percentage and count, and units sold, so you can rank results by seller quality before pulling any detail.

### Is the result total returned?

No. eBay's total is an estimate that more than halved between consecutive pages when measured, so publishing it would mislead. Paginate until a page is empty.

### How do I sort eBay search results?

By best match, price low to high, price high to low, newly listed or ending soonest. Best match is the default.

See the full eBay API: https://www.socialcrawl.dev/platforms/ebay

## Pricing

- Standard endpoints: 1 credit per call
- Advanced endpoints: 5 credits per call
- Premium endpoints: 10 credits per call
- 100 free credits on signup, no credit card required. Cached responses cost 0 credits. Credit packs never expire.
- Full pricing: https://www.socialcrawl.dev/pricing

## Explore with AI

Questions this API answers, phrased for an AI assistant:

- How do I search eBay listings with an API?
- Can I filter eBay search by item condition?
- How many eBay listings can I get in one API call?