{ "openapi": "3.0.1", "info": { "title": "eBay Sold Listings API", "description": "Real eBay sold prices as JSON: search 400M+ completed sales on ebay.com and ebay.co.uk by keyword or category, with history past eBay's 90 days. Final price, sale date, condition, shipping, item id. No scraping, no login wall.", "version": "0.1", "x-build-id": "KsMojkwFBROKf4AK4" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/trawl~ebay-sold-listings-api/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-trawl-ebay-sold-listings-api", "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/trawl~ebay-sold-listings-api/runs": { "post": { "operationId": "runs-sync-trawl-ebay-sold-listings-api", "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/trawl~ebay-sold-listings-api/run-sync": { "post": { "operationId": "run-sync-trawl-ebay-sold-listings-api", "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": { "keyword": { "title": "Keyword", "type": "string", "description": "Words that must ALL appear in the sold listing's title, in any order (up to 32 words). Leave empty to get every sale in a category." }, "marketplace": { "title": "Marketplace", "enum": [ "EBAY_US", "EBAY_GB" ], "type": "string", "description": "ebay.com (prices in USD) or ebay.co.uk (prices in GBP).", "default": "EBAY_US" }, "maxResults": { "title": "Max results", "minimum": 1, "maximum": 20000, "type": "integer", "description": "How many sold listings to return at most, newest first. You are charged per listing actually returned, so a search with fewer matches costs less.", "default": 100 }, "condition": { "title": "Condition", "type": "array", "description": "Only sales in these conditions. Leave empty for all.", "items": { "type": "string", "enum": [ "new", "used", "parts", "other" ], "enumTitles": [ "New", "Used / Pre-owned", "For parts or not working", "Other / unspecified" ] } }, "exclude": { "title": "Exclude words", "type": "string", "description": "Words that must NOT appear in the title (for example: case screen protector box). Up to 32 words, none of them in the keyword." }, "categoryId": { "title": "Category ID", "pattern": "^\\d{1,10}$", "type": "string", "description": "A numeric eBay leaf category id (for example 9355 for Cell Phones & Smartphones on ebay.com). Ids differ per marketplace. On its own, with no keyword, returns every sale in the category. Look ids up at https://trawl.dev/docs or with GET /categories." }, "minPrice": { "title": "Min sold price", "minimum": 0, "type": "number", "description": "Lowest final price to include, in USD on ebay.com or GBP on ebay.co.uk." }, "maxPrice": { "title": "Max sold price", "minimum": 0, "type": "number", "description": "Highest final price to include, in the marketplace's currency." }, "dateFrom": { "title": "Sold from (date)", "pattern": "^\\d{4}-\\d{2}-\\d{2}$", "type": "string", "description": "Earliest sale date, inclusive, as YYYY-MM-DD. History reaches back well past eBay's own 90-day window." }, "dateTo": { "title": "Sold to (date)", "pattern": "^\\d{4}-\\d{2}-\\d{2}$", "type": "string", "description": "Latest sale date, inclusive, as YYYY-MM-DD." }, "attributes": { "title": "Item specifics", "maxItems": 16, "type": "array", "description": "Filter on item specifics as Key:Value, one per line, exact match, case-insensitive (Brand:Apple, Storage Capacity:256 GB, Grade:PSA 10). Different keys must all match; the same key twice matches either value. Up to 16. Only listings whose full details were read carry specifics.", "items": { "type": "string" } }, "includeDetails": { "title": "Include full listing details", "type": "boolean", "description": "Add a `details` object to every sale with the listing page's item specifics, description, all images, seller, shipping and returns, and the accepted Best Offer amount where eBay publishes it. Costs twice as much per listing and limits results to listings with details available.", "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 } } } } } } } } } }