{ "openapi": "3.0.1", "info": { "title": "OLX Listings Scraper: Poland, Ukraine, Romania & More", "description": "Scrape OLX listings from Poland, Ukraine, Kazakhstan, Portugal, Romania, Bulgaria and Uzbekistan by keyword, city, price or category URL. Price, params, dates, photos, seller type; only-new mode for monitoring.", "version": "0.1", "x-build-id": "rrjEqvDjhOR0aYedR" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/cliqtomedia~olx-listings-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-cliqtomedia-olx-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/cliqtomedia~olx-listings-scraper/runs": { "post": { "operationId": "runs-sync-cliqtomedia-olx-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/cliqtomedia~olx-listings-scraper/run-sync": { "post": { "operationId": "run-sync-cliqtomedia-olx-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": { "country": { "title": "Country (OLX site)", "enum": [ "pl", "ua", "kz", "pt", "ro", "bg", "uz" ], "type": "string", "description": "Which OLX site keyword searches run on: pl = olx.pl, ua = olx.ua, kz = olx.kz, pt = olx.pt, ro = olx.ro, bg = olx.bg, uz = olx.uz. URLs below always use the site from the URL itself.", "default": "pl" }, "queries": { "title": "Search keywords", "maxItems": 50, "type": "array", "description": "One OLX search per keyword, e.g. iphone, bmw x5 or mieszkanie. Up to 50 keywords and URLs together. Leave empty when you paste category URLs below.", "items": { "type": "string" } }, "categoryUrls": { "title": "OLX category or search URLs", "maxItems": 10, "type": "array", "description": "Paste any OLX results page with your filters already set, e.g. https://www.olx.pl/motoryzacja/samochody/bmw/warszawa/ or https://www.olx.ua/uk/nedvizhimost/kvartiry/kiev/. Category, city and the page's own filters are kept. Offer (single listing) pages are not supported. Up to 10 URLs per run.", "items": { "type": "string" } }, "city": { "title": "City (for keyword searches)", "maxLength": 100, "type": "string", "description": "Limit keyword searches to one city or region, written as in the OLX address bar: warszawa, krakow, kiev, alma-ata, astana, lisboa, bucuresti, sofiya, tashkent. Accents are removed automatically (Kraków → krakow). An unknown city gives status not_found for those searches. Empty = whole country." }, "priceMin": { "title": "Minimum price", "minimum": 0, "type": "integer", "description": "Lowest price in the site's currency (PLN, UAH, KZT, EUR, RON, BGN/EUR, UZS). Applies to all searches and URLs. Empty = no minimum." }, "priceMax": { "title": "Maximum price", "minimum": 0, "type": "integer", "description": "Highest price in the site's currency. Applies to all searches and URLs. Empty = no maximum." }, "sortBy": { "title": "Sort by", "enum": [ "newest", "relevance", "price_asc", "price_desc" ], "type": "string", "description": "Order of results. newest = newest and recently refreshed first (best for monitoring and onlyNew).", "default": "newest" }, "maxItems": { "title": "Max listings per search", "minimum": 1, "maximum": 1000, "type": "integer", "description": "Stop each keyword or URL after this many listings. OLX itself shows at most about 1,000 listings per search; narrow by city, category or price to get more. You pay per listing saved.", "default": 100 }, "onlyNew": { "title": "Only new listings since the last run", "type": "boolean", "description": "For scheduled monitoring: return only listings created after the previous run of the same search and not returned before. The first run returns current listings. Memory is kept in your account in the key-value store olx-listings-scraper-state.", "default": false }, "includeDescription": { "title": "Include description text", "type": "boolean", "description": "Add the full listing description as plain text. Turn off for smaller output.", "default": true }, "includePromoted": { "title": "Include promoted listings", "type": "boolean", "description": "OLX mixes paid (promoted) listings into every results page. They (and TOP ads among the results) are marked isPromoted = true. Turn off to keep only organic results.", "default": 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 } } } } } } } } } }