{ "openapi": "3.0.1", "info": { "title": "eBay Sold Comps — Pricing Intelligence", "description": "Real eBay sold prices & comps — average, median, and recommended resale price across 8 marketplaces, with lot normalization and an A–D confidence score.", "version": "1.2", "x-build-id": "4MqFAu2GVuAPd8ed2" }, "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": "What item do you want eBay sold prices for? Enter the product to look up in completed/sold listings. Be specific — include brand, model number, and size for accurate comps. Example: 'dewalt 20v drill driver DCD771'." }, "maxResults": { "title": "Max Results", "minimum": 1, "maximum": 100, "type": "integer", "description": "How many sold comp records should be returned? More records give better average/median pricing but take longer to run. Range 1–100, default 25.", "default": 25 }, "condition": { "title": "Condition Filter", "enum": [ "", "new", "used", "refurbished", "for_parts" ], "type": "string", "description": "Do you want to filter sold listings by item condition? Choose New, Used, Refurbished, or For parts — or leave blank to include all conditions and read the per-condition price breakdown instead (recommended for most searches).", "default": "" }, "knownBrands": { "title": "Brand Filter", "type": "array", "description": "Which brands should be treated as the target brand? If your search query names one of these brands, sold listings whose title shows 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": "Which title phrases should exclude a sold listing? Any completed listing whose title contains one of these case-insensitive phrases is removed before pricing. Example: [\"case only\", \"charger only\", \"holster only\"].", "default": [], "items": { "type": "string" } }, "excludedPatterns": { "title": "Excluded Patterns (Regex)", "type": "array", "description": "Which regex patterns should exclude a sold listing? Sold listings whose titles match any of these case-insensitive regular expressions are dropped. Example: [\"\\\\bfor parts\\\\b\", \"\\\\bnot working\\\\b\"].", "default": [], "items": { "type": "string" } }, "includeConditionPricing": { "title": "Include Condition-Adjusted Pricing", "type": "boolean", "description": "Do you want the average sold price broken down by condition? When enabled, the stats output adds a per-condition price breakdown (new / used / refurbished / for parts) — 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 should be searched for sold prices? Defaults to eBay.com (US). Choose a regional site like eBay.co.uk for local sold comps in that country's currency.", "default": "ebay.com" }, "minPrice": { "title": "Min Price", "minimum": 0, "type": "number", "description": "What is the lowest sold price to include? Completed listings below this amount (in the marketplace's native currency) are filtered out at the eBay search level. Useful for removing parts, accessories, or junk comps." }, "maxPrice": { "title": "Max Price", "minimum": 0, "type": "number", "description": "What is the highest sold price to include? Completed listings above this amount (in the marketplace's native currency) are filtered out at the eBay search level. Useful for capping high-variance searches." }, "daysBack": { "title": "Days Back", "minimum": 1, "maximum": 90, "type": "integer", "description": "How recent should the sold listings be? Only include comps sold within this many days — for example, 30 returns only the last 30 days. Leave blank for all available history (eBay shows ~90 days of completed listings). Tighter windows improve the confidence score's recency signal." }, "proxyConfiguration": { "title": "Proxy configuration", "type": "object", "description": "Which proxies should the scraper use? Residential is strongly recommended for eBay — datacenter IPs are blocked or challenged frequently. Defaults to Apify residential proxies.", "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 } } } } } } } } } }