{ "openapi": "3.0.1", "info": { "title": "eBay Scraper — Search, Listings, Prices & Sellers", "description": "eBay search results and item pages as structured rows: price, list price, shipping, condition, buying format, bids, units sold, watchers, seller feedback and location. Filter by price server-side across 11 marketplaces. Pay per listing row.", "version": "1.0", "x-build-id": "LsaEKNGmziLM6auOh" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/kestrel~ebay-search-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-kestrel-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/kestrel~ebay-search-scraper/runs": { "post": { "operationId": "runs-sync-kestrel-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/kestrel~ebay-search-scraper/run-sync": { "post": { "operationId": "run-sync-kestrel-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": { "queries": { "title": "Search keywords", "uniqueItems": true, "type": "array", "description": "Keywords to search, exactly as a shopper would type them: \"mechanical keyboard\", \"vintage pocket watch\". Each is searched across the pages set below, on the marketplace you choose.", "default": [], "items": { "type": "string" } }, "startUrls": { "title": "eBay URLs", "uniqueItems": true, "type": "array", "description": "eBay search URLs (https://www.ebay.com/sch/i.html?_nkw=...) to read exactly as pasted — every filter already in the URL is kept — and/or individual item URLs (https://www.ebay.com/itm/123456789012), which return the richer item-page row. The marketplace is taken from each URL, so you can mix countries in one run.", "default": [], "items": { "type": "string" } }, "domain": { "title": "Marketplace", "type": "string", "description": "eBay marketplace for the keyword searches: com, de, fr, it, es, at, nl, pl, com.au, com.sg, com.my. These are the hosts measured answering reliably on 2026-08-29; eBay UK, Ireland, Canada, Switzerland and Hong Kong currently return an anti-bot challenge on every proxy pool, so they are not offered here — paste their URLs into the field above if you want to try anyway. URLs bring their own marketplace.", "default": "com" }, "buyingFormat": { "title": "Buying format", "enum": [ "all", "buy_it_now", "auction" ], "type": "string", "description": "Restrict to Buy It Now listings or to auctions. Auction cards carry the bid count and the time left; fixed-price cards carry units sold and watchers.", "default": "all" }, "conditions": { "title": "Item condition", "uniqueItems": true, "type": "array", "description": "Keep only these conditions. eBay grades refurbished in four separate tiers, so pick the ones you actually accept. Leave empty for every condition.", "items": { "type": "string", "enum": [ "new", "open_box", "certified_refurbished", "excellent_refurbished", "very_good_refurbished", "good_refurbished", "seller_refurbished", "used", "for_parts" ], "enumTitles": [ "New", "Open box", "Certified refurbished", "Excellent - refurbished", "Very good - refurbished", "Good - refurbished", "Seller refurbished", "Used / pre-owned", "For parts or not working" ] }, "default": [] }, "minPrice": { "title": "Minimum price", "minimum": 0, "maximum": 10000000, "type": "integer", "description": "Lower price bound in the marketplace's own currency. Sent to eBay as _udlo so the results arrive already filtered, then checked again before billing — you are never charged for a listing outside your range.", "default": 0 }, "maxPrice": { "title": "Maximum price", "minimum": 0, "maximum": 10000000, "type": "integer", "description": "Upper price bound in the marketplace's own currency. Sent to eBay as _udhi and checked again before billing. Leave at 0 for no upper bound.", "default": 0 }, "category": { "title": "Category id", "type": "string", "description": "Optional eBay category id to search inside, e.g. \"175672\" for computer components. It is the _sacat number in any eBay category URL. Leave empty to search all of eBay.", "default": "" }, "sortBy": { "title": "Sort order", "enum": [ "best_match", "ending_soonest", "newly_listed", "price_low", "price_high" ], "type": "string", "description": "How eBay orders the results. Price sorts are on price plus shipping, which is what a shopper actually compares.", "default": "best_match" }, "pages": { "title": "Pages per keyword or URL", "minimum": 1, "maximum": 34, "type": "integer", "description": "How many result pages to walk. Each page carries 60 listings, and eBay stops paginating a search at about 2000 items however many it reports.", "default": 1 }, "maxResultsPerQuery": { "title": "Max listings per keyword or URL", "minimum": 0, "maximum": 2000, "type": "integer", "description": "0 = everything the pages returned. N = the first N in eBay's order. The main cost control: the run stops fetching once each job has N.", "default": 0 }, "sessions": { "title": "Parallel sessions", "minimum": 1, "maximum": 16, "type": "integer", "description": "How many proxy sessions (egress IPs) run in parallel. More is faster; each is paced separately and warmed on eBay's homepage before its first request.", "default": 4 }, "perIp": { "title": "Requests per second per IP", "minimum": 0.1, "maximum": 2, "type": "number", "description": "Pace for each session. eBay tolerates about 0.5/s per IP; faster earns interstitials, not speed.", "default": 0.5 }, "proxyConfiguration": { "title": "Proxy", "type": "object", "description": "Apify Proxy is required: eBay answers unproxied and unrotated callers with an Akamai interstitial. The run starts on datacentre proxies and escalates to RESIDENTIAL by itself when eBay pushes back.", "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 } } } } } } } } } }