# eBay Sold Items Scraper 🔥 $0.60/1K Resale Comps ⚡ (`azzouzana/ebay-sold-comps-scraper`) Actor

From $0.60/1K 💰 Scrape confirmed eBay sold items, sold prices, dates & resale comps! Built for flippers & collectors (Pokemon, sneakers, electronics). Optional Best Offer Price. Toggle all completed listings to compute sell-through rates. Export JSON, CSV, Excel. Start now! 🚀

- **URL**: https://apify.com/azzouzana/ebay-sold-comps-scraper.md
- **Developed by:** [Azzouzana](https://apify.com/azzouzana) (community)
- **Categories:** E-commerce, Lead generation
- **Features:** Limited permissions
- **Stats:** 8 total users, 7 monthly users, 93.9% runs succeeded, 0 bookmarks
- **User rating**: No ratings yet

## Pricing

from $0.60 / 1,000 sold comp listings

This Actor is paid per event. You are not charged for the Apify platform usage, but only a fixed price for specific events.
Since this Actor supports Apify Store discounts, the price gets lower the higher subscription plan you have.

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

## What's an Apify Actor?

An Actor is a serverless cloud program that runs on the Apify platform. It has two run modes.
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.

Apify vocabulary and the platform model are defined once, in the agent quickstart at https://apify.com/agents.md.

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

Do not guess an integration path. Every one of them is in the agent quickstart at https://apify.com/agents.md: the Apify MCP server, Agent Skills with the Apify CLI, the JavaScript and Python clients, the REST API, and the account-free path for an agent with no human to sign in. It also carries the rule on stating cost before the first paid run.

For examples already wired to this Actor's own input schema, see the [API](#api) section below.

Each client library has reference documentation the quickstart does not restate: [JavaScript/TypeScript](https://docs.apify.com/api/client/js/docs.md) (`npm install apify-client`) and [Python](https://docs.apify.com/api/client/python/docs.md) (`pip install apify-client`).

# README

## eBay Sold Items & Completed Listings Scraper — Real Sold Prices & Resale Comps

Fast, structured eBay sold listings and resale comps scraper. Extract real historical sold prices, transaction dates, condition metrics, and completed listings across global eBay marketplaces.

***

### ⚡ Why Use This Sold Comps Scraper?

- **Real Confirmed Sales**: Extracts actual transaction prices and sold dates, not just asking prices.
- **Sell-Through Rate (STR) Analysis**: Toggle `includeUnsold` to analyze both sold and unsold completed listings to compute real market demand and absorption rates.
- **Total Acquisition Cost**: Automatically computes `totalPriceWithShipping` (final sold price + shipping postage) so resellers know exact historical margins.
- **Auction vs Buy It Now**: Captures final winning auction bids, total bid counts, or Buy It Now transactions.
- **Deep Item Specifics (`fetchFullDetails`)**: Enriches listings in parallel with complete technical specifications, clean HTML-stripped descriptions, and high-resolution photos.
- **Multi-Marketplace Comps**: Check historical sold prices in the US, UK, Germany, France, Italy, Spain, Australia, and Canada with localized currencies.

***

### ▶️ How to Get Started

1. 👉 [**Create a free Apify account**](https://apify.com/sign-up?fpr=cbgdsf) — **no credit card required!** (Includes $5 free monthly credits).
2. Open [**eBay Sold Comps Scraper**](https://apify.com/azzouzana/ebay-sold-comps-scraper) in your Apify Console.
3. Enter your product keywords (e.g. `pokemon 151 booster box`) into **`target`**.
4. Click **Start** and export real sold comps to JSON, CSV, or Excel.

***

### 🛠️ Input Parameters

| Field | Type | Required | Description |
|---|---|---|---|
| `target` | String | **Yes** | **Product Query**: Enter search keywords (`pokemon 151 booster box`), barcode (`upc:045496590420` or `ean:0711719541523`), an eBay item ID, or paste an existing eBay sold search URL. |
| `includeUnsold` | Boolean | No | **Include Unsold / Ended Listings**: When `false` (default), returns only confirmed **Sold** items (`LH_Sold=1`). When `true`, returns all completed listings (both sold and unsold) to calculate sell-through rates. |
| `maxItems` | Integer | **Yes** | Maximum sold comps to collect (default: `100`). |
| `fetchFullDetails` | Boolean | No | When enabled, enriches listings with full Item Specifics, clean descriptions, and high-res images in parallel (default: `false`). |
| `condition` | String | No | Filter comps by item condition: `new`, `open_box`, `refurbished`, `used`. |
| `buyingFormat` | String | No | Filter by `buy_it_now` or `auction` (with bid counts). |
| `minPrice` | Number | No | Filter comps with sold price above or equal to this amount. |
| `maxPrice` | Number | No | Filter comps with sold price below or equal to this amount. |
| `freeShipping` | Boolean | No | Only return sales offering free delivery. |
| `marketplace` | String | No | Regional marketplace (e.g. `EBAY-US`, `EBAY-GB`, `EBAY-DE`). Default: auto-detects from URL or US. |
| `sortBy` | String | No | Sort order: `ended_recently` (default for freshest comps), `lowest_price`, `highest_price`, `newly_listed`. |

> \[!IMPORTANT]
> **Barcode Search vs eBay Item ID Format Requirement**:
>
> - **Barcodes (UPC, EAN, ISBN)**: **Must** be preceded by `upc:` or `ean:` (e.g. `upc:045496590420` or `ean:0711719541523`).
> - **Raw Numbers**: Any unadorned 9 to 14-digit number (e.g. `257388279541`) is strictly treated as a specific eBay Item ID. Always use the `upc:` or `ean:` prefix when scanning retail packaging barcodes to search sold comps.

***

### 📋 JSON Input Examples

#### 1. Collectibles & Trading Cards (Pokemon / Sports Cards)

Track real market comps for collectible cards with recently ended sales:

```json
{
  "target": "charizard ex 199/165 special illustration rare",
  "maxItems": 50,
  "condition": "new",
  "sortBy": "ended_recently",
  "fetchFullDetails": false
}
```

#### 2. Sell-Through Rate (STR) Analysis (Sold vs Unsold)

Analyze market absorption by fetching both sold and unsold completed listings:

```json
{
  "target": "sony wh-1000xm4 headphones",
  "maxItems": 100,
  "includeUnsold": true,
  "sortBy": "ended_recently",
  "fetchFullDetails": false
}
```

#### 3. Electronics & Smartphone Flipping Comps

Check historical price bands for refurbished and used electronics:

```json
{
  "target": "iphone 14 pro 128gb unlocked",
  "maxItems": 50,
  "condition": "refurbished",
  "buyingFormat": "buy_it_now",
  "minPrice": 350,
  "maxPrice": 600,
  "fetchFullDetails": false
}
```

#### 4. Sneaker & Streetwear Resale Valuation

Find winning auction sales and Buy It Now transaction history:

```json
{
  "target": "jordan 4 retro military blue size 10",
  "maxItems": 50,
  "condition": "new",
  "freeShipping": true,
  "fetchFullDetails": true
}
```

#### 5. International European Market Comps (UK / Germany)

Benchmark sold comps on international eBay domains:

```json
{
  "target": "omega seamaster professional 300m",
  "maxItems": 40,
  "marketplace": "EBAY-GB",
  "sortBy": "ended_recently",
  "fetchFullDetails": false
}
```

#### 6. Retail Barcode & UPC Scanning (In-Store Resale Flipping)

Check sold comps instantly by scanning product packaging barcodes:

```json
{
  "target": "upc:045496590420",
  "maxItems": 50,
  "sortBy": "ended_recently"
}
```

***

### 📊 Output Dataset

Each record represents a completed or sold comp with zero nested clutter: (A highlight )

| Field | Type | Description |
|---|---|---|
| `itemId` | String | Unique eBay item ID. |
| `title` | String | Listing title. |
| `url` | String | Canonical listing URL. |
| `price` | Number | Final sold price (or final asking price if unsold). |
| `currency` | String | Three-letter currency code (`USD`, `GBP`, `EUR`, `AUD`, `CAD`). |
| `priceDisplay` | String | Formatted sold price (e.g. `$145.00`). |
| `shippingCost` | Number | Shipping postage paid (0 if free shipping). |
| `isFreeShipping` | Boolean | `true` if free shipping was offered. |
| `totalPriceWithShipping` | Number | **Total Acquisition Cost**: `price + shippingCost`. |
| `isSold` | Boolean | `true` if confirmed sold; `false` if ended unsold. |
| `isBestOfferAccepted` | Boolean | `true` on a sold listing that shows Best offer accepted. When the item page includes the accepted amount, `price` is that amount and `originalPrice` is the asking price. That amount is not always available, so `price` can stay the search price. |
| `soldDate` | String | Confirmed sale or ending date string. |
| `condition` | String | Condition (`Brand New`, `Pre-Owned`, `Refurbished`). |
| `conditionDetails` | String | Seller notes on condition. |
| `buyingFormat` | String | `BUY_IT_NOW` or `AUCTION`. |
| `bidCount` | Integer | Total bids placed (for auction sales). |
| `watchCount` | Integer | Final buyer watchers count. |
| `sellerUsername` | String | Seller username. |
| `sellerFeedbackScore` | Integer | Seller feedback score. |
| `sellerPositivePercent` | String | Seller positive feedback percentage. |
| `itemLocation` | String | Physical item location. |
| `imageUrl` | String | Primary high-res photo URL. |
| `scrapedAt` | String | ISO 8601 timestamp. |
| `spec_<Name>` | String | Flattened Item Specifics *(when fetchFullDetails is on)*. |
| `sellerDescription` | String | Clean plain-text seller description *(when fetchFullDetails is on)*. |

***

### 🚀 Use Cases

- **Resale & Thrift Arbitrage**: Check real historical market value before sourcing inventory at estate sales or thrift stores.
- **TCG & Sports Card Appraisals**: Determine the true market value of raw and graded cards based on actual completed transactions.
- **Sell-Through Rate Calculation**: Compute the ratio of sold listings vs unsold completed listings to identify high-demand categories.
- **Cross-Border Resale**: Compare sold prices across US, UK, and European marketplaces to identify international arbitrage opportunities.

***

### 🔗 Related eBay Scraping Tools

Looking for other specialized eBay scraping tools? Explore the rest of our suite:

- [**eBay Scraper (All-In-One Search & Details)**](https://apify.com/azzouzana/ebay-scraper) — The foundational workhorse scraper for live active listings, complex eBay search URLs, full technical specifications, and high-resolution photo galleries.
- [**eBay Seller Store & Competitor Inventory Scraper**](https://apify.com/azzouzana/ebay-seller-store-scraper) — Extract and monitor complete seller store catalogs, inventory stock counts, out-of-stock items, and newly listed inventory drops.
- [**eBay Trending Products & Buyer Demand Hunter**](https://apify.com/azzouzana/ebay-trending-products-hunter) — Discover high-velocity winning products with real-time buyer demand signals: items in cart, 24-hour page views, sales velocity, and watcher counts.
- [**eBay Sellers Reviews Scraper PRO**](https://apify.com/azzouzana/ebay-feedback-profile-scraper) — Extract complete seller feedback profiles, positive/negative reviews, buyer comments, ratings, and verified purchase context across +20 eBay markets.

***

### 🔎 SEO Keywords

eBay sold comps, eBay sold listings scraper, eBay historical sold prices, eBay resale comps, eBay completed listings, sell-through rate eBay, pokemon card sold prices, sneaker resale comps, eBay price guide, eBay valuation tool, sports card sold comps, eBay arbitrage tracker, export eBay sold items to CSV Excel.

***

### Contact 📬

**Need a custom filter, dedicated integration, or feature request?**\
We'd love to hear from you!

- 💬 **Discord**: `@azzouzana`
- 📧 **Email**: <labs@azzouzana.com>

***

### ⚠️ Disclaimer

This actor is an **independent tool** and is **not affiliated with, endorsed by, or sponsored by** eBay Inc. or any of its subsidiaries. **eBay** and related marks are registered trademarks of eBay Inc.

# Actor input Schema

## `target` (type: `string`):

Enter search keywords (e.g. 'pokemon 151 booster box'), a prefixed barcode (e.g. 'upc:045496590420' or 'ean:0711719541523'), an eBay item ID, or paste a sold search URL. Barcodes must be prefixed with upc: or ean:.

## `includeUnsold` (type: `boolean`):

When unchecked (default), returns only confirmed Sold sales (LH_Sold=1). When checked, returns all ended listings (both sold and unsold) to calculate sell-through rates and market demand.

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

Maximum completed listings to collect.

## `fetchFullDetails` (type: `boolean`):

When enabled, enriches listings with complete Item Specifics, clean HTML-stripped descriptions, high-res photos, and real-time popularity demand signals.

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

Filter comps by condition.

## `buyingFormat` (type: `string`):

Filter by auction sales or Buy It Now.

## `minPrice` (type: `number`):

Exclude comps below this price.

## `maxPrice` (type: `number`):

Exclude comps above this price.

## `freeShipping` (type: `boolean`):

Only return sales with free shipping.

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

Target eBay regional marketplace for localized sold currency.

## `sortBy` (type: `string`):

Sort order for sold comps.

## Actor input object example

```json
{
  "target": "pokemon 151 booster box",
  "includeUnsold": false,
  "maxItems": 100,
  "fetchFullDetails": false
}
```

# Actor output Schema

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

No description

# 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 = {
    "target": "pokemon 151 booster box",
    "includeUnsold": false,
    "maxItems": 100,
    "fetchFullDetails": false
};

// Run the Actor and wait for it to finish
const run = await client.actor("azzouzana/ebay-sold-comps-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 = {
    "target": "pokemon 151 booster box",
    "includeUnsold": False,
    "maxItems": 100,
    "fetchFullDetails": False,
}

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

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

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

```

## CLI example

```bash
echo '{
  "target": "pokemon 151 booster box",
  "includeUnsold": false,
  "maxItems": 100,
  "fetchFullDetails": false
}' |
apify call azzouzana/ebay-sold-comps-scraper --silent --output-dataset

```

## MCP server setup

```json
{
    "mcpServers": {
        "apify": {
            "type": "http",
            "url": "https://mcp.apify.com/?tools=fetch-actor-details,azzouzana/ebay-sold-comps-scraper"
        }
    }
}
```

The hosted server signs you in with OAuth on first connect, so no API token belongs in this config. Clients without OAuth support can send an `Authorization: Bearer <APIFY_API_TOKEN>` header instead, using a token from API & Integrations in Apify Console (https://console.apify.com/settings/integrations).

## OpenAPI specification

Download the OpenAPI definition: https://api.apify.com/v2/actors/JNx6y7zOxJYwbPQdW/builds/lwqAYsg0PczrW6vhg/openapi.json
