{ "openapi": "3.0.1", "info": { "title": "eBay Scraper - Listings, Sold Prices & Sellers (8 markets)", "description": "Scrape eBay active and sold listings, products, and seller info across 8 marketplaces (US/UK/DE/FR/IT/ES/CA/AU). Search by keyword or paste eBay URLs. Returns flat JSON with 28 fields per item — built for resellers, dropshippers, and AI agents.", "version": "0.5", "x-build-id": "h9VA3HySpSNMQNAF3" }, "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 on eBay (e.g., 'iphone 15 pro 256gb', 'vintage rolex submariner'). Supports eBay's standard search syntax including quotes for exact match and minus signs for exclusions. Leave empty if you provide startUrls. NOT a product URL — for direct URL scraping use the startUrls field below." }, "startUrls": { "title": "Start URLs (alternative to Search Query)", "type": "array", "description": "Direct eBay URLs to scrape. Accepts search result URLs (https://www.ebay.com/sch/i.html?_nkw=...), category URLs, OR individual item URLs (https://www.ebay.com/itm/...). When provided, searchQuery and other filter fields are ignored. NOT for seller storefront URLs — those return 0 results.", "default": [], "items": { "type": "object", "required": [ "url" ], "properties": { "url": { "type": "string", "title": "URL of a web page", "format": "uri" } } } }, "mode": { "title": "Listing Mode", "enum": [ "active", "sold", "both" ], "type": "string", "description": "What to scrape: 'active' returns currently listed items (Buy It Now + auctions), 'sold' returns sold/completed listings for price comps (last ~90 days), 'both' returns active first then sold. Default is 'active'. Sold mode is the eBay equivalent of Terapeak/Sold Comps.", "default": "active" }, "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": "Which eBay regional site to scrape. Affects currency, language, and available inventory. Default is ebay.com (US). NOT all sellers ship internationally — pick the marketplace closest to your buyer location for accurate pricing.", "default": "ebay.com" }, "maxResults": { "title": "Max Results", "minimum": 1, "maximum": 10000, "type": "integer", "description": "Maximum number of items to return. eBay paginates 60 results per page; the actor handles pagination automatically. Set to 50 for quick test runs, 1000+ for full market sweeps. Hard cap is 10000 to protect against runaway PPE costs.", "default": 50 }, "condition": { "title": "Item Condition", "enum": [ "any", "new", "used", "refurbished", "open_box" ], "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" }, "detailedItems": { "title": "Visit each item page (slower, richer data)", "type": "boolean", "description": "When true, the actor visits each item's detail page to extract item specifics (brand, model, MPN, color, etc.), full description, seller feedback details, and gallery images. Roughly 3x slower and 3x more PPE cost. Default is false (search-page data only).", "default": false }, "proxyConfiguration": { "title": "Proxy Configuration", "type": "object", "description": "Proxy settings. Leave default — residential proxies are required for eBay reliability and the actor configures them automatically.", "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 } } }, "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 } } } } } } } } } }