{ "openapi": "3.0.1", "info": { "title": "eBay Sold Listings Scraper", "description": "Get real eBay sold prices for resale comps and price research: sold date, sold price, shipping, condition, bids or best offer, location and item link. 12 eBay sites, keyword or URL, plus a free median/percentile price summary per search. Pay only for results.", "version": "1.0", "x-build-id": "rKia1opCOG9HU7fju" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/axlymxp~ebay-sold-listings-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-axlymxp-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/axlymxp~ebay-sold-listings-scraper/runs": { "post": { "operationId": "runs-sync-axlymxp-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/axlymxp~ebay-sold-listings-scraper/run-sync": { "post": { "operationId": "run-sync-axlymxp-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": { "searchQueries": { "title": "Search queries", "type": "array", "description": "Keywords to look up in eBay's sold (completed) listings, one per line. Each query gets its own results and its own price summary. eBay operators work: quotes for exact phrases, a minus sign to exclude words (e.g. iphone 13 -case).", "items": { "type": "string" } }, "marketplace": { "title": "eBay site", "enum": [ "com", "co.uk", "de", "fr", "it", "es", "ca", "com.au", "at", "ch", "nl", "ie" ], "type": "string", "description": "Which eBay site to search. Prices come in that site's currency.", "default": "com" }, "maxItemsPerQuery": { "title": "Max sold listings per query", "minimum": 1, "maximum": 10000, "type": "integer", "description": "Stop after this many sold listings for each query (up to 10,000). One eBay results page holds 240 listings; popular products have 10,000+ sales in eBay's sold history.", "default": 100 }, "titleMustContainAllWords": { "title": "Title must contain every keyword", "type": "boolean", "description": "eBay also returns loosely related items (an 'iphone 13' search can include iPhone 14s). Turn this on to keep only listings whose title contains every word of the query (words after a minus sign are ignored). Skipped listings are not charged.", "default": false }, "soldWithinDays": { "title": "Sold within the last N days", "minimum": 1, "maximum": 365, "type": "integer", "description": "Optional. Only keep listings sold in the last N days (eBay keeps roughly the last 90 days of sales, plus some older multi-quantity listings)." }, "condition": { "title": "Condition", "enum": [ "any", "new", "open_box", "refurbished", "used", "for_parts" ], "type": "string", "description": "Filter by item condition.", "default": "any" }, "buyingFormat": { "title": "Buying format", "enum": [ "any", "auction", "buy_it_now", "best_offer" ], "type": "string", "description": "Only auctions, only Buy It Now, or only listings that accepted offers.", "default": "any" }, "minPrice": { "title": "Min price", "minimum": 0, "type": "integer", "description": "Optional. Minimum sold price in the site's currency (whole units)." }, "maxPrice": { "title": "Max price", "minimum": 0, "type": "integer", "description": "Optional. Maximum sold price in the site's currency (whole units)." }, "categoryId": { "title": "Category ID", "type": "string", "description": "Optional. Numeric eBay category ID to search in, e.g. 9355 (Cell Phones & Smartphones) or 183454 (CCG Individual Cards). Find it in the URL of an eBay category page." }, "sort": { "title": "Sort", "enum": [ "ended_recently", "price_high", "price_low", "best_match" ], "type": "string", "description": "Order of the results. 'Recently sold' gives the freshest comps.", "default": "ended_recently" }, "startUrls": { "title": "eBay search URLs", "type": "array", "description": "Optional. Paste eBay search result URLs (…/sch/i.html?…) to reuse filters you set on eBay. The sold-items filter is added automatically; the filter fields above are not applied to URLs.", "items": { "type": "object", "required": [ "url" ], "properties": { "url": { "type": "string", "title": "URL of a web page", "format": "uri" } } } }, "includeSummary": { "title": "Save a price summary per query", "type": "boolean", "description": "Saves median / average / min / max / 25th-75th percentile price, sales per day and sale-type mix for each query to the key-value store record SUMMARY (free, not a dataset row).", "default": true }, "proxyConfiguration": { "title": "Proxy configuration", "type": "object", "description": "Optional. Works without a proxy; if eBay blocks the run's IP, the actor switches to Apify Proxy by itself." } } }, "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 } } } } } } } } } }