{ "openapi": "3.0.1", "info": { "title": "OtoMoto.pl Cars Scraper: Samochody używane", "description": "Scrape OtoMoto.pl (ogłoszenia samochodowe) for used car listings by make, model, price, mileage, year, and fuel type. Get price, mileage, seller type, and links as JSON, CSV, or Excel. Export to Sheets, Make, Zapier. Skip manual copy-paste. $0.00086 per listing.", "version": "0.1", "x-build-id": "N4HKLLiDWeKFIinRx" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/getascraper~otomoto-cars-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-getascraper-otomoto-cars-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/getascraper~otomoto-cars-scraper/runs": { "post": { "operationId": "runs-sync-getascraper-otomoto-cars-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/getascraper~otomoto-cars-scraper/run-sync": { "post": { "operationId": "run-sync-getascraper-otomoto-cars-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": { "startUrls": { "title": "Start URLs (advanced override)", "type": "array", "description": "Optional. Paste one or more OtoMoto search or listing URLs to scrape exactly that page instead of building a URL from the filters below. When set, this takes priority and the filter fields below are ignored.", "items": { "type": "object", "required": [ "url" ], "properties": { "url": { "type": "string", "title": "URL of a web page", "format": "uri" } } } }, "make": { "title": "Make", "type": "string", "description": "Vehicle brand to filter by, such as 'bmw', 'audi', or 'mercedes-benz'. Matches OtoMoto's own brand slug. Leave blank to search all makes.", "default": "" }, "model": { "title": "Model", "type": "string", "description": "Model slug, only applied when Make is also set. OtoMoto model slugs are body-style specific (for example Audi A4 is 'a4-limousine', 'a4-avant', or 'a4-allroad'; Mercedes E-Class is 'e-klasa'). Browse the model on otomoto.pl and copy the slug from its URL if unsure. An unrecognized slug is ignored by OtoMoto rather than erroring, so results fall back to the make-only search.", "default": "" }, "bodyType": { "title": "Body Type", "enum": [ "", "mini", "city-car", "compact", "sedan", "combi", "coupe", "cabrio", "suv", "minivan" ], "type": "string", "description": "Vehicle body style.", "default": "" }, "fuelType": { "title": "Fuel Type", "enum": [ "", "petrol", "diesel", "petrol-lpg", "petrol-cng", "hybrid", "plugin-hybrid", "electric", "etanol", "hidrogen" ], "type": "string", "description": "Fuel type.", "default": "" }, "transmission": { "title": "Transmission", "enum": [ "", "manual", "automatic" ], "type": "string", "description": "Gearbox type.", "default": "" }, "priceFrom": { "title": "Price From (PLN)", "minimum": 0, "type": "integer", "description": "Minimum asking price in Polish złoty." }, "priceTo": { "title": "Price To (PLN)", "minimum": 0, "type": "integer", "description": "Maximum asking price in Polish złoty." }, "yearFrom": { "title": "Year From", "minimum": 1900, "maximum": 2100, "type": "integer", "description": "Earliest production year." }, "yearTo": { "title": "Year To", "minimum": 1900, "maximum": 2100, "type": "integer", "description": "Latest production year." }, "mileageFrom": { "title": "Mileage From (km)", "minimum": 0, "type": "integer", "description": "Minimum odometer reading in kilometers." }, "mileageTo": { "title": "Mileage To (km)", "minimum": 0, "type": "integer", "description": "Maximum odometer reading in kilometers." }, "region": { "title": "Region (Voivodeship)", "enum": [ "", "dolnoslaskie", "kujawsko-pomorskie", "lubelskie", "lubuskie", "lodzkie", "malopolskie", "mazowieckie", "opolskie", "podkarpackie", "podlaskie", "pomorskie", "slaskie", "swietokrzyskie", "warminsko-mazurskie", "wielkopolskie", "zachodniopomorskie" ], "type": "string", "description": "Restrict results to one Polish voivodeship. Applied instead of Model, since OtoMoto exposes only one filter path segment at a time.", "default": "" }, "sellerType": { "title": "Seller Type", "enum": [ "", "private", "business" ], "type": "string", "description": "Only private-seller or only dealer listings.", "default": "" }, "maxItems": { "title": "Maximum Listings", "minimum": 1, "maximum": 1000, "type": "integer", "description": "Maximum number of unique car listings to return.", "default": 25 }, "maxPages": { "title": "Maximum Search Pages", "minimum": 1, "maximum": 20, "type": "integer", "description": "Maximum number of search pages to visit.", "default": 5 }, "proxyConfiguration": { "title": "Proxy Configuration", "type": "object", "description": "Optional proxy settings. OtoMoto works with a direct connection by default.", "default": { "useApifyProxy": 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 } } } } } } } } } }