# eBay Scraper (`unfenced-group/ebay-scraper`) Actor Scrape eBay active and sold listings across 8 marketplaces (US, UK, DE, AU, CA, FR, IT, ES). Get prices, sold dates, conditions, buying formats and buyer-total cost (item + shipping) for price comps, reselling and market research. Filter by condition, price, location and recency. - **URL**: https://apify.com/unfenced-group/ebay-scraper.md - **Developed by:** [Unfenced Group](https://apify.com/unfenced-group) (community) - **Categories:** E-commerce - **Stats:** 2 total users, 1 monthly users, 0.0% runs succeeded, 0 bookmarks - **User rating**: No ratings yet ## Pricing from $1.79 / 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. Since this Actor supports Apify Store discounts, the price gets lower the higher subscription plan you have. Learn more: https://docs.apify.com/platform/actors/running/actors-in-store#pay-per-event ## What's an Apify Actor? Actors are a software tools running on the Apify platform, for all kinds of web data extraction and automation use cases. 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. In JavaScript/TypeScript projects, use official [JavaScript/TypeScript client](https://docs.apify.com/api/client/js.md): ```bash npm install apify-client ``` In Python projects, use official [Python client library](https://docs.apify.com/api/client/python.md): ```bash pip install apify-client ``` In shell scripts, use [Apify CLI](https://docs.apify.com/cli/docs.md): ````bash # MacOS / Linux curl -fsSL https://apify.com/install-cli.sh | bash # Windows irm https://apify.com/install-cli.ps1 | iex ```bash In AI frameworks, you might use the [Apify MCP server](https://docs.apify.com/platform/integrations/mcp.md). If your project is in a different language, use 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 active and sold listings across 12 marketplaces in one run. Get titles, prices in the marketplace's native currency, condition, buying format, sold dates, sold counts, shipping, location, and images — clean structured data for price research, market analysis, and reselling intelligence. ### What it does - Scrapes **active listings**, **sold/completed listings**, or **both** in a single run - Covers **United States, United Kingdom, Germany, Australia, Canada, France, Italy, Spain, Netherlands, Austria, Switzerland, and Ireland** - Returns native-currency prices per marketplace (USD, GBP, EUR, AUD, CAD, CHF) - Captures sold dates and sold counts — ideal for price comps and demand analysis - Search by keyword or paste eBay search URLs directly ### Marketplaces | Market | Site | |--------|------| | United States | ebay.com | | United Kingdom | ebay.co.uk | | Germany | ebay.de | | Australia | ebay.com.au | | Canada | ebay.ca | | France | ebay.fr | | Italy | ebay.it | | Spain | ebay.es | | Netherlands | ebay.nl | | Austria | ebay.at | | Switzerland | ebay.ch | | Ireland | ebay.ie | ### Input | Field | Type | Description | |-------|------|-------------| | `market` | string | Marketplace: us, uk, de, au, ca, fr, it, es, nl, at, ch, ie. Ignored when Start URLs are set. | | `searchQuery` | string | Keyword to search, e.g. "vintage camera". | | `searchQueries` | array | Run several keyword searches in one job. Combines with `searchQuery`. | | `listingType` | string | `active`, `sold`, or `both`. Default active. | | `condition` | string | Filter by condition: any, new, openBox, refurbished, used, parts. | | `minPrice` / `maxPrice` | integer | Price band in the marketplace currency. | | `sortOrder` | string | bestMatch, priceAsc (cheapest incl. shipping), priceDesc, newlyListed, endingSoonest. | | `buyItNowOnly` | boolean | Exclude auctions — fixed-price only. | | `freeShippingOnly` | boolean | Only listings with free shipping. | | `itemLocation` | string | any, domestic, or worldwide. | | `maxDaysBack` | integer | Sold listings only — keep items sold within the last N days (recent comps). | | `startUrls` | array | eBay search URLs. Overrides market/search. Add `&LH_Sold=1&LH_Complete=1` for sold listings. | | `maxResults` | integer | Maximum listings to return. Set to `0` for unlimited. Default 5. | ### Output | Field | Type | Description | |-------|------|-------------| | `itemId` | string | eBay item number. | | `title` | string | Listing title. | | `price` | number | Price in the marketplace's native currency. | | `buyerPrice` | number | Total a buyer pays: item price + shipping. The number that decides a flip. | | `currency` | string | Currency code (USD, GBP, EUR, etc.). | | `condition` | string | Item condition, e.g. Brand New, Pre-Owned, Refurbished. | | `buyingFormat` | string | Buy It Now, Best Offer, or Auction. | | `bids` | number | Number of bids (auction listings). | | `timeLeft` | string | Time remaining (auction listings), e.g. "3d 18h". | | `rating` | number | Product rating out of 5 (listings with aggregated reviews). | | `reviewCount` | number | Number of product ratings. | | `listingType` | string | active or sold. | | `soldDate` | string | Date the item sold (sold listings only). | | `soldCount` | number | Number sold (active listings with a sold count). | | `shipping` | string | Shipping label, or "Free". | | `shippingCost` | number | Shipping cost as a number (0 if free, null if unspecified). | | `freeReturns` | boolean | Listing offers free returns. | | `sponsored` | boolean | Sponsored placement in search results. | | `topRatedSeller` | boolean | Carries eBay's Top Rated listing badge. | | `location` | string | Item location. | | `url` | string | Listing URL. | | `image` | string | Primary image URL. | | `market` | string | Marketplace code. | | `source` | string | Source marketplace domain. | | `scrapedAt` | string | ISO 8601 timestamp. | #### Example record ```json { "itemId": "377282888326", "title": "Super Mario 64 (N64) Loose Cart Only - Authentic & Tested", "price": 208.46, "buyerPrice": 208.46, "currency": "USD", "condition": "Pre-Owned", "buyingFormat": "Buy It Now", "bids": null, "timeLeft": null, "rating": 4.9, "reviewCount": 37, "listingType": "sold", "soldDate": "Jun 20, 2026", "soldCount": null, "shipping": "Free", "shippingCost": 0, "freeReturns": true, "sponsored": false, "topRatedSeller": true, "location": "United States", "url": "https://www.ebay.com/itm/377282888326", "image": "https://i.ebayimg.com/images/g/abc/s-l500.jpg", "market": "us", "source": "ebay.com", "scrapedAt": "2026-06-20T20:55:30.543Z" } ```` ### Examples **Active listings on US eBay** ```json { "market": "us", "searchQuery": "vintage camera", "listingType": "active", "maxResults": 100 } ``` **Sold listings for price comps** ```json { "market": "us", "searchQuery": "nintendo 64", "listingType": "sold", "maxResults": 200 } ``` **Reseller sourcing — cheapest used stock in a price band** ```json { "market": "us", "searchQuery": "nintendo switch", "condition": "used", "minPrice": 20, "maxPrice": 80, "sortOrder": "priceAsc", "buyItNowOnly": true, "maxResults": 100 } ``` **Recent sold comps — last 14 days, multiple products** ```json { "market": "us", "searchQueries": ["pokemon charizard psa 10", "pokemon blastoise psa 10"], "listingType": "sold", "maxDaysBack": 14, "maxResults": 200 } ``` **Both active and sold in the UK** ```json { "market": "uk", "searchQuery": "lego star wars", "listingType": "both", "maxResults": 100 } ``` **Native-currency results on a European marketplace** ```json { "market": "nl", "searchQuery": "playstation 5", "listingType": "active", "maxResults": 100 } ``` **Scrape from pasted search URLs** ```json { "startUrls": [{ "url": "https://www.ebay.de/sch/i.html?_nkw=kamera&LH_Sold=1&LH_Complete=1" }], "maxResults": 100 } ``` ### Pricing **$1.99 per 1,000 results** — you only pay for successfully retrieved listings. Failed retries are never charged. | Results | Cost | |---------|------| | 1,000 | $1.99 | | 10,000 | $19.90 | | 100,000 | $199.00 | *** ### Need a custom scraper? **[Unfenced Group](https://www.unfencedgroup.nl)** builds Apify actors for any website — for free. If the site you need isn't in our portfolio yet, just ask. We scope, build, and publish it at no cost to you. You only pay for results — we absorb the compute and proxy costs ourselves. Same pay-per-result pricing, same quality, same standards as every actor in this portfolio. **Get in touch:** [www.unfencedgroup.nl](https://www.unfencedgroup.nl) # Actor input Schema ## `market` (type: `string`): eBay marketplace to scrape. Ignored when Start URLs are provided. ## `searchQuery` (type: `string`): Keyword to search, e.g. "vintage camera". ## `searchQueries` (type: `array`): Run several keyword searches in one job. Each keyword is searched separately. Combines with the single Search query field. ## `listingType` (type: `string`): Scrape active listings, sold/completed listings, or both. ## `condition` (type: `string`): Filter by item condition (server-side). ## `minPrice` (type: `integer`): Only listings at or above this price (marketplace currency). ## `maxPrice` (type: `integer`): Only listings at or below this price (marketplace currency). ## `sortOrder` (type: `string`): How eBay orders results. Price sorts include shipping. ## `buyItNowOnly` (type: `boolean`): Exclude auctions — fixed-price listings only. ## `freeShippingOnly` (type: `boolean`): Only listings with free shipping. ## `itemLocation` (type: `string`): Filter by item location relative to the marketplace. ## `maxDaysBack` (type: `integer`): Sold listings only. Keep items sold within the last N days — ideal for recent price comps. Leave blank for all available sold listings. ## `startUrls` (type: `array`): eBay search URLs. Overrides Marketplace/Search. Market auto-detected per URL. Add \&LH\_Sold=1\&LH\_Complete=1 for sold listings. ## `maxResults` (type: `integer`): Maximum listings to return. Set to 0 for unlimited. ## `proxyConfiguration` (type: `object`): Residential proxy required — eBay blocks datacenter IPs. ## Actor input object example ```json { "market": "us", "searchQuery": "vintage camera", "searchQueries": [ "nintendo switch", "ps5", "xbox series x" ], "listingType": "active", "condition": "any", "sortOrder": "bestMatch", "buyItNowOnly": false, "freeShippingOnly": false, "itemLocation": "any", "maxResults": 5, "proxyConfiguration": { "useApifyProxy": true, "apifyProxyGroups": [ "RESIDENTIAL" ] } } ``` # 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 '' with your token const client = new ApifyClient({ token: '', }); // Prepare Actor input const input = { "proxyConfiguration": { "useApifyProxy": true, "apifyProxyGroups": [ "RESIDENTIAL" ] } }; // Run the Actor and wait for it to finish const run = await client.actor("unfenced-group/ebay-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 '' with your token. client = ApifyClient("") # Prepare the Actor input run_input = { "proxyConfiguration": { "useApifyProxy": True, "apifyProxyGroups": ["RESIDENTIAL"], } } # Run the Actor and wait for it to finish run = client.actor("unfenced-group/ebay-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 '{ "proxyConfiguration": { "useApifyProxy": true, "apifyProxyGroups": [ "RESIDENTIAL" ] } }' | apify call unfenced-group/ebay-scraper --silent --output-dataset ``` ## MCP server setup ```json { "mcpServers": { "apify": { "command": "npx", "args": [ "mcp-remote", "https://mcp.apify.com/?tools=unfenced-group/ebay-scraper", "--header", "Authorization: Bearer " ] } } } ``` ## OpenAPI specification ```json { "openapi": "3.0.1", "info": { "title": "eBay Scraper", "description": "Scrape eBay active and sold listings across 8 marketplaces (US, UK, DE, AU, CA, FR, IT, ES). Get prices, sold dates, conditions, buying formats and buyer-total cost (item + shipping) for price comps, reselling and market research. Filter by condition, price, location and recency.", "version": "0.0", "x-build-id": "KGev5NqSDUFOLlqfY" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/unfenced-group~ebay-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-unfenced-group-ebay-scraper", "x-openai-isConsequential": false, "summary": "Executes an Actor, waits for its completion, and returns Actor's dataset items in response.", "tags": [ "Run Actor" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/inputSchema" } } } }, "parameters": [ { "name": "token", "in": "query", "required": true, "schema": { "type": "string" }, "description": "Enter your Apify token here" } ], "responses": { "200": { "description": "OK" } } } }, "/acts/unfenced-group~ebay-scraper/runs": { "post": { "operationId": "runs-sync-unfenced-group-ebay-scraper", "x-openai-isConsequential": false, "summary": "Executes an Actor and returns information about the initiated run in response.", "tags": [ "Run Actor" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/inputSchema" } } } }, "parameters": [ { "name": "token", "in": "query", "required": true, "schema": { "type": "string" }, "description": "Enter your Apify token here" } ], "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/runsResponseSchema" } } } } } } }, "/acts/unfenced-group~ebay-scraper/run-sync": { "post": { "operationId": "run-sync-unfenced-group-ebay-scraper", "x-openai-isConsequential": false, "summary": "Executes an Actor, waits for completion, and returns the OUTPUT from Key-value store in response.", "tags": [ "Run Actor" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/inputSchema" } } } }, "parameters": [ { "name": "token", "in": "query", "required": true, "schema": { "type": "string" }, "description": "Enter your Apify token here" } ], "responses": { "200": { "description": "OK" } } } } }, "components": { "schemas": { "inputSchema": { "type": "object", "properties": { "market": { "title": "Marketplace", "enum": [ "us", "uk", "de", "au", "ca", "fr", "it", "es", "nl", "at", "ch", "ie" ], "type": "string", "description": "eBay marketplace to scrape. Ignored when Start URLs are provided.", "default": "us" }, "searchQuery": { "title": "Search query", "type": "string", "description": "Keyword to search, e.g. \"vintage camera\"." }, "searchQueries": { "title": "Search queries (multiple)", "type": "array", "description": "Run several keyword searches in one job. Each keyword is searched separately. Combines with the single Search query field.", "items": { "type": "string" } }, "listingType": { "title": "Listing type", "enum": [ "active", "sold", "both" ], "type": "string", "description": "Scrape active listings, sold/completed listings, or both.", "default": "active" }, "condition": { "title": "Condition", "enum": [ "any", "new", "openBox", "refurbished", "used", "parts" ], "type": "string", "description": "Filter by item condition (server-side).", "default": "any" }, "minPrice": { "title": "Minimum price", "minimum": 0, "type": "integer", "description": "Only listings at or above this price (marketplace currency)." }, "maxPrice": { "title": "Maximum price", "minimum": 0, "type": "integer", "description": "Only listings at or below this price (marketplace currency)." }, "sortOrder": { "title": "Sort order", "enum": [ "bestMatch", "priceAsc", "priceDesc", "newlyListed", "endingSoonest" ], "type": "string", "description": "How eBay orders results. Price sorts include shipping.", "default": "bestMatch" }, "buyItNowOnly": { "title": "Buy It Now only", "type": "boolean", "description": "Exclude auctions — fixed-price listings only.", "default": false }, "freeShippingOnly": { "title": "Free shipping only", "type": "boolean", "description": "Only listings with free shipping.", "default": false }, "itemLocation": { "title": "Item location", "enum": [ "any", "domestic", "worldwide" ], "type": "string", "description": "Filter by item location relative to the marketplace.", "default": "any" }, "maxDaysBack": { "title": "Max days back (sold listings)", "minimum": 1, "type": "integer", "description": "Sold listings only. Keep items sold within the last N days — ideal for recent price comps. Leave blank for all available sold listings." }, "startUrls": { "title": "Start URLs", "type": "array", "description": "eBay search URLs. Overrides Marketplace/Search. Market auto-detected per URL. Add &LH_Sold=1&LH_Complete=1 for sold listings.", "items": { "type": "object", "required": [ "url" ], "properties": { "url": { "type": "string", "title": "URL of a web page", "format": "uri" } } } }, "maxResults": { "title": "Max results", "minimum": 0, "type": "integer", "description": "Maximum listings to return. Set to 0 for unlimited.", "default": 5 }, "proxyConfiguration": { "title": "Proxy configuration", "type": "object", "description": "Residential proxy required — eBay blocks datacenter IPs.", "default": { "useApifyProxy": true, "apifyProxyGroups": [ "RESIDENTIAL" ] } } } }, "runsResponseSchema": { "type": "object", "properties": { "data": { "type": "object", "properties": { "id": { "type": "string" }, "actId": { "type": "string" }, "userId": { "type": "string" }, "startedAt": { "type": "string", "format": "date-time", "example": "2025-01-08T00:00:00.000Z" }, "finishedAt": { "type": "string", "format": "date-time", "example": "2025-01-08T00:00:00.000Z" }, "status": { "type": "string", "example": "READY" }, "meta": { "type": "object", "properties": { "origin": { "type": "string", "example": "API" }, "userAgent": { "type": "string" } } }, "stats": { "type": "object", "properties": { "inputBodyLen": { "type": "integer", "example": 2000 }, "rebootCount": { "type": "integer", "example": 0 }, "restartCount": { "type": "integer", "example": 0 }, "resurrectCount": { "type": "integer", "example": 0 }, "computeUnits": { "type": "integer", "example": 0 } } }, "options": { "type": "object", "properties": { "build": { "type": "string", "example": "latest" }, "timeoutSecs": { "type": "integer", "example": 300 }, "memoryMbytes": { "type": "integer", "example": 1024 }, "diskMbytes": { "type": "integer", "example": 2048 } } }, "buildId": { "type": "string" }, "defaultKeyValueStoreId": { "type": "string" }, "defaultDatasetId": { "type": "string" }, "defaultRequestQueueId": { "type": "string" }, "buildNumber": { "type": "string", "example": "1.0.0" }, "containerUrl": { "type": "string" }, "usage": { "type": "object", "properties": { "ACTOR_COMPUTE_UNITS": { "type": "integer", "example": 0 }, "DATASET_READS": { "type": "integer", "example": 0 }, "DATASET_WRITES": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_READS": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_WRITES": { "type": "integer", "example": 1 }, "KEY_VALUE_STORE_LISTS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_READS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_WRITES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_INTERNAL_GBYTES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_EXTERNAL_GBYTES": { "type": "integer", "example": 0 }, "PROXY_RESIDENTIAL_TRANSFER_GBYTES": { "type": "integer", "example": 0 }, "PROXY_SERPS": { "type": "integer", "example": 0 } } }, "usageTotalUsd": { "type": "number", "example": 0.00005 }, "usageUsd": { "type": "object", "properties": { "ACTOR_COMPUTE_UNITS": { "type": "integer", "example": 0 }, "DATASET_READS": { "type": "integer", "example": 0 }, "DATASET_WRITES": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_READS": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_WRITES": { "type": "number", "example": 0.00005 }, "KEY_VALUE_STORE_LISTS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_READS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_WRITES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_INTERNAL_GBYTES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_EXTERNAL_GBYTES": { "type": "integer", "example": 0 }, "PROXY_RESIDENTIAL_TRANSFER_GBYTES": { "type": "integer", "example": 0 }, "PROXY_SERPS": { "type": "integer", "example": 0 } } } } } } } } } } ```