Skip to main content

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

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.
MarketDomainMarketDomain
:us: comebay.com:gb: co.ukebay.co.uk
:de: deebay.de:fr: frebay.fr
:it: itebay.it:es: esebay.es
:australia: com.auebay.com.au:canada: caebay.ca
:at: atebay.at:switzerland: chebay.ch
:be: beebay.be:ireland: ieebay.ie
:netherlands: nlebay.nl:poland: plebay.pl
:hong_kong: com.hkebay.com.hk:singapore: com.sgebay.com.sg
:malaysia: com.myebay.com.my:philippines: phebay.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);

​
Endpoints

EndpointMethodDescription
/v1/ebay/searchGETSearch a marketplace for active listings
/v1/ebay/completedGETCompleted / sold listings (sold-price history)
/v1/ebay/items/{item_id}GETFull detail for a single listing
/v1/ebay/items/{item_id}/reviewsGETCatalog product reviews for a listing
/v1/ebay/sellers/{username}GETSeller public profile
/v1/ebay/sellers/{username}/itemsGETA seller’s active listings
/v1/ebay/sellers/{username}/feedbackGETA seller’s recent feedback comments
/v1/ebay/categories/{category_id}/itemsGETList listings within a category
/v1/ebay/categoriesGETList top-level category aliases
/v1/ebay/autocompleteGETKeyword autocomplete suggestions
/v1/ebay/marketsGETList all supported marketplaces

​
Credit Costs

EndpointCost
Search5 credits
Completed / sold5 credits
Get item detail5 credits
Get item reviews10 credits
Get seller5 credits
Seller items5 credits
Seller feedback10 credits
Browse category5 credits
Autocomplete1 credit
List categories0 credits
List markets0 credits
Failed requests0 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.

​
Next Steps

Search Listings

Full API reference for searching the eBay catalog

Sold-Price History

Retrieve the closing prices of completed/sold listings