eBay Scraper Overview

Scrape eBay active listings, sold-price history, item details, reviews, and seller data across 18 marketplaces with structured JSON responses.

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 watchers.

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.

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

Node.js

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

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.

Next Steps

Search Listings

Full API reference for searching the eBay catalog

Sold-Price History

Retrieve the closing prices of completed/sold listings