> ## Documentation Index
> Fetch the complete documentation index at: https://docs.scrapebadger.com/llms.txt
> Use this file to discover all available pages before exploring further.

# eBay Scraper by ScrapeBadger — Overview

> Scrape eBay active listings, item details, reviews, and seller data across 18 marketplaces with structured JSON responses.

## Scraper API for eBay

Search active listings by keyword or by image, fetch full item detail, list reviews, and retrieve seller profiles, storefronts, and feedback from eBay — one of the world's largest online marketplaces. The API handles authentication, anti-bot bypass, and marketplace routing automatically.

## Key Features

<CardGroup cols={3}>
  <Card title="18 Marketplaces" icon="earth-americas">
    Access all major eBay marketplaces including US, UK, DE, FR, IT, ES, AU, CA, and more.
  </Card>

  <Card title="18 Marketplaces, One API" icon="globe">
    Search, item detail, reviews and seller data resolve across every supported
    marketplace from a single `domain` parameter.
  </Card>

  <Card title="Anti-Bot Bypass" icon="shield-halved">
    Automatic session management, Chrome TLS impersonation, and fingerprint rotation to avoid blocks.
  </Card>

  <Card title="Rich Item Data" icon="box">
    Prices, conditions, item specifics, shipping options, returns, seller info, ratings, and sold counts.
  </Card>

  <Card title="Auction Data" icon="gavel">
    Live auction fields — bid count, time remaining, current high bid, absolute end time, and Buy It Now price — on search cards and item detail.
  </Card>

  <Card title="Country Proxies" icon="globe">
    Requests are routed through proxies matching the target marketplace for accurate pricing and availability.
  </Card>

  <Card title="SDK Support" icon="code">
    First-class support via the ScrapeBadger Node.js and Python SDKs.
  </Card>
</CardGroup>

<Note>
  eBay no longer exposes public **watcher counts**, so the `watchers` field is often `null` on search, seller-items, and item-detail responses. `sold_count` remains available on item detail and is the reliable signal for demand. Completed/sold **price history** is available via [`/v1/ebay/completed`](/api-reference/endpoint/ebay/completed), which returns items that have sold with their sale price and date.
</Note>

## Supported Marketplaces

eBay operates across 18 country domains. Use the `domain` query parameter to target a specific one.

| Market | Domain | Market | Domain |
| - | - | - | - |
| :us: `com` | ebay.com | :gb: `co.uk` | ebay.co.uk |
| :de: `de` | ebay.de | :fr: `fr` | ebay.fr |
| :it: `it` | ebay.it | :es: `es` | ebay.es |
| :australia: `com.au` | ebay.com.au | :canada: `ca` | ebay.ca |
| :at: `at` | ebay.at | :switzerland: `ch` | ebay.ch |
| :be: `be` | ebay.be | :ireland: `ie` | ebay.ie |
| :netherlands: `nl` | ebay.nl | :poland: `pl` | ebay.pl |
| :hong\_kong: `com.hk` | ebay.com.hk | :singapore: `com.sg` | ebay.com.sg |
| :malaysia: `com.my` | ebay.com.my | :philippines: `ph` | ebay.ph |

<Tip>
  If no `domain` is specified, it defaults to `com`. Country-style aliases also work (`us` → `com`, `uk`/`gb` → `co.uk`, `au` → `com.au`, `hk`/`sg`/`my`). Use the [`/v1/ebay/markets`](/api-reference/endpoint/ebay/list-markets) endpoint to get the full list (with currency, locale, and site id) programmatically.
</Tip>

## Quick Start

<CodeGroup>
  ```javascript Node.js theme={null}
  import ScrapeBadger from "scrapebadger";

  const client = new ScrapeBadger({ apiKey: "YOUR_API_KEY" });

  const results = await client.ebay.search({
    query: "nintendo switch oled",
    domain: "com",
    page: 1,
  });

  console.log(results.results);
  ```

  ```python Python theme={null}
  from scrapebadger import ScrapeBadger

  client = ScrapeBadger(api_key="YOUR_API_KEY")

  results = client.ebay.search(
      query="nintendo switch oled",
      domain="com",
      page=1,
  )

  print(results.results)
  ```

  ```bash cURL theme={null}
  curl "https://scrapebadger.com/v1/ebay/search?query=nintendo+switch+oled&domain=com&page=1" \
    -H "x-api-key: YOUR_API_KEY"
  ```
</CodeGroup>

## Endpoints

| Endpoint | Method | Description |
| - | - | - |
| [`/v1/ebay/search`](/api-reference/endpoint/ebay/search) | GET | Search a marketplace for active listings |
| [`/v1/ebay/search/by-image`](/api-reference/endpoint/ebay/search-by-image) | POST | Search active listings by image — eBay's own visual search |
| [`/v1/ebay/completed`](/api-reference/endpoint/ebay/completed) | GET | Search completed (sold) listings — sold-price history |
| [`/v1/ebay/items/{item_id}`](/api-reference/endpoint/ebay/get-item-detail) | GET | Full detail for a single listing |
| [`/v1/ebay/items/{item_id}/reviews`](/api-reference/endpoint/ebay/get-item-reviews) | GET | Catalog product reviews for a listing |
| [`/v1/ebay/sellers/{username}`](/api-reference/endpoint/ebay/get-seller) | GET | Seller public profile |
| [`/v1/ebay/sellers/{username}/items`](/api-reference/endpoint/ebay/get-seller-items) | GET | A seller's active listings |
| [`/v1/ebay/sellers/{username}/feedback`](/api-reference/endpoint/ebay/get-seller-feedback) | GET | A seller's recent feedback comments |
| [`/v1/ebay/categories/{category_id}/items`](/api-reference/endpoint/ebay/browse-category) | GET | List listings within a category |
| [`/v1/ebay/categories`](/api-reference/endpoint/ebay/list-categories) | GET | List top-level category aliases |
| [`/v1/ebay/autocomplete`](/api-reference/endpoint/ebay/autocomplete) | GET | Keyword autocomplete suggestions |
| [`/v1/ebay/markets`](/api-reference/endpoint/ebay/list-markets) | GET | List all supported marketplaces |

## Credit Costs

| Endpoint | Cost |
| - | - |
| Search | 5 credits |
| Search by image | 10 credits |
| Completed / sold | 5 credits |
| Get item detail | 5 credits |
| Get item reviews | 10 credits |
| Get seller | 5 credits |
| Seller items | 5 credits |
| Seller feedback | 10 credits |
| Browse category | 5 credits |
| Autocomplete | 1 credit |
| List categories | 0 credits |
| List markets | 0 credits |
| Failed requests | 0 credits |

## Authentication

All requests require your API key in the `X-API-Key` header:

```bash theme={null}
curl "https://scrapebadger.com/v1/ebay/search?query=laptop" \
  -H "X-API-Key: YOUR_API_KEY"
```

## Anti-Bot Handling

eBay protects its catalog with IP-reputation scoring, TLS/HTTP-2 fingerprinting, and per-domain server-side rendering. ScrapeBadger clears these automatically using Chrome TLS impersonation on sessions matched to the target marketplace. You never need to manage proxies, sessions, or CAPTCHAs.

<Note>
  For accurate pricing and availability, requests are routed through proxies in the marketplace's country. This is handled automatically based on the `domain` parameter.
</Note>

## Auction Data

Auction listings are fully supported across search cards and item detail. When a listing is an auction (`is_auction` is `true`), these fields are populated:

| Field | Where | Description |
| - | - | - |
| `bids` | cards + detail | Number of bids placed so far. |
| `time_left` | cards + detail | Relative time remaining, e.g. `12h 16m`. |
| `current_bid` | cards + detail | Current high bid (an `EbayPrice`, mirrors `price`). |
| `end_time_utc` | detail | Absolute end time as a Unix timestamp (float seconds). |
| `end_time_at` | detail | Absolute end time as an ISO-8601 Z string, e.g. `2026-06-22T19:50:51Z`. |
| `buy_it_now_price` | detail | Buy It Now price (an `EbayPrice`); `null` for pure auctions. |

For non-auction (fixed-price) listings, `current_bid`, `end_time_utc`, and `end_time_at` are `null`, and `buy_it_now_price` mirrors `price`. Use [`buying_format=auction`](/api-reference/endpoint/ebay/search) on search, or [`sort_by=ending_soonest`](/api-reference/endpoint/ebay/search), to surface auctions.

## Next Steps

<CardGroup cols={2}>
  <Card title="Search Listings" icon="magnifying-glass" href="/api-reference/endpoint/ebay/search">
    Full API reference for searching the eBay catalog
  </Card>

  <Card title="Item Detail" icon="tag" href="/api-reference/endpoint/ebay/get-item-detail">
    Full listing detail including price, condition, specifics and seller
  </Card>
</CardGroup>

***

*ScrapeBadger is an independent tool and is not affiliated with, endorsed by, or sponsored by eBay. "eBay" is a trademark of eBay Inc., used here only to describe the platform this scraper is designed to work with.*


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.