{ "openapi": "3.0.1", "info": { "title": "OLX Listings Scraper (PL, UA, RO, PT, BG, KZ, UZ)", "description": "OLX classifieds from one actor: search by keyword, category, city/region and price on olx.pl, olx.ua, olx.ro, olx.pt, olx.bg, olx.kz, olx.uz. Flat rows with price, currency, condition, location, coordinates, seller type, photos, all parameters. Monitor mode alerts on new listings and price changes.", "version": "0.1", "x-build-id": "4u8uoj9bHJk3jRpNE" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/datahamster~olx-europe-listings/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-datahamster-olx-europe-listings", "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/datahamster~olx-europe-listings/runs": { "post": { "operationId": "runs-sync-datahamster-olx-europe-listings", "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/datahamster~olx-europe-listings/run-sync": { "post": { "operationId": "run-sync-datahamster-olx-europe-listings", "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", "enum": [ "pl", "ua", "ro", "pt", "bg", "kz", "uz" ], "type": "string", "description": "Which OLX site to search", "default": "pl" }, "queries": { "title": "Search queries", "type": "array", "description": "Free-text searches (each paginated separately)", "default": [ "rower" ], "items": { "type": "string" } }, "categoryId": { "title": "Category id", "minimum": 1, "type": "integer", "description": "OLX numeric category id (visible in the site's filter URLs); optional" }, "cityId": { "title": "City id", "minimum": 1, "type": "integer", "description": "OLX numeric city id; optional" }, "regionId": { "title": "Region id", "minimum": 1, "type": "integer", "description": "OLX numeric region id; optional" }, "priceFrom": { "title": "Min price", "minimum": 0, "type": "integer", "description": "In the site's currency" }, "priceTo": { "title": "Max price", "minimum": 0, "type": "integer", "description": "In the site's currency" }, "sortBy": { "title": "Sort", "enum": [ "created_at:desc", "relevance:desc", "filter_float_price:asc", "filter_float_price:desc" ], "type": "string", "description": "Result order", "default": "created_at:desc" }, "maxPages": { "title": "Pages per query", "minimum": 1, "maximum": 25, "type": "integer", "description": "40 listings per page; OLX caps any query at 1,000 listings — narrow by category/price to see more", "default": 5 }, "offerIds": { "title": "Offer ids", "type": "array", "description": "Numeric OLX offer ids for full detail rows (description, all params)", "items": { "type": "string" } }, "maxItems": { "title": "Max items", "minimum": 1, "type": "integer", "description": "Stop after this many listings (you are charged only for pushed items)", "default": 200 }, "mode": { "title": "Mode", "enum": [ "scrape", "monitor" ], "type": "string", "description": "scrape = full results; monitor = only new listings / price changes since the previous run of this task", "default": "scrape" }, "monitorKey": { "title": "Monitor key", "type": "string", "description": "Optional state key when not running as a saved task" }, "webhookUrl": { "title": "Webhook URL", "type": "string", "description": "POST a change summary here in monitor mode" }, "telegramBotToken": { "title": "Telegram bot token", "type": "string", "description": "Optional: bot token for monitor-mode change summaries" }, "telegramChatId": { "title": "Telegram chat id", "type": "string", "description": "Optional: chat id that receives monitor-mode summaries" } } }, "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 } } } } } } } } } }