{ "openapi": "3.0.1", "info": { "title": "eBay Active Listings & Auctions Search Scraper: US, UK, Germany", "description": "eBay active listings and auctions by keyword or search URL on ebay.com, .co.uk, .de, .ca and .com.au: price, shipping cost, condition, auction or Buy It Now, bids, time left, seller feedback score and sponsored flag. $2.50 per 1,000 items, with plan discounts. No login, so no sold listings.", "version": "0.1", "x-build-id": "2HjQ3KUUcns3sTyPS" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/charitable_trousseau~ebay-search-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-charitable_trousseau-ebay-search-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/charitable_trousseau~ebay-search-scraper/runs": { "post": { "operationId": "runs-sync-charitable_trousseau-ebay-search-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/charitable_trousseau~ebay-search-scraper/run-sync": { "post": { "operationId": "run-sync-charitable_trousseau-ebay-search-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", "properties": { "keywords": { "title": "Keywords", "type": "array", "description": "What to search for, one search per line, for example mechanical keyboard. If this and the search URLs are both empty, the example search mechanical keyboard on ebay.com runs.", "items": { "type": "string" } }, "site": { "title": "eBay site", "enum": [ "ebay.com", "ebay.co.uk", "ebay.de", "ebay.ca", "ebay.com.au" ], "type": "string", "description": "Which eBay site to search with the keywords above. Prices come in that site's currency.", "default": "ebay.com" }, "sort": { "title": "Sort by", "enum": [ "best_match", "ending_soonest", "newly_listed", "price_lowest", "price_highest" ], "type": "string", "description": "Applies to keywords.", "default": "best_match" }, "condition": { "title": "Condition", "enum": [ "any", "new", "open_box", "refurbished", "used", "for_parts" ], "type": "string", "description": "Applies to keywords.", "default": "any" }, "listingType": { "title": "Listing type", "enum": [ "all", "auction", "buy_it_now", "best_offer" ], "type": "string", "description": "Applies to keywords.", "default": "all" }, "searchUrls": { "title": "eBay search URLs", "type": "array", "description": "Optional, for any other filter: run a search on eBay, set the filters you want, and paste the address of the results page. Supported sites: ebay.com, ebay.co.uk, ebay.de, ebay.ca, ebay.com.au. Sold-listing searches are not supported.", "items": { "type": "string" } }, "maxItemsPerSearch": { "title": "Maximum items per search", "minimum": 1, "type": "integer", "description": "Stop each keyword or URL after this many items. eBay shows 60 per page.", "default": 100 }, "proxyConfiguration": { "title": "Proxy", "type": "object", "description": "The default (Apify residential proxies) is the fast route and is recommended; each eBay site is reached from its own country. Choosing the UNBLOCKER group instead sends every page through Apify's unblocker, which is much slower. Datacenter proxies are not verified to work.", "default": { "useApifyProxy": true, "apifyProxyGroups": [ "RESIDENTIAL" ] } } } }, "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 } } } } } } } } } }