{ "openapi": "3.0.1", "info": { "title": "Nehnutelnosti.sk 🧡 🏡 Real Estate Scraper", "description": "Scrapes property listings from nehnutelnosti.sk — prices, area, location, GPS, photos, agent and agency details.", "version": "1.1", "x-build-id": "OXr54h9KERkOSVsV0" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/nogards95~nehnutelnosti-sk-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-nogards95-nehnutelnosti-sk-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/nogards95~nehnutelnosti-sk-scraper/runs": { "post": { "operationId": "runs-sync-nogards95-nehnutelnosti-sk-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/nogards95~nehnutelnosti-sk-scraper/run-sync": { "post": { "operationId": "run-sync-nogards95-nehnutelnosti-sk-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": { "category": { "title": "Property category", "type": "string", "description": "URL slug of the property category, as used by nehnutelnosti.sk. Common values: byty (apartments), domy (houses), pozemky (land), komercne-priestory (commercial), sklady (warehouses), chaty (cottages). Room-specific slugs also work, e.g. 1-izbove-byty, 2-izbove-byty, 3-izbove-byty.", "default": "byty" }, "location": { "title": "Location", "type": "string", "description": "URL slug of the location, e.g. bratislava, kosice, bratislava-stare-mesto, okres-bratislava-i. Use 'slovensko' to search the whole country. Tip: run the search on the website and copy the slug out of the address bar.", "default": "bratislava" }, "transactionType": { "title": "Transaction type", "enum": [ "predaj", "prenajom" ], "type": "string", "description": "Whether to scrape properties for sale or for rent.", "default": "predaj" }, "maxItems": { "title": "Maximum listings", "minimum": 0, "type": "integer", "description": "Stop after collecting this many listings. Set to 0 to scrape every result the search returns — use with care, a country-wide search can return tens of thousands.", "default": 40 }, "includeFullDetail": { "title": "Fetch full listing details", "type": "boolean", "description": "Visit each listing's own page to collect the complete description, approximate GPS coordinates, all photos and the full attribute table. This costs one extra request per listing, so runs take noticeably longer and are billed at the higher rate. Without it, descriptions are only available for some listings.", "default": false }, "priceMin": { "title": "Minimum price (EUR)", "minimum": 0, "type": "integer", "description": "Lower price bound. Leave at 0 for no minimum.", "default": 0 }, "priceMax": { "title": "Maximum price (EUR)", "minimum": 0, "type": "integer", "description": "Upper price bound. Leave at 0 for no maximum.", "default": 0 }, "areaMin": { "title": "Minimum area (m²)", "minimum": 0, "type": "integer", "description": "Lower area bound in square metres. Leave at 0 for no minimum.", "default": 0 }, "areaMax": { "title": "Maximum area (m²)", "minimum": 0, "type": "integer", "description": "Upper area bound in square metres. Leave at 0 for no maximum.", "default": 0 }, "startUrls": { "title": "Start URLs", "type": "array", "description": "nehnutelnosti.sk search URLs or individual /detail/... listing URLs. When provided, these replace the category / location / transaction fields above — handy for reusing a filtered search you built on the website.", "default": [], "items": { "type": "object", "required": [ "url" ], "properties": { "url": { "type": "string", "title": "URL of a web page", "format": "uri" } } } }, "proxyConfiguration": { "title": "Proxy configuration", "type": "object", "description": "nehnutelnosti.sk has no anti-bot protection, so a proxy is not needed and off by default. Enable Apify Proxy only if a very large run starts hitting rate limits.", "default": { "useApifyProxy": false } } } }, "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 } } } } } } } } } }