# eBay Scraper: Prices, Condition & Sellers (`themineworks/ebay-search-scraper`) Actor

Scrape eBay search listings: title, price, condition, delivery cost, item location, watchers, sold count and seller feedback. 8 eBay sites. No login, no API key.

- **URL**: https://apify.com/themineworks/ebay-search-scraper.md
- **Developed by:** [The Mine Works](https://apify.com/themineworks) (community)
- **Categories:** E-commerce
- **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, 0 bookmarks
- **User rating**: No ratings yet

## Pricing

from $0.50 / 1,000 listings

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/actors/running/actors-in-store.md#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: Prices, Condition & Sellers

🏆 Part of The Mine Works' 149-actor portfolio · 40,000+ runs · 200,000+ results delivered across our full distribution stack · 99.9%+ success rate

💰 $0.50 / 1,000 results.

> ⚡ Eight eBay marketplaces in one actor: US, UK, Germany, Australia, Canada,
> France, Italy, Spain. No login, no API key, no browser.
>
> [Browse all The Mine Works actors](https://apify.com/themineworks)

Scrape eBay search listings across eight eBay marketplaces. Title, price, condition, delivery cost, item location, watchers, sold count and seller feedback. No login, no API key, no browser.

✅ Title and price on 100% of records · ✅ Condition and item location · ✅ Seller feedback score · ✅ 8 eBay sites · ✅ No listings found, no per-listing charge

### Search any eBay marketplace

```json
{
  "queries": ["water bottle"],
  "site": "us",
  "maxItems": 200
}
```

Sites: `us` (ebay.com), `uk`, `de`, `au`, `ca`, `fr`, `it`, `es`.

### Compare the same product across countries

Run the same term against different marketplaces to see price and availability differences.

```json
{
  "queries": ["owala freesip 32oz"],
  "site": "uk",
  "maxItems": 100
}
```

### What you get for each listing

```json
{
  "item_id": "127823363122",
  "title": "Owala FreeSip 32oz Stainless Steel Water Bottle",
  "price": 22.99,
  "currency": "USD",
  "condition": "Brand New",
  "buying_format": "Buy It Now",
  "delivery": "+$6.24 delivery",
  "free_delivery": false,
  "item_location": "United States",
  "watchers": 12,
  "sold_count": 43,
  "seller_feedback_percent": 99.2,
  "item_url": "https://www.ebay.com/itm/127823363122"
}
```

| Field | Description |
| --- | --- |
| 🏷️ `title` | Listing title, with eBay's accessibility text stripped out |
| 💰 `price`, `currency`, `price_text` | Price as a sortable number, its currency, and the original formatted string |
| 📦 `condition` | Brand New, Pre-Owned, Refurbished and so on |
| 🔨 `buying_format` | Buy It Now or Auction |
| 🚚 `delivery`, `free_delivery` | Delivery cost line and whether it is free |
| 📍 `item_location` | Where the item ships from |
| 👀 `watchers`, `sold_count` | Demand signals, where eBay shows them |
| ⭐ `seller_feedback_percent` | Seller's positive feedback percentage |
| 🖼️ `image` | Listing image URL |

**On coverage:** title, price and currency come back on every listing. Condition, location and seller feedback appear on roughly 3 in 4, and watchers or sold counts only where eBay chooses to display them. Those gaps are eBay's, not missing parsing, and the fields are left null rather than guessed.

### A note on why other eBay scrapers return empty columns

eBay replaced its old search markup. The `s-item__title` and `s-item__price` selectors that most eBay scrapers were written against **no longer appear on the page at all**, so those scrapers return rows of nulls while still reporting success.

This actor is written against eBay's current card component, and every run logs a field-coverage line on its first page. If eBay renames things again, the run says so immediately instead of quietly delivering empty records.

### Common use cases

**Competitive price monitoring** across conditions and marketplaces.

**Resale and arbitrage research**, using sold counts and watchers as demand signals.

**Market research** on what a product actually sells for, new versus used.

**Seller intelligence**, via feedback scores alongside pricing.

### Pricing

| Event | Price | You pay when |
| --- | --- | --- |
| Listing | $0.0005 | An eBay listing lands in your dataset |
| Actor start | $0.005 per GB of memory, once per run | The actor starts running |

$0.50 per 1,000 listings. Flat pricing, the same on every Apify plan. A search
that returns nothing fires no listing charge.

### Run it on a schedule

1. Run once with the input you want repeated, then click **Save as a task**.
2. Turn on **Monitor mode** so later runs return only newly listed items.
3. In the Apify Console go to **Schedules** and add the saved task.

Nothing is charged just for a schedule existing.

### FAQ

**Do I need an eBay account or API key?**
No. Everything comes from public search results.

**Does it cover auctions as well as fixed price?**
Yes. The `buying_format` field distinguishes them.

**Why are watchers empty on most listings?**
eBay only surfaces a watcher count on some listings. Where it is not shown, the field is null rather than zero, so you can tell "none shown" from "genuinely zero".

**Is this GDPR compliant?**
It collects public marketplace listings and public seller feedback scores, not personal data.

### Use from Claude, ChatGPT and any MCP agent

```
https://mcp.apify.com/?tools=themineworks/ebay-search-scraper
```

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

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

const run = await client.actor('themineworks/ebay-search-scraper').call({
    queries: ['water bottle'],
    site: 'us',
    maxItems: 200,
});

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

### Part of the marketplace research suite

Pair this with [Etsy listing data](https://apify.com/themineworks/etsy-search-scraper)
for handmade and vintage price comparisons, so you can check a category across
both marketplaces before you list or reprice.

Keywords: eBay scraper, eBay price tracker, eBay search API, eBay listing data,
reseller price monitoring, eBay watcher count, eBay sold listings,
cross-marketplace price comparison

# Actor input Schema

## `queries` (type: `array`):

What to search eBay for. Each search term returns its own set of listings, e.g. "water bottle" or "vintage camera".

## `site` (type: `string`):

Which eBay marketplace to search.

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

Maximum listings to return across all queries. Default 50, maximum 2000.

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

Run on a schedule and get ONLY listings not delivered in a previous run. Keep the input the same across runs.

## Actor input object example

```json
{
  "queries": [
    "water bottle"
  ],
  "site": "us",
  "maxItems": 60,
  "monitorMode": 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 = {
    "queries": [
        "water bottle"
    ],
    "site": "us",
    "maxItems": 60
};

// Run the Actor and wait for it to finish
const run = await client.actor("themineworks/ebay-search-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 = {
    "queries": ["water bottle"],
    "site": "us",
    "maxItems": 60,
}

# Run the Actor and wait for it to finish
run = client.actor("themineworks/ebay-search-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 '{
  "queries": [
    "water bottle"
  ],
  "site": "us",
  "maxItems": 60
}' |
apify call themineworks/ebay-search-scraper --silent --output-dataset

```

## MCP server setup

```json
{
    "mcpServers": {
        "apify": {
            "type": "http",
            "url": "https://mcp.apify.com/?tools=fetch-actor-details,themineworks/ebay-search-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/iJCxQUuxjHa3MRoji/builds/DYAsBEGI49uycaWiY/openapi.json