# eBay Scraper - Listings, Sold Prices & Seller Leads (`scrapesage/ebay-scraper`) Actor

Scrape eBay active listings AND real sold/completed prices (comps): condition, price, shipping, bids, sold count, seller & feedback. Item detail adds brand, MPN, GTIN, ratings & photos; seller leads add feedback & location. Sold-price analytics, 10 marketplaces, monitoring mode.

- **URL**: https://apify.com/scrapesage/ebay-scraper.md
- **Developed by:** [Scrape Sage](https://apify.com/scrapesage) (community)
- **Categories:** E-commerce, Lead generation, Automation
- **Stats:** 3 total users, 1 monthly users, 100.0% runs succeeded, 0 bookmarks
- **User rating**: No ratings yet

## Pricing

from $1.50 / 1,000 listing / sold item scrapeds

This Actor is paid per event. You are not charged for the Apify platform usage, but only a fixed price for specific events.

Learn more: https://docs.apify.com/platform/actors/running/actors-in-store#pay-per-event

## What's an Apify Actor?

Actors are web data automations that power AI and operations. They run on the Apify platform to scrape websites, process data, connect APIs, and automate workflows.
In Batch mode, an Actor accepts a well-defined JSON input, performs an action which can take anything from a few seconds to a few hours,
and optionally produces a well-defined JSON output, datasets with results, or files in key-value store.
In Standby mode, an Actor provides a web server which can be used as a website, API, or an MCP server.
Actors are written with capital "A".

## How to integrate an Actor?

If asked about integration, you help developers integrate Actors into their projects.
You adapt to their stack and deliver integrations that are safe, well-documented, and production-ready.
The best way to integrate Actors is as follows.

- **AI agents and MCP clients** — the [Apify MCP server](https://docs.apify.com/integrations/mcp.md) at `https://mcp.apify.com` (remote, streamable HTTP, OAuth on first use).
- **Agentic workflows and local Actor development** — [Agent Skills](https://apify.com/.well-known/agent-skills/index.json) with the [Apify CLI](https://docs.apify.com/cli/docs.md): `npm install -g apify-cli`, then `apify login`.
- **JavaScript/TypeScript projects** — the official [JS/TS client](https://docs.apify.com/api/client/js/docs.md): `npm install apify-client`.
- **Python projects** — the official [Python client](https://docs.apify.com/api/client/python/docs.md): `pip install apify-client`.
- **Any other language** — the [REST API](https://docs.apify.com/api/v2.md).

For usage examples, see the [API](#api) section below.

For more details, see Apify documentation as [Markdown index](https://docs.apify.com/llms.txt) and [Markdown full-text](https://docs.apify.com/llms-full.txt).

# README

## eBay Scraper — Listings, Sold Prices & Seller Leads

Extract **active listings, real sold/completed prices (comps), full item details, and seller leads** from [eBay](https://www.ebay.com) — the world's largest auction & marketplace. Get **title, condition, price, shipping, bids, sold counts, location, the seller and feedback** straight off search results, plus **sold-price comps** (what items *actually* sold for, with the sold date), deep **item detail** (brand, MPN, GTIN/UPC, model, product rating, high-resolution photos, payment methods) and **B2B seller-lead profiles** with positive-feedback %, items sold, location and a lead score.

No login and no API key — eBay's own pages, parsed into clean, structured JSON. Works across **10 marketplaces** (US, UK, DE, AU, CA, FR, IT, ES, NL, IE).

### Why this eBay scraper?

| Typical scrapers | This actor |
| --- | --- |
| Active listings only | **Active *and* sold/completed** prices — real comps with sold dates |
| Title + price only | **50+ fields**: condition, shipping, bids, sold count, seller + feedback, brand, MPN, GTIN, model, rating, photos, payment methods |
| No market analytics | **Sold-price analytics** — min/max/average/median, sold-per-day & a recommended list price, per query |
| No contact/seller data | **Seller leads** — positive-feedback %, feedback score, items sold, location, member-since, Top Rated + a 0–100 lead score |
| One marketplace | **10 eBay marketplaces** with localized currency |
| Re-scrapes everything | **Monitoring mode** — only new listings / newly sold / new sellers since the last run |
| Hidden caps & start fees | **No start fee**, transparent pay-per-result |

### Use cases

- **Reselling & arbitrage** — pull *sold* comps for any product to know exactly what it sells for, the sell-through rate, and the price you should list at. The single most-requested eBay data set.
- **Price & repricing intelligence** — track active and sold prices across conditions and marketplaces to drive dynamic pricing and competitor monitoring.
- **Deal sniping** — monitor a saved search (e.g. "vintage Omega Seamaster under $1,500") and get only newly listed items each run.
- **B2B lead generation** — turn active eBay sellers into leads with feedback %, volume, location and a lead score (power sellers, stores, refurbishers, liquidators).
- **Catalog & demand research** — aggregate brand/model, condition mix, watcher and sold counts to model demand and supply for a category.

### How to use

1. [Sign up for Apify](https://console.apify.com/sign-up) — the free plan is enough to try this actor.
2. Open the **eBay Scraper**, choose a **mode**, enter keywords (or an eBay URL), set filters, and click **Start**.
3. Watch results stream into the dataset as each page is parsed.
4. **Export** as JSON, CSV, Excel, XML, or RSS — or pull results via the [Apify API](https://docs.apify.com/api/v2).

> eBay blocks datacenter IPs, so this actor uses **Apify Residential proxy by default** (already pre-filled). Keep it on for reliable results.

### Input

```json
{
  "mode": "sold",
  "searchQueries": ["nintendo switch oled", "iphone 15 pro 256gb"],
  "marketplace": "US",
  "condition": "used",
  "priceMin": 50,
  "priceMax": 400,
  "sort": "newest",
  "computeAnalytics": true,
  "enrichItemDetails": false,
  "emitSellerLeads": false,
  "maxItems": 500,
  "monitorMode": false,
  "proxyConfiguration": { "useApifyProxy": true, "apifyProxyGroups": ["RESIDENTIAL"] }
}
```

- **mode** — `search` (active listings), `sold` (real sold/completed prices), `itemDetail` (full data for item URLs), or `seller` (a seller's inventory + lead profile).
- **searchQueries** — keywords like `pokemon booster box`, `vintage rolex`, `dyson v15`. Combined with the filters below.
- **startUrls** — paste eBay URLs directly: search (`ebay.com/sch/i.html?_nkw=...`), item (`ebay.com/itm/123...`), or seller (`ebay.com/usr/<name>`).
- **marketplace / categoryId / condition / listingType / priceMin / priceMax / freeShippingOnly / sort** — narrow the results.
- **enrichItemDetails** — open each item page to add brand, MPN, GTIN, model, rating, all photos, payment methods, the seller and quantity sold/watchers.
- **emitSellerLeads** — also output one deduplicated seller-lead record per unique seller.
- **computeAnalytics** — in Sold mode, add a sold-price comps summary per query.

### Output

An **active listing** (`type: "listing"`) — sold items use `type: "sold"` and add `soldDate`:

```json
{
  "type": "listing",
  "marketplace": "US",
  "itemId": "326374503310",
  "epid": "8048191202",
  "url": "https://www.ebay.com/itm/326374503310",
  "title": "NEW Nintendo Switch OLED 64GB Neon Red Blue Joy-Con",
  "subtitle": "Nintendo Switch · Nintendo Switch (OLED Model)",
  "condition": "Brand New",
  "price": { "raw": "$319.99", "value": 319.99, "currency": "USD" },
  "buyItNow": true,
  "auction": false,
  "bestOffer": false,
  "bids": null,
  "shipping": { "raw": "Free delivery", "free": true, "cost": 0, "currency": "USD" },
  "soldQuantity": 199,
  "soldDate": null,
  "returns": "Free returns",
  "seller": { "username": "bestsellerssince1977", "url": "https://www.ebay.com/usr/bestsellerssince1977", "positiveFeedbackPercent": 99.3, "feedbackScore": 3700 },
  "image": "https://i.ebayimg.com/images/g/.../s-l500.webp",
  "listingType": "fixed_price",
  "searchQuery": "nintendo switch oled",
  "scrapedAt": "2026-06-17T06:44:56Z"
}
```

An **itemDetail** record (`type: "itemDetail"`) adds `brand`, `model`, `mpn`, `gtin13`, `color`, `availability`, `rating` (`{ value, count }`), `images` (hi-res), `paymentMethods`, `shippingDetails`, `itemSpecifics`, the `seller` and `soldQuantity`/`watchers`. A **seller** record (`type: "seller"`) carries `storeName`, `positiveFeedbackPercent`, `feedbackScore`, `itemsSold`, `followers`, `location`, `memberSince`, `topRatedSeller` and a 0–100 `leadScore`. A **priceInsights** record (`type: "priceInsights"`, Sold mode) carries `sampleSize`, `soldPrice` (`{ min, max, average, median }`), `soldDateRange`, `estimatedSoldPerDay` and `recommendedListPrice`.

Notes: enrichment fields populate only when **enrichItemDetails** is on (or in `itemDetail` mode). Empty results are reported as a successful run. The actor scrapes public marketplace data only.

### Monitoring — get only new listings

Turn on **monitorMode** and the actor remembers every id it has emitted (in a named key-value store keyed by **monitorKey**). On the next run with the same inputs it returns **only records it hasn't seen before** — new listings, newly sold items, or new sellers.

- Use a distinct **monitorKey** per saved search so different watches keep separate memory.
- It pairs with **[Apify Schedules](https://docs.apify.com/platform/schedules)**: the schedule starts the run on a cron; monitoring mode dedupes against prior runs — so a daily watch only ever surfaces fresh listings or sales.

### Automate & schedule

Run this actor on autopilot and pull results into your own stack:

- **[Apify API](https://docs.apify.com/api/v2)** — start runs, fetch datasets, manage schedules over REST.
- **[apify-client for JavaScript](https://docs.apify.com/api/client/js/)** and **[apify-client for Python](https://docs.apify.com/api/client/python/)** — official SDKs.
- **[Schedules](https://docs.apify.com/platform/schedules)** — run it on a cron to keep your data fresh.
- **[Webhooks](https://docs.apify.com/platform/integrations/webhooks)** — trigger downstream actions the moment a run finishes.

```js
import { ApifyClient } from 'apify-client';

const client = new ApifyClient({ token: 'MY_APIFY_TOKEN' });

const run = await client.actor('scrapesage/ebay-scraper').call({
    mode: 'sold',
    searchQueries: ['nintendo switch oled'],
    condition: 'used',
    computeAnalytics: true,
    monitorMode: true,
    monitorKey: 'switch-oled-comps',
});

const { items } = await client.dataset(run.defaultDatasetId).listItems();
console.log(`Got ${items.length} records`);
```

### Integrate with any app

Connect the dataset to 5,000+ apps — no code required:

- **[Make](https://docs.apify.com/platform/integrations/make)** — multi-step automation scenarios.
- **[Zapier](https://docs.apify.com/platform/integrations/zapier)** — push new records into your CRM, sheet, or repricer.
- **[Slack](https://docs.apify.com/platform/integrations/slack)** — get notified when a run finds something new.
- **[Google Drive / Sheets](https://docs.apify.com/platform/integrations/drive)** — auto-export every run to a spreadsheet.
- **[Airbyte](https://docs.apify.com/platform/integrations/airbyte)** — pipe results into your data warehouse.
- **[GitHub](https://docs.apify.com/platform/integrations/github)** — trigger runs from commits or releases.

### Use with AI assistants (MCP)

The output is clean, LLM-ready JSON. Call this actor from Claude, ChatGPT, or any agent framework through the **[Apify MCP server](https://docs.apify.com/platform/integrations/mcp)** — ask your assistant to "find sold prices for a sealed Nintendo Switch OLED on eBay and tell me the median and a good list price" and let it run this scraper for you.

### Agent-ready: autonomous payments (x402 & Skyfire)

This actor is **agent-ready** — AI agents can discover it, run it, and **pay for it autonomously**, with no Apify account and no human in the loop. It uses [pay-per-event](https://docs.apify.com/platform/actors/publishing/monetize/pay-per-event) pricing and [limited permissions](https://docs.apify.com/platform/actors/development/permissions), so it qualifies for Apify's agentic-payment standards:

- **[x402](https://docs.apify.com/platform/integrations/x402)** — an open, HTTP-native payment protocol. Agents pay per run in USDC on the Base network directly through the [Apify MCP server](https://docs.apify.com/platform/integrations/mcp) — no account, no API key.
- **[Skyfire](https://docs.apify.com/platform/integrations/skyfire)** — agent-to-service payments for fully autonomous AI-agent workflows.

Building an AI agent, MCP tool, or autonomous data pipeline? This scraper is ready to plug in and pay as it goes.

### More scrapers from scrapesage

Pair eBay with other marketplace, price and lead-gen scrapers:

- [reverb-scraper](https://apify.com/scrapesage/reverb-scraper) — musical-instrument marketplace listings, prices & seller leads
- [shopify-store-scraper](https://apify.com/scrapesage/shopify-store-scraper) — Shopify storefront products, variants & prices
- [made-in-china-scraper](https://apify.com/scrapesage/made-in-china-scraper) — B2B supplier products & manufacturer leads
- [tradeindia-scraper](https://apify.com/scrapesage/tradeindia-scraper) — India B2B suppliers, manufacturers & leads
- [importyeti-scraper](https://apify.com/scrapesage/importyeti-scraper) — US import records, suppliers & B2B leads
- [craigslist-scraper](https://apify.com/scrapesage/craigslist-scraper) — classifieds listings, prices & contact leads
- [sgcarmart-used-car-scraper](https://apify.com/scrapesage/sgcarmart-used-car-scraper) — used-vehicle marketplace prices & dealer leads
- [steam-scraper](https://apify.com/scrapesage/steam-scraper) — game store prices, reviews & charts

### Tips

- For resale comps, use **mode = `sold`** with **computeAnalytics** on — you get every recent sale *and* a min/max/average/median summary with a recommended list price.
- Keep **Residential proxy** on (the default). eBay blocks datacenter IPs, so datacenter runs will return little or nothing.
- Narrow with **condition**, **priceMin/Max**, **listingType** and **categoryId** to get cleaner comps and avoid unrelated items.
- Turn on **enrichItemDetails** only when you need brand/MPN/GTIN/ratings/photos/seller — it adds one request per item.
- Use a distinct **monitorKey** per saved search so each watch keeps its own memory.

### FAQ

- **Does it need my eBay login or an API key?** No. It reads eBay's public pages — no account, cookies or developer key.
- **Can I get *sold* prices?** Yes — that's the headline feature. Use Sold mode for real completed-listing prices with the sold date, plus optional analytics.
- **Why residential proxy?** eBay returns HTTP 403 to datacenter IPs. Residential proxy (the default) is required for reliable results.
- **Which marketplaces?** US, UK, DE, AU, CA, FR, IT, ES, NL and IE — set with the **marketplace** input; prices use the local currency.
- **How do I get seller contact details?** Use **Seller** mode or **emitSellerLeads** — eBay masks email/phone, so leads carry the seller's username, feedback, items sold, location and a lead score.
- **Are there exports?** Yes — JSON, CSV, Excel, XML and RSS, plus the API and 5,000+ integrations.
- **Is this legal?** It collects publicly available marketplace and business listings only — no private personal data.

### Need help?

Open an issue on the actor's **Issues** tab, or visit the [Apify help center](https://help.apify.com/). Feature requests are welcome — this actor is actively maintained.

# Actor input Schema

## `mode` (type: `string`):

<b>Active listings</b> = items currently for sale (the default). <b>Sold / completed</b> = real sold prices (comps) — what items actually sold for, with the sold date. <b>Item detail</b> = full data for specific item URLs (brand, MPN, GTIN, ratings, all photos, seller). <b>Seller</b> = a seller's full inventory + a B2B lead profile (feedback, items sold, location).

## `searchQueries` (type: `array`):

Keywords to search on eBay, e.g. <code>nintendo switch oled</code>, <code>iphone 15 pro</code>, <code>vintage rolex</code>, <code>pokemon booster box</code>. Each is combined with the filters below. Leave empty to browse a whole category (set <b>Category ID</b>).

## `startUrls` (type: `array`):

Paste eBay URLs directly: search pages (<code>ebay.com/sch/i.html?\_nkw=...</code>), item pages (<code>ebay.com/itm/123...</code>), or seller pages (<code>ebay.com/usr/\<name></code>, <code>ebay.com/str/\<store></code>). Used in addition to the keywords above.

## `sellerNames` (type: `array`):

eBay seller usernames to scrape in <b>Seller</b> mode, e.g. <code>musicstore\_official</code>. The actor pulls each seller's active inventory and a lead profile.

## `marketplace` (type: `string`):

Which eBay site to search. Controls the domain and default currency.

## `categoryId` (type: `string`):

Optional eBay category id (<code>\_sacat</code>) to scope the search, e.g. <code>139971</code> (Video Game Consoles). Find it in any eBay search URL.

## `condition` (type: `string`):

Filter by item condition.

## `listingType` (type: `string`):

Restrict to auctions or fixed-price (Buy It Now) listings.

## `priceMin` (type: `integer`):

Only items at or above this price (in the marketplace currency).

## `priceMax` (type: `integer`):

Only items at or below this price.

## `freeShippingOnly` (type: `boolean`):

Only return listings that ship for free.

## `sort` (type: `string`):

How to order results. For Sold mode, "Newest" surfaces the most recently sold.

## `enrichItemDetails` (type: `boolean`):

For each listing, open its item page to add brand, model, MPN, GTIN/UPC, color, product rating, high-resolution photos, payment methods, the seller (username + feedback) and quantity sold/watchers. Adds one request per item.

## `emitSellerLeads` (type: `boolean`):

Output one deduplicated seller-lead record (type = "seller") for every unique seller found — with positive-feedback %, feedback score, items sold, location, member-since and a 0–100 lead score. (In Active/Sold modes this requires item-detail enrichment to discover sellers.)

## `computeAnalytics` (type: `boolean`):

In Sold mode, add one summary record per query with min / max / average / median sold price, the sold-date range, an estimated sold-per-day rate and a recommended list price — instant resale comps.

## `maxItems` (type: `integer`):

Maximum number of listings (or sold items) to scrape across all queries. eBay paginates up to ~240/page.

## `maxSellers` (type: `integer`):

Maximum number of seller-lead profiles to fetch (Seller mode, or when "emit seller-lead records" is on).

## `deduplicateResults` (type: `boolean`):

Skip records already emitted in this run (recommended).

## `monitorMode` (type: `boolean`):

Remember item/seller ids across runs in a named key-value store and emit ONLY records not seen before — new listings, newly sold items, or new sellers. Perfect for deal alerts and price-watching. Works with Apify Schedules.

## `monitorKey` (type: `string`):

Names the memory used by monitoring mode. Use a distinct key per saved search so different watches keep separate state.

## `maxConcurrency` (type: `integer`):

Maximum parallel requests. eBay needs residential IPs; 3–6 is a good balance of speed and reliability.

## `proxyConfiguration` (type: `object`):

Proxy settings. eBay blocks datacenter IPs, so RESIDENTIAL proxy is the default and is strongly recommended.

## Actor input object example

```json
{
  "mode": "search",
  "searchQueries": [
    "nintendo switch oled"
  ],
  "marketplace": "US",
  "condition": "any",
  "listingType": "all",
  "freeShippingOnly": false,
  "sort": "best_match",
  "enrichItemDetails": false,
  "emitSellerLeads": false,
  "computeAnalytics": false,
  "maxItems": 100,
  "maxSellers": 50,
  "deduplicateResults": true,
  "monitorMode": false,
  "monitorKey": "default",
  "maxConcurrency": 4,
  "proxyConfiguration": {
    "useApifyProxy": true
  }
}
```

# Actor output Schema

## `results` (type: `string`):

All scraped records as JSON items in the default dataset.

# API

You can run this Actor programmatically using our API. Below are code examples in JavaScript, Python, and CLI, as well as the OpenAPI specification and MCP server setup.

## JavaScript example

```javascript
import { ApifyClient } from 'apify-client';

// Initialize the ApifyClient with your Apify API token
// Replace the '<YOUR_API_TOKEN>' with your token
const client = new ApifyClient({
    token: '<YOUR_API_TOKEN>',
});

// Prepare Actor input
const input = {
    "searchQueries": [
        "nintendo switch oled"
    ],
    "proxyConfiguration": {
        "useApifyProxy": true
    }
};

// Run the Actor and wait for it to finish
const run = await client.actor("scrapesage/ebay-scraper").call(input);

// Fetch and print Actor results from the run's dataset (if any)
console.log('Results from dataset');
console.log(`💾 Check your data here: https://console.apify.com/storage/datasets/${run.defaultDatasetId}`);
const { items } = await client.dataset(run.defaultDatasetId).listItems();
items.forEach((item) => {
    console.dir(item);
});

// 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/js/docs

```

## Python example

```python
from apify_client import ApifyClient

# Initialize the ApifyClient with your Apify API token
# Replace '<YOUR_API_TOKEN>' with your token.
client = ApifyClient("<YOUR_API_TOKEN>")

# Prepare the Actor input
run_input = {
    "searchQueries": ["nintendo switch oled"],
    "proxyConfiguration": { "useApifyProxy": True },
}

# Run the Actor and wait for it to finish
run = client.actor("scrapesage/ebay-scraper").call(run_input=run_input)

# Fetch and print Actor results from the run's dataset (if there are any)
print("💾 Check your data here: https://console.apify.com/storage/datasets/" + run["defaultDatasetId"])
for item in client.dataset(run["defaultDatasetId"]).iterate_items():
    print(item)

# 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/python/docs/quick-start

```

## CLI example

```bash
echo '{
  "searchQueries": [
    "nintendo switch oled"
  ],
  "proxyConfiguration": {
    "useApifyProxy": true
  }
}' |
apify call scrapesage/ebay-scraper --silent --output-dataset

```

## MCP server setup

```json
{
    "mcpServers": {
        "apify": {
            "command": "npx",
            "args": [
                "mcp-remote",
                "https://mcp.apify.com/?tools=scrapesage/ebay-scraper",
                "--header",
                "Authorization: Bearer <YOUR_API_TOKEN>"
            ]
        }
    }
}

```

## OpenAPI specification

Download the OpenAPI definition: https://api.apify.com/v2/acts/BtR5IYOJtaQQgMxjE/builds/j8WwGq8fde3c3T5g8/openapi.json