{ "openapi": "3.0.1", "info": { "title": "eBay Sold Listings Scraper", "description": "Scrape eBay sold listings from 8 marketplaces with no login or cookies. Get real sold prices, sale age, seller rating, condition and shipping from search, seller or listing links. Bulk input and auto proxy switching. Export JSON, CSV or Excel for price comps and resale research.", "version": "1.0", "x-build-id": "JWpmKVxqQ7Y8oqUFA" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/data_minds~ebay-sold-listings-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-data_minds-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/data_minds~ebay-sold-listings-scraper/runs": { "post": { "operationId": "runs-sync-data_minds-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/data_minds~ebay-sold-listings-scraper/run-sync": { "post": { "operationId": "run-sync-data_minds-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", "required": [ "urls" ], "properties": { "urls": { "title": "🛒 eBay links", "minItems": 1, "type": "array", "description": "One or more eBay links, in bulk. A search link (…/sch/i.html?_nkw=iphone+13) looks up that search term; a seller link (…/usr/username) reads that seller's recent sales; a listing link (…/itm/123456789012) looks up one listing. You can mix all three. Plain keywords are accepted too.", "items": { "type": "string" } }, "keywords": { "title": "🔍 Extra search keywords", "type": "array", "description": "Optional. Add search phrases here instead of pasting a search link. Sold listings must contain ALL words of a phrase, in any order.", "items": { "type": "string" } }, "maxItems": { "title": "📊 Maximum listings", "minimum": 0, "type": "integer", "description": "Stop after this many sold listings in total. 0 means no limit.", "default": 10 }, "includeItemDetails": { "title": "🔬 Add item details", "type": "boolean", "description": "Also open each listing to add exact end date, condition, category, shipping price, total price, item location and image. Slower, one extra request per listing.", "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 site to search. Leave empty to use the site of your links (otherwise ebay.com)." }, "soldWithin": { "title": "📅 Sold within", "enum": [ "30d", "6m", "12m", "all" ], "type": "string", "description": "Only keep sales that happened inside this window. eBay publishes the age of a sale only as the past month, past 6 months, past 12 months or older.", "default": "6m" }, "minPrice": { "title": "💵 Minimum sold price", "minimum": 0, "type": "number", "description": "Skip sales below this price. 0 means no lower limit.", "default": 0 }, "maxPrice": { "title": "💎 Maximum sold price", "minimum": 0, "type": "number", "description": "Skip sales above this price. 0 means no upper limit.", "default": 0 }, "excludeWords": { "title": "🚫 Exclude words", "type": "array", "description": "Drop sold listings whose title contains any of these words or phrases, for example 'for parts' or 'cracked'.", "items": { "type": "string" } }, "sellersPerKeyword": { "title": "🏪 Sellers per keyword", "minimum": 1, "maximum": 500, "type": "integer", "description": "How many sellers (most matching listings first) to read for each search term. More sellers means more sales found but a longer run.", "default": 60 }, "searchPages": { "title": "📄 Search pages", "minimum": 1, "maximum": 10, "type": "integer", "description": "How many result pages (120 listings each) are used to find sellers for each search term.", "default": 3 }, "feedbackPages": { "title": "📚 Sales pages per seller", "minimum": 1, "maximum": 20, "type": "integer", "description": "How many pages of each seller's newest sales to read (200 sales per page).", "default": 3 }, "concurrency": { "title": "🚀 Parallel requests", "minimum": 1, "maximum": 10, "type": "integer", "description": "How many requests run at the same time. Lower it if eBay slows the run down.", "default": 4 }, "proxyConfiguration": { "title": "🌐 Proxy configuration", "type": "object", "description": "Optional connection settings. The default works for most runs, and the run adjusts by itself if eBay refuses requests.", "default": { "useApifyProxy": false } } } }, "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 } } } } } } } } } }