# Nehnutelnosti.sk Scraper - Slovakia Property Listings & Prices (`sian.agency/nehnutelnosti-property-scraper`) Actor

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.

- **URL**: https://apify.com/sian.agency/nehnutelnosti-property-scraper.md
- **Developed by:** [SIÁN OÜ](https://apify.com/sian.agency) (community)
- **Categories:** Real estate, Lead generation, Business
- **Stats:** 1 total users, 0 monthly users, 100.0% runs succeeded, 1 bookmarks
- **User rating**: No ratings yet

## Pricing

from $1.32 / 1,000 property listings

This Actor is paid per event. You are not charged for the Apify platform usage, but only a fixed price for specific events.
Since this Actor supports Apify Store discounts, the price gets lower the higher subscription plan you have.

Learn more: https://docs.apify.com/actors/running/actors-in-store.md#pay-per-event

## What's an Apify Actor?

An Actor is a serverless cloud program that runs on the Apify platform. It has two run modes.
In Batch mode, an Actor accepts a well-defined JSON input, performs an action which can take anything from a few seconds to a few hours,
and optionally produces a well-defined JSON output, datasets with results, or files in key-value store.
In Standby mode, an Actor provides a web server which can be used as a website, API, or an MCP server.

Apify vocabulary and the platform model are defined once, in the agent quickstart at https://apify.com/agents.md.

## How to integrate an Actor?

If asked about integration, you help developers integrate Actors into their projects.
You adapt to their stack and deliver integrations that are safe, well-documented, and production-ready.

Do not guess an integration path. Every one of them is in the agent quickstart at https://apify.com/agents.md: the Apify MCP server, Agent Skills with the Apify CLI, the JavaScript and Python clients, the REST API, and the account-free path for an agent with no human to sign in. It also carries the rule on stating cost before the first paid run.

For examples already wired to this Actor's own input schema, see the [API](#api) section below.

Each client library has reference documentation the quickstart does not restate: [JavaScript/TypeScript](https://docs.apify.com/api/client/js/docs.md) (`npm install apify-client`) and [Python](https://docs.apify.com/api/client/python/docs.md) (`pip install apify-client`).

# README

## Nehnutelnosti.sk Scraper - Slovakia Property Listings & Prices 🚀

[![SIÁN Agency Store](https://img.shields.io/badge/Store-SI%C3%81N%20Agency-1AE392)](https://apify.com/sian.agency?fpr=sian) [![Sreality Scraper](https://img.shields.io/badge/Store-Sreality%20Scraper-CC0000)](https://apify.com/sian.agency/sreality-property-scraper?fpr=sian) [![Otodom Property Scraper](https://img.shields.io/badge/Store-Otodom%20Property%20Scraper-1AE392)](https://apify.com/sian.agency/otodom-property-scraper?fpr=sian) [![Willhaben Property Scraper](https://img.shields.io/badge/Store-Willhaben%20Property%20Scraper-1A75CF)](https://apify.com/sian.agency/willhaben-property-scraper?fpr=sian)

#### 🎉 Slovakia's biggest property portal as a spreadsheet: price, price per m², area, agency and photos for 30 listings per page

##### For agencies, investors and analysts who track flats, houses and land in Bratislava, Košice and every Slovak region

### 🔎 What is the Nehnutelnosti.sk Scraper — and when should you use it?

The **Nehnutelnosti.sk Scraper** turns public Slovak property listings from nehnutelnosti.sk, the country's most visited property portal, into clean, structured rows you can filter, export and feed straight into a spreadsheet, database or AI agent. No account, no portal API key, no browser automation to maintain.

**Use it when you need:** flats, houses, land, holiday homes or commercial space anywhere in Slovakia, for sale, rent, sublet or auction. Rows carry the asking price in EUR, price per m² where the listing gives a price and area, the room count for flats, the full address, the agency or private owner, photos and the advert text. Turn on full detail for GPS, floor, construction, year built, energy class and the agency's company ID (IČO).

**Use something else when:** the property is not in Slovakia. Use [Sreality Scraper](https://apify.com/sian.agency/sreality-property-scraper?fpr=sian) for Czech listings from sreality.cz, the neighbouring market Slovak buyers compare against. Use [Otodom Property Scraper](https://apify.com/sian.agency/otodom-property-scraper?fpr=sian) for Polish flats and houses with price per m². Use [Willhaben Property Scraper](https://apify.com/sian.agency/willhaben-property-scraper?fpr=sian) for Austrian listings, the Vienna side of the Bratislava commuter belt. This actor reads nehnutelnosti.sk only. Agent phone numbers and sold prices are not included, and Slovak stock listed only on topreality.sk, reality.sk or bazos.sk is out of scope.

### 🤖 Use with AI agents

Already connected to the [Apify MCP server](https://mcp.apify.com)? Just ask for this Actor by name: sian.agency/nehnutelnosti-property-scraper

**Your agent can pay for its own runs.** This Actor is eligible for [agentic payments](https://docs.apify.com/platform/actors/publishing/monetize), so an agent can discover it, run it and settle the bill over [x402](https://www.x402.org/) (USDC on Base) or [Skyfire](https://www.skyfire.xyz/) — without an Apify account or API token of its own. Billing is the same either way: per successful row, never for errors.

Otherwise copy this prompt into Claude, ChatGPT, Cursor or any MCP-enabled assistant:

```text
I want Slovak property listings and prices from nehnutelnosti.sk using the Apify Actor `sian.agency/nehnutelnosti-property-scraper`.

Use it when I need: flats, houses, land, holiday homes or commercial space anywhere in Slovakia, for sale, rent, sublet or auction. Rows carry the asking price in EUR, price per m² where the listing gives a price and area, the room count for flats, the full address, the agency or private owner, photos and the advert text. Turn on full detail for GPS, floor, construction, year built, energy class and the agency's company ID (IČO).

Don't use it when: the property is not in Slovakia — use sreality-property-scraper or otodom-property-scraper or willhaben-property-scraper instead.

How to call it: leave `operation` on `search` and set `propertyType` (`byty`, `2-izbove-byty`, `domy`, `pozemky`, `all` and more), `location` (`bratislava`, `slovensko`, a region such as `kosicky-kraj`, a city or a Bratislava district) and `transaction` (`predaj` sale, `prenajom` rent, `podnajom`, `drazba`, `kupa`). Narrow with `minPrice`, `maxPrice`, `minArea` and `maxArea`, and set `maxResults` (one search returns at most about 990). `includeDetails` opens each listing for GPS and building facts at an extra charge per listing. For any other town, paste a nehnutelnosti.sk search address into `searchUrls`; to open listings you already have, set `operation` to `detail` and pass `listingUrls`.

Start with this input:
{
  "operation": "search",
  "propertyType": "2-izbove-byty",
  "location": "bratislava",
  "transaction": "predaj",
  "maxPrice": 250000,
  "maxResults": 90
}

Ask me which Slovak region or city, whether they want sale or rent, and whether they need GPS and building facts from full detail, then run the Actor and summarise the results as a table.
```

**Things you can ask your agent for:**

- *List 2-room flats for sale in Bratislava under 250,000 EUR and rank them by price per m².*
- *Compare monthly rents with sale prices for 3-room flats in Košice so I can estimate gross yield.*
- *Give me every agency with houses for sale in the Senec district, with its website and company ID.*

Machine-readable API, MCP config and OpenAPI definition for this Actor are published at [apify.com/sian.agency/nehnutelnosti-property-scraper.md](https://apify.com/sian.agency/nehnutelnosti-property-scraper.md).

### 📋 Overview

**Nehnutelnosti.sk is where most of Slovakia's property is advertised**, about 65,000 live listings on any given day. This actor turns its search results into rows you can sort and export. Price a district or build an agency list without clicking through hundreds of pages.

**What you get:**

- ✅ **Full rows from the search page**: price in EUR, price per m², area, rooms for flats, full address, agency, flags, photos and the complete description, 30 listings per page
- 🇸🇰 **Slovak property vocabulary as dropdowns**: garsónka to 5-room flats, houses, land, holiday homes and commercial space across all 8 regions, the main cities and the five Bratislava districts
- 🎯 **Filters the site applies itself**: sale, rent, sublet, auction or wanted-to-buy, plus price and floor-area bands, so a narrow search returns only matching listings
- 📍 **Building facts on demand**: switch on full detail for GPS, floor, construction, year built, energy class, the attribute list and the agency's Slovak company ID (IČO)
- 💰 **Pay per listing**: $1.50 per 1,000 listings, and failed inputs cost nothing
- ✨ **Buyer requests too**: the wanted-to-buy section, which Slovak agencies work as a lead list

***

### ✨ Features

- 🏢 **Every property type**: flats by room count, houses, land, holiday property, offices, shops, warehouses and garages
- 🗺️ **All of Slovakia**: 8 regions (kraje), 10 cities, the five Bratislava districts plus Senec, Pezinok and Malacky
- 🔗 **Paste any search**: paste a nehnutelnosti.sk search address for towns that are not in the dropdown. Price, area, keyword and new-build filters in the address are kept, sort order is ignored, and any other filter is named in the log as not applied
- 💶 **Clean prices**: priceEur and pricePerM2Eur as numbers, plus the text the site prints; "Cena dohodou" listings are flagged, never shown as zero
- 🏗️ **Developer projects**: new-build listings carry the project name, project ID and construction state
- 🧑‍💼 **Agency or private owner**: every row says who placed the advert, with the agency's name, website and office address
- 📸 **Photos**: a thumbnail and up to 4 photos from the search page when the advert has photos; full detail returns every photo
- 📄 **Full listing detail**: GPS, street and number, floor, total floors, construction, year built, energy class, elevator and the attribute list
- 🔁 **No duplicates**: a listing that appears in two of your searches is returned and charged once

***

### 🎬 Quick Start

Choose a property type, a place, and sale or rent, then press Start. A page of 30 listings takes a few seconds.

```bash
curl -X POST "https://api.apify.com/v2/acts/sian.agency~nehnutelnosti-property-scraper/runs?token=YOUR_TOKEN" \
-H 'Content-Type: application/json' \
-d '{"operation": "search", "propertyType": "byty", "location": "bratislava", "transaction": "predaj", "maxResults": 60}'
```

***

### 🚀 Getting Started (3 Simple Steps)

#### Step 1: Pick what to search

Choose a property type (for example 2-room flats), a region or city, and sale or rent.

#### Step 2: Set your limits

Set how many listings you want and, if you like, a price or area band. Turn on "Open each listing in full" when you need GPS and building facts.

#### Step 3: Run and export

Press Start, then download the dataset as CSV, Excel or JSON, or pull it through the API.

**That's it! In about a minute, you'll have:**

- A table of live listings with EUR price, price per m² and area
- The agency or private owner behind each advert
- Photos and the full description for every listing

***

### 📥 Input Configuration

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `operation` | string | No | `search` (default) finds listings; `detail` opens listing addresses you paste |
| `propertyType` | string | No | `byty` (default), `garsonky`, `1-izbove-byty` to `5-a-viac-izbove-byty`, `domy`, `pozemky`, `rekreacne-nehnutelnosti`, `priestory-a-objekty`, `kancelarie-administrativa`, `obchody`, `sklady`, `garaze-parkovanie`, or `all` |
| `location` | string | No | `bratislava` (default), `slovensko`, a region such as `kosicky-kraj`, a city, a Bratislava district, or `all` |
| `transaction` | string | No | `predaj` sale (default), `prenajom` rent, `podnajom` sublet, `drazba` auction, `kupa` wanted to buy |
| `maxResults` | integer | No | Listings per search, default 30 (one page). One search returns at most about 990 |
| `minPrice` / `maxPrice` | integer | No | Price band in EUR (monthly rent for rentals) |
| `minArea` / `maxArea` | integer | No | Floor area band in m² (plot area for land) |
| `includeDetails` | boolean | No | Open each listing for GPS, building facts, agency IČO and every photo |
| `searchUrls` | array | No | nehnutelnosti.sk search addresses to use instead of the dropdowns |
| `listingUrls` | array | No | nehnutelnosti.sk listing addresses for `detail` |

**Example: 2-room flats for sale in Bratislava under €250,000**

```json
{
  "operation": "search",
  "propertyType": "2-izbove-byty",
  "location": "bratislava",
  "transaction": "predaj",
  "maxPrice": 250000,
  "maxResults": 90
}
```

**Example: paste your own searches**

```json
{
  "operation": "search",
  "searchUrls": [
    { "url": "https://www.nehnutelnosti.sk/vysledky/domy/okres-senec/predaj" },
    { "url": "https://www.nehnutelnosti.sk/vysledky/byty/zilina/prenajom" }
  ],
  "maxResults": 100
}
```

**Example: open specific listings in full**

```json
{
  "operation": "detail",
  "listingUrls": [
    { "url": "https://www.nehnutelnosti.sk/detail/Ju5B6d8o5hM/saratovska-22" }
  ]
}
```

***

### 📤 Output

Results are saved to the Apify dataset with **55+ fields** including:

| Field | Type | Description |
|-------|------|-------------|
| `listingId` | string | Listing ID on nehnutelnosti.sk |
| `url` | string | Link to the listing |
| `propertyTitle` | string | Advert title |
| `priceEur` | number | Asking price in EUR (monthly for rent) |
| `pricePerM2Eur` | number | Price per square metre in EUR |
| `priceOnRequest` | boolean | True for "Cena dohodou" or "Info v RK" |
| `dealType` | string | sale, rent, sublet, auction or wanted |
| `categoryName` | string | Category as the site names it, e.g. "2 izbové byty" |
| `rooms` | number | Room count (Slovak convention: a 2-room flat has one bedroom) |
| `areaM2` | number | Floor area, or plot area for land |
| `condition` | string | Condition, e.g. Novostavba, Kompletná rekonštrukcia |
| `address`, `city`, `district`, `region` | string | Where the property is |
| `advertiserType` | string | AGENT or PRIVATE_PERSON |
| `agencyName`, `agencyWebsite` | string | The agency behind the advert |
| `thumbnail`, `imageUrls`, `imageCount` | mixed | Photos |
| `descriptionText` | string | Full advert text |
| `latitude`, `longitude` | number | GPS (full detail) |
| `floor`, `totalFloors`, `construction`, `yearBuilt`, `energyRating` | mixed | Building facts (full detail) |
| `agencyCompanyId` | string | Agency's Slovak company ID, IČO (full detail) |

**Example** (a real row, shortened):

```json
{
  "listingId": "JuzuG9Lsmen",
  "propertyTitle": "2 izbový byt v novostavbe Rezidencia Alžbetina",
  "url": "https://www.nehnutelnosti.sk/detail/JuzuG9Lsmen/2-izbovy-byt-v-novostavbe-rezidencia-alzbetina",
  "priceEur": 990,
  "priceText": "990 €/mes.",
  "pricePerM2Eur": 16.78,
  "priceOnRequest": false,
  "dealType": "rent",
  "categoryName": "2 izbové byty",
  "rooms": 2,
  "areaM2": 59,
  "condition": "Novostavba",
  "address": "Alžbetina, Košice-Staré Mesto, okres Košice I",
  "city": "Košice-Staré Mesto",
  "region": "Košický kraj",
  "advertiserType": "AGENT",
  "agencyName": "TOBI Real Košice s.r.o.",
  "agencyWebsite": "https://www.tobireal.sk",
  "imageCount": 27,
  "latitude": 48.7194679,
  "longitude": 21.2541505,
  "floor": 1,
  "totalFloors": 3,
  "construction": "Tehlová",
  "agencyCompanyId": "47470798",
  "updatedAt": "2026-09-25T18:52:53.223Z",
  "status": "success"
}
```

A run report (`report.html`) is saved to the key-value store with the numbers, a table of listings, any inputs that need a fix and what the run cost.

***

### 💼 Use Cases & Examples

#### 1. Bratislava price-per-m² index

**Property analysts track asking prices per m² by district, week by week.**

**Input:** `byty`, one of the five Bratislava districts, `predaj`
**Output:** price, area and price per m² for every flat in the district
**Use:** a weekly asking-price index for Slovakia's most expensive market

#### 2. Agency lead lists

**Proptech sales teams and brokerages map who holds stock where.**

**Input:** a region, any property type, full detail on
**Output:** agency name, website, office address and IČO on every listing
**Use:** group by agency to see who is active in each district before the first call

#### 3. New-build project monitoring

**Developers and investors watch competing projects.**

**Input:** Bratislava or a regional city, `byty`, `predaj`
**Output:** listings with project name, project ID, construction state and price per m²
**Use:** see which projects are still selling and at what price

#### 4. Rental yield screen

**Buy-to-let investors compare rents with sale prices.**

**Input:** the same city twice, once `predaj` and once `prenajom`
**Output:** sale prices and monthly rents with rooms and area
**Use:** gross yield per district, matched on flat size

#### 5. Private-owner sourcing

**Agents and acquisition desks look for owners selling without an agency.**

**Input:** any search
**Output:** rows with advertiserType PRIVATE_PERSON
**Use:** a list of owner-listed properties for brokerage outreach

#### 6. Buyer-demand leads

**Agencies match stock to people who want to buy.**

**Input:** `transaction`: `kupa`
**Output:** wanted-to-buy adverts in the same row format: what the buyer wants, where, and the text of their request
**Use:** real buyers to call when a matching property comes in

***

### 🔗 Integration Examples

#### JavaScript/Node.js

```javascript
import { ApifyClient } from 'apify-client';
const client = new ApifyClient({ token: 'YOUR_TOKEN' });

const run = await client.actor('sian.agency/nehnutelnosti-property-scraper').call({
  operation: 'search',
  propertyType: '3-izbove-byty',
  location: 'kosice',
  transaction: 'predaj',
  maxResults: 60,
});

const { items } = await client.dataset(run.defaultDatasetId).listItems();
console.log(items[0]);
```

#### Python

```python
from apify_client import ApifyClient
client = ApifyClient('YOUR_TOKEN')

run = client.actor('sian.agency/nehnutelnosti-property-scraper').call(
    run_input={
        'operation': 'search',
        'propertyType': 'domy',
        'location': 'okres-senec',
        'transaction': 'predaj',
        'maxResults': 60,
    }
)

for item in client.dataset(run['defaultDatasetId']).iterate_items():
    print(item['priceEur'], item['areaM2'], item['url'])
```

#### cURL

```bash
curl -X POST 'https://api.apify.com/v2/acts/sian.agency~nehnutelnosti-property-scraper/run-sync-get-dataset-items?token=YOUR_TOKEN' \
-H 'Content-Type: application/json' \
-d '{"operation": "search", "propertyType": "byty", "location": "bratislava", "transaction": "prenajom", "maxResults": 30}'
```

#### Automation Workflows (N8N / Zapier / Make)

1. **Trigger**: a daily schedule, or a webhook from your CRM
2. **HTTP Request**: call the run-sync endpoint above with your search
3. **Process**: keep listing IDs you have not seen before
4. **Action**: add them to a Google Sheet, post them to Slack or create CRM leads

***

### 📊 Performance & Pricing

#### Try it on a free Apify plan

- **25 listings** per run with every field, same data as paid runs
- Up to 30 runs a day on this actor from a free plan (the first 10 unbilled)
- No credit card required
- Enough to check a district or test your workflow

#### Paid plans (production)

- As many listings as you ask for, up to about 990 per search and any number of searches per run
- Pay per result: listings actually returned are charged, plus a small start fee per run

| Event | Free plan | Bronze and up |
|-------|------|------|
| Listing returned, per 1,000 | $6.00 | $1.50 |
| Listing opened in full (only with full detail or `detail`), per 1,000 | $12.00 | $3.00 |
| Run start (per GB of memory; the default 512 MB is one) | $0.02 | $0.005 |

Silver, Gold, Platinum and Diamond plans pay slightly less than Bronze; the Store page shows your exact price.

Search pages come in at about 30 listings every few seconds. Full detail opens one page per listing, so it is slower and costs extra.

🔗 [View current pricing](https://apify.com/sian.agency/nehnutelnosti-property-scraper?fpr=sian)

***

### ❓ Frequently Asked Questions

**Q: Do I need an account, an API key or a proxy?**
A: No. Pick a property type, a place and sale or rent, then press Start.

**Q: How many listings can I get?**
A: Free plans get 25 per run. Paid plans get what they ask for, up to about 990 per search: the site shows 33 pages of 30. To go further, split by city, district or price band. Each is its own search, and you can run many in one go.

**Q: Which places are covered?**
A: All of Slovakia. The dropdown has the 8 regions, 10 cities, the five Bratislava districts, and Senec, Pezinok and Malacky. For any other town, open it on nehnutelnosti.sk and paste the address into Search page URLs.

**Q: What does "Open each listing in full" add?**
A: GPS, street and number, floor and total floors, construction, year built, energy class, elevator, the attribute list, every photo and the agency's IČO.

**Q: Are prices in euros?**
A: Yes. priceEur is a number; rentals are monthly. Listings with "Cena dohodou" or "Info v RK" have priceOnRequest set to true and no number. Any price filter leaves those listings out.

**Q: Can I get agent phone numbers?**
A: No. The site shows phone numbers only after a click, and this actor does not reveal them. You get the agent's name, the agency, its website and its IČO.

**Q: Can I sort by newest or by price?**
A: No. Results come in the site's default order. Use price bands to choose which part of the market you get.

**Q: What output formats are there?**
A: JSON, CSV, Excel, XML and HTML, straight from the Apify dataset, or through the API.

***

### 🐛 Troubleshooting

**"No listings match this search right now"**

- Widen the place: a region instead of a city, or All of Slovakia
- Choose All property types, or drop the price band

**I asked for 2,000 listings and got about 990**

- One search stops at page 33. Split it by city, district or price band and add each as its own search

**A pasted address was skipped**

- Search page URLs must start with https://www.nehnutelnosti.sk/vysledky/
- Listing URLs must start with https://www.nehnutelnosti.sk/detail/

**"This listing is no longer on nehnutelnosti.sk"**

- It was sold, let or withdrawn. Run a fresh search to get current stock. You were not charged for it

**"Temporarily unavailable, please retry"**

- The site did not answer after five tries. Run the same input again in a few minutes

***

### ⚖️ Is it legal to scrape data?

This actor returns only what advertisers publish on nehnutelnosti.sk, including the name a private seller chooses to show on their advert. It does not collect email addresses, phone numbers or any data behind a login. We therefore believe that our actors, when used for ethical purposes by Apify users, are safe.

However, you should be aware that your results could contain personal data. Personal data is protected by the **GDPR** in the European Union and by other regulations around the world. You should not scrape personal data unless you have a legitimate reason to do so. If you're unsure whether your reason is legitimate, consult your lawyers.

You can also read Apify's blog post on the [legality of web scraping](https://blog.apify.com/is-web-scraping-legal/).

Nehnuteľnosti.sk is a trademark of United Classifieds s.r.o. This actor is not affiliated with, endorsed by, or sponsored by Nehnuteľnosti.sk or United Classifieds.

***

### 🤝 Support

**Join our active support community**

- For issues or questions, open an issue on the actor's [Issues tab](https://apify.com/sian.agency/nehnutelnosti-property-scraper/issues)
- Check [SIÁN Agency Store](https://apify.com/sian.agency?fpr=sian) for more automation tools
- 📧 <apify@sian-agency.online>

***

**Built by [SIÁN Agency](https://www.sian-agency.online)** | **[More Tools](https://apify.com/sian.agency?fpr=sian)**

# Changelog

This Actor's version history is a separate document: https://apify.com/sian.agency/nehnutelnosti-property-scraper/changelog.md

# Actor input Schema

## `operation` (type: `string`):

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.

## `propertyType` (type: `string`):

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.

## `location` (type: `string`):

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.

## `transaction` (type: `string`):

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.

## `maxResults` (type: `integer`):

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.

## `minPrice` (type: `integer`):

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` (type: `integer`):

Only listings priced at or below this, in euros. Monthly rent for rentals. Leave empty for no ceiling.

## `minArea` (type: `integer`):

Only listings with at least this floor area (plot area for land), in square metres. Leave empty for no minimum.

## `maxArea` (type: `integer`):

Only listings with at most this floor area (plot area for land), in square metres. Leave empty for no maximum.

## `includeDetails` (type: `boolean`):

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.

## `searchUrls` (type: `array`):

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.

## `listingUrls` (type: `array`):

Paste nehnutelnosti.sk listing addresses for Property Detail, for example https://www.nehnutelnosti.sk/detail/Ju5B6d8o5hM/saratovska-22. One per line.

## Actor input object example

```json
{
  "operation": "search",
  "propertyType": "byty",
  "location": "bratislava",
  "transaction": "predaj",
  "maxResults": 30,
  "includeDetails": false,
  "listingUrls": [
    {
      "url": "https://www.nehnutelnosti.sk/detail/Ju5B6d8o5hM/saratovska-22"
    }
  ]
}
```

# Actor output Schema

## `nehnutelnostiSkListings` (type: `string`):

Every listing this run returned, one row each: price, EUR per m², area, address, agency and photos.

## `scrapingSummary` (type: `string`):

HTML summary showing successful and failed results with key metrics

# API

You can run this Actor programmatically using our API. Below are code examples in JavaScript, Python, and CLI, as well as the OpenAPI specification and MCP server setup.

## JavaScript example

```javascript
import { ApifyClient } from 'apify-client';

// Initialize the ApifyClient with your Apify API token
// Replace the '<YOUR_API_TOKEN>' with your token
const client = new ApifyClient({
    token: '<YOUR_API_TOKEN>',
});

// Prepare Actor input
const input = {
    "operation": "search",
    "propertyType": "byty",
    "location": "bratislava",
    "transaction": "predaj",
    "maxResults": 30,
    "includeDetails": false,
    "listingUrls": [
        {
            "url": "https://www.nehnutelnosti.sk/detail/Ju5B6d8o5hM/saratovska-22"
        }
    ]
};

// Run the Actor and wait for it to finish
const run = await client.actor("sian.agency/nehnutelnosti-property-scraper").call(input);

// Fetch and print Actor results from the run's dataset (if any)
console.log('Results from dataset');
console.log(`💾 Check your data here: https://console.apify.com/storage/datasets/${run.defaultDatasetId}`);
const { items } = await client.dataset(run.defaultDatasetId).listItems();
items.forEach((item) => {
    console.dir(item);
});

// 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/js/docs

```

## Python example

```python
from apify_client import ApifyClient

# Initialize the ApifyClient with your Apify API token
# Replace '<YOUR_API_TOKEN>' with your token.
client = ApifyClient("<YOUR_API_TOKEN>")

# Prepare the Actor input
run_input = {
    "operation": "search",
    "propertyType": "byty",
    "location": "bratislava",
    "transaction": "predaj",
    "maxResults": 30,
    "includeDetails": False,
    "listingUrls": [{ "url": "https://www.nehnutelnosti.sk/detail/Ju5B6d8o5hM/saratovska-22" }],
}

# Run the Actor and wait for it to finish
run = client.actor("sian.agency/nehnutelnosti-property-scraper").call(run_input=run_input)

# Fetch and print Actor results from the run's dataset (if there are any)
print(f"💾 Check your data here: https://console.apify.com/storage/datasets/{run.default_dataset_id}")
for item in client.dataset(run.default_dataset_id).iterate_items():
    print(item)

# 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/python/docs/quick-start

```

## CLI example

```bash
echo '{
  "operation": "search",
  "propertyType": "byty",
  "location": "bratislava",
  "transaction": "predaj",
  "maxResults": 30,
  "includeDetails": false,
  "listingUrls": [
    {
      "url": "https://www.nehnutelnosti.sk/detail/Ju5B6d8o5hM/saratovska-22"
    }
  ]
}' |
apify call sian.agency/nehnutelnosti-property-scraper --silent --output-dataset

```

## MCP server setup

```json
{
    "mcpServers": {
        "apify": {
            "type": "http",
            "url": "https://mcp.apify.com/?tools=fetch-actor-details,sian.agency/nehnutelnosti-property-scraper"
        }
    }
}
```

The hosted server signs you in with OAuth on first connect, so no API token belongs in this config. Clients without OAuth support can send an `Authorization: Bearer <APIFY_API_TOKEN>` header instead, using a token from API & Integrations in Apify Console (https://console.apify.com/settings/integrations).

## OpenAPI specification

Download the OpenAPI definition: https://api.apify.com/v2/actors/VIbgxdI3I3JSXmA64/builds/Hb3ZoxR1kIz2KnEEI/openapi.json