{ "openapi": "3.0.1", "info": { "title": "Otodom, Storia, Imovirtual Scraper (search, filters, alerts)", "description": "Otodom.pl, Storia.ro and Imovirtual.com scraper for OLX Group real estate: flats, houses and land to rent or buy, by location, price, area and rooms or any result URL. Rows with price, price per m2, area, rooms, floor, district, city, agency, photos. Monitor mode alerts on new listings.", "version": "0.1", "x-build-id": "ZTEAN1DPkRyuv8L65" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/datahamster~olx-group-real-estate/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-datahamster-olx-group-real-estate", "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-group-real-estate/runs": { "post": { "operationId": "runs-sync-datahamster-olx-group-real-estate", "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-group-real-estate/run-sync": { "post": { "operationId": "run-sync-datahamster-olx-group-real-estate", "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": { "site": { "title": "Site", "enum": [ "storia", "otodom", "imovirtual" ], "type": "string", "description": "Which OLX Group portal to search. Accepted codes: storia (storia.ro, Romania), otodom (otodom.pl, Poland), imovirtual (imovirtual.com, Portugal). One run covers one portal. Example: \"storia\".", "default": "storia" }, "transaction": { "title": "Transaction", "enum": [ "rent", "sale" ], "type": "string", "description": "Whether to search listings to rent or to buy. Accepted values: rent, sale. Example: \"rent\".", "default": "rent" }, "estate": { "title": "Estate type", "enum": [ "flat", "house", "room", "terrain", "commercial", "office" ], "type": "string", "description": "Property type. Accepted values: flat, house, room, terrain (land), commercial, office. Example: \"flat\".", "default": "flat" }, "location": { "title": "Location path", "type": "string", "description": "Location segment(s) exactly as they appear in the portal's own URL after the property type. Examples: \"bucuresti\" or \"cluj-napoca\" (storia), \"mazowieckie/warszawa/warszawa/warszawa\" (otodom), \"lisboa\" (imovirtual).", "default": "bucuresti" }, "priceFrom": { "title": "Min price", "minimum": 0, "type": "integer", "description": "Minimum price, whole number in the portal's currency (EUR on storia, PLN on otodom, EUR on imovirtual). Example: 400. Optional." }, "priceTo": { "title": "Max price", "minimum": 0, "type": "integer", "description": "Maximum price, whole number in the portal's currency. Example: 900. Optional." }, "areaFrom": { "title": "Min area (m²)", "minimum": 0, "type": "integer", "description": "Minimum living area in square metres. Example: 50. Optional." }, "roomsFrom": { "title": "Min rooms", "minimum": 1, "maximum": 6, "type": "integer", "description": "Minimum number of rooms, 1 to 6. Example: 2. Optional." }, "searchUrls": { "title": "Search URLs (advanced)", "type": "array", "description": "Any result URLs of the chosen portal, with the filters you set there; overrides site, transaction, estate and location. Example: [\"https://www.storia.ro/ro/rezultate/inchiriere/apartament/bucuresti\"]. Optional.", "items": { "type": "string" } }, "maxPages": { "title": "Pages", "minimum": 1, "maximum": 300, "type": "integer", "description": "How many result pages to fetch per search, 36 listings per page. Example: 3.", "default": 3 }, "maxItems": { "title": "Max items", "minimum": 1, "type": "integer", "description": "Stop the run after this many listings; you are charged only for listings actually pushed. Example: 20.", "default": 20 }, "mode": { "title": "Mode", "enum": [ "scrape", "monitor" ], "type": "string", "description": "scrape = return all matching listings; monitor = return only listings that are new or changed price since the previous run of this saved Task. Example: \"scrape\".", "default": "scrape" }, "monitorKey": { "title": "Monitor key", "type": "string", "description": "Optional state key for monitor mode when the actor is started directly instead of from a saved Task; any stable string, e.g. \"bucuresti-2cam-rent\"." }, "webhookUrl": { "title": "Webhook URL", "type": "string", "description": "Optional HTTPS URL that receives a POST with the monitor-mode change summary (JSON). Example: \"https://hooks.example.com/storia\"." }, "telegramBotToken": { "title": "Telegram bot token", "type": "string", "description": "Optional Telegram bot token used to send monitor-mode change summaries. Format: \"123456789:AA...\"." }, "telegramChatId": { "title": "Telegram chat id", "type": "string", "description": "Optional Telegram chat id that receives monitor-mode summaries. Example: \"-1001234567890\"." } } }, "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 } } } } } } } } } }