# eBay Sold Listings Scraper — Sold Prices & Dates, No API Key (`jamhimself/ebay-sold-listings-scraper`) Actor

Scrape eBay sold & completed listings — real sold prices, sold dates, condition & item URLs for price comps and resale valuation. No API key, no login, bulk, pay per result.

- **URL**: https://apify.com/jamhimself/ebay-sold-listings-scraper.md
- **Developed by:** [Jaime Martinez](https://apify.com/jamhimself) (community)
- **Categories:** E-commerce, Agents, Developer tools
- **Stats:** 3 total users, 2 monthly users, 84.8% runs succeeded, 0 bookmarks
- **User rating**: No ratings yet

## Pricing

$5.00 / 1,000 product results

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 Sold Listings Scraper (No API Key)

Scrape eBay **sold and completed listings** — real **sold prices**, sold dates, and condition for any search term, exported as clean JSON/CSV/Excel. Get the actual transaction data buyers paid for **price comps, resale valuation, and market research** — with **no API key, no login**, bulk-ready and **pay per result**. Each row returns `title`, `price`, `soldDate`, `condition`, `currency`, `itemUrl`, and `imageUrl`. Built for resellers, flippers, dropshippers, collectors, and analysts who need eBay completed-listings price history at scale.

Sold-item price history is **not exposed by eBay's free Finding or Browse APIs**, so scraping the completed-listings view is the only way to pull this data in bulk — that is the durable value here.

Reliability: requests use browser-grade TLS/header fingerprinting (got-scraping), **US residential proxies**, an eBay homepage **cookie warm-up**, and automatic **session rotation** on proxy/network errors, so search pages return real results instead of soft-blocks.

### ⚡ Quick start

Paste this into the Actor's **Input** (JSON view) and hit **Start**:

```json
{
  "searchQuery": "nintendo switch",
  "maxResults": 50
}
```

Each result row looks like:

```json
{
  "title": "Nintendo Switch OLED Model 64GB Console - White",
  "price": 189.99,
  "priceRaw": "$189.99",
  "currency": "$",
  "soldDate": "Jul 2, 2026",
  "condition": "Pre-owned",
  "itemUrl": "https://www.ebay.com/itm/145678901234",
  "imageUrl": "https://i.ebayimg.com/images/g/abc/s-l500.jpg"
}
```

Or run it from the API:

```
POST https://api.apify.com/v2/acts/jamhimself~ebay-sold-listings-scraper/run-sync-get-dataset-items?token=YOUR_APIFY_TOKEN
```

### What you get

Each dataset item is one sold/completed eBay listing:

| Field | Type | Description |
|-------|------|-------------|
| `title` | string | Listing title (cleaned) |
| `price` | number | Actual sold price, parsed to a number |
| `priceRaw` | string | Original price text as shown (e.g. `$842.00`, ranges preserved) |
| `currency` | string | Currency symbol — `$`, `£`, `€` |
| `soldDate` | string | Date the item sold (e.g. `Jun 28, 2026`) |
| `condition` | string | Item condition — e.g. `Brand New`, `Pre-owned` |
| `itemUrl` | string | Direct link to the eBay listing |
| `imageUrl` | string | Listing thumbnail image URL |

### Use cases

- **eBay price comps & resale valuation** — pull real sold prices to value inventory, trade-ins, or one-off collectibles with no fixed market price.
- **Reseller & flipper pricing** — see what items actually sold for before you list, so you price to sell instead of guessing from asking prices.
- **Sourcing & dropshipping research** — validate demand and real sale prices for a product before you buy or list it.
- **Price tracking & trend analysis** — snapshot sold prices and sold dates over time to chart demand and seasonality for a niche.
- **Competitor & market research** — monitor completed-listings prices across a category, brand, or keyword to size a market.
- **Dataset building & LLM/RAG feeds** — export structured sold-price history as JSON/CSV to feed pricing models, spreadsheets, or an AI knowledge base.

### Input

| Field | Type | Required | Default | Description |
|-------|------|----------|---------|-------------|
| `searchQuery` | string | Yes | `nintendo switch oled` | What to search eBay for, e.g. `vintage omega seamaster`. |
| `maxResults` | integer | No | `50` | Max sold listings to return (1–2000). |
| `soldOnly` | boolean | No | `true` | On = sold/completed only (real transaction prices). Off = include active listings. |
| `proxyConfiguration` | object | No | US `RESIDENTIAL` | Proxy settings. eBay blocks datacenter IPs, so US residential is strongly recommended. |

### Pricing

Pay per sold listing delivered. No subscription. If the Actor saves you time, a quick review on the Store page is genuinely appreciated and helps other buyers find it.

# Actor input Schema

## `searchQuery` (type: `string`):

What to search eBay for, e.g. "nintendo switch oled" or "vintage omega seamaster". The scraper returns matching sold & completed listings.

## `maxResults` (type: `integer`):

Maximum number of sold listings to return.

## `soldOnly` (type: `boolean`):

When on, returns only sold/completed listings (real transaction prices). Turn off to include active listings.

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

Proxy settings. eBay blocks datacenter IPs, so RESIDENTIAL proxies are strongly recommended for reliable results.

## Actor input object example

```json
{
  "searchQuery": "nintendo switch oled",
  "maxResults": 50,
  "soldOnly": true,
  "proxyConfiguration": {
    "useApifyProxy": true,
    "apifyProxyGroups": [
      "RESIDENTIAL"
    ],
    "apifyProxyCountry": "US"
  }
}
```

# Actor output Schema

## `soldListings` (type: `string`):

One row per sold listing: title, sold price, date, condition, and URL.

# 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 = {
    "searchQuery": "nintendo switch oled",
    "proxyConfiguration": {
        "useApifyProxy": true,
        "apifyProxyGroups": [
            "RESIDENTIAL"
        ],
        "apifyProxyCountry": "US"
    }
};

// Run the Actor and wait for it to finish
const run = await client.actor("jamhimself/ebay-sold-listings-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 = {
    "searchQuery": "nintendo switch oled",
    "proxyConfiguration": {
        "useApifyProxy": True,
        "apifyProxyGroups": ["RESIDENTIAL"],
        "apifyProxyCountry": "US",
    },
}

# Run the Actor and wait for it to finish
run = client.actor("jamhimself/ebay-sold-listings-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 '{
  "searchQuery": "nintendo switch oled",
  "proxyConfiguration": {
    "useApifyProxy": true,
    "apifyProxyGroups": [
      "RESIDENTIAL"
    ],
    "apifyProxyCountry": "US"
  }
}' |
apify call jamhimself/ebay-sold-listings-scraper --silent --output-dataset

```

## MCP server setup

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

```

## OpenAPI specification

Download the OpenAPI definition: https://api.apify.com/v2/acts/7SAIb00eDJ7dcDBv9/builds/QPDbpeJcYMoggT5pW/openapi.json