{ "openapi": "3.0.1", "info": { "title": "eBay Listings Scraper – Prices & Auctions", "description": "eBay listings scraper for price monitoring and market research across 13 marketplaces. Extract up to 60 fields, including prices, shipping, sellers, bids, watchers, sold counts, promotions, and sponsored results. Not affiliated with eBay Inc.", "version": "0.0", "x-build-id": "Sd6rhCB7lLsSj0r1W" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/astravalabs~ebay-listings-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-astravalabs-ebay-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/astravalabs~ebay-listings-scraper/runs": { "post": { "operationId": "runs-sync-astravalabs-ebay-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/astravalabs~ebay-listings-scraper/run-sync": { "post": { "operationId": "run-sync-astravalabs-ebay-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", "required": [ "queries" ], "properties": { "queries": { "title": "Search queries", "minItems": 1, "maxItems": 50, "type": "array", "description": "One to fifty active-listing search queries.", "items": { "type": "string" }, "default": [ "iphone 15 pro" ] }, "marketplace": { "title": "Marketplace", "enum": [ "US", "UK", "DE", "AU", "CA", "FR", "IT", "ES", "NL", "IE", "AT", "CH", "PL" ], "type": "string", "description": "eBay marketplace used for localized active listings.", "default": "US" }, "maxResultsPerQuery": { "title": "Maximum results per query", "minimum": 0, "maximum": 2400, "type": "integer", "description": "Stop persisting a query after this many unique records. Set to 0 for unlimited results within the page and Actor safety limits.", "default": 100 }, "sortOrder": { "title": "Sort order", "enum": [ "BEST_MATCH", "TIME_ENDING_SOONEST", "TIME_NEWLY_LISTED", "PRICE_LOW_TO_HIGH", "PRICE_HIGH_TO_LOW", "DISTANCE_NEAREST_FIRST" ], "type": "string", "description": "Ordering applied by eBay before pages are collected.", "default": "BEST_MATCH" }, "minPrice": { "title": "Minimum displayed price", "minimum": 0, "type": "number", "description": "Optional marketplace-currency lower price bound." }, "maxPrice": { "title": "Maximum displayed price", "minimum": 0, "type": "number", "description": "Optional marketplace-currency upper price bound." }, "itemLocation": { "title": "Item location", "enum": [ "DEFAULT", "DOMESTIC", "WORLDWIDE" ], "type": "string", "description": "Location filter applied directly to eBay. Domestic means the selected marketplace's home country.", "default": "DEFAULT" }, "condition": { "title": "Condition", "enum": [ "ANY", "NEW", "OPEN_BOX", "REFURBISHED", "USED", "FOR_PARTS" ], "type": "string", "description": "Condition filter applied directly to eBay. Refurbished includes Certified, Excellent, Very Good, and Good refurbished grades.", "default": "ANY" }, "buyingFormat": { "title": "Buying format", "enum": [ "ANY", "AUCTION", "BUY_IT_NOW", "ACCEPTS_OFFERS" ], "type": "string", "description": "Buying-format filter applied directly to eBay. Any omits all format parameters.", "default": "ANY" }, "maxPagesPerQuery": { "title": "Maximum pages per query", "minimum": 1, "maximum": 10, "type": "integer", "description": "Advanced request-effort cap for each search query.", "default": 5 }, "maxTotalResults": { "title": "Maximum results for the run", "minimum": 0, "maximum": 120000, "type": "integer", "description": "Advanced whole-run cap across every query. Set to 0 for unlimited results within the Actor safety limit.", "default": 1000 } } }, "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 } } } } } } } } } }