eBay Scraper API

Search active listings, pull completed/sold-price history, 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

18 Marketplaces

Access all major eBay marketplaces including US, UK, DE, FR, IT, ES, AU, CA, and more.

Sold-Price History

The /v1/ebay/completed endpoint returns real sold listings — the closing prices buyers actually paid.

Anti-Bot Bypass

Automatic session management, Chrome TLS impersonation, and fingerprint rotation to avoid blocks.

Rich Item Data

Prices, conditions, item specifics, shipping options, returns, seller info, ratings, and sold counts.

Auction Data

Live auction fields — bid count, time remaining, current high bid, absolute end time, and Buy It Now price — on search cards and item detail.

Country Proxies

Requests are routed through proxies matching the target marketplace for accurate pricing and availability.

SDK Support

First-class support via the ScrapeBadger Node.js and Python SDKs.

eBay no longer exposes public watcher counts, so the watchers field is often null on search, seller-items, and item-detail responses. Sold counts (sold_count, and the /v1/ebay/completed sold-price history) remain available and are the reliable signal for demand.

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

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 endpoint to get the full list (with currency, locale, and site id) programmatically.

Quick Start

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);

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)

curl "https://scrapebadger.com/v1/ebay/search?query=nintendo+switch+oled&domain=com&page=1" \
  -H "x-api-key: YOUR_API_KEY"

Endpoints

Endpoint	Method	Description
`/v1/ebay/search`	GET	Search a marketplace for active listings
`/v1/ebay/completed`	GET	Completed / sold listings (sold-price history)
`/v1/ebay/items/{item_id}`	GET	Full detail for a single listing
`/v1/ebay/items/{item_id}/reviews`	GET	Catalog product reviews for a listing
`/v1/ebay/sellers/{username}`	GET	Seller public profile
`/v1/ebay/sellers/{username}/items`	GET	A seller’s active listings
`/v1/ebay/sellers/{username}/feedback`	GET	A seller’s recent feedback comments
`/v1/ebay/categories/{category_id}/items`	GET	List listings within a category
`/v1/ebay/categories`	GET	List top-level category aliases
`/v1/ebay/autocomplete`	GET	Keyword autocomplete suggestions
`/v1/ebay/markets`	GET	List all supported marketplaces

Credit Costs

Endpoint	Cost
Search	5 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:

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.

For accurate pricing and availability, requests are routed through proxies in the marketplace’s country. This is handled automatically based on the domain parameter.

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 on search, or sort_by=ending_soonest, to surface auctions.

Overview

Search

Items

Sellers

Categories

Reference

eBay Scraper Overview

eBay Scraper API

Key Features

18 Marketplaces

Sold-Price History

Anti-Bot Bypass

Rich Item Data

Auction Data

Country Proxies

SDK Support

Supported Marketplaces

Quick Start

Endpoints

Credit Costs

Authentication

Anti-Bot Handling

Auction Data

Next Steps

Search Listings

Sold-Price History

​eBay Scraper API

​Key Features

18 Marketplaces

Sold-Price History

Anti-Bot Bypass

Rich Item Data

Auction Data

Country Proxies

SDK Support

​Supported Marketplaces

​Quick Start

​Endpoints

​Credit Costs

​Authentication

​Anti-Bot Handling

​Auction Data

​Next Steps

Search Listings

Sold-Price History

eBay Scraper API

Key Features

Supported Marketplaces

Quick Start

Endpoints

Credit Costs

Authentication

Anti-Bot Handling

Auction Data

Next Steps