{ "openapi": "3.0.1", "info": { "title": "eBay Scraper — Listings, Prices & Item Details (8 Sites)", "description": "Scrape active eBay listings by keyword or item URL on 8 eBay sites: price, shipping, total, condition, bids, sold count, seller, specifics. Fast HTTP-first; no sold search.", "version": "0.10", "x-build-id": "x2ve1k55iaQonfGUr" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/khadinakbar~ebay-all-in-one-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-khadinakbar-ebay-all-in-one-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/khadinakbar~ebay-all-in-one-scraper/runs": { "post": { "operationId": "runs-sync-khadinakbar-ebay-all-in-one-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/khadinakbar~ebay-all-in-one-scraper/run-sync": { "post": { "operationId": "run-sync-khadinakbar-ebay-all-in-one-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": { "searchQuery": { "title": "Search Query", "type": "string", "description": "Keyword to search current eBay listings, for example \"canon ae-1\". Leave empty when using Search Queries or Start URLs." }, "searchQueries": { "title": "Search Queries (several keywords)", "type": "array", "description": "Optional list of keywords. Each keyword is searched separately with the same filters, and Max Results applies to each keyword. Up to 20 keywords. An item already saved for one keyword is not saved or charged again.", "items": { "type": "string" } }, "startUrls": { "title": "Start URLs (alternative to Search Query)", "type": "array", "description": "Public HTTPS eBay /itm/ item URLs or active /sch/ search URLs from any supported site (ebay.com, ebay.co.uk, ebay.de, ebay.fr, ebay.it, ebay.es, ebay.ca, ebay.com.au). Sold/completed filters and category/storefront URLs are rejected. When provided, keyword and search filters are ignored.", "default": [], "items": { "type": "object", "required": [ "url" ], "properties": { "url": { "type": "string", "title": "URL of a web page", "format": "uri" } } } }, "marketplace": { "title": "eBay Marketplace", "enum": [ "ebay.com", "ebay.co.uk", "ebay.de", "ebay.fr", "ebay.it", "ebay.es", "ebay.ca", "ebay.com.au" ], "type": "string", "description": "eBay site to search. Each site shows its own listings in its own currency.", "default": "ebay.com" }, "maxResults": { "title": "Max Results", "minimum": 1, "maximum": 10000, "type": "integer", "description": "Maximum saved items per keyword (for Start URLs: in total). Start small to bound pay-per-event charges. Hard cap: 10000.", "default": 50 }, "condition": { "title": "Item Condition", "enum": [ "any", "new", "used", "refurbished", "open_box", "for_parts" ], "type": "string", "description": "Filter by item condition. 'any' returns all conditions (default). NOT applied when startUrls already encode a condition filter in the URL.", "default": "any" }, "minPrice": { "title": "Minimum Price", "minimum": 0, "type": "integer", "description": "Lower bound on listing price (in marketplace currency). Leave blank for no minimum. Example: 100 returns items priced $100 and above. NOT applied when startUrls already encode price filters." }, "maxPrice": { "title": "Maximum Price", "minimum": 0, "type": "integer", "description": "Upper bound on listing price (in marketplace currency). Leave blank for no maximum. Example: 500 returns items priced $500 and below. NOT applied when startUrls already encode price filters." }, "sortBy": { "title": "Sort Order", "enum": [ "best_match", "ending_soon", "newest", "price_asc", "price_desc" ], "type": "string", "description": "How eBay should order the results before scraping. 'best_match' (default) is eBay's relevance ranking. 'ending_soon' surfaces auctions about to close. 'price_asc' / 'price_desc' for cheapest / most expensive first. NOT applied when startUrls already encode sort.", "default": "best_match" }, "listingType": { "title": "Listing Type", "enum": [ "all", "auction", "buy_it_now", "best_offer" ], "type": "string", "description": "Only auctions, only Buy It Now, or only listings that accept Best Offer. 'all' keeps every format.", "default": "all" }, "freeShipping": { "title": "Free shipping only", "type": "boolean", "description": "Only listings with free shipping or delivery.", "default": false }, "returnsAccepted": { "title": "Returns accepted only", "type": "boolean", "description": "Only listings whose seller accepts returns.", "default": false }, "itemLocation": { "title": "Item Location", "enum": [ "default", "domestic", "worldwide" ], "type": "string", "description": "Where items ship from, relative to the selected site: 'domestic' keeps items located in that country; 'worldwide' includes all locations.", "default": "default" }, "categoryId": { "title": "Category ID", "type": "string", "description": "Optional numeric eBay category ID to search within, for example 15230 (Film Cameras on ebay.com). Category IDs differ between sites." }, "seller": { "title": "Seller username", "type": "string", "description": "Optional eBay seller username to search only that seller's listings, for example a store's username (not its display name)." }, "detailedItems": { "title": "Visit each item page (slower, richer data)", "type": "boolean", "description": "Visit each result's item page for item specifics, brand, MPN, full seller fields, returns, location, category path, description and gallery images. Slower, and uses the detailed-item event price shown in Pricing. If a detail page stays unavailable, the search card is saved at the lower result price with a warning and PARTIAL outcome.", "default": false }, "proxyConfiguration": { "title": "Proxy Configuration", "type": "object", "description": "Optional. By default the Actor uses its own residential HTTP routes first and a browser only as backup. A custom proxy here applies to the browser backup.", "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 } } } } } } } } } }