# eBay Sold Comps — Pricing Intelligence (`midwest_united/ebay-sold-comps`) Actor Get real eBay sold prices with avg, median, recommended listing price, and A–D confidence grade. Lot normalization, outlier fencing, 8 marketplaces. - **URL**: https://apify.com/midwest\_united/ebay-sold-comps.md - **Developed by:** [Jim Giganti](https://apify.com/midwest_united) (community) - **Categories:** E-commerce, Automation - **Stats:** 5 total users, 1 monthly users, 100.0% runs succeeded, NaN bookmarks - **User rating**: No ratings yet ## Pricing from $39.00 / 1,000 pricing report generateds 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 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 Search eBay completed/sold listings and get **aggregated comp pricing** with statistical outlier fencing, lot normalization, and a data-quality **confidence score (A–D grade)**. Built for resellers, pawn shops, auction tools, and any pricing service that needs to know what items *actually sold for* — not what sellers are hoping to get. --- ### Why this actor is different Most eBay sold scrapers return a raw dump of listings and leave the pricing math to you. This actor does the work before it hands you results: | Feature | What it does | |---|---| | **Lot normalization** | Detects multi-item listings ("lot of 3", "bundle of 5", "2x") and divides to per-unit price before computing averages | | **IQR outlier fencing** | Removes statistical outliers using interquartile range fencing — one $500 anomaly won't skew your $45 avg | | **Confidence score (A–D)** | Every result includes a grade based on comp count, price spread, and recency so you know when to trust the number | | **Recommended listing price** | A single suggested price — weighted blend of median (60%) and p75 (40%) — so you don't have to do the math yourself | | **Relevance filtering** | Token-based scoring drops junk comps that technically matched the keyword but aren't the item | | **Condition-adjusted pricing** | Optional breakdown of avg sold price by condition tier (new / used / refurbished / for_parts) | | **8 eBay marketplaces** | US, UK, DE, FR, IT, ES, CA, AU — search regional sold data with a single input field | | **Clean schema** | One camelCase field per data point — no duplicate aliases, no mixed casing | --- ### Pricing This actor uses **Pay Per Event** pricing — you only pay for what you get back. | Event | Cost | When charged | |---|---|---| | `comp-record-returned` | $0.02 / record | Per individual sold listing in the dataset | | `pricing-report-generated` | $0.10 / run | Once per run when aggregated stats are produced | **Example:** A typical run returning 25 comp records = 25 × $0.02 + $0.10 = **$0.60 total**. There is no subscription, no minimum spend, and no charge for runs that return zero results. --- ### Input | Field | Type | Required | Default | Description | |---|---|---|---|---| | `searchQuery` | string | ✅ | — | What to search for. Be specific — include brand, model, size. | | `maxResults` | integer | | 25 | Max comp records to return (1–100). | | `condition` | string | | all | Filter by: `new`, `used`, `refurbished`, `for_parts`. | | `eBaySite` | string | | `ebay.com` | Marketplace: `ebay.com`, `ebay.co.uk`, `ebay.de`, `ebay.fr`, `ebay.it`, `ebay.es`, `ebay.ca`, `ebay.com.au`. | | `minPrice` | number | | — | Drop listings below this price (applied at eBay search level). | | `maxPrice` | number | | — | Drop listings above this price (applied at eBay search level). | | `daysBack` | integer | | — | Only include comps sold within this many days (1–90). | | `knownBrands` | string[] | | `[]` | Brand mismatch filter. Listings with a different brand from this list are dropped. | | `excludedPhrases` | string[] | | `[]` | Plain-text phrases — matching titles are dropped. | | `excludedPatterns` | string[] | | `[]` | Regex patterns (case-insensitive) — matching titles are dropped. | | `includeConditionPricing` | boolean | | `false` | Add per-condition price breakdown to stats output. | #### Example input ```json { "searchQuery": "dewalt 20v drill driver", "maxResults": 25, "condition": "used", "eBaySite": "ebay.com", "minPrice": 15, "maxPrice": 150, "daysBack": 30, "knownBrands": ["dewalt", "milwaukee", "makita"], "excludedPhrases": ["case only", "charger only"], "includeConditionPricing": true } ```` *** ### Output #### Comp records — default dataset One record per sold listing: ```json { "id": "145023948271", "title": "DeWalt 20V MAX Drill Driver DCD771 Bare Tool", "url": "https://www.ebay.com/itm/145023948271", "soldDate": "Dec 18, 2024", "soldPrice": 42.00, "shippingCost": 0, "totalPrice": 42.00, "isLot": false, "inferredLotSize": null, "normalizedPrice": 42.00, "normalizationMethod": "none", "normalizationConfidence": 1.0, "condition": "Used", "conditionTier": "used", "relevanceScore": 0.88, "primaryImageUrl": "https://i.ebayimg.com/images/g/.../s-l500.jpg", "thumbnailUrl": "https://i.ebayimg.com/images/g/.../s-l225.jpg", "detailPageFetched": true, "detailPageFailReason": null } ``` #### Aggregated stats — key-value store key: `stats` ```json { "searchQuery": "dewalt 20v drill driver", "condition": "used", "compCount": 18, "rawCandidateCount": 24, "price": { "avg": 47.82, "median": 44.50, "low": 28.00, "high": 89.00, "p25": 36.75, "p75": 58.00, "stdDev": 14.21 }, "recommendedPrice": 49.90, "confidence": { "score": 0.74, "grade": "B", "compCount": 18, "priceSpread": 0.61, "recencyDays": 22, "outliersRemoved": 2, "lotNormalizedCount": 1, "notes": [] }, "conditionPricing": { "new": { "avg": 89.00, "count": 2 }, "used": { "avg": 43.50, "count": 14 }, "refurbished": { "avg": 55.00, "count": 2 }, "for_parts": { "avg": null, "count": 0 } }, "dropped": { "byRelevance": 3, "byNegativePhrase": 1, "byNegativePattern": 0, "byBrandMismatch": 2, "byConditionFilter": 0, "byMaxResultsCap": 0 }, "lot": { "detected": 2, "normalized": 1 }, "outliers": { "removed": 2, "prices": [4.99, 220.00], "fencingApplied": true }, "runtime": { "totalSeconds": 18.4, "searchSeconds": 4.1, "detailSeconds": 14.3 } } ``` *** ### Confidence grade guide | Grade | Score | What it means | |---|---|---| | **A** | ≥ 0.85 | High comp count, tight price spread, recent sales — strong signal | | **B** | ≥ 0.65 | Solid data with minor caveats | | **C** | ≥ 0.45 | Limited comps or noisy spread — use with judgment | | **D** | < 0.45 | Thin market, old data, or very wide spread — treat with caution | The confidence score is a weighted blend of three sub-signals: comp count (40%), price spread (35%), and recency (25%). *** ### Use cases - **Pawn shops** — instant comp price before making an offer - **Resellers / flippers** — verify buy prices against real sold data - **Auction software** — embed real-time eBay comp pricing into bidding tools - **Estate sale pricing** — bulk item valuation from actual market data - **Consignment shops** — set listing prices based on what's actually selling - **Pricing APIs** — embed as a data source in your own resale or inventory platform *** ### Notes - This actor scrapes publicly available eBay sold listing data. It is not affiliated with or endorsed by eBay Inc. - You are responsible for complying with eBay's Terms of Service when using data retrieved by this actor. - Detail page fetches are used only when the search result card does not include an image. Most runs require few or no detail page fetches, keeping runtime low. - Lot normalization confidence is 1.0 when no lot is detected, 0.85 for successful size-inferred division, and 0.30 when a lot is detected but size cannot be inferred. # Actor input Schema ## `searchQuery` (type: `string`): The item to search for on eBay sold listings. Be specific — include brand, model number, size, etc. for better comp quality. Example: 'dewalt 20v drill driver DCD771' ## `maxResults` (type: `integer`): Maximum number of comp records to return. Higher values produce better aggregate stats but take longer to run. Default: 25. ## `condition` (type: `string`): Filter eBay results to a specific item condition. Leave blank to include all conditions (recommended for most use cases — use conditionPricing output instead). ## `knownBrands` (type: `array`): Optional list of brand names (lowercase). If the search query contains one of these brands, listings whose title contains a different brand from this list are dropped. Leave empty to disable brand filtering. Example: \["dewalt", "milwaukee", "makita"] ## `excludedPhrases` (type: `array`): Optional plain-text phrases (case-insensitive). Listings whose titles contain any of these are dropped before aggregation. Example: \["case only", "charger only", "holster only"] ## `excludedPatterns` (type: `array`): Optional regular expression strings (case-insensitive). Listings whose titles match any of these patterns are dropped. Example: \["\bfor parts\b", "\bnot working\b"] ## `includeConditionPricing` (type: `boolean`): When enabled, the stats output includes a per-condition price breakdown (new / used / refurbished / for\_parts) based on eBay condition labels. Useful for pawn shops and resellers who price by condition. ## `eBaySite` (type: `string`): Which eBay marketplace to search. Defaults to eBay.com (US). Use other sites for regional pricing — e.g. ebay.co.uk for UK comps. ## `minPrice` (type: `number`): Filter out listings below this price (in the marketplace's native currency). Applied at the eBay search level. Useful for filtering out parts, accessories, or junk comps on wide-category searches. ## `maxPrice` (type: `number`): Filter out listings above this price (in the marketplace's native currency). Applied at the eBay search level. Useful for capping results on high-variance searches. ## `daysBack` (type: `integer`): Only include comps sold within this many days. For example, 30 returns only comps from the last 30 days. Leave blank to include all available history (eBay typically shows ~90 days of completed listings). Tighter windows improve confidence score recency. ## Actor input object example ```json { "searchQuery": "dewalt 20v drill driver", "maxResults": 25, "condition": "", "knownBrands": [], "excludedPhrases": [], "excludedPatterns": [], "includeConditionPricing": false, "eBaySite": "ebay.com" } ``` # Actor output Schema ## `compRecords` (type: `string`): Individual sold listing records with normalized pricing, lot detection, condition, and relevance score. ## `stats` (type: `string`): Aggregated pricing summary (avg/median/high/low/p25/p75/stdDev), confidence score (A-D grade), outlier metrics, lot normalization counts, filter telemetry, and runtime. Stored as 'stats' key in the default key-value store. # 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 = {}; // Run the Actor and wait for it to finish const run = await client.actor("midwest_united/ebay-sold-comps").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 = {} # Run the Actor and wait for it to finish run = client.actor("midwest_united/ebay-sold-comps").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 '{}' | apify call midwest_united/ebay-sold-comps --silent --output-dataset ``` ## MCP server setup ```json { "mcpServers": { "apify": { "command": "npx", "args": [ "mcp-remote", "https://mcp.apify.com/?tools=midwest_united/ebay-sold-comps", "--header", "Authorization: Bearer " ] } } } ``` ## OpenAPI specification ```json { "openapi": "3.0.1", "info": { "title": "eBay Sold Comps — Pricing Intelligence", "description": "Get real eBay sold prices with avg, median, recommended listing price, and A–D confidence grade. Lot normalization, outlier fencing, 8 marketplaces.", "version": "1.1", "x-build-id": "0AN4RZclmtjVcQgfF" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/midwest_united~ebay-sold-comps/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-midwest_united-ebay-sold-comps", "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/midwest_united~ebay-sold-comps/runs": { "post": { "operationId": "runs-sync-midwest_united-ebay-sold-comps", "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/midwest_united~ebay-sold-comps/run-sync": { "post": { "operationId": "run-sync-midwest_united-ebay-sold-comps", "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": [ "searchQuery" ], "properties": { "searchQuery": { "title": "Search Query", "type": "string", "description": "The item to search for on eBay sold listings. Be specific — include brand, model number, size, etc. for better comp quality. Example: 'dewalt 20v drill driver DCD771'" }, "maxResults": { "title": "Max Results", "minimum": 1, "maximum": 100, "type": "integer", "description": "Maximum number of comp records to return. Higher values produce better aggregate stats but take longer to run. Default: 25.", "default": 25 }, "condition": { "title": "Condition Filter", "enum": [ "", "new", "used", "refurbished", "for_parts" ], "type": "string", "description": "Filter eBay results to a specific item condition. Leave blank to include all conditions (recommended for most use cases — use conditionPricing output instead).", "default": "" }, "knownBrands": { "title": "Brand Filter", "type": "array", "description": "Optional list of brand names (lowercase). If the search query contains one of these brands, listings whose title contains a different brand from this list are dropped. Leave empty to disable brand filtering. Example: [\"dewalt\", \"milwaukee\", \"makita\"]", "default": [], "items": { "type": "string" } }, "excludedPhrases": { "title": "Excluded Phrases", "type": "array", "description": "Optional plain-text phrases (case-insensitive). Listings whose titles contain any of these are dropped before aggregation. Example: [\"case only\", \"charger only\", \"holster only\"]", "default": [], "items": { "type": "string" } }, "excludedPatterns": { "title": "Excluded Patterns (Regex)", "type": "array", "description": "Optional regular expression strings (case-insensitive). Listings whose titles match any of these patterns are dropped. Example: [\"\\\\bfor parts\\\\b\", \"\\\\bnot working\\\\b\"]", "default": [], "items": { "type": "string" } }, "includeConditionPricing": { "title": "Include Condition-Adjusted Pricing", "type": "boolean", "description": "When enabled, the stats output includes a per-condition price breakdown (new / used / refurbished / for_parts) based on eBay condition labels. Useful for pawn shops and resellers who price by condition.", "default": false }, "eBaySite": { "title": "eBay Marketplace", "enum": [ "ebay.com", "ebay.co.uk", "ebay.de", "ebay.fr", "ebay.it", "ebay.es", "ebay.ca", "ebay.com.au" ], "type": "string", "description": "Which eBay marketplace to search. Defaults to eBay.com (US). Use other sites for regional pricing — e.g. ebay.co.uk for UK comps.", "default": "ebay.com" }, "minPrice": { "title": "Min Price", "minimum": 0, "type": "number", "description": "Filter out listings below this price (in the marketplace's native currency). Applied at the eBay search level. Useful for filtering out parts, accessories, or junk comps on wide-category searches." }, "maxPrice": { "title": "Max Price", "minimum": 0, "type": "number", "description": "Filter out listings above this price (in the marketplace's native currency). Applied at the eBay search level. Useful for capping results on high-variance searches." }, "daysBack": { "title": "Days Back", "minimum": 1, "maximum": 90, "type": "integer", "description": "Only include comps sold within this many days. For example, 30 returns only comps from the last 30 days. Leave blank to include all available history (eBay typically shows ~90 days of completed listings). Tighter windows improve confidence score recency." } } }, "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 } } } } } } } } } } ```