# eBay Scraper - Products, Variants & Stores (`wilcode/ebay-scraper`) Actor
Scrape eBay listing details, variants, item specifics, seller descriptions, and eBay Store product listings.
- **URL**: https://apify.com/wilcode/ebay-scraper.md
- **Developed by:** [Wilcode](https://apify.com/wilcode) (community)
- **Categories:**
- **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, 0 bookmarks
- **User rating**: No ratings yet
## Pricing
from $4.00 / 1,000 products
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 - Scrape eBay Products, Variants & Store Listings
**eBay Scraper** extracts full eBay **product details** - **variants and stock**, **item specifics** and **product descriptions** - from item URLs, and **summary product listings** from any **eBay Store** or seller page. No eBay account, login, or eBay API key required.
Use this eBay scraper to research products before sourcing, import products into your own shop, track a competitor's catalogue, or monitor eBay prices and stock across every eBay marketplace.
### What is eBay Scraper and how does it work?
eBay Scraper is a web scraping tool that extracts data from eBay using item URLs or eBay Store / seller URLs - no category browsing required.
It runs in one of two modes, picked via the **Mode** input:
| Mode | Input used | Output |
|------|-----------|--------|
| `product` | `productUrls` | One row per eBay product, with full details and every variant |
| `sellerProducts` | `sellerUrls` | One summary row per product found in the eBay Store's item grid |
Just paste one or more eBay URLs into the matching input field, pick a mode, and start the run. Results land in the dataset and can be downloaded as JSON, CSV or Excel, or pulled via the Apify API without ever opening the platform UI.
For a full field-by-field breakdown, see the **Input** tab.
### What data can you scrape from eBay?
| Data | Where it comes from |
|------|--------------------|
| Product title, item ID, seller name | eBay item page |
| Image gallery | eBay item page |
| Item specifics (brand, type, model, condition…) | Item specifics table |
| Price, original price, currency, price range | eBay's embedded product model |
| Variants: price, currency, discount, stock, image, option values | eBay's embedded product model |
| Real stock level (`quantityAvailable`) | Quantity field maximum |
| Sold count | eBay item page |
| Product description (sanitized HTML) | `itm.ebaydesc.com` description iframe |
| eBay Store products (summary only): item ID, title, URL, image, price range, original price, currency | Store / seller item grid |
| Store name, slug, domain, pagination and total item count | Store page |
### Why scrape eBay products?
➡️ **Import eBay products into your own shop** - title, images, item specifics, variants and descriptions in one structured row.
➡️ **Monitor competitor prices and stock on eBay** daily or hourly without manually opening products.
➡️ **Track an eBay store's entire catalogue** - everything a seller currently has listed, and at what price.
➡️ **Feed a product database or repricing tool** with clean, structured eBay data instead of raw HTML.
### How much does it cost to scrape eBay?
This eBay scraper uses Apify's **pay-per-event** pricing - you're charged only for data actually returned, not for compute time:
| Event | Price | Fires when |
|-------|-------|------------|
| Product | $0.004 | A product is successfully scraped in `product` mode |
| Store product | $0.002 | A summary product row (item ID, title, URL, image, price) is returned from a store grid in `sellerProducts` mode |
Failed items (a removed product, a blocked page, an invalid URL) are **never charged** - you only pay for rows that actually made it into your dataset. Fetching the product description is free — it's bundled into the product charge.
Run a small test batch first to get your actual per-item cost, then multiply by your expected volume.
### Is it legal to scrape eBay?
Yes - scraping publicly available data such as product titles, prices, item specifics, or store products is legal. This eBay scraper only reads pages a normal shopper can already see; it doesn't log in, bypass paywalls, or access private data. Use the data responsibly and in line with eBay's own terms for your use case.
### How to scrape eBay products
#### 1. Scrape eBay product details
```json
{
"mode": "product",
"productUrls": [{ "url": "https://www.ebay.com/itm/397200450899" }],
"fetchDescriptions": true
}
```
Output (abridged):
```json
{
"success": true,
"url": "https://www.ebay.com/itm/397200450899",
"itemId": "397200450899",
"title": "Makita XVJ04Z-R 18V LXT BL Cordless Jig Saw (Tool Only) Certified Refurbished",
"seller": "CPO Commerce",
"images": ["https://i.ebayimg.com/images/g/OFMAAeSwt8NqTw9c/s-l1600.jpg"],
"specifics": { "Brand": "Makita", "Type": "Jig Saws", "Voltage": "18 V" },
"priceRange": { "min": 139.99, "max": 139.99, "currency": "USD" },
"soldCount": 87,
"description_iframe": "https://itm.ebaydesc.com/itmdesc/397200450899?t=0&category=111422",
"description_html": "…
",
"variantOptions": [{ "name": "Color", "values": ["Black", "White"] }],
"variants": [
{
"variantId": "5011122233",
"name": "Black",
"price": 139.99,
"priceText": "US $139.99",
"currency": "USD",
"originalPrice": null,
"quantityAvailable": 12,
"isAvailable": true,
"image": "https://i.ebayimg.com/images/g/OFMAAeSwt8NqTw9c/s-l1600.jpg",
"optionValues": [{ "name": "Color", "value": "Black" }]
}
]
}
```
Notable details:
- **Prices stay in the product's own currency.** Nothing is converted, and eBay's own "localized" price is ignored in favour of the seller's original one.
- **A product with no variations still returns exactly one variant**, built from its main price - so you can treat every eBay product the same way.
- **`quantityAvailable` is the real stock level**, read from the quantity field's maximum. eBay hides that number behind "More than 10 available" in the visible text.
- **Item specifics exclude page meta.** Rows eBay renders with identical markup but that aren't product specifics (Quantity, Item number, Category, Postage, Payments…) are filtered out.
Best for: full eBay products you need to research, compare, or re-list elsewhere.
#### 2. Scrape eBay Store products
`sellerProducts` mode reads the store's item grid, so each row carries only what a grid card shows: item ID, title, URL, image and price. Variants, item specifics, stock levels, sold count and descriptions are **not** part of a store row - they only exist on the item page itself.
```json
{
"mode": "sellerProducts",
"sellerUrls": [{ "url": "https://www.ebay.co.uk/str/thelabelsoutlet" }],
"allPages": true,
"maxPages": 5
}
```
Output (one row per product):
```json
{
"success": true,
"slug": "thelabelsoutlet",
"store": "The Label Outlet",
"domain": "ebay.co.uk",
"storeUrl": "https://www.ebay.co.uk/str/thelabelsoutlet",
"page": 1,
"hasNextPage": true,
"totalItems": 550,
"itemId": "282997517914",
"title": "Sloggi Basic Maxi Brief Knickers 4 Pack 95% Cotton",
"url": "https://www.ebay.co.uk/itm/282997517914",
"imageUrl": "https://i.ebayimg.com/images/g/XukAAeSwn75qKsjH/s-l1600.jpg",
"price": 23.4,
"priceMax": 36.0,
"currency": "GBP",
"priceText": "£23.40 to £36.00",
"originalPrice": null
}
```
Supported eBay store / seller URL formats:
- `https://www.ebay.co.uk/str/STORE_SLUG` - store front
- `https://www.ebay.com/usr/SELLER_NAME` - seller profile
- `https://www.ebay.com/sch/i.html?_ssn=SELLER_NAME` - search scoped to a seller
- `https://www.ebay.com/sch/SELLER_NAME/m.html` - search by seller, legacy path form
Best for: tracking a competitor's or a supplier's full eBay catalogue, and for collecting the item URLs you want to scrape in depth.
##### Getting full details for a store's products
To get the full data for a store's products, run the two modes in sequence:
1. Run `sellerProducts` on the store URL and collect the `url` field from each row.
2. Feed those URLs back in as `productUrls` with `mode: "product"` to get variants, item specifics, stock and descriptions.
Step 2 is billed per product at the full product rate, so scrape the store first and filter down to the items you actually care about before running it.
#### 3. Scrape eBay product descriptions
eBay renders the product description inside a separate iframe, so it is not part of the item page. `product` mode always returns that iframe's URL as `description_iframe`; turn on **Fetch product description** to have the actor fetch and clean it into `description_html` as well.
The returned HTML is made safe to inject **inline** into your own page:
- all scripting removed - `