{ "openapi": "3.0.1", "info": { "title": "eBay Sold Listings Scraper — Real Sold Prices & Comps", "description": "Real eBay sold prices by keyword: sold price, shipping, total, sold date, condition, auction or Buy It Now, best offer and seller rating. Up to 200 recent sales per keyword on 8 eBay sites, plus median price per keyword. No login.", "version": "0.0", "x-build-id": "Ok4OwFnwh3Ooz4B79" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/apimy~ebay-sold-listings-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-apimy-ebay-sold-listings-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/apimy~ebay-sold-listings-scraper/runs": { "post": { "operationId": "runs-sync-apimy-ebay-sold-listings-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/apimy~ebay-sold-listings-scraper/run-sync": { "post": { "operationId": "run-sync-apimy-ebay-sold-listings-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": { "keywords": { "title": "Keywords", "type": "array", "description": "What sold on eBay, one keyword per line, e.g. \"nintendo switch 2\" or \"lego 42143\". Each keyword returns up to 200 of its most recent sales. Be specific (model, storage, size) to get clean price comps.", "items": { "type": "string" } }, "site": { "title": "eBay site", "enum": [ "ebay.com", "ebay.co.uk", "ebay.de", "ebay.ca", "ebay.com.au", "ebay.fr", "ebay.it", "ebay.es" ], "type": "string", "description": "Which eBay marketplace to read. Prices come in that site's currency.", "default": "ebay.com" }, "daysBack": { "title": "Days back", "minimum": 1, "maximum": 90, "type": "integer", "description": "How far back to look, in days (eBay keeps about 90 days of sold listings). Popular items fill 200 rows within a day or two, so this matters mostly for rare items.", "default": 30 }, "minPrice": { "title": "Min sold price", "minimum": 0, "type": "integer", "description": "Skip sales below this price, in the site's currency. Useful to drop cases, parts and accessories that share the keyword." }, "maxPrice": { "title": "Max sold price", "minimum": 0, "type": "integer", "description": "Skip sales above this price, in the site's currency. Applied to the 200 recent sales, so a tight range returns fewer rows." }, "condition": { "title": "Condition", "enum": [ "any", "new", "used", "refurbished", "parts" ], "type": "string", "description": "Keep only sales in this condition. Applied to the 200 recent sales, so it returns fewer rows.", "default": "any" }, "listingType": { "title": "Listing type", "enum": [ "any", "buy_it_now", "auction", "best_offer" ], "type": "string", "description": "Keep only fixed-price sales, auctions, or sales where the seller accepted a best offer (the real price may be lower than shown there).", "default": "any" }, "maxItemsPerKeyword": { "title": "Sales per keyword", "minimum": 1, "maximum": 200, "type": "integer", "description": "How many recent sales to keep for each keyword, from 1 to 200.", "default": 200 }, "maxItems": { "title": "Max rows", "minimum": 1, "maximum": 10000, "type": "integer", "description": "Upper limit of sold-listing rows for the whole run. Protects you from an unexpectedly large bill.", "default": 1000 } } }, "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 } } } } } } } } } }