{ "openapi": "3.0.1", "info": { "title": "eBay Sold Comps - Real Sold Prices Without Login", "description": "eBay sold listings are behind a login wall. This actor still gets real sold prices: it finds the sellers listing your item and reads their public feedback for what buyers actually paid. Sold comps, price range, recommended price, demand. No account, no cookies.", "version": "0.0", "x-build-id": "aiFP00786sgpSa63T" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/marielise.dev~ebay-sold-listings-intelligence/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-marielise.dev-ebay-sold-listings-intelligence", "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/marielise.dev~ebay-sold-listings-intelligence/runs": { "post": { "operationId": "runs-sync-marielise.dev-ebay-sold-listings-intelligence", "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/marielise.dev~ebay-sold-listings-intelligence/run-sync": { "post": { "operationId": "run-sync-marielise.dev-ebay-sold-listings-intelligence", "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": { "query": { "title": "Search Query", "type": "string", "description": "Item keywords, for example \"iPhone 13 Pro 128GB\" or \"Nintendo Switch OLED\". The actor finds the sellers currently listing it and reads their public feedback for what they actually sold it for." }, "ebayUrl": { "title": "Or Paste eBay URL", "type": "string", "description": "Required unless you fill Search Query above. Paste a full eBay listing URL to find similar sold items. The Actor extracts the item title from the URL and searches for comparable sales, so the URL needs to contain the title (an /itm/Some-Item-Title/123456789 style link), not just the numeric item ID." }, "ebaySite": { "title": "eBay Site", "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. Auto-detected from URL if provided.", "default": "ebay.com" }, "soldWithinDays": { "title": "Sold within", "minimum": 30, "maximum": 365, "type": "integer", "description": "eBay shows sale timing in three bands: past month (30), past 6 months (180), past year (365). Values in between round up to the next band.", "default": 180 }, "condition": { "title": "Condition filter", "type": "array", "description": "Filter by item condition (leave empty for all conditions)", "items": { "type": "string", "enum": [ "new", "open_box", "certified_refurbished", "like_new", "very_good", "good", "acceptable", "for_parts" ] }, "default": [] }, "priceMin": { "title": "Min price", "minimum": 0, "type": "number", "description": "Minimum sold price, in the marketplace's own currency (USD on ebay.com, GBP on ebay.co.uk, EUR on ebay.de)." }, "priceMax": { "title": "Max price", "minimum": 0, "type": "number", "description": "Maximum sold price, in the marketplace's own currency (USD on ebay.com, GBP on ebay.co.uk, EUR on ebay.de)." }, "maxItems": { "title": "Max items to return", "minimum": 10, "maximum": 200, "type": "integer", "description": "Maximum sold comps to return. Each comp is billed as one result; a run that finds fewer bills fewer.", "default": 50 }, "maxSellers": { "title": "Sellers to read", "minimum": 5, "maximum": 60, "type": "integer", "description": "How many sellers' public feedback profiles to read, ranked by how many listings they have for your query and how large their store is. More sellers, more comps, slower run.", "default": 20 }, "includeAnalytics": { "title": "Include Pricing Analytics", "type": "boolean", "description": "Generate pricing intelligence summary (avg/median price, condition impact, days to sell)", "default": true }, "outputFormat": { "title": "Output format", "enum": [ "full", "summary_only", "items_only" ], "type": "string", "description": "How much detail to return", "default": "full" }, "proxy": { "title": "Proxy Configuration", "type": "object", "description": "eBay blocks datacenter IP addresses, so residential proxies are required for reliable results. Changing this away from RESIDENTIAL will very likely cause the run to be blocked.", "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 }, "PROXY_UNBLOCKER_UNITS": { "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 }, "PROXY_UNBLOCKER_UNITS": { "type": "integer", "example": 0 } } } } } } } } } }