# eBay Sold Comps Scraper (`xtracto/ebay-sold-comps-scraper`) Actor Pull eBay sold/completed listings for any keyword and get a reseller-grade price band (min, median, p90) per query. - **URL**: https://apify.com/xtracto/ebay-sold-comps-scraper.md - **Developed by:** [Farhan Febrian Nauval](https://apify.com/xtracto) (community) - **Categories:** E-commerce - **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, 0 bookmarks - **User rating**: No ratings yet ## Pricing from $20.00 / 1,000 results This Actor is paid per event and usage. You are charged both the fixed price for specific events and for Apify platform usage. 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 Sold Comps Scraper Look up **sold and completed** eBay listings for any keyword and get a clean, reseller-grade price band — minimum, median, 90th-percentile, and average — alongside every individual sold item. ### Why use this actor - **Sold prices, not asking prices** — pulls the items that actually sold, so you price against reality, not wishful listings. - **Instant price band per search** — every query returns a summary row with min / p10 / median / p90 / max and the average, ready to drop into a sourcing decision. - **Per-item detail too** — each sold listing comes through with title, sold price, sold date, condition, image, and URL. - **15 eBay markets** — choose the country site (US, UK, DE, AU, CA, and more), each priced in its local currency. - **No account, no API key** — works straight from public sold-search pages. - **Stable JSON output** — same field names every run, ready for spreadsheets, databases, or pipelines. ### How it works 1. You provide one or more search keywords and pick the eBay country site. 2. The actor pulls the sold/completed results for each keyword across as many pages as you allow (240 items per page). 3. Each sold item is saved as a `SOLD_LISTING` record; the sold date is parsed into a clean `YYYY-MM-DD` field. 4. After the last page of a keyword, the actor adds one `COMPS_SUMMARY` record with the full price band and the date range of the sample. 5. Everything lands in your dataset, exportable as JSON, CSV, or Excel. You don't need to manage any browsers or scrapers. ### Input ```json { "queries": [ "pokemon charizard psa 10", "air jordan 1 chicago" ], "domain": "www.ebay.co.uk", "maxPagesPerQuery": 2, "maxConcurrency": 4, "maxRequestRetries": 5, "proxyConfiguration": { "useApifyProxy": true, "apifyProxyGroups": ["RESIDENTIAL"] } } ```` Each keyword in `queries` is processed independently: it produces its own set of `SOLD_LISTING` rows and exactly one `COMPS_SUMMARY` price band. | Field | Type | Description | | --- | --- | --- | | `queries` | array | **Required.** Keywords to look up sold/completed listings for (one per entry). Each keyword yields its own sold rows plus one price-band summary. | | `domain` | string | eBay country site to search. One of: `www.ebay.com` (US, USD), `www.ebay.co.uk` (UK, GBP), `www.ebay.de` (DE, EUR), `www.ebay.com.au` (AU, AUD), `www.ebay.ca` (CA, CAD), `www.ebay.fr` (FR, EUR), `www.ebay.it` (IT, EUR), `www.ebay.es` (ES, EUR), `www.ebay.ie` (IE, EUR), `www.ebay.at` (AT, EUR), `www.ebay.nl` (NL, EUR), `www.ebay.be` (BE, EUR), `www.ebay.ch` (CH, CHF), `www.ebay.pl` (PL, PLN), `www.ebay.com.hk` (HK, HKD). The price currency follows the chosen site. Default `www.ebay.com`. | | `maxPagesPerQuery` | integer | Pages of sold results per query, 240 items/page (`1`–`20`). The actor stops early once a page returns no more sold results. Default `2`. | | `maxConcurrency` | integer | Number of parallel requests across all keywords (`1`–`20`). Default `4`. | | `maxRequestRetries` | integer | Retries per page before giving up (`1`–`15`). Default `5`. | | `proxyConfiguration` | object | Apify Proxy or a custom proxy list. RESIDENTIAL recommended for consistent local pricing. | ### Output The dataset contains two record types. Per sold item (`recordType: "SOLD_LISTING"`): ```json { "recordType": "SOLD_LISTING", "query": "air jordan 1 chicago", "page": 1, "domain": "www.ebay.com", "itemId": "157962165890", "title": "DS 2025 Nike Air Jordan Retro 1 OG Low Chicago Men's Sz 11", "soldPrice": 178.5, "soldPriceMax": null, "currency": "USD", "priceFormatted": "$178.50", "soldDate": "2026-06-09", "condition": "Pre-Owned", "image": "https://i.ebayimg.com/images/g/bJ4AAeSwwapqHk~2/s-l500.webp", "url": "https://www.ebay.com/itm/157962165890", "scrapedAt": "2026-06-10T10:54:50Z" } ``` One price-band summary per query (`recordType: "COMPS_SUMMARY"`): ```json { "recordType": "COMPS_SUMMARY", "query": "air jordan 1 chicago", "domain": "www.ebay.com", "currency": "USD", "sampleSize": 240, "totalParsed": 240, "minPrice": 92.0, "p10Price": 121.5, "medianPrice": 172.0, "p90Price": 268.4, "maxPrice": 540.0, "avgPrice": 188.6, "soldDateFrom": "2026-03-22", "soldDateTo": "2026-06-10", "scrapedAt": "2026-06-10T10:54:50Z" } ``` | Field | Type | Description | | --- | --- | --- | | `recordType` | string | `"SOLD_LISTING"` for an item, `"COMPS_SUMMARY"` for the per-query price band. | | `query` | string | The keyword that produced this record. | | `itemId` | string | eBay item number. | | `title` | string | Listing title. | | `soldPrice` | number | Sold price in the listed currency. | | `soldPriceMax` | number | Upper value when the listing sold as a range; otherwise `null`. | | `currency` | string | ISO currency of the price (depends on the site/region). | | `priceFormatted` | string | The price exactly as shown on eBay. | | `soldDate` | string | Sold date, normalized to `YYYY-MM-DD`. | | `condition` | string | Item condition when shown (e.g. `Pre-Owned`). | | `image` | string | Primary thumbnail URL. | | `url` | string | Full listing URL. | | `sampleSize` | integer | Number of priced sold listings in the summary. | | `minPrice` / `maxPrice` | number | Lowest / highest sold price in the sample. | | `p10Price` / `medianPrice` / `p90Price` | number | 10th-percentile, median, and 90th-percentile sold price. | | `avgPrice` | number | Mean sold price. | | `soldDateFrom` / `soldDateTo` | string | Date range covered by the sample. | | `scrapedAt` | string | ISO 8601 timestamp of collection. | Note: eBay shows prices in the currency of the chosen country site / viewing region. Run with a RESIDENTIAL proxy in the matching country for consistent local pricing. ### Other eBay Scrapers | Actor | Description | | --- | --- | | [eBay Search Scraper](https://apify.com/ebay-search-scraper) | Live search results with price, condition, and seller signals. | | [eBay Product Scraper](https://apify.com/ebay-product-scraper) | Full item detail: price, seller, shipping, and return policy. | | [eBay Sold Comps Scraper](https://apify.com/ebay-sold-comps-scraper) | Sold/completed listings with a reseller-grade price band per keyword. | # Actor input Schema ## `queries` (type: `array`): Keywords to look up sold/completed listings for (one per array entry). ## `domain` (type: `string`): Country-specific eBay site to search. The price currency follows the chosen site (and your proxy region). Default www.ebay.com. ## `maxPagesPerQuery` (type: `integer`): How many pages of sold results to traverse per query (240 results per page). ## `maxConcurrency` (type: `integer`): Maximum number of parallel requests across all keywords. ## `maxRequestRetries` (type: `integer`): How many times a request will be retried before giving up on a page. ## `proxyConfiguration` (type: `object`): Apify Proxy or your own proxy list. RESIDENTIAL group is recommended for consistent US pricing. ## Actor input object example ```json { "queries": [ "pokemon charizard psa 10" ], "domain": "www.ebay.com", "maxPagesPerQuery": 2, "maxConcurrency": 4, "maxRequestRetries": 5, "proxyConfiguration": { "useApifyProxy": true, "apifyProxyGroups": [ "RESIDENTIAL" ] } } ``` # 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 = { "queries": [ "pokemon charizard psa 10" ], "domain": "www.ebay.com", "proxyConfiguration": { "useApifyProxy": true, "apifyProxyGroups": [ "RESIDENTIAL" ] } }; // Run the Actor and wait for it to finish const run = await client.actor("xtracto/ebay-sold-comps-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 = { "queries": ["pokemon charizard psa 10"], "domain": "www.ebay.com", "proxyConfiguration": { "useApifyProxy": True, "apifyProxyGroups": ["RESIDENTIAL"], }, } # Run the Actor and wait for it to finish run = client.actor("xtracto/ebay-sold-comps-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 '{ "queries": [ "pokemon charizard psa 10" ], "domain": "www.ebay.com", "proxyConfiguration": { "useApifyProxy": true, "apifyProxyGroups": [ "RESIDENTIAL" ] } }' | apify call xtracto/ebay-sold-comps-scraper --silent --output-dataset ``` ## MCP server setup ```json { "mcpServers": { "apify": { "command": "npx", "args": [ "mcp-remote", "https://mcp.apify.com/?tools=xtracto/ebay-sold-comps-scraper", "--header", "Authorization: Bearer " ] } } } ``` ## OpenAPI specification ```json { "openapi": "3.0.1", "info": { "title": "eBay Sold Comps Scraper", "description": "Pull eBay sold/completed listings for any keyword and get a reseller-grade price band (min, median, p90) per query.", "version": "1.0", "x-build-id": "jWl5cb7Q1097gVDnt" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/xtracto~ebay-sold-comps-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-xtracto-ebay-sold-comps-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/xtracto~ebay-sold-comps-scraper/runs": { "post": { "operationId": "runs-sync-xtracto-ebay-sold-comps-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/xtracto~ebay-sold-comps-scraper/run-sync": { "post": { "operationId": "run-sync-xtracto-ebay-sold-comps-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", "required": [ "queries" ], "properties": { "queries": { "title": "Search keywords", "type": "array", "description": "Keywords to look up sold/completed listings for (one per array entry).", "items": { "type": "string" } }, "domain": { "title": "eBay domain", "enum": [ "www.ebay.com", "www.ebay.co.uk", "www.ebay.de", "www.ebay.com.au", "www.ebay.ca", "www.ebay.fr", "www.ebay.it", "www.ebay.es", "www.ebay.ie", "www.ebay.at", "www.ebay.nl", "www.ebay.be", "www.ebay.ch", "www.ebay.pl", "www.ebay.com.hk" ], "type": "string", "description": "Country-specific eBay site to search. The price currency follows the chosen site (and your proxy region). Default www.ebay.com.", "default": "www.ebay.com" }, "maxPagesPerQuery": { "title": "Max pages per query", "minimum": 1, "maximum": 20, "type": "integer", "description": "How many pages of sold results to traverse per query (240 results per page).", "default": 2 }, "maxConcurrency": { "title": "Max concurrency", "minimum": 1, "maximum": 20, "type": "integer", "description": "Maximum number of parallel requests across all keywords.", "default": 4 }, "maxRequestRetries": { "title": "Max retries", "minimum": 1, "maximum": 15, "type": "integer", "description": "How many times a request will be retried before giving up on a page.", "default": 5 }, "proxyConfiguration": { "title": "Proxy configuration", "type": "object", "description": "Apify Proxy or your own proxy list. RESIDENTIAL group is recommended for consistent US pricing." } } }, "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 } } } } } } } } } } ```