# Reality.iDNES.cz Scraper ($3.80/1K): Real Estate & Monitor (`tsutseisoftware/idnes-reality-scraper`) Actor

Scrape reality.idnes.cz: flats, houses, land, commercial, rentals and auctions by URL, location, region, district or ID. Price, price per m², GPS, agency, parameters, listing date. Monitoring of new, changed and removed listings. Unofficial.

- **URL**: https://apify.com/tsutseisoftware/idnes-reality-scraper.md
- **Developed by:** [Tsutsei Software](https://apify.com/tsutseisoftware) (community)
- **Categories:** Real estate, Lead generation
- **Features:** Limited permissions
- **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, 0 bookmarks
- **User rating**: No ratings yet

## Pricing

from $3.20 / 1,000 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

## iDNES Reality Scraper: Real Estate Listings & Monitor

Scrape real estate listings from **reality.idnes.cz (iDNES Reality)**, one of the biggest Czech property portals (over 100 000 listings): **flats, houses, land, commercial property, garages**, for **sale, rent or auction**. Start from a **search URL** copied from the website (all its filters are kept), from **locations in words** ("Brno", "Praha 6", "Smíchov") with an optional **radius**, from whole **regions** or **districts**, or from **listing URLs and IDs**. Searches of any size are read completely, e.g. all 26 000 flats for sale. For investors, agencies and analysts who want the agency and developer offers of iDNES Reality, or a daily watchdog of new listings and price drops.

**Price:** **$3.80** per 1 000 listings, **$5.55** with full details (FREE plan, no proxy needed).

> **Česky:** Scraper realit z **reality.idnes.cz**: byty, domy, pozemky, komerční prostory, pronájmy i dražby podle URL, lokality, kraje, okresu nebo ID. Cena, cena za m², GPS, realitní kancelář, parametry a datum vložení. Monitoring nových, změněných a odstraněných inzerátů. Výstup do Excelu, CSV nebo JSON. Podporu poskytujeme i česky.

### Why use this iDNES Reality scraper?

- 💸 **Cheaper than the most used iDNES Reality scraper:** $5.55 per 1 000 listings with details against $6.00 (it always reads details), and $3.80 when the listing data are enough, which it doesn't offer (Store prices, autumn 2026).
- ⚡ **Fast, no browser:** on Apify, 1 000 listings take about 40 seconds and all 4 400 flats for sale in Prague about 2.5 minutes; with details about 1 second per listing, **2× faster than the most used competitor** (measured on the same day).
- 🔎 **More ways to search than any other iDNES Reality scraper:** website URLs with all their filters, locations in words with a radius, regions, districts, listing IDs, and 50 input fields: transaction, property types, layouts and kinds, price, area, plot area, listing age, condition, building type, ownership, furnishing, house kind, rooms, 13 "must have" features (balcony, terrace, garage, elevator, pool, open house…). Investor filters: min/max **price per m²**, only discounted, only with a price, exclude reserved listings, only or except given **agencies**, keywords and excluded keywords ("podíl", "rezervováno"). Other iDNES scrapers take a URL or a region slug and a price.
- 🔔 **Real monitoring:** schedule it and get, and pay for, only **new listings and price changes** (`previousPrice`, `priceChange`, `priceChangePercent`), with filters for **price changes only** and **minimum price drop**, plus removed listings with a **reason** (`deleted` or `noLongerMatches`, each checked on the website, no false alarms) and reappeared listings.
- 📅 **Clean data without details:** the listing date (`listedAt`) for 100 % of listings, so "created in the last N days" works for any number of days, and the website's one-line address split into `street`, `cityPart`, `city`, `district`, `region` and `country` (also for listings abroad); GPS with details. Flat camelCase fields for CSV and Excel, numbers as numbers, ISO dates, `null` for missing values, a stable `id` for joining runs.
- 🔒 **No personal data:** brokers' names, phones, e-mails and photos are never returned; phone numbers and e-mails are removed from descriptions; an advertiser whose name is a person's name is returned as `null`.

### What data can you get?

For each listing you get the title, type, layout, **price, price per m², price unit** (per month for rentals), usable and plot area, the **address split into street, city part, city, district and region**, the agency, discount and reservation flags, a photo and **the date the listing was created**, all without opening the listing. With **Add listing details** you also get **GPS**, the description, all photos, floor, condition, building type, ownership, furnishing, **energy class**, balcony, terrace, cellar, elevator, parking, heating and utilities, the **original price before a discount**, the price note, **auction date, deposit and estimate**, and the agency; with **Add agency IČO and website** also the **agency's IČO and website**.

The output uses **the same field names as our Sreality.cz Scraper** for the same data (the portal's own listing ID is `listingId` here, `estateId` there; `agencyId` is text here), so you can merge both portals into one table.

Share of listings with a value, measured on Apify on 4 415 flats for sale in Prague and 1 000 in the whole country (listing data) and on 200 listing pages of flats and 200 of houses, 2026-10-19. Fields marked *details* need **Add listing details**.

| Field | Example | Filled |
|---|---|---|
| Title, type, subtype / layout | Prodej bytu 2+1 56 m², sale, flat, 2+1 | 100 % (subtype: flats, land, commercial; houses with details or when you search one subtype) |
| Price, price unit, price per m² | 8 390 000 CZK, za nemovitost, 149 821 CZK/m² | ~96 % (the rest: price on request, `priceOnRequest: true`) |
| Usable area, plot area | 56 m²; houses 433 m², plot 373 m² | 100 % (plot: houses and land) |
| Street, city part, city, district, region | V předpolí, Strašnice, Praha, Praha 10, Hlavní město Praha | city 100 %, region ~99 % in Czechia, street 77 % |
| Listed on (created) | 2026-08-21 | 100 % |
| Agency | Realitní agentura Starlet, s.r.o. | ~99 % |
| Discounted, reserved, new | `isDiscounted`, `isReserved`, `isNewListing` | 100 % |
| Photo | thumbnail (all photos with details) | 100 % |
| GPS, precision *(details)* | 50.0709, 14.4830, address | 97–98 % (address or the middle of the street) |
| Description *(details)* | full text, contacts removed | 100 % |
| Condition, building type, energy class *(details)* | Velmi dobrý, Cihlová, G | 100 % |
| Floor, ownership, furnishing *(details)* | 1, Osobní, Ne | flats: 95 %, 100 %, 45 % |
| Balcony, terrace, cellar, elevator, parking *(details)* | yes, 2 m² | when the listing says so |
| Original price, discount *(details)* | 5 890 000 CZK (−1.7 %) | discounted listings |
| Price note *(details)* | včetně provize RK | 81–86 % |
| Auction date, kind, deposit, estimate, min. bid *(details)* | 2026-11-25T10:00:00, Dobrovolná, 700 000 CZK | auctions |
| Agency IČO and website *(agency details)* | 27170934, http://www.rastarlet.cz | 98 %, 71–88 % |

See the **Output** tab for all 99 fields.

### How to scrape iDNES Reality

1. Open reality.idnes.cz, search as usual (e.g. flats for sale in Prague, 2+kk, up to 8 million), and paste the URL from the address bar into **iDNES Reality search or listing URLs**. Or leave the URL out and fill in **Transaction**, **Property types**, **Subtypes / layouts** and **Locations**, **Regions** or **Districts**.
2. Optionally add **Website filters** (price, area, condition, features…) and **Filters** (price per m², agency, keywords…), set **Max listings** and turn on **Add listing details**.
3. Click **Start** and download the results as JSON, CSV or Excel, or use the API.

**Tip:** website URLs keep their own filters and order; the **Website filters** of the input apply to the searches built from the input fields, the **Filters** to everything.

### Use cases

Copy an input into the **JSON** tab of the input and adjust it.

**2+kk and 3+kk for sale in Prague up to 9 million, with a balcony or a terrace, newest first:**

```json
{
  "transactionType": "sale",
  "propertyTypes": ["flat"],
  "subtypes": ["2+kk", "3+kk"],
  "regions": ["10"],
  "maxPrice": 9000000,
  "features": ["balcony", "terrace"],
  "maxItems": 500
}
```

**Daily watchdog: new rentals in Brno and its surroundings (10 km) and price drops, with details:**

```json
{
  "transactionType": "rent",
  "propertyTypes": ["flat", "house"],
  "locations": ["Brno"],
  "radiusKm": 10,
  "includeDetails": true,
  "onlyNewOrChanged": true,
  "includeRemovedListings": true,
  "monitoringKey": "brno-rent",
  "maxItems": 0
}
```

**Investor screening: flats in the Central Bohemian region under 70 000 CZK per m², without reserved ones:**

```json
{
  "transactionType": "sale",
  "propertyTypes": ["flat"],
  "regions": ["11"],
  "maxPricePerSqm": 70000,
  "excludeReserved": true,
  "excludeKeywords": ["podíl"],
  "maxItems": 0
}
```

**Detached family houses with a garden near Prague, new builds or after reconstruction:**

```json
{
  "transactionType": "sale",
  "propertyTypes": ["house"],
  "subtypes": ["Rodinný"],
  "districts": ["Praha-západ", "Praha-východ"],
  "houseKinds": ["detached"],
  "features": ["garden"],
  "conditions": ["new", "after-reconstruction"],
  "includeDetails": true,
  "maxItems": 0
}
```

**Upcoming property auctions in the whole country with dates, deposits and estimates:**

```json
{
  "transactionType": "auction",
  "propertyTypes": ["flat", "house", "land", "commercial", "other"],
  "includeDetails": true,
  "maxItems": 0
}
```

**Market data: all flats for rent in Czechia (for price maps and statistics):**

```json
{
  "transactionType": "rent",
  "propertyTypes": ["flat"],
  "maxItems": 0
}
```

**Your own URL, or a list of listings:**

```json
{
  "startUrls": [
    { "url": "https://reality.idnes.cz/s/pronajem/byty/brno/?dispozice=2-kk%7C3-kk" },
    { "url": "https://reality.idnes.cz/detail/prodej/byt/praha-10-v-predpoli/6a883699007ec0e42e0cf59d/" }
  ],
  "listingIds": ["6a4d30e2639aaa52010942bc"],
  "includeDetails": true
}
```

**An agency's listings, or the market without the big agencies:** use **Only these agencies** or **Exclude agencies** with (a part of) the agency's name, e.g. `"REMAX"` (spaces and punctuation are ignored).

#### Website filters (applied by reality.idnes.cz)

Price, usable area, plot area, listing age ("Aktuálnost": a day, a week or a month), building condition, building type, ownership, furnishing, house kind, number of rooms, the "must have" features and "only discounted" are applied by reality.idnes.cz itself, so only matching listings are read.

#### Filters (you don't pay for filtered-out listings)

Seller, price per m², only discounted, only with a price, exclude reserved, only with GPS or photos, created in the last N days, keywords, excluded keywords, only or except given agencies. They cost nothing extra (keywords in descriptions, GPS and the agency's own name need details).

#### Monitoring mode explained

Turn on **Monitoring: only new or changed listings** and schedule the actor (e.g. every morning). The first run returns everything and remembers it under the **Monitoring key**. Every next run returns only listings that are new (`changeType: "new"`) or whose price or title changed (`"updated"`, with `previousPrice`, `priceChange`, `priceChangePercent`). With **include removed listings**, listings that are no longer in your search are checked on reality.idnes.cz and returned once as `"removed"` with `removedReason` `"deleted"` (the listing is no longer active, reported right away) or `"noLongerMatches"` (still active, but e.g. its price moved out of your range; confirmed by the next run before it is reported, so there are no false alarms); a removed listing that comes back is `"reappeared"`. Use one monitoring key per watched search.

#### Fast mode (optional, small extra charge)

Fast mode helps little on this website (measured: 6 % faster on 200 listings with details); the normal speed suits most runs. It drops back to the normal speed for the rest of the run at the first sign of load and never changes IP address to get around a limit.

### How much does it cost to scrape iDNES Reality?

You pay per saved listing, and a little more for the listings saved with their details. Platform usage is included. Filtered-out and unchanged listings (in monitoring mode) are free.

| Plan | Per 1 000 listings | + with details (Add listing details) | + Fast mode |
|---|---|---|---|
| FREE | **$3.80** | +$1.75 | +$0.01 |
| BRONZE | **$3.60** | +$1.75 | +$0.01 |
| SILVER | **$3.40** | +$1.75 | +$0.01 |
| GOLD and higher | **$3.20** | +$1.75 | +$0.01 |

So 1 000 listings cost $3.80, or $5.55 with all the details (FREE plan; the details cost the same on every plan). Agency IČO and website are included in the details price. A removed-listing row in monitoring mode is a row like any other (without details). In monitoring mode every search page read is **$0.10 per 1 000 pages** (the `monitoring-page` event): a daily check of a search with about 120 listings is $0.0005 a day. There is also a tiny start fee of $0.00005 per run.

Typical runs (measured on Apify, 2026-10-19):

| Scenario | Typical time | Price (FREE plan) |
|---|---|---|
| 20 listings from a search URL (the prefilled input) | ~10 s | $0.08 |
| 1 000 listings | ~40 s | $3.80 |
| 1 000 listings with details | ~17 min | $5.55 |
| All 4 400 flats for sale in Prague | ~2.5 min | $16.80 |
| Daily monitoring of all 4 400 flats for sale in Prague, ~10 new or changed | ~3 min | ~$0.06 |

### Input example

```json
{
  "startUrls": [{ "url": "https://reality.idnes.cz/s/prodej/byty/praha/" }],
  "maxItems": 20
}
```

### Output example

```json
{
  "id": "idnes:6a883699007ec0e42e0cf59d",
  "listingId": "6a883699007ec0e42e0cf59d",
  "source": "reality.idnes.cz",
  "url": "https://reality.idnes.cz/detail/prodej/byt/praha-10-v-predpoli/6a883699007ec0e42e0cf59d/",
  "name": "Prodej bytu 2+1 56 m²",
  "transactionType": "sale",
  "propertyType": "flat",
  "subtype": "2+1",
  "price": 8390000,
  "priceCurrency": "CZK",
  "priceUnit": "za nemovitost",
  "pricePerSqm": 149821,
  "priceOnRequest": false,
  "isDiscounted": false,
  "isReserved": false,
  "usableArea": 56,
  "address": "V předpolí, Praha 10 - Strašnice",
  "region": "Hlavní město Praha",
  "district": "Praha 10",
  "city": "Praha",
  "cityPart": "Strašnice",
  "street": "V předpolí",
  "country": "Česko",
  "latitude": 50.0709193,
  "longitude": 14.4829549,
  "locationPrecision": "address",
  "agencyId": "5a85b7dca26e3a321d502910",
  "agencyName": "Realitní agentura Starlet, s.r.o.",
  "agencyIco": "27170934",
  "agencyWebsite": "http://www.rastarlet.cz",
  "isPrivateSeller": false,
  "imageUrl": "https://sta-reality2.1gr.cz/sta/compile/thumbs/5/0/d/b8f72832cc76bb4b364e258de0a7f.jpg?gt=r",
  "imageCount": 27,
  "listedAt": "2026-08-21",
  "description": "Úsporný byt 2+1/B, Praha 10 - Strašnice, dům v rekonstrukci na PENB A/B\n\nHledáte příjemné bydlení v klidné lokalitě…",
  "agencyListingCode": "IDNES-119",
  "priceNote": "včetně provize a právního servisu",
  "floor": 1,
  "floors": 5,
  "condition": "Velmi dobrý",
  "buildingType": "Cihlová",
  "ownership": "Osobní",
  "furnished": "Ne",
  "energyClass": "G",
  "elevator": true,
  "balcony": true,
  "balconyArea": 2,
  "cellar": true,
  "detailScraped": true,
  "scrapedAt": "2026-10-19T17:00:00Z"
}
```

(Shortened; every row has all fields, missing values are `null`.)

### Limitations

- **GPS** is on the listing page, so it needs **Add listing details**. Listings without an exact address get the middle of their street (`locationPrecision: "street"`) or no GPS.
- **Listed on** (`listedAt`) is the date the listing was created on reality.idnes.cz, known without opening the listing. The website shows no "updated" date, so `updatedAt` is not in the output.
- **Area** without details comes from the title (it is the area the website shows); with details from the listing's parameters.
- **Promoted listings** ("Tip regionu" at the top of every search page) are skipped: they are repeated on every page and may not match your filters. Counting them out, a search returns 99.8 % of the number the website shows (measured: 4 415 of 4 422); the rest are listings that moved between pages while the search was read.
- **Website filters** work for the searches built from the input; a pasted URL keeps exactly its own filters.
- **Contacts:** brokers' names, phones, e-mails and photos are never returned, and phone numbers and e-mails are removed from descriptions. Names written in a description stay there.
- **Photos** are returned as URLs; they are copyrighted, so check the rights before you republish them.
- **Proxy:** not needed.
- A page the website rejects is retried once a little later, never from another IP address; if rejections continue, the run stops with what it has saved and says so. Listings whose page couldn't be read are returned without details (`detailScraped: false`).
- **Details are slow:** 1 000 listings with details take about 17 minutes. Test a search without details first; the listing data already have the price, area, address, agency and date.

### For AI agents and API users

- **Minimal input:** `{"startUrls": [{"url": "https://reality.idnes.cz/s/prodej/byty/praha/"}], "maxItems": 20}`, or `{"locations": ["Brno"], "transactionType": "rent", "maxItems": 50}`, or `{"listingIds": ["6a883699007ec0e42e0cf59d"]}`.
- One row = one listing = one charge (+ the details event for rows with `detailScraped: true`, + the fast-mode event when fast mode is on).
- `maxItems` counts saved listings (0 = no limit), `maxItemsPerSearch` limits each URL, location and search.
- Prices are in CZK (`priceCurrency`); `priceUnit` says whether it is the whole property or per month. `transactionType` is `sale`, `rent` or `auction`; `propertyType` is `flat`, `house`, `land`, `commercial` or `other`. The same values and field names as the Sreality.cz Scraper.
- Regions take the same IDs as the Sreality.cz Scraper (`10` Praha, `11` Středočeský, `14` Jihomoravský…, see the input); subtypes the same names (`2+kk`, `Rodinný`, `Kanceláře`…).
- Monitoring state is kept per `monitoringKey` between runs of the same user.

#### Python

```python
from apify_client import ApifyClient

client = ApifyClient("<YOUR_API_TOKEN>")
run = client.actor("tsutseisoftware/idnes-reality-scraper").call(run_input={
    "transactionType": "rent",
    "propertyTypes": ["flat"],
    "locations": ["Praha 6"],
    "maxPrice": 30000,
    "maxItems": 100,
})
for listing in client.dataset(run.default_dataset_id).iterate_items():
    print(listing["name"], listing["price"], listing["cityPart"], listing["url"])
```

#### JavaScript

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

const client = new ApifyClient({ token: '<YOUR_API_TOKEN>' });
const run = await client.actor('tsutseisoftware/idnes-reality-scraper').call({
    startUrls: [{ url: 'https://reality.idnes.cz/s/prodej/domy/brno-venkov/' }],
    includeDetails: true,
    maxItems: 50,
});
const { items } = await client.dataset(run.defaultDatasetId).listItems();
console.log(items.map((l) => `${l.name}: ${l.price} CZK (${l.pricePerSqm} CZK/m²)`));
```

#### cURL

```bash
curl -X POST "https://api.apify.com/v2/acts/tsutseisoftware~idnes-reality-scraper/run-sync-get-dataset-items?token=<YOUR_API_TOKEN>" \
  -H "Content-Type: application/json" \
  -d '{"listingIds": ["6a883699007ec0e42e0cf59d"]}'
```

You can also connect the actor to Make, Zapier, n8n, Google Sheets, Slack or webhooks and schedule it in Apify Console.

### Troubleshooting

| Status message | What to do |
|---|---|
| `skipped … unsupported URLs` (the log says which) | Use a reality.idnes.cz search page (`/s/…`) or a listing URL (`/detail/…`). Developer projects (`/projekty/`) are not supported. |
| `Ignored URL parameters …` (log) | Tracking parameters (utm\_…) and `page` are removed; the search starts at its first page. |
| `Location not found` | Type the place as the website's search box suggests it (a town, a city part, a street, a district). |
| `Unknown subtype / region / condition …` | Use one of the values listed in the message. |
| `no listings: …` | The search is empty (with these filters). |
| `not found: …` | The listing ID doesn't exist or the listing is no longer active. |
| `not read because reality.idnes.cz rejected the request or did not answer …` | The website did not give the listing this time (it may still exist); try again later. |
| `… could not be read (reality.idnes.cz did not answer)` | The website did not answer; try again later. |
| `reality.idnes.cz is rejecting requests` | Try again later; turn on Apify Proxy in **Proxy configuration**. |
| `stopped at your maximum cost per run` | Raise the maximum cost per run in the run options. |

### Privacy and error reports

When a run fails, the actor sends its developer a short error report: the error, the run ID and your input with secrets left out (tokens, webhooks, e-mails and similar values are hidden). Your results are never sent. Reports are deleted after at most 120 hours (5 days). To send nothing, turn off **Send error reports** (`sendErrorReports: false`). Questions about your data: open an issue in the **Issues** tab of this actor.

### More Czech real-estate scrapers

The same output format for the other big Czech real-estate portals (many listings are published on several of them):

- [Czech Real Estate Aggregator](https://apify.com/tsutseisoftware/czech-real-estate-aggregator): all these Czech real-estate portals in one run: duplicates merged, price against the district, rental yield, monitoring
- [Sreality.cz Scraper](https://apify.com/tsutseisoftware/sreality-scraper): the biggest Czech real-estate portal: price per m², GPS, agency, monitoring
- [Bezrealitky.cz Scraper](https://apify.com/tsutseisoftware/bezrealitky-scraper): flats, houses and rentals from private owners: price per m², charges, GPS, walking distances, monitoring

### FAQ

#### Is it legal to scrape iDNES Reality?

The actor collects publicly available listing data that anyone sees on the website. It does not log in, makes at most 90 requests per minute by default (180 in fast mode), slows down when the website asks, never changes IP address to get around a limit and never solves captchas or other challenges. It returns no personal data of brokers (no names, phones, e-mails or photos), returns an advertiser whose name is a person's name as `null`, and removes phone numbers and e-mails from descriptions. How you use the data is your responsibility: use it for analysis, monitoring and market research, and don't republish the listings, texts or photos as your own. If unsure, consult a lawyer. Objections and data protection requests: the **Issues** tab of this actor.

#### Do I need a proxy?

No. The default is without a proxy, and nothing needs to be set.

#### How do I get all listings of a category or of the whole country?

Set **Max listings** to 0 and choose only the transaction and the property types (no location). The whole search is read.

#### Why is GPS empty?

GPS is on the listing page: turn on **Add listing details**. Some listings have no exact address; they get the middle of their street, or no GPS.

#### Why are some prices empty?

The listing has its price on request ("Cena na vyžádání"); `priceOnRequest` is `true`. Use **Only with a price** to skip them.

#### What does "noLongerMatches" mean?

In monitoring mode, a listing that is not in your search anymore is checked on reality.idnes.cz. If it is no longer active, it is `deleted` right away. If it is still active (e.g. its price changed out of your range), it is `noLongerMatches`, confirmed by the next run before it is reported, so there are no false alarms.

#### Can I get the broker's phone or e-mail?

No. The actor never returns personal contacts. You get the agency's name and, with **Add agency IČO and website**, its IČO and website.

#### Can I combine it with Sreality.cz?

Yes. The fields have the same names and values as in our Sreality.cz Scraper, and the inputs take the same regions and subtypes, so you can run both with one input and merge the datasets.

#### Something doesn't work

Open an issue in the **Issues** tab with the link to the run.

This actor is not affiliated with reality.idnes.cz, iDNES.cz or MAFRA, a.s. It is also known as an iDNES Reality API, reality.idnes.cz scraper, Czech real estate scraper or "hlídač realit iDNES" (hlídač nových inzerátů a cen nemovitostí).

# Changelog

This Actor's version history is a separate document: https://apify.com/tsutseisoftware/idnes-reality-scraper/changelog.md

# Actor input Schema

## `startUrls` (type: `array`):

Search pages from reality.idnes.cz (set the filters on the website and paste the URL, e.g. https://reality.idnes.cz/s/prodej/byty/praha/?s-qc%5BsubtypeFlat%5D=2k) or listings (…/detail/…/6a883699007ec0e42e0cf59d/). All the website's filters in the URL are kept. The "Website filters" below apply to the searches built from the fields of this input; "Filters" apply to everything.

## `transactionType` (type: `string`):

For the search built from the fields below (locations, regions, districts; or the whole country when no URL, location, region, district or ID is given).

## `propertyTypes` (type: `array`):

For the search built from these fields (default: flats). Each type is its own search on the website.

## `subtypes` (type: `array`):

As on Sreality.cz, so one input works for both: flats 1+kk, 1+1, 2+kk, 2+1, 3+kk, 3+1, 4+kk, 4+1, 5+kk, 5+1, 6 a více, Pokoj, Atypický; houses Rodinný, Chata (chata nebo chalupa), Na klíč, Ostatní; land Bydlení (stavební), Komerční, Pole, Lesy, Zahrady, Louky, Rybníky, Ostatní; commercial Kanceláře, Obchodní prostory, Sklady, Výroba, Ubytování, Restaurace, Činžovní dům, Zemědělský, Ostatní.

## `locations` (type: `array`):

Towns, city parts, streets, districts or regions in words (e.g. "Brno", "Praha 6", "Smíchov", "Říčany"), looked up like the website's search box. Each location is its own search. Up to 20.

## `radiusKm` (type: `integer`):

Also listings around each location (towns, city parts, streets, districts). The website offers 0.5, 1, 5, 10 and 20 km; other values are rounded up. 0 = only the location itself.

## `regions` (type: `array`):

Whole regions, searched together.

## `districts` (type: `array`):

Districts by name, each its own search: e.g. "Brno-město", "Praha-západ", "Kladno".

## `listingIds` (type: `array`):

iDNES Reality listing IDs (the 24 characters at the end of a listing URL, e.g. 6a883699007ec0e42e0cf59d). Each listing is read with its details. Up to 2000 per run.

## `maxItems` (type: `integer`):

Maximum number of listings saved (and charged) in total. 0 = no limit (whole searches, e.g. all 26 000 flats for sale).

## `maxItemsPerSearch` (type: `integer`):

Limit for each URL, location and search separately. 0 = no limit.

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

Read each listing's page too: GPS, description, all photos, parameters (floor, condition, building type, ownership, furnishing, energy class, balcony, cellar, elevator…), original price before a discount, price note, auction date and deposit, the agency. Charged as listing details and slower: 1 000 listings with details take about 17 minutes, so test a search without details first.

## `includeAgencyDetails` (type: `boolean`):

With "Add listing details": also the agency's IČO and website, included in the details price.

## `descriptionMaxLength` (type: `integer`):

Cut descriptions to this many characters. 0 = full description.

## `sortBy` (type: `string`):

Order of the results in each search. Empty = as in the URL (newest first by default).

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

Website filter for the searches built from this input.

## `maxPrice` (type: `integer`):

Website filter. For rentals the monthly rent.

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

Website filter.

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

Website filter.

## `minPlotArea` (type: `integer`):

Website filter (houses and land).

## `maxPlotArea` (type: `integer`):

Website filter (houses and land).

## `maxAgeDays` (type: `integer`):

Website filter "Aktuálnost": 1 (a day), 7 (a week) or 31 (a month); other values are rounded up. Empty = any age.

## `conditions` (type: `array`):

Website filter: any of them.

## `buildingTypes` (type: `array`):

Website filter: any of them.

## `ownership` (type: `array`):

Website filter: any of them.

## `furnished` (type: `array`):

Website filter (flats, houses, commercial).

## `houseKinds` (type: `array`):

Website filter (houses).

## `roomCounts` (type: `array`):

Website filter (houses): number of rooms.

## `features` (type: `array`):

Website filter. Balcony, loggia and terrace count as one group (any of the chosen ones), garage and parking too; the other features must all be there.

## `onlyDiscounted` (type: `boolean`):

Only listings marked as discounted (Zlevněno). A website filter for the searches of this input, a filter for URLs.

## `sellerType` (type: `string`):

Agencies only or private sellers only (with details, a listing without an agency or broker counts as private).

## `minPricePerSqm` (type: `integer`):

Only listings with at least this price per m².

## `maxPricePerSqm` (type: `integer`):

Only listings with at most this price per m² (finds bargains).

## `onlyWithPrice` (type: `boolean`):

Skip listings with the price on request.

## `excludeReserved` (type: `boolean`):

Skip listings marked as reserved (Rezervováno).

## `onlyWithGps` (type: `boolean`):

Skip listings without coordinates (needs "Add listing details").

## `onlyWithImages` (type: `boolean`):

Skip listings without photos.

## `listedWithinDays` (type: `integer`):

Only listings created on the website in this many days (listedAt, known without details). Any number of days, unlike the website filter above.

## `keywords` (type: `array`):

Only listings whose title (or description, with details) contains any of these words, e.g. "sauna", "výhled", "garáž".

## `excludeKeywords` (type: `array`):

Skip listings whose title (or description, with details) contains any of these words, e.g. "podíl", "rezervováno".

## `agencyNames` (type: `array`):

Agency names or parts of them (agencyName in the results), e.g. "REMAX", "Century 21" (spaces and punctuation are ignored).

## `excludeAgencyNames` (type: `array`):

Agency names or parts of them (agencyName in the results).

## `onlyNewOrChanged` (type: `boolean`):

Return only listings that are new or whose price or title changed since the previous run with the same monitoring key. Unchanged listings are not saved or charged; every search page read in this mode is $0.0001 (the monitoring-page event). Schedule the actor to get a watchdog.

## `monitoringKey` (type: `string`):

Name of the remembered state; use a different key for each watched search. Empty = "default". The value is stored encrypted.

## `onlyPriceChanges` (type: `boolean`):

Of the changed listings, only those whose price changed (new listings are still returned).

## `minPriceDropPercent` (type: `integer`):

Only listings whose price dropped at least this much since the previous run.

## `includeRemovedListings` (type: `boolean`):

Also return listings that left the search since the previous run, each checked on reality.idnes.cz: removedReason "deleted" (no longer active on the website) or "noLongerMatches" (still active, but no longer in your search; confirmed by the next run before it is reported, so there are no false alarms). Listings that come back are marked "reappeared".

## `fastMode` (type: `boolean`):

Faster listing details for a small extra charge per listing, but on this website the gain is usually small; the normal speed suits most runs. Drops back to the normal speed for the rest of the run at the first sign of load; it never changes IP address to get around a limit.

## `maxRequestsPerMinute` (type: `integer`):

Upper limit of the normal speed. The default suits almost every run.

## `proxyConfiguration` (type: `object`):

No proxy needed. Turn on Apify Proxy only if the website starts rejecting requests.

## `sendErrorReports` (type: `boolean`):

When a run fails, send the developer a short error report: the error and your input with secrets left out (tokens, webhooks and e-mails are hidden). Your results are never sent. Reports are deleted after at most 120 hours. Turn off to send nothing.

## Actor input object example

```json
{
  "startUrls": [
    {
      "url": "https://reality.idnes.cz/s/prodej/byty/praha/"
    }
  ],
  "transactionType": "sale",
  "subtypes": [],
  "maxItems": 20,
  "includeDetails": false,
  "includeAgencyDetails": false,
  "onlyDiscounted": false,
  "sellerType": "any",
  "onlyWithPrice": false,
  "excludeReserved": false,
  "onlyWithGps": false,
  "onlyWithImages": false,
  "onlyNewOrChanged": false,
  "onlyPriceChanges": false,
  "includeRemovedListings": false,
  "fastMode": false,
  "maxRequestsPerMinute": 90,
  "proxyConfiguration": {
    "useApifyProxy": false
  },
  "sendErrorReports": true
}
```

# Actor output Schema

## `listings` (type: `string`):

No description

# 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 = {
    "startUrls": [
        {
            "url": "https://reality.idnes.cz/s/prodej/byty/praha/"
        }
    ],
    "subtypes": [],
    "maxItems": 20,
    "proxyConfiguration": {
        "useApifyProxy": false
    }
};

// Run the Actor and wait for it to finish
const run = await client.actor("tsutseisoftware/idnes-reality-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 = {
    "startUrls": [{ "url": "https://reality.idnes.cz/s/prodej/byty/praha/" }],
    "subtypes": [],
    "maxItems": 20,
    "proxyConfiguration": { "useApifyProxy": False },
}

# Run the Actor and wait for it to finish
run = client.actor("tsutseisoftware/idnes-reality-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 '{
  "startUrls": [
    {
      "url": "https://reality.idnes.cz/s/prodej/byty/praha/"
    }
  ],
  "subtypes": [],
  "maxItems": 20,
  "proxyConfiguration": {
    "useApifyProxy": false
  }
}' |
apify call tsutseisoftware/idnes-reality-scraper --silent --output-dataset

```

## MCP server setup

```json
{
    "mcpServers": {
        "apify": {
            "type": "http",
            "url": "https://mcp.apify.com/?tools=fetch-actor-details,tsutseisoftware/idnes-reality-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/gJshu3rnPY6byrjvI/builds/7NghxMXeSKm8LKZ2E/openapi.json
