# eBay scraper API — $0.001 per listing

> eBay scraper API: eBay listings for a keyword — price, condition, format, shipping. $0.001 per delivered listing, nothing delivered means nothing charged.

[Home](https://quanticdata.io/)/[Collectors](https://quanticdata.io/collectors/)/*eBay scraper API*

# eBay scraper API

An eBay scraper API that returns listings for a keyword: item id, title, price and struck-through list price, condition, buying format, shipping and returns lines, seller location, sponsored flag and image — across 15 marketplaces.

[Get my free API key](https://app.quanticdata.io/register) [See the request](/collectors/ebay-scraper-api/#integration)

$0.001 per delivered listing · $2 free every month · Failed runs never billed

POST /v1/scraper/collectors/ebay_search/run

```
$ curl $QD/ebay_search/run \
    -H "Authorization: Bearer $QD_API_KEY" \
    -d '{"query": "running shoes", "country": "us", "max_results": 50}'
{ "status": "done", "count": 50,
  "results": [
    {
      "item_id": "…",
      "title": "…",
      "price": "…",
      "price_value": … } ],
  "cost": 0.05 }
# 50 listings × $0.001 · nothing delivered, nothing charged
```

**$0.001 / listing**2,000 listings on the free $2 every month

**Semantic input**query, condition, buy_it_now_only — no URL lists

**Up to 250**listings per run, pagination handled for you

**No browser**read over HTTP/TLS — cheaper and faster than rendering

On this page: [What it is](/collectors/ebay-scraper-api/#what) [Output fields](/collectors/ebay-scraper-api/#output) [Inputs](/collectors/ebay-scraper-api/#input) [Pricing](/collectors/ebay-scraper-api/#pricing) [Integration](/collectors/ebay-scraper-api/#integration) [Use cases](/collectors/ebay-scraper-api/#use-cases) [Versus the alternatives](/collectors/ebay-scraper-api/#compare) [FAQ](/collectors/ebay-scraper-api/#faq)

## What an eBay scraper API does

eBay rebuilt its result cards around generic text spans, which broke every scraper that relied on the old `s-item` classes. This collector reconstructs a row from the card's text roles instead, so it survives the class churn that takes selector-based scrapers offline.

Two details matter and both are handled: the sponsored label is written reversed in the DOM specifically to defeat naive parsers, and the condition chip is not always first — refurbished listings put a seller blurb ahead of it, so the condition is picked by vocabulary rather than by position.

Input is meaning, not a URL *query* *condition* *buy_it_now_only* *country* *max_results*

## What one listing looks like

Every delivered listing carries these fields. Nullable means the source did not publish it — the field stays empty instead of being guessed.

| Field | Type | What it holds |
| --- | --- | --- |
| `rank` | integer | 1-based position across pages. |
| `page` | integer | Search page the row came from. |
| `item_id` | string | eBay item id. |
| `title` | string | Listing title. |
| `price` | string · nullable | Price as shown. |
| `price_value` | number · nullable | Numeric price. |
| `list_price` | string · nullable | Struck-through price when discounted. |
| `condition` | string · nullable | Condition chip (Brand New, Pre-Owned…). |
| `attributes` | string[] | Variant/brand chips shown under the title. |
| `format` | string · nullable | Buying format (Buy It Now, bids…). |
| `shipping` | string · nullable | Shipping/delivery line. |
| `location` | string · nullable | Seller location line. |
| `returns` | string · nullable | Returns line when shown. |
| `sponsored` | boolean | True for paid placements. |
| `image` | string · nullable | Thumbnail URL. |
| `url` | string · nullable | Listing URL. |

## Inputs

The whole request. Anything you leave out falls back to the default shown in the catalog.

| Input | Type | Required | What it does |
| --- | --- | --- | --- |
| `query` | string | yes | What to search on eBay, e.g. "running shoes". |
| `condition` | string | no | Restrict to new or used listings. One of: `any`, `new`, `used`. |
| `buy_it_now_only` | boolean | no | Exclude auctions. |
| `country` | string | no | ISO 3166-1 alpha-2 code — picks the local site AND the proxy exit (default us). |
| `max_results` | integer | no | How many listings to deliver at most (1–250). You pay only for delivered listings. |

Pricing

## eBay scraper API pricing

$0.001 per delivered listing. A run that delivers nothing costs nothing: blocked pages, challenges and retries are on us, and the $2 monthly allowance covers about 2,000 listings before you spend anything.

**$0.001**per delivered listing*$1 per 1,000 delivered listings*

**2,000 listings**on the free allowance*$2 every month, no card*

**Zero rows**zero charge*blocks, captchas and retries are on us*

**−30%**on volume tiers*the catalog returns your key's price*

### Pay as you go

$0/mo

- $2 free credit / month

- 60 requests / min

- List unit prices

### Starter

$19/mo

- $15 free credit / month

- 300 requests / min

- 10% off unit prices

Most popular

### Growth

$79/mo

- $50 free credit / month

- 600 requests / min

- 20% off unit prices

### Scale

$299/mo

- $250 free credit / month

- 1,200 requests / min

- 30% off unit prices

Same wallet, same key and same $2 monthly allowance as every other [Data API](https://quanticdata.io/web-data-api-for-ai/). Prices are launch pricing read live from the billing config — `GET /v1/scraper/collectors` returns the price your key actually pays.

Integration

## One POST, typed rows

Base URL `https://api.quanticdata.io/v1`, Bearer auth, the same key as every other Data API. Endpoint: `POST /v1/scraper/collectors/ebay_search/run`.

```
curl -X POST https://api.quanticdata.io/v1/scraper/collectors/ebay_search/run \
  -H "Authorization: Bearer $QD_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"query":"running shoes","country":"us","max_results":50}'
```

```
import requests

r = requests.post(
    "https://api.quanticdata.io/v1/scraper/collectors/ebay_search/run",
    headers={"Authorization": f"Bearer {QD_API_KEY}"},
    json={
        "query": "running shoes",
        "country": "us",
        "max_results": 50
    },
    timeout=120,
)
for row in r.json()["payload"]["results"]:
    print(row)
```

```
const res = await fetch(
  "https://api.quanticdata.io/v1/scraper/collectors/ebay_search/run",
  {
    method: "POST",
    headers: {
      Authorization: `Bearer ${process.env.QD_API_KEY}`,
      "Content-Type": "application/json",
    },
    body: JSON.stringify({"query":"running shoes","country":"us","max_results":50}),
  },
);
const { payload } = await res.json();
console.table(payload.results);
```

```
claude mcp add quantumproxies \
  -e QUANTUMPROXIES_API_KEY=qd_live_your_key_here \
  -- npx -y quantumproxies-mcp

# then, in the chat:
> run the ebay_search collector with query="running shoes" and country="us"
```

## What people build with the eBay scraper API

Three shapes of work this endpoint was designed around.

### Resale price research

Compare asking prices by condition for the same model across a marketplace.

### Auction versus fixed price

Split the market by buying format before deciding how to list.

### Grey-market monitoring

Watch which sellers list your product, from which country, at what price.

## eBay scraper API versus rolling your own

The differences that actually cost time when you build this in-house.

|  | DIY scraper | This collector |
| --- | --- | --- |
| Card markup | Breaks with every class rename | Rebuilt from text roles |
| Sponsored detection | Missed (the label is reversed in the DOM) | Detected |
| Condition | First chip, often the seller's blurb | Matched against eBay's condition vocabulary |

## The index versus the page

eBay's Browse and Finding APIs are real and well documented, and reaching them means registering an application, completing developer onboarding and handling OAuth token refresh. For a team that wants a comparable price series across five marketplaces this quarter, that is a lot of process before the first row.

They also answer from eBay's index with eBay's ranking, while a dataset about the market usually needs the result page as served — including promoted placements and the order buyers actually saw. For comparability the fields that matter are `format` and `shipping`: an auction bid mid-flight and a fixed price are not the same measurement, and a cheap item with expensive postage is not cheap.

## Limits, filters and the legal bit

Up to 250 listings per run — deep enough that long-tail supply on page four is reachable. The `condition` and `buy_it_now_only` filters apply at the source, so narrowing a sweep reduces what you are billed rather than just what you keep. Throughput is your plan's rate limit rather than anything about the collector: 60 requests/minute on pay-as-you-go, up to 1,200 on the top tier.

Collecting publicly visible data is generally lawful in most jurisdictions, and courts have repeatedly declined to treat reading a public page as unauthorised access. eBay's terms restrict automated access, and seller usernames and locations can be personal data depending on context. None of this is legal advice — get some for your actual use case.

## FAQ

Questions we get about the eBay scraper API.

[Something else? Ask us →](mailto:hello@quanticdata.io)

### Can I filter to new or used only?

Yes. `condition` accepts new or used and maps to eBay's own filter ids, and `buy_it_now_only` drops auctions.

### Which marketplaces are supported?

Fifteen, chosen with `country`: US, UK, IE, DE, FR, IT, ES, NL, BE, AT, CH, PL, CA, AU.

### Do you return the seller name?

The result card publishes location, format, shipping and returns, not a seller handle. Where eBay shows a store name in the card it lands in the attribute chips.

### Is there a free eBay scraper API?

Every account gets $2 of credit every month with no card, which is about 2,000 delivered listings on this endpoint at $0.001 each. It renews monthly, and a run that delivers nothing is never billed — so a failed or blocked attempt does not eat the allowance.

### How much does one run cost?

Multiply the rows you actually receive by $0.001. A run capped at 250 listings — the maximum for this collector — costs $0.25 if every row comes back, and less when the source has fewer. Volume tiers take up to 30% off, and `GET /v1/scraper/collectors` returns the price your key actually pays.

### Why keep the buying format as a column?

Because mixing auctions and fixed-price listings produces a price series that moves for reasons unrelated to the market. Keeping format lets one dataset answer both questions instead of quietly averaging them into a third that means nothing.

### Do the filters save money?

Yes — they are applied by eBay before results are collected, so a used-only or Buy-It-Now-only sweep collects and bills fewer rows rather than returning everything for you to discard.

## Run the eBay scraper API now

$2 of free credit every month, no card. Your key returns its own prices from `GET /v1/scraper/collectors`.

[Get my free API key](https://app.quanticdata.io/register)

Related: [All 32 collectors](https://quanticdata.io/collectors/) [Amazon scraper API](https://quanticdata.io/collectors/amazon-scraper-api/) [AliExpress scraper API](https://quanticdata.io/collectors/aliexpress-scraper-api/) [Google Shopping API](https://quanticdata.io/collectors/google-shopping-api/) [Documentation](https://quanticdata.io/docs/)

---

Source: https://quanticdata.io/collectors/ebay-scraper-api/ · Site index for AI: https://quanticdata.io/llms.txt