{ "openapi": "3.0.1", "info": { "title": "eBay Sold Listings Intelligence", "description": "Get real market prices from eBay sold listings. See what items ACTUALLY sold for, not asking prices. Includes pricing analytics, market velocity, demand levels, and recommended listing price. Perfect for resellers, collectors, estate sales, inheritance sales.", "version": "0.0", "x-build-id": "yNnSNkO6tziEHHmxE" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/marielise.dev~ebay-sold-listings-intelligence/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-marielise.dev-ebay-sold-listings-intelligence", "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/marielise.dev~ebay-sold-listings-intelligence/runs": { "post": { "operationId": "runs-sync-marielise.dev-ebay-sold-listings-intelligence", "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/marielise.dev~ebay-sold-listings-intelligence/run-sync": { "post": { "operationId": "run-sync-marielise.dev-ebay-sold-listings-intelligence", "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": { "query": { "title": "Search Query", "type": "string", "description": "Required unless you paste an eBay URL below. Enter keywords like 'iPhone 13 Pro 128GB', 'Pokemon Charizard card', 'vintage Levi's 501'. The more specific, the better your results." }, "ebayUrl": { "title": "Or Paste eBay URL", "type": "string", "description": "Required unless you fill Search Query above. Paste a full eBay listing URL to find similar sold items. The Actor will extract the item title and search for comparable sales." }, "ebaySite": { "title": "eBay Site", "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. Auto-detected from URL if provided.", "default": "ebay.com" }, "soldWithinDays": { "title": "Sold within (days)", "minimum": 1, "maximum": 90, "type": "integer", "description": "Only show items sold in the last N days. Max 90 (eBay limit)", "default": 30 }, "condition": { "title": "Condition filter", "type": "array", "description": "Filter by item condition (leave empty for all conditions)", "items": { "type": "string", "enum": [ "new", "open_box", "certified_refurbished", "like_new", "very_good", "good", "acceptable", "for_parts" ] }, "default": [] }, "priceMin": { "title": "Min price ($)", "minimum": 0, "type": "number", "description": "Minimum sold price in USD" }, "priceMax": { "title": "Max price ($)", "minimum": 0, "type": "number", "description": "Maximum sold price in USD" }, "listingType": { "title": "Listing type", "type": "array", "description": "Filter by listing type (leave empty for all types)", "items": { "type": "string", "enum": [ "auction", "buy_it_now", "best_offer" ] }, "default": [] }, "categoryId": { "title": "eBay Category ID", "type": "string", "description": "Optional narrowing filter for an existing search (e.g., '9355' for Cell Phones). This does not replace Search Query or eBay URL." }, "maxItems": { "title": "Max items to return", "minimum": 10, "maximum": 200, "type": "integer", "description": "Maximum number of sold items to scrape (affects runtime and cost)", "default": 50 }, "sortBy": { "title": "Sort by", "enum": [ "date_desc", "date_asc", "price_desc", "price_asc" ], "type": "string", "description": "How to sort the results", "default": "date_desc" }, "includeAnalytics": { "title": "Include Pricing Analytics", "type": "boolean", "description": "Generate pricing intelligence summary (avg/median price, condition impact, days to sell)", "default": true }, "outputFormat": { "title": "Output format", "enum": [ "full", "summary_only", "items_only" ], "type": "string", "description": "How much detail to return", "default": "full" }, "proxy": { "title": "Proxy Configuration", "type": "object", "description": "Configure proxy settings. Default uses Apify's smart proxy selection. Enable RESIDENTIAL only if you experience high block rates.", "default": { "useApifyProxy": true } } } }, "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 } } } } } } } } } }