{ "openapi": "3.0.1", "info": { "title": "eBay Sold Listings API: 3 Years History + Real Best Offer", "description": "eBay sold prices for any keyword: 240 sales per search on 8 eBay sites, up to 3 years of sold history, and the real accepted Best Offer price, not the asking price. Median and range included. 5.4% wrong items in a 40-search benchmark vs 25.7% to 31.6% for other eBay sold APIs.", "version": "0.1", "x-build-id": "ECBKBoAkApg5Q6tYN" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/compsniper~compsniper-ebay-sold-listings/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-compsniper-compsniper-ebay-sold-listings", "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/compsniper~compsniper-ebay-sold-listings/runs": { "post": { "operationId": "runs-sync-compsniper-compsniper-ebay-sold-listings", "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/compsniper~compsniper-ebay-sold-listings/run-sync": { "post": { "operationId": "run-sync-compsniper-compsniper-ebay-sold-listings", "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": [ "keywords" ], "properties": { "keywords": { "title": "Keywords", "type": "array", "description": "One or more specific product keywords. Include the model or variant you need. Each keyword is searched separately and can return up to the requested result count.", "items": { "type": "string" } }, "mode": { "title": "Mode", "enum": [ "recent", "history" ], "type": "string", "description": "Recent: up to 240 recent eBay sold listings per keyword (about the last 90 days). History: up to 3 years of eBay sold history between Start date and End date, in US dollars.", "default": "recent" }, "count": { "title": "Results per keyword", "minimum": 1, "maximum": 240, "type": "integer", "description": "Maximum sold listings per keyword (1 to 240), not a guaranteed count. Start with 5 or 10 to check your query; fewer may remain after filtering.", "default": 240 }, "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 to search.", "default": "ebay.com" }, "itemCondition": { "title": "Condition", "enum": [ "any", "new", "used" ], "type": "string", "description": "Broad new/used condition filter. Returned condition labels can be category-specific, such as New with tags or Pre-Owned; unavailable values may be null.", "default": "any" }, "minPrice": { "title": "Minimum price", "minimum": 0, "type": "integer", "description": "Minimum item price in the search marketplace's displayed currency. Shipping is separate. The form accepts whole numbers." }, "maxPrice": { "title": "Maximum price", "minimum": 0, "type": "integer", "description": "Maximum item price in the search marketplace's displayed currency. Must be at least the minimum price. Shipping is separate." }, "relevance": { "title": "AI relevance cleaning", "type": "boolean", "description": "Use relevance cleaning to help reduce unrelated results. Review returned titles and variants before pricing. Turning this off disables semantic cleaning, not normal invalid-row checks.", "default": true }, "bestOfferPrice": { "title": "Real Best Offer prices", "type": "boolean", "description": "Recent mode only. For sales that closed through an accepted Best Offer, add the price the buyer actually paid (acceptedOfferPrice). eBay's sold page shows only the asking price for those sales. A row can come back as pending while its price is still being looked up.", "default": false }, "startDate": { "title": "Start date (history mode)", "pattern": "^\\d{4}-\\d{2}-\\d{2}$", "type": "string", "description": "First sold date to include, YYYY-MM-DD, up to 3 years ago. Default: one year ago." }, "endDate": { "title": "End date (history mode)", "pattern": "^\\d{4}-\\d{2}-\\d{2}$", "type": "string", "description": "Last sold date to include, YYYY-MM-DD. Default: today." }, "historyMaxRows": { "title": "Max history rows per keyword", "minimum": 1, "maximum": 2000, "type": "integer", "description": "History mode only. Rows are fetched 50 per page, newest first.", "default": 100 }, "singleUnitOnly": { "title": "Single-unit sales only (history mode)", "type": "boolean", "description": "History mode only. Keep only one-unit listings, so every row is one sale with its own price and date.", "default": 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 } } } } } } } } } }