{ "openapi": "3.0.1", "info": { "title": "eBay Scraper - Product Listings, Prices & Sold Data", "description": "eBay scraper and API for product listings, prices and sold data. No API key. Search by keyword, category, condition, price, buying format or item URL across 9 eBay sites. Get price, seller feedback, shipping, item specifics, GTIN, images and sold-price comps. Export JSON, CSV, Excel.", "version": "0.1", "x-build-id": "ceUoFMvk9cwxObPV2" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/scrapers_lat~ebay-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-scrapers_lat-ebay-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/scrapers_lat~ebay-scraper/runs": { "post": { "operationId": "runs-sync-scrapers_lat-ebay-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/scrapers_lat~ebay-scraper/run-sync": { "post": { "operationId": "run-sync-scrapers_lat-ebay-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": { "searchQueries": { "title": "Search queries", "type": "array", "description": "Keywords to search on eBay, like \"nintendo switch\" or \"vintage rolex\". Every result page is read and paginated until Max products is reached.", "items": { "type": "string" } }, "itemUrls": { "title": "Item URLs", "type": "array", "description": "Direct eBay item URLs (https://www.ebay.com/itm/) to scrape, ideal for tracking specific listings over time.", "items": { "type": "string" } }, "startUrls": { "title": "Start URLs (search, category or item pages)", "type": "array", "description": "Paste any eBay search-results, category, or item page URLs. Search/category pages are paginated; item pages are scraped directly. Filters already encoded in the URL are respected as-is.", "items": { "type": "string" } }, "maxProducts": { "title": "Max products", "minimum": 1, "maximum": 1000000, "type": "integer", "description": "Maximum number of products to collect across all inputs combined." }, "marketplace": { "title": "Marketplace (eBay site)", "enum": [ "US", "UK", "DE", "FR", "IT", "ES", "CA", "AU", "IE" ], "type": "string", "description": "Which eBay country site to search. Sets both the domain and a matching residential proxy country.", "default": "US" }, "category": { "title": "Category ID", "type": "string", "description": "Optional eBay category ID to restrict a keyword search (for example 139973 for Video Games). Leave blank to search all categories." }, "condition": { "title": "Condition", "type": "array", "description": "Filter by item condition. Choose one or more.", "items": { "type": "string", "enum": [ "new", "open_box", "refurbished", "used", "for_parts" ], "enumTitles": [ "New", "Open box", "Refurbished", "Used", "For parts / not working" ] }, "default": [] }, "minPrice": { "title": "Min price", "minimum": 0, "type": "integer", "description": "Only return listings priced at or above this amount (in the marketplace currency)." }, "maxPrice": { "title": "Max price", "minimum": 0, "type": "integer", "description": "Only return listings priced at or below this amount (in the marketplace currency)." }, "listingType": { "title": "Buying format", "enum": [ "all", "buy_it_now", "auction", "best_offer" ], "type": "string", "description": "Restrict to a buying format.", "default": "all" }, "freeShipping": { "title": "Free shipping only", "type": "boolean", "description": "Only return listings that offer free shipping.", "default": false }, "location": { "title": "Item location", "enum": [ "any", "us", "north_america", "europe", "asia", "worldwide" ], "type": "string", "description": "Preferred item location filter.", "default": "any" }, "sort": { "title": "Sort order", "enum": [ "best_match", "ending_soonest", "newly_listed", "price_low", "price_high" ], "type": "string", "description": "How eBay orders the results.", "default": "best_match" }, "soldListings": { "title": "Sold / completed listings (price comps)", "type": "boolean", "description": "Return past SOLD and completed listings instead of active ones, to get real sold-price comparables for market research and pricing. Applies to search queries and search start URLs.", "default": false }, "withDetails": { "title": "Scrape item details", "type": "boolean", "description": "Open each item page to add full item specifics (brand, model, MPN, UPC and every other attribute), the complete image gallery, sold count, quantity available, return policy and availability. Turn off for a faster, lighter run.", "default": true }, "withDescription": { "title": "AI: clean & translate title (paid add-on)", "type": "boolean", "description": "Opt-in AI add-on (paid plans only), off by default. Turn the noisy listing title into a concise clean product name and an English name. Charged only when the model returns usable output.", "default": false }, "withAttributes": { "title": "AI: extract attributes & category (paid add-on)", "type": "boolean", "description": "Opt-in AI add-on (paid plans only), off by default. Extract normalized structured product attributes/specs and a broad product category from the title and item specifics. Charged only when the model returns usable output.", "default": false } } }, "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 } } } } } } } } } }