{ "openapi": "3.0.1", "info": { "title": "Nehnutelnosti.sk Scraper - Slovakia Property Listings & Prices", "description": "Scrape nehnutelnosti.sk: Slovak flats, houses and land with EUR prices, price per mΒ², area, agency and photos, plus GPS on full detail. Sale, rent, auctions.", "version": "1.0", "x-build-id": "Hb3ZoxR1kIz2KnEEI" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/sian.agency~nehnutelnosti-property-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-sian.agency-nehnutelnosti-property-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/sian.agency~nehnutelnosti-property-scraper/runs": { "post": { "operationId": "runs-sync-sian.agency-nehnutelnosti-property-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/sian.agency~nehnutelnosti-property-scraper/run-sync": { "post": { "operationId": "run-sync-sian.agency-nehnutelnosti-property-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": { "operation": { "title": "🎯 What do you want to scrape?", "enum": [ "search", "detail" ], "type": "string", "description": "Pick one per run. Property Listing returns the listings that match a property type, a region or city and sale or rent, 30 per page. Property Detail opens nehnutelnosti.sk listing addresses you paste and returns GPS, floor, year built, energy class, every photo and the agency's company ID.", "default": "search" }, "propertyType": { "title": "🏠 Property type", "enum": [ "all", "byty", "garsonky", "1-izbove-byty", "2-izbove-byty", "3-izbove-byty", "4-izbove-byty", "5-a-viac-izbove-byty", "domy", "pozemky", "rekreacne-nehnutelnosti", "priestory-a-objekty", "kancelarie-administrativa", "obchody", "sklady", "garaze-parkovanie" ], "type": "string", "description": "Which kind of property to list. Flats is the largest residential section; a Slovak '2-room flat' (2-izbovΓ½ byt) is a one-bedroom flat with a living room. All property types mixes everything the site sells.", "default": "byty" }, "location": { "title": "πŸ—ΊοΈ Region or city", "enum": [ "all", "slovensko", "bratislavsky-kraj", "trnavsky-kraj", "trenciansky-kraj", "nitriansky-kraj", "zilinsky-kraj", "banskobystricky-kraj", "presovsky-kraj", "kosicky-kraj", "bratislava", "okres-bratislava-i", "okres-bratislava-ii", "okres-bratislava-iii", "okres-bratislava-iv", "okres-bratislava-v", "kosice", "presov", "zilina", "nitra", "banska-bystrica", "trnava", "trencin", "martin", "poprad", "okres-senec", "okres-pezinok", "okres-malacky" ], "type": "string", "description": "A region (kraj), a city or a Bratislava district. For any other town or district, open it on nehnutelnosti.sk and paste the address into Search page URLs. Everywhere also includes the few listings the site carries abroad.", "default": "bratislava" }, "transaction": { "title": "🀝 Sale or rent", "enum": [ "predaj", "prenajom", "podnajom", "drazba", "kupa" ], "type": "string", "description": "For sale or for rent covers almost all listings. Wanted to buy returns adverts placed by people looking for a property, which agencies use as buyer leads.", "default": "predaj" }, "maxResults": { "title": "πŸ”’ Max listings", "minimum": 1, "maximum": 10000, "type": "integer", "description": "How many listings to return per search. 30 is one page. The site stops at page 33, so one search gives at most about 990; split a bigger market by city or price band. Free accounts stop at 25.", "default": 30 }, "minPrice": { "title": "πŸ’° Min price (EUR)", "minimum": 0, "type": "integer", "description": "Only listings priced at or above this, in euros. Monthly rent for rentals. Filtered by the site itself, so it also splits a large market into bands under the 990-per-search limit. Listings with price on request are dropped by any price filter. Leave empty for no floor." }, "maxPrice": { "title": "πŸ’° Max price (EUR)", "minimum": 0, "type": "integer", "description": "Only listings priced at or below this, in euros. Monthly rent for rentals. Leave empty for no ceiling." }, "minArea": { "title": "πŸ“ Min area (mΒ²)", "minimum": 0, "type": "integer", "description": "Only listings with at least this floor area (plot area for land), in square metres. Leave empty for no minimum." }, "maxArea": { "title": "πŸ“ Max area (mΒ²)", "minimum": 0, "type": "integer", "description": "Only listings with at most this floor area (plot area for land), in square metres. Leave empty for no maximum." }, "includeDetails": { "title": "πŸ“„ Open each listing in full", "type": "boolean", "description": "Opens every listing for GPS, street, floor, construction, year built, energy certificate, the attribute list, the agency's company ID and every photo. Billed as one Property Detail on top of the listing row. Off by default: the search row already has price, area, address, agency and description.", "default": false }, "searchUrls": { "title": "πŸ”— Search page URLs", "type": "array", "description": "Paste nehnutelnosti.sk search pages instead of using the dropdowns, for example https://www.nehnutelnosti.sk/vysledky/domy/okres-senec/predaj. One per line. Price and area filters in the address are kept. Ignored when the operation is Property Detail.", "items": { "type": "object", "required": [ "url" ], "properties": { "url": { "type": "string", "title": "URL of a web page", "format": "uri" } } } }, "listingUrls": { "title": "πŸ”— Listing URLs", "type": "array", "description": "Paste nehnutelnosti.sk listing addresses for Property Detail, for example https://www.nehnutelnosti.sk/detail/Ju5B6d8o5hM/saratovska-22. One per line.", "items": { "type": "object", "required": [ "url" ], "properties": { "url": { "type": "string", "title": "URL of a web page", "format": "uri" } } } } } }, "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 } } } } } } } } } }