eBay Scraper by ScrapeBadger — Overview

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

18 Marketplaces

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

18 Marketplaces, One API

Search, item detail, reviews and seller data resolve across every supported marketplace from a single domain parameter.

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_count remains available on item detail and is the reliable signal for demand. Completed/sold price history is available via /v1/ebay/completed, which returns items that have sold with their sale price and date.

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/search/by-image`	POST	Search active listings by image — eBay’s own visual search
`/v1/ebay/completed`	GET	Search 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
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:

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

Item Detail

Full listing detail including price, condition, specifics and seller

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.

Overview

Search

Items

Sellers

Categories

Reference

eBay Scraper by ScrapeBadger — Overview

Scraper API for eBay

Key Features

18 Marketplaces

18 Marketplaces, One API

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

Item Detail

​Scraper API for eBay

​Key Features

18 Marketplaces

18 Marketplaces, One API

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

Item Detail

Scraper API for eBay

Key Features

Supported Marketplaces

Quick Start

Endpoints

Credit Costs

Authentication

Anti-Bot Handling

Auction Data

Next Steps