{ "openapi": "3.0.1", "info": { "title": "OLX Motoryzacja Polska: Samochody, Filtry, Monitoring", "description": "Scraper OLX.pl dla motoryzacji: samochody osobowe, motocykle, ciężarowe, dostawcze, części. Multi-brand i multi-model. Pełne filtry (marka, rocznik, przebieg, paliwo, skrzynia, cena, miasto z promieniem). Monitoring nowych okazji dla autokomisów. Od Klevio, polski specjalista e-commerce.", "version": "1.0", "x-build-id": "ie2Ihf6lQ1CWYEKID" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/klevio~olx-motoryzacja-pl/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-klevio-olx-motoryzacja-pl", "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/klevio~olx-motoryzacja-pl/runs": { "post": { "operationId": "runs-sync-klevio-olx-motoryzacja-pl", "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/klevio~olx-motoryzacja-pl/run-sync": { "post": { "operationId": "run-sync-klevio-olx-motoryzacja-pl", "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": { "kategoria": { "title": "Kategoria", "enum": [ "samochody-osobowe", "motocykle", "ciezarowe", "dostawcze", "przyczepy-naczepy", "czesci" ], "type": "string", "description": "Wybierz typ pojazdu.", "default": "samochody-osobowe" }, "marki": { "title": "Marki", "type": "array", "description": "Wybierz jedną lub kilka marek jednocześnie, na przykład BMW, Audi, Mercedes-Benz. Puste oznacza wszystkie marki (tylko dla samochodów osobowych).", "items": { "type": "string", "enum": [ "alfa-romeo", "audi", "bmw", "chevrolet", "chrysler", "citroen", "daewoo", "fiat", "ford", "honda", "hyundai", "kia", "lancia", "mazda", "mercedes-benz", "mitsubishi", "nissan", "opel", "peugeot", "renault", "saab", "seat", "skoda", "subaru", "suzuki", "toyota", "volkswagen", "volvo", "pozostale", "rover", "landrover", "jeep", "polonez", "smart", "mini", "porsche", "dodge", "jaguar", "dacia", "daihatsu", "lexus", "cadillac", "infiniti", "aixam", "ssangyong", "cupra", "jaecoo", "omoda", "byd", "mg", "abarth", "acura", "alpina", "aston-martin", "baic", "bentley", "buick", "chatenet", "dfsk", "ds-automobiles", "e-go", "elaris", "ferrari", "forthing", "genesis", "gmc", "hongqi", "hummer", "ineos", "isuzu", "iveco", "lada", "lamborghini", "ligier", "lincoln", "maserati", "maxus", "mclaren", "microcar", "pontiac", "ram", "rolls-royce", "tesla", "zhidou", "leapmotor", "lotus", "lucid", "lynk-and-co", "chery", "geely", "ariel", "baw", "maextro", "denza", "blaval", "swm", "dr-motor", "ich-x", "sportequipe", "zeekr", "chery-fulwin", "xpeng", "changan", "gac" ], "enumTitles": [ "Alfa Romeo", "Audi", "BMW", "Chevrolet", "Chrysler", "Citroen", "Daewoo", "Fiat", "Ford", "Honda", "Hyundai", "Kia", "Lancia", "Mazda", "Mercedes-Benz", "Mitsubishi", "Nissan", "Opel", "Peugeot", "Renault", "Saab", "Seat", "Skoda", "Subaru", "Suzuki", "Toyota", "Volkswagen", "Volvo", "Pozostałe osobowe", "Rover", "Land Rover", "Jeep", "Polonez", "Smart", "Mini", "Porsche", "Dodge", "Jaguar", "Dacia", "Daihatsu", "Lexus", "Cadillac", "Infiniti", "Aixam", "SsangYong / KGM", "Cupra", "Jaecoo", "Omoda", "BYD", "MG", "Abarth", "Acura", "BMW Alpina", "Aston Martin", "Baic", "Bentley", "Buick", "Chatenet", "DFSK", "DS Automobiles", "e.GO", "Elaris", "Ferrari", "Forthing", "Genesis", "GMC", "Hongqi", "Hummer", "Ineos", "Isuzu", "Iveco", "Lada", "Lamborghini", "Ligier", "Lincoln", "Maserati", "Maxus", "McLaren", "Microcar", "Pontiac", "RAM", "Rolls-Royce", "Tesla", "Zhidou", "Leapmotor", "Lotus", "Lucid", "Lynk & Co", "Chery", "Geely", "Ariel", "BAW", "Maextro", "Denza", "Blaval", "SWM", "DR MOTOR", "ICH-X", "Sportequipe", "ZEEKR", "Chery Fulwin", "XPeng", "Changan", "GAC" ] } }, "modele": { "title": "Modele", "type": "array", "description": "Wpisz konkretne modele oddzielone przecinkiem, na przykład Golf, Passat lub Seria 3, X5. Puste oznacza wszystkie modele wybranych marek. Działa najlepiej gdy wybrana jest jedna marka.", "items": { "type": "string" } }, "cenaOd": { "title": "Cena od (zł)", "minimum": 0, "type": "integer", "description": "Dolny próg ceny." }, "cenaDo": { "title": "Cena do (zł)", "minimum": 0, "type": "integer", "description": "Górny próg ceny." }, "rocznikOd": { "title": "Rocznik od", "minimum": 1900, "maximum": 2030, "type": "integer", "description": "Najstarszy rok produkcji." }, "rocznikDo": { "title": "Rocznik do", "minimum": 1900, "maximum": 2030, "type": "integer", "description": "Najnowszy rok produkcji." }, "przebiegOd": { "title": "Przebieg od (km)", "minimum": 0, "type": "integer", "description": "Dolny próg przebiegu." }, "przebiegDo": { "title": "Przebieg do (km)", "minimum": 0, "type": "integer", "description": "Górny próg przebiegu." }, "paliwa": { "title": "Rodzaj paliwa", "type": "array", "description": "Można wybrać kilka.", "items": { "type": "string", "enum": [ "petrol", "diesel", "lpg", "electric", "plugin-hybrid", "cng" ], "enumTitles": [ "Benzyna", "Diesel", "LPG (gaz)", "Elektryczny", "Hybryda plug-in", "CNG i Hybryda" ] } }, "skrzynia": { "title": "Skrzynia biegów", "enum": [ "all", "manual", "automatic" ], "type": "string", "description": "", "default": "all" }, "naped": { "title": "Napęd", "enum": [ "all", "front-wheel", "rear-wheel", "all-wheel-permanent", "all-wheel-lock", "all-wheel-auto" ], "type": "string", "description": "", "default": "all" }, "pojemnoscOd": { "title": "Pojemność silnika od (cm³)", "minimum": 0, "type": "integer", "description": "Dolny próg pojemności." }, "pojemnoscDo": { "title": "Pojemność silnika do (cm³)", "minimum": 0, "type": "integer", "description": "Górny próg pojemności." }, "mocOd": { "title": "Moc od (KM)", "minimum": 0, "type": "integer", "description": "Dolny próg mocy." }, "mocDo": { "title": "Moc do (KM)", "minimum": 0, "type": "integer", "description": "Górny próg mocy." }, "typNadwozia": { "title": "Typ nadwozia", "type": "array", "description": "Dla samochodów osobowych (można wybrać kilka).", "items": { "type": "string", "enum": [ "sedan", "hatchback", "estate-car", "suv", "coupe", "cabriolet", "pickup", "off-road-vehicle", "minibus", "mvp" ], "enumTitles": [ "Sedan", "Hatchback", "Kombi", "SUV", "Coupe", "Kabriolet", "Pickup", "Terenowy", "Minibus", "Minivan" ] } }, "kolor": { "title": "Kolor", "type": "array", "description": "Można wybrać kilka.", "items": { "type": "string", "enum": [ "bialy", "czarny", "szary", "srebrny", "niebieski", "brazowy_bezowy", "czerwony", "zielony", "zolty_zloty", "inny" ], "enumTitles": [ "Biały", "Czarny", "Szary", "Srebrny", "Niebieski", "Brązowy / Beżowy", "Czerwony", "Zielony", "Żółty / Złoty", "Inny" ] } }, "stan": { "title": "Stan techniczny", "enum": [ "all", "notdamaged", "damaged" ], "type": "string", "description": "", "default": "all" }, "miasto": { "title": "Miasto", "type": "string", "description": "Nazwa miasta, na przykład Warszawa, Kraków. Puste oznacza cała Polska." }, "promienKm": { "title": "Promień od miasta", "enum": [ "0", "5", "10", "15", "30", "50", "75", "100" ], "type": "string", "description": "Rozszerz wyszukiwanie o okoliczne miejscowości w promieniu wybranej liczby kilometrów. Wymaga podanego miasta.", "default": "0" }, "typSprzedawcy": { "title": "Typ sprzedawcy", "enum": [ "all", "private", "business" ], "type": "string", "description": "", "default": "all" }, "tylkoZeZdjeciem": { "title": "Tylko ogłoszenia ze zdjęciem", "type": "boolean", "description": "Pomiń ogłoszenia bez żadnego zdjęcia.", "default": false }, "opublikowaneW": { "title": "Opublikowane w ciągu", "enum": [ "all", "24h", "7d", "30d" ], "type": "string", "description": "Ogranicz do ogłoszeń dodanych w wybranym okresie.", "default": "all" }, "maxLiczbaOgloszen": { "title": "Maks. liczba ogłoszeń na run", "minimum": 1, "type": "integer", "description": "Bezpiecznik kosztów, górny limit ogłoszeń w jednym uruchomieniu (dla wszystkich marek łącznie).", "default": 500 }, "monitorNowe": { "title": "🔔 Monitoruj tylko NOWE ogłoszenia od ostatniego runu", "type": "boolean", "description": "Najmocniejsza funkcja dla autokomisów. Aktor pamięta co już widział i przy kolejnych uruchomieniach zwraca tylko nowe ogłoszenia. Ustaw harmonogram w zakładce Schedules i bądź pierwszy do kontaktu.", "default": false }, "wykrywajZmianyCen": { "title": "📉 Wykrywaj zmiany cen", "type": "boolean", "description": "W trybie monitoringu zwracaj także ogłoszenia gdzie cena się zmieniła (wyłapywanie okazji). Zawiera pole poprzedniej ceny.", "default": true }, "uzyjProxy": { "title": "Użyj proxy Apify (rotacja IP)", "type": "boolean", "description": "Domyślnie wyłączone. OLX działa najlepiej przy bezpośrednim połączeniu. Włącz tylko przy bardzo dużych wolumenach, jeśli pojawia się ograniczanie zapytań. Uwaga: proxy datacenter bywa blokowane przez OLX.", "default": false }, "advancedUrls": { "title": "🔧 Zaawansowane: URL-e wyszukiwania OLX", "type": "array", "description": "Dla power-userów. Wklej gotowe linki wyszukiwania z OLX. Jeśli podasz, nadpisują filtry z panelu.", "items": { "type": "string" } } } }, "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 } } } } } } } } } }