# eBay Items Scraper — Active Listings, No API Key (`jamhimself/ebay-items-scraper`) Actor

Scrape eBay active listings as clean JSON: title, price, condition, shipping, auction/Buy-It-Now format, and URL. Sort and filter by condition, price, free shipping. Bulk, pay per item, no API key.

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

## Pricing

$5.00 / 1,000 item 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 Items Scraper — Active Listings, Prices & Filters, No API Key

Scrape **eBay active listings** into clean JSON — no login, no API key. Search any keyword, sort and filter (condition, price range, Buy-It-Now, free shipping), and get structured rows with title, price, condition, shipping, auction/Buy-It-Now format, and a direct link to every listing.

Built for reliability: warm-session + US residential engine, health-monitored daily and patched fast when eBay changes. Output is structured for spreadsheets, price monitoring, and LLM/RAG pipelines.

### ⚡ Quick start

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

```json
{
  "searchQuery": "mechanical keyboard",
  "maxResults": 60,
  "sortOrder": "best_match",
  "condition": "all"
}
```

Each result row looks like:

```json
{
  "title": "Keychron K8 Wireless Mechanical Keyboard RGB Hot-Swappable",
  "price": 74.99,
  "priceRaw": "$74.99",
  "currency": "$",
  "condition": "Brand New",
  "format": "BuyItNow",
  "bids": null,
  "shipping": "Free shipping",
  "unitsSold": 128,
  "itemUrl": "https://www.ebay.com/itm/335678901234",
  "imageUrl": "https://i.ebayimg.com/images/g/abcAAOSw.../s-l500.jpg"
}
```

Or run it from the API:

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

### Input options

| Field | Type | Description |
|---|---|---|
| `searchQuery` | string (required) | What to search eBay for |
| `maxResults` | integer | Max listings to return (default 60) |
| `sortOrder` | enum | `best_match`, `newly_listed`, `ending_soonest`, `price_asc`, `price_desc` |
| `condition` | enum | `all`, `new`, `used` |
| `buyItNowOnly` | boolean | Exclude auctions |
| `freeShippingOnly` | boolean | Only free-shipping listings |
| `minPrice` / `maxPrice` | integer | Price range filter (USD) |

### Output fields

Every row includes: `title`, `price`, `priceRaw`, `currency`, `condition`, `format` (Auction/BuyItNow), `bids` (auctions), `shipping`, `unitsSold` (when shown), `itemUrl`, `imageUrl`.

### Use cases

- **Price & competitor monitoring** — track active listing prices, formats, and shipping for any product.
- **Resale & arbitrage** — pair with sold-history data to spot margin.
- **AI agents & RAG** — feed structured, deduplicated listing rows into agent pipelines (this Actor is agent-payable).

### Related Actors

Need **real transaction prices** instead of active asking prices? Use [eBay Sold Listings Scraper](https://apify.com/jamhimself/ebay-sold-listings-scraper) — sold & completed history that eBay's free APIs don't expose.

***

Found an issue or need another field or filter? **Open an issue on this Actor** — it's actively maintained and issues get fixed fast. If this Actor saves you time, a ⭐ review helps others find it.

# Actor input Schema

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

What to search eBay for, e.g. "mechanical keyboard" or "vintage omega seamaster". Returns matching active listings.

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

Maximum number of active listings to return.

## `sortOrder` (type: `string`):

How to sort results.

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

Filter by item condition.

## `buyItNowOnly` (type: `boolean`):

Only fixed-price (Buy It Now) listings, excluding auctions.

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

Only listings with free shipping.

## `minPrice` (type: `integer`):

Only listings at or above this price. Leave empty for no minimum.

## `maxPrice` (type: `integer`):

Only listings at or below this price. Leave empty for no maximum.

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

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

## Actor input object example

```json
{
  "searchQuery": "mechanical keyboard",
  "maxResults": 60,
  "sortOrder": "best_match",
  "condition": "all",
  "buyItNowOnly": false,
  "freeShippingOnly": false,
  "proxyConfiguration": {
    "useApifyProxy": true,
    "apifyProxyGroups": [
      "RESIDENTIAL"
    ],
    "apifyProxyCountry": "US"
  }
}
```

# Actor output Schema

## `items` (type: `string`):

One row per active listing: title, price, condition, shipping, format, 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": "mechanical keyboard",
    "proxyConfiguration": {
        "useApifyProxy": true,
        "apifyProxyGroups": [
            "RESIDENTIAL"
        ],
        "apifyProxyCountry": "US"
    }
};

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

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

```

## MCP server setup

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

```

## OpenAPI specification

Download the OpenAPI definition: https://api.apify.com/v2/actors/6PWgPXgoLzz0a4zAd/builds/Ib9oB2nRqenazH47Y/openapi.json