# eBay Search Scraper | Listings, Prices & Sellers (`genial_candlestand/ebay-search-scraper-listings-prices`) Actor

Get active eBay listings by keyword or search URL: title, price or price range, original price, condition, shipping, seller feedback %, bids, watchers and sold count. Filters for category, condition, auction, price. No login.

- **URL**: https://apify.com/genial_candlestand/ebay-search-scraper-listings-prices.md
- **Developed by:** [Flowo](https://apify.com/genial_candlestand) (community)
- **Categories:** E-commerce, Lead generation
- **Features:** Limited permissions
- **Stats:** 2 total users, 1 monthly users, 68.8% runs succeeded, 0 bookmarks
- **User rating**: No ratings yet

## Pricing

from $1.96 / 1,000 ebay 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 Search Scraper — Active Listings, Prices, Sellers & Sold Counts

![eBay Search Scraper | Listings, Prices & Sellers](https://api.apify.com/v2/key-value-stores/Ll7RrWtDkZYOrBvfE/records/ebay-com-product-search-category-listings-banner-bbd67df0.png)

This actor returns active eBay listings from ebay.com search results as flat rows. Each row has the listing title, price (or price range), original price, condition, shipping cost, seller name with positive feedback percent, and the "N sold" counter. Enter keywords or paste eBay search URLs, no login needed.

### What does the eBay Search Scraper do?

It searches ebay.com for each keyword or search URL and saves every active listing found as one row. Per listing you get `price`, `priceMax` for variation listings with a price range, `originalPrice` (the struck-through price), `condition`, `listingType` (`auction` or `fixedPrice`), `bidsCount` and `timeLeft` for auctions, `bestOffer`, `shippingCost`, `freeReturns`, `location`, `sellerName`, `sellerPositivePercent`, `sellerFeedbackCount`, `soldCount`, `watchersCount`, `rating`, `imageUrl` and the `position` on the page.

**Sold and completed listings are not supported.** Since July 2026 eBay requires a sign-in for them, and this actor does not use a login. The only sales signal is the "N sold" counter (`soldCount`) that eBay shows on some multi-quantity fixed-price listings. It is empty on many cards.

### How to scrape eBay listings

![How eBay Search Scraper works: Builds an ebay.com search URL from each keyword and filter; Requests result pages over US residential proxy, 60 to 240 per page; Retries blocked pages on a fresh session](https://api.apify.com/v2/key-value-stores/Ll7RrWtDkZYOrBvfE/records/ebay-com-product-search-category-listings-how-f16b8ab2.png)

1. Open the actor and enter one or more **Search terms**, for example `lego technic`, or paste ebay.com search URLs into **eBay search URLs**.
2. Optionally set category ID, condition, buying format, price range, sort order and the maximum listings per search.
3. Click **Start**. Results appear in the dataset; export them as JSON, CSV or Excel, or read them through the Apify API.

### How much does it cost to scrape eBay?

Price per event by Apify plan:

| Event | Free | Bronze | Silver | Gold and above |
|---|---|---|---|---|
| eBay listing | $2.80 per 1,000 | $2.52 per 1,000 | $2.24 per 1,000 | $1.96 per 1,000 |
| Actor start | $0.00005 | $0.00005 | $0.00005 | $0.00005 |

A test run with the API example input below returned 100 rows in 15 s.

You pay per listing saved, plus a very small start fee. Duplicates (a listing found by two searches) and searches with no results are not charged. Examples at $2.80 per 1,000 listings:

- 100 listings of one search: about $0.28
- 1,000 listings: about $2.80
- 5 keywords x 1,000 listings: about $14
- 10,000 listings: about $28

Platform usage is included in the listing price. Use **Max listings in total** to cap the spend of a run.

### Input

![eBay Search Scraper input example: Search terms, Max listings per search, Condition, Buying format, Sort by, Listings per page](https://api.apify.com/v2/key-value-stores/Ll7RrWtDkZYOrBvfE/records/ebay-com-product-search-category-listings-input-9e521fbb.png)

- **Search terms** (`queries`) and/or **eBay search URLs** (`startUrls`). URLs must be ebay.com search pages with a keyword; eBay's own filters in the URL are kept.
- **Max listings per search** (`maxItemsPerQuery`, default 100, up to 10,000) and **Max listings in total** (`maxItems`).
- **Category ID** (`categoryId`), e.g. 31387 for Wristwatches.
- **Condition**: any, new, used.
- **Buying format**: all, auctions only, Buy It Now only.
- **Min price / Max price** in USD.
- **Sort by**: best match, lowest price, highest price, newly listed, ending soonest.
- **Listings per page**: 60, 120 or 240. 240 needs fewer requests for large searches.
- **Proxy**: US residential proxy is the default and the most reliable.

Example input:

```json
{
  "queries": ["iphone 13"],
  "condition": "used",
  "minPrice": 150,
  "maxPrice": 300,
  "sort": "priceLowest",
  "maxItemsPerQuery": 200
}
```

### What data do you get from eBay?

![eBay Search Scraper output example: Image, Title, Price, Currency, Condition, Type](https://api.apify.com/v2/key-value-stores/Ll7RrWtDkZYOrBvfE/records/ebay-com-product-search-category-listings-output-4f952dd4.png)

One row per listing. Real example (shortened):

```json
{
  "id": "278352937398",
  "url": "https://www.ebay.com/itm/278352937398",
  "title": "LEGO Technic Black Champion Racer (42026) - New - Sealed - FastShip!",
  "condition": "Brand New",
  "price": 26.99,
  "originalPrice": 29.99,
  "currency": "USD",
  "listingType": "fixedPrice",
  "bestOffer": true,
  "shippingCost": 13.65,
  "shippingText": "+$13.65 delivery",
  "freeReturns": true,
  "location": "United States",
  "sellerName": "2ndhandgaming",
  "sellerPositivePercent": 99.7,
  "sellerFeedbackCount": 4700,
  "query": "lego technic",
  "page": 1
}
```

Other fields: `subtitle`, `buyItNowPrice`, `priceText`, `bidsCount`, `timeLeft`, `soldCount`, `watchersCount`, `rating`, `reviewsCount`, `imageUrl`, `caption`, `badges`, `position`, `totalResults`, `scrapedAt`. Fields eBay does not show for a listing are `null`.

### Use cases

- Compare competing offers and price points for a product as a reseller or e-commerce seller.
- Track listings of your brand's products, including sellers and locations.
- Build price datasets by category, condition or buying format.
- Watch auctions by bids and time left, sorted by ending soonest.
- Spot sellers by feedback percent and feedback count.

### Limitations

- Active listings only: no sold or completed listings, no item detail pages (no item specifics or descriptions).
- Only ebay.com; other eBay country sites are rejected.
- Category browse pages, store pages and item URLs are not accepted as start URLs.
- `soldCount` is filled only where eBay shows an "N sold" counter.
- Price filters are in USD.
- eBay blocks requests without a proxy; some pages may stay blocked on a datacenter proxy.

### Tips and troubleshooting

- Keep the default US residential proxy. If a run fails with "blocked", it is the proxy type.
- For big searches set Listings per page to 240 and raise Max listings per search.
- Copy a filtered search from your browser into eBay search URLs to reuse eBay's own filters.
- A category ID needs a keyword or URL; there is no keyword-less category search.
- If a search has no results, the run finishes without charge for it.

### API, MCP and integrations

Run the actor from your code with the same JSON input as in Console. Your API token is in [Console → Settings → API & Integrations](https://console.apify.com/settings/integrations).

**Python** (`pip install apify-client`):

```python
from apify_client import ApifyClient

client = ApifyClient("YOUR_APIFY_TOKEN")
run = client.actor("genial_candlestand/ebay-search-scraper-listings-prices").call(run_input={"queries": ["lego technic"], "maxItemsPerQuery": 100})
for item in client.dataset(run["defaultDatasetId"]).iterate_items():
    print(item)
```

**Node.js** (`npm install apify-client`):

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

const client = new ApifyClient({ token: 'YOUR_APIFY_TOKEN' });
const run = await client.actor('genial_candlestand/ebay-search-scraper-listings-prices').call({"queries": ["lego technic"], "maxItemsPerQuery": 100});
const { items } = await client.dataset(run.defaultDatasetId).listItems();
console.log(items);
```

**HTTP** — one request runs the actor and returns the results (runs up to 5 minutes; longer ones: [run asynchronously](https://docs.apify.com/api/v2/act-runs-post)):

```bash
curl -X POST "https://api.apify.com/v2/acts/genial_candlestand~ebay-search-scraper-listings-prices/run-sync-get-dataset-items?token=YOUR_APIFY_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"queries":["lego technic"],"maxItemsPerQuery":100}'
```

**AI agents (MCP).** Add the actor as a tool of the [Apify MCP server](https://docs.apify.com/platform/integrations/mcp). Claude Code:

```bash
claude mcp add --transport http apify "https://mcp.apify.com?tools=genial_candlestand/ebay-search-scraper-listings-prices"
```

Claude Desktop, Cursor or VS Code: `{"mcpServers": {"apify": {"url": "https://mcp.apify.com?tools=genial_candlestand/ebay-search-scraper-listings-prices"}}}`. Then ask, for example:

- "Find used iPhone 13 listings on eBay and list the cheapest ones with seller feedback"
- "Get the 60 vintage camera auctions on eBay that end soonest, with bids and time left"
- "Search eBay for new LEGO Technic sets and show shipping cost and free returns"

**Integrations.** Run it on a schedule with [Apify Schedules](https://docs.apify.com/platform/schedules) and send the results to Google Sheets, Slack, Zapier, Make, n8n or your webhook — see [Apify integrations](https://docs.apify.com/platform/integrations).

### FAQ

**Can I get sold listings and sold prices?**<br>
No. eBay now asks for a sign-in on sold and completed searches, and this actor does not log in.

**Do I need an eBay account or API key?**<br>
No.

**Is it legal to scrape eBay?**<br>
The actor collects publicly visible listing data. Check eBay's terms and the laws that apply to you, especially for personal data and how you use the results. This is not legal advice.

**Why do some seller fields stay empty?**<br>
If eBay serves a layout without seller data, the fields are `null` and the log shows a warning.

### Also useful

- [Naver Shopping Scraper](https://apify.com/genial_candlestand/naver-shopping-product-search-scraper) — compare product prices by keyword on Naver Shopping: discounts, delivery fee, reviews
- [ALDI Australia Product Scraper](https://apify.com/genial_candlestand/aldi-au-product-scraper) — get supermarket prices, unit prices and Special Buys from ALDI Australia

# Actor input Schema

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

Keywords to search on ebay.com, one per line, e.g. "lego technic". Each term is a separate search with its own results. Give search terms or start URLs (or both). Active listings only: sold/completed listings need an eBay login and are not supported.

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

ebay.com search result URLs copied from the browser (https://www.ebay.com/sch/i.html?\_nkw=...), with eBay's own filters kept. The URL must contain a keyword (\_nkw). Item pages, category browse pages (/b/), stores, other eBay sites and sold-listing URLs are rejected. Filter fields below, when set, replace the same filter in the URL.

## `maxItemsPerQuery` (type: `integer`):

Stop each search term or URL after this many listings. Pages are fetched until this number is reached or eBay has no next page.

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

Optional cap on all listings of the run across every search. Leave empty for no total cap.

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

Limit the search to an eBay category by its numeric ID, e.g. 31387 for Wristwatches (the number in category URLs). Needs search terms or URLs: eBay has no keyword-less category search.

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

Item condition filter. "Used" is eBay's Pre-Owned. Works with every other filter.

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

Auctions only or Buy It Now (fixed price) only. Works with every other filter.

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

Lowest item price in USD. Must not be higher than Max price. Listings with a price range overlapping the filter are kept, as on eBay.

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

Highest item price in USD. Must not be lower than Min price.

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

Result order on eBay. "Ending soonest" puts auctions first.

## `itemsPerPage` (type: `string`):

How many listings each eBay page request returns. 240 needs 4× fewer requests for large searches; 60 is enough for small ones.

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

eBay blocks requests without a proxy. US residential proxy is the most reliable; datacenter proxy is cheaper but some pages may stay blocked.

## Actor input object example

```json
{
  "queries": [
    "lego technic"
  ],
  "maxItemsPerQuery": 100,
  "condition": "any",
  "buyingFormat": "any",
  "sort": "bestMatch",
  "itemsPerPage": "60",
  "proxyConfiguration": {
    "useApifyProxy": true,
    "apifyProxyGroups": [
      "RESIDENTIAL"
    ],
    "apifyProxyCountry": "US"
  }
}
```

# Actor output Schema

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

Dataset with all listings

## `overview` (type: `string`):

Listings table with the main fields

# 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": [
        "lego technic"
    ]
};

// Run the Actor and wait for it to finish
const run = await client.actor("genial_candlestand/ebay-search-scraper-listings-prices").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": ["lego technic"] }

# Run the Actor and wait for it to finish
run = client.actor("genial_candlestand/ebay-search-scraper-listings-prices").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": [
    "lego technic"
  ]
}' |
apify call genial_candlestand/ebay-search-scraper-listings-prices --silent --output-dataset

```

## MCP server setup

```json
{
    "mcpServers": {
        "apify": {
            "type": "http",
            "url": "https://mcp.apify.com/?tools=fetch-actor-details,genial_candlestand/ebay-search-scraper-listings-prices"
        }
    }
}
```

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/rFQjh8jAs0cwr047K/builds/HJBFwuKAWtG6668Nk/openapi.json
