{ "openapi": "3.0.1", "info": { "title": "eBay Sold Items by Image & Keyword", "description": "Search eBay sold listings by PHOTO or by keyword. Upload an image and CLIP visual similarity finds matching sold items. Returns USD sold prices, sold dates, condition, and listing type, plus a median/average price summary. Ideal for pricing research, reselling, and collectibles valuation.", "version": "0.1", "x-build-id": "bE1SwqFzrjUKs7ZNF" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/scrapelabmax~ebay-sold-image-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-scrapelabmax-ebay-sold-image-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/scrapelabmax~ebay-sold-image-scraper/runs": { "post": { "operationId": "runs-sync-scrapelabmax-ebay-sold-image-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/scrapelabmax~ebay-sold-image-scraper/run-sync": { "post": { "operationId": "run-sync-scrapelabmax-ebay-sold-image-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": [ "maxItems" ], "properties": { "imageUrl": { "title": "Image (upload or URL)", "type": "string", "description": "Reference image to match sold listings against — upload a file or paste an image URL. JPEG, PNG, HEIC (iPhone), WebP, GIF, TIFF, and AVIF up to 10 MB. Provide this, imageBase64, or keyword (at least one is required)." }, "imageBase64": { "title": "Image (base64, for API use)", "type": "string", "description": "Base64-encoded reference image, up to 3 MB. Intended for API integrations that send the image inline; in this form, use the upload field above instead." }, "keyword": { "title": "Keyword", "type": "string", "description": "Search keyword(s), e.g. \"rtx 3080\". Provide this, imageUrl, or imageBase64 (at least one is required)." }, "similarityThreshold": { "title": "Similarity threshold", "minimum": 0, "maximum": 1, "type": "number", "description": "Minimum CLIP image-similarity score (0-1) for a listing to be considered a match when an image is provided.", "default": 0.65 }, "minPrice": { "title": "Minimum price", "minimum": 0, "type": "number", "description": "Exclude sold listings priced below this amount." }, "maxPrice": { "title": "Maximum price", "minimum": 0, "type": "number", "description": "Exclude sold listings priced above this amount." }, "condition": { "title": "Condition", "enum": [ "any", "new", "used", "refurbished" ], "type": "string", "description": "Filter sold listings by item condition.", "default": "any" }, "categoryId": { "title": "Category ID", "type": "string", "description": "Restrict the search to a specific eBay category ID." }, "daysBack": { "title": "Days back", "minimum": 1, "maximum": 90, "type": "integer", "description": "How many days back (from today) to include sold listings for.", "default": 90 }, "marketplace": { "title": "Marketplace", "enum": [ "ebay.com" ], "type": "string", "description": "eBay marketplace to search.", "default": "ebay.com" }, "maxItems": { "title": "Max items", "minimum": 1, "maximum": 10000, "type": "integer", "description": "Maximum number of sold items to return. Required — acts as a hard cost cap." }, "proxyConfiguration": { "title": "Proxy configuration", "type": "object", "description": "Apify Proxy configuration used for requests to eBay. Defaults to US residential exits: eBay converts sold prices to the viewer's local currency by geo-IP, and a non-US exit makes prices unusable (they are dropped rather than mis-reported).", "default": { "useApifyProxy": true, "apifyProxyGroups": [ "RESIDENTIAL" ], "apifyProxyCountry": "US" } } } }, "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 } } }, "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 } } } } } } } } } }