{ "openapi": "3.0.1", "info": { "title": "eBay Listings Scraper", "description": "eBay Scraper SD - eBay Scraper is an e-commerce data tool that extracts active eBay listings by search term or URL: item ID, title, condition, price, bids, shipping, location, seller rating and feedback, page after page, plus optional item-page details. No login.", "version": "1.0", "x-build-id": "UFfOpbRTOTH9nnJkz" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/neuro-scraper~ebay-listings-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-neuro-scraper-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/neuro-scraper~ebay-listings-scraper/runs": { "post": { "operationId": "runs-sync-neuro-scraper-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/neuro-scraper~ebay-listings-scraper/run-sync": { "post": { "operationId": "run-sync-neuro-scraper-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", "properties": { "searchTerms": { "title": "Search terms", "type": "array", "description": "What you would type into the eBay search box, one term per line. Each term is searched on ebay.com among active listings. Example: iphone 13", "items": { "type": "string" } }, "startUrls": { "title": "eBay search or item URLs (optional)", "type": "array", "description": "Paste eBay search result URLs, e.g. https://www.ebay.com/sch/i.html?_nkw=lego+star+wars&LH_Auction=1 (every filter in the URL is kept), or item URLs, e.g. https://www.ebay.com/itm/267543612733 (an ended listing is returned too, with listingStatus ENDED and the price its page shows). Sites tested: ebay.com, ebay.co.uk, ebay.de. Sold / completed SEARCH URLs (LH_Sold=1, LH_Complete=1) need an eBay login since 2026 and are skipped with an error.", "items": { "type": "object", "required": [ "url" ], "properties": { "url": { "type": "string", "title": "URL of a web page", "format": "uri" } } } }, "maxItems": { "title": "Max results", "minimum": 1, "type": "integer", "description": "Maximum number of listings to return in total. Result pages are read one after another until this number is reached or eBay has no next page. Example: 100", "default": 20 }, "maxPagesPerSearch": { "title": "Max result pages per search", "minimum": 1, "maximum": 200, "type": "integer", "description": "Safety limit on result pages read per search term or search URL. Example: 5", "default": 50 }, "itemsPerPage": { "title": "Results per page", "enum": [ "auto", "60", "120", "240" ], "type": "string", "description": "How many listings eBay puts on one result page (60, 120 or 240). Auto picks the smallest size that covers Max results, so small runs download less. A search URL that already sets _ipg keeps its own value. Example: 240 for runs of 1,000+ listings.", "default": "auto" }, "buyingFormat": { "title": "Buying format", "enum": [ "all", "buyItNow", "auction" ], "type": "string", "description": "Only for search terms (a pasted search URL keeps its own filters). Buy It Now includes fixed-price listings that also accept Best Offer. Example: Auction.", "default": "all" }, "condition": { "title": "Condition", "enum": [ "any", "new", "used" ], "type": "string", "description": "Only for search terms. New = eBay's \"Brand New\" condition, Used = \"Pre-Owned\" / used. Example: Used.", "default": "any" }, "sort": { "title": "Sort order", "enum": [ "bestMatch", "newlyListed", "endingSoonest", "priceLowest", "priceHighest" ], "type": "string", "description": "Only for search terms. Price sorts include shipping, as on eBay. Example: Ending soonest.", "default": "bestMatch" }, "minPrice": { "title": "Minimum price (optional)", "minimum": 0, "type": "integer", "description": "Only for search terms. Lowest item price in the site's currency (USD on ebay.com); 0 = no minimum. Example: 100", "default": 0 }, "maxPrice": { "title": "Maximum price (optional)", "minimum": 0, "type": "integer", "description": "Only for search terms. Highest item price in the site's currency; 0 = no maximum. Example: 300", "default": 0 }, "includeDetails": { "title": "Add item-page details", "type": "boolean", "description": "Open every result's item page and add brand, model, MPN / GTIN, availability, quantity and sold count, all images, shipping options, return policy, payment methods, category path, listing start time, seller notes, item specifics and seller details. Costs one extra request per listing, so runs are slower. Example: on, to get item specifics for 50 listings.", "default": false }, "proxyConfiguration": { "title": "Proxy configuration", "type": "object", "description": "eBay is protected by Akamai Bot Manager. Residential proxy in the US is recommended and is the default; a blocked page is retried on a new proxy IP. Shipping costs follow the proxy country. Example: RESIDENTIAL group, country US.", "default": { "useApifyProxy": true, "apifyProxyGroups": [ "RESIDENTIAL" ], "apifyProxyCountry": "US" } } } }, "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 } } } } } } } } } }