{ "openapi": "3.0.1", "info": { "title": "Otomoto Listings Scraper", "description": "Scrape Otomoto.pl vehicle listings by filters or search URL: price, full specs, equipment, seller and location for cars, motorcycles, vans and trucks. Optional seller phone numbers, VIN, description and photos. No page cap, no duplicates.", "version": "0.0", "x-build-id": "YL7TUyW8wmyozvjcV" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/piotrv1001~otomoto-listings-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-piotrv1001-otomoto-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/piotrv1001~otomoto-listings-scraper/runs": { "post": { "operationId": "runs-sync-piotrv1001-otomoto-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/piotrv1001~otomoto-listings-scraper/run-sync": { "post": { "operationId": "run-sync-piotrv1001-otomoto-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": { "searchUrls": { "title": "Search URLs", "type": "array", "description": "Otomoto search result URLs, copied from your browser after setting filters on otomoto.pl, e.g. https://www.otomoto.pl/osobowe/bmw/x5/od-2018?search%5Bfilter_enum_fuel_type%5D=diesel. Every filter, the sort order and the page number in the URL are kept. When you add URLs, the filter fields below are ignored.", "items": { "type": "string" } }, "category": { "title": "Category", "enum": [ "cars", "motorcycles", "vans", "trucks", "construction", "trailers", "agricultural", "parts" ], "type": "string", "description": "Vehicle category to search when no search URLs are given. Defaults to passenger cars." }, "keyword": { "title": "Keyword", "type": "string", "description": "Free-text search, e.g. \"tesla model 3\" or \"webasto\"." }, "make": { "title": "Make", "type": "string", "description": "Vehicle make as on otomoto.pl, e.g. \"Toyota\", \"BMW\", \"Mercedes-Benz\", \"Skoda\"." }, "model": { "title": "Model", "type": "string", "description": "Model of the chosen make, e.g. \"Corolla\", \"X5\", \"Octavia\". Needs \"Make\"." }, "priceMin": { "title": "Min price (PLN)", "minimum": 0, "type": "integer", "description": "Lowest price in Polish złoty." }, "priceMax": { "title": "Max price (PLN)", "minimum": 0, "type": "integer", "description": "Highest price in Polish złoty." }, "yearMin": { "title": "Year from", "minimum": 0, "maximum": 2100, "type": "integer", "description": "Oldest production year, e.g. 2018." }, "yearMax": { "title": "Year to", "minimum": 0, "maximum": 2100, "type": "integer", "description": "Newest production year." }, "mileageMin": { "title": "Min mileage (km)", "minimum": 0, "type": "integer", "description": "Lowest mileage in kilometres." }, "mileageMax": { "title": "Max mileage (km)", "minimum": 0, "type": "integer", "description": "Highest mileage in kilometres." }, "fuelType": { "title": "Fuel type", "type": "array", "description": "One or more fuel types (any of them matches).", "items": { "type": "string", "enum": [ "petrol", "diesel", "hybrid", "plugin-hybrid", "electric", "petrol-lpg", "petrol-cng", "etanol", "hidrogen" ], "enumTitles": [ "Petrol", "Diesel", "Hybrid", "Plug-in hybrid", "Electric", "Petrol + LPG", "Petrol + CNG", "Ethanol", "Hydrogen" ] } }, "bodyType": { "title": "Body type", "type": "array", "description": "One or more body types (any of them matches).", "items": { "type": "string", "enum": [ "suv", "combi", "sedan", "compact", "city-car", "mini", "minivan", "coupe", "cabrio" ], "enumTitles": [ "SUV", "Estate (kombi)", "Sedan", "Compact", "City car", "Mini", "Minivan", "Coupe", "Convertible" ] } }, "gearbox": { "title": "Gearbox", "enum": [ "manual", "automatic" ], "type": "string", "description": "Manual or automatic transmission." }, "condition": { "title": "Condition", "enum": [ "used", "new" ], "type": "string", "description": "New or used vehicles." }, "sellerType": { "title": "Seller type", "enum": [ "private", "business" ], "type": "string", "description": "Private sellers or dealers (companies)." }, "region": { "title": "Region", "enum": [ "mazowieckie", "malopolskie", "slaskie", "wielkopolskie", "dolnoslaskie", "pomorskie", "lodzkie", "kujawsko-pomorskie", "lubelskie", "podkarpackie", "zachodniopomorskie", "warminsko-mazurskie", "swietokrzyskie", "podlaskie", "lubuskie", "opolskie" ], "type": "string", "description": "Polish voivodeship. For a city with a radius, paste a search URL instead." }, "sort": { "title": "Sort by", "enum": [ "newest", "relevance", "priceAsc", "priceDesc", "mileageAsc", "mileageDesc", "powerAsc", "powerDesc" ], "type": "string", "description": "Order of results for the filter search and for search URLs that do not set their own order. \"Newest first\" is the most reliable for large runs.", "default": "newest" }, "maxItems": { "title": "Max listings", "minimum": 0, "type": "integer", "description": "Maximum number of listings to save across all searches. 0 = no limit (every result of the search, there is no page cap).", "default": 50 }, "includeDetails": { "title": "Include details (phone, VIN, description)", "type": "boolean", "description": "Also open every listing page to add the seller phone numbers, VIN, full description, all photos, equipment list and the seller address with GPS. Costs an extra detail event per listing and is slower.", "default": false }, "proxyConfiguration": { "title": "Proxy configuration", "type": "object", "description": "The default Apify proxy works for Otomoto.", "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 }, "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 } } } } } } } } } }