{ "openapi": "3.0.1", "info": { "title": "OLX.pl Used Car Listings by Make & Fuel Type", "description": "Search olx.pl for used cars in Poland by keyword, fuel type, gearbox, condition, year, and price range. Get make, model, year, price in PLN, mileage, location, and photos per listing.", "version": "2.0", "x-build-id": "B1EwcpcWEih0uOWU0" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/vexaloom-labs~olx-pl-used-car-listings-by-make-and-fuel-type/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-vexaloom-labs-olx-pl-used-car-listings-by-make-and-fuel-type", "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/vexaloom-labs~olx-pl-used-car-listings-by-make-and-fuel-type/runs": { "post": { "operationId": "runs-sync-vexaloom-labs-olx-pl-used-car-listings-by-make-and-fuel-type", "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/vexaloom-labs~olx-pl-used-car-listings-by-make-and-fuel-type/run-sync": { "post": { "operationId": "run-sync-vexaloom-labs-olx-pl-used-car-listings-by-make-and-fuel-type", "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": { "mode": { "title": "Mode", "enum": [ "search", "details" ], "type": "string", "description": "Search listings by filters, or read individual listing pages from URLs / IDs.", "default": "search" }, "listingUrls": { "title": "Listing URLs or IDs", "type": "array", "description": "Detail/URL mode only. Paste olx.pl car listing links, or numeric OLX listing IDs. One per line.", "items": { "type": "string" } }, "query": { "title": "Search query", "type": "string", "description": "Free-text keywords (e.g. 'Toyota Corolla', 'BMW 3'). Leave empty to browse all cars." }, "make": { "title": "Make", "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", "dongfeng", "eletroride", "bajaj", "melex", "gwm", "exeed", "jetour", "luqi", "haval" ], "type": "string", "description": "Car manufacturer. Leave empty for all makes.", "default": "" }, "model": { "title": "Model", "type": "string", "description": "Model name inside the selected make (e.g. Corolla, Octavia, C Klasa). Leave empty for all models." }, "fuelType": { "title": "Fuel type", "enum": [ "", "petrol", "diesel", "lpg", "cng", "electric", "plugin-hybrid", "hybrid" ], "type": "string", "description": "Fuel or powertrain type.", "default": "" }, "transmission": { "title": "Gearbox", "enum": [ "", "manual", "automatic" ], "type": "string", "description": "Transmission type.", "default": "" }, "condition": { "title": "Condition", "enum": [ "", "notdamaged", "damaged", "used", "new" ], "type": "string", "description": "OLX technical condition: not damaged or damaged.", "default": "" }, "bodyType": { "title": "Body type", "enum": [ "", "cabriolet", "sedan", "coupe", "pickup", "hatchback", "estate-car", "off-road-vehicle", "minibus", "mvp", "suv" ], "type": "string", "description": "Car body style.", "default": "" }, "color": { "title": "Colour", "enum": [ "", "bialy", "czarny", "szary", "srebrny", "niebieski", "brazowy_bezowy", "czerwony", "zielony", "zolty_zloty", "inny" ], "type": "string", "description": "Exterior colour.", "default": "" }, "drive": { "title": "Drive", "enum": [ "", "all-wheel-auto", "all-wheel-lock", "all-wheel-permanent", "front-wheel", "rear-wheel" ], "type": "string", "description": "Driven wheels / 4x4 type.", "default": "" }, "countryOrigin": { "title": "Country of origin", "enum": [ "", "a", "b", "by", "bg", "hr", "cz", "dk", "est", "fi", "f", "gr", "h", "nl", "irl", "is", "jp", "cdn", "li", "lt", "l", "lv", "mc", "d", "n", "pl", "ru", "ro", "sk", "si", "usa", "ch", "s", "tr", "ua", "hu", "gb", "i", "others" ], "type": "string", "description": "Country the car was imported from, as declared by the seller.", "default": "" }, "steeringSide": { "title": "Steering side", "enum": [ "", "1", "2" ], "type": "string", "description": "Left- or right-hand drive.", "default": "" }, "ownerType": { "title": "Seller type", "enum": [ "", "private", "business" ], "type": "string", "description": "Private seller or business/dealer.", "default": "" }, "region": { "title": "Region", "enum": [ "", "wielkopolskie", "mazowieckie", "dolnoslaskie", "malopolskie", "pomorskie", "slaskie", "lodzkie", "lubelskie", "lubuskie", "zachodniopomorskie", "opolskie", "swietokrzyskie", "warminsko-mazurskie", "kujawsko-pomorskie", "podkarpackie", "podlaskie" ], "type": "string", "description": "Polish voivodeship to search in. Leave empty for all of Poland.", "default": "" }, "minYear": { "title": "Min model year", "minimum": 1900, "maximum": 2030, "type": "integer", "description": "Oldest model year to include." }, "maxYear": { "title": "Max model year", "minimum": 1900, "maximum": 2030, "type": "integer", "description": "Newest model year to include." }, "minPrice": { "title": "Min price (PLN)", "minimum": 0, "maximum": 100000000, "type": "integer", "description": "Minimum listing price in Polish zloty." }, "maxPrice": { "title": "Max price (PLN)", "minimum": 0, "maximum": 100000000, "type": "integer", "description": "Maximum listing price in Polish zloty." }, "minMileage": { "title": "Min mileage (km)", "minimum": 0, "maximum": 2000000, "type": "integer", "description": "Minimum odometer reading in kilometres." }, "maxMileage": { "title": "Max mileage (km)", "minimum": 0, "maximum": 2000000, "type": "integer", "description": "Maximum odometer reading in kilometres." }, "minEngineSize": { "title": "Min engine size (cc)", "minimum": 0, "maximum": 10000, "type": "integer", "description": "Minimum engine displacement in cubic centimetres." }, "maxEngineSize": { "title": "Max engine size (cc)", "minimum": 0, "maximum": 10000, "type": "integer", "description": "Maximum engine displacement in cubic centimetres." }, "minEnginePower": { "title": "Min engine power (hp)", "minimum": 0, "maximum": 2000, "type": "integer", "description": "Minimum engine power in horsepower." }, "maxEnginePower": { "title": "Max engine power (hp)", "minimum": 0, "maximum": 2000, "type": "integer", "description": "Maximum engine power in horsepower." }, "sortBy": { "title": "Sort order", "enum": [ "relevance:desc", "created_at:desc", "filter_float_price:asc", "filter_float_price:desc" ], "type": "string", "description": "Order of the returned listings.", "default": "created_at:desc" }, "includePromoted": { "title": "Include promoted listings", "type": "boolean", "description": "Include paid/promoted OLX listings alongside organic results.", "default": true }, "maxItems": { "title": "Max items", "minimum": 1, "maximum": 5000, "type": "integer", "description": "Maximum number of unique listings to return. OLX exposes up to 1,000 per query; larger limits are split across year/price slices automatically.", "default": 20 } } }, "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 } } } } } } } } } }