# Sreality scraper (`bebich/sreality-scraper`) Actor

Fast and efficient sreality.cz actor. The script get all offers (according to the selected input). Reworked and updated to new version

- **URL**: https://apify.com/bebich/sreality-scraper.md
- **Developed by:** [ALi](https://apify.com/bebich) (community)
- **Categories:** Real estate
- **Features:** Limited permissions
- **Stats:** 86 total users, 1 monthly users, 89.7% runs succeeded, 6 bookmarks
- **User rating**: 2.17 out of 5 stars

## Pricing

from $1.00 / 1,000 results

This Actor is paid per event and usage. You are charged both the fixed price for specific events and for Apify platform usage.
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

## Sreality API Scraper

Scrape real estate listings from [Sreality.cz](https://www.sreality.cz/) into a structured Apify dataset.

This actor reads Sreality search data from the site, follows pagination, normalizes listing fields, and can optionally enrich each listing with detail-page data such as description, seller, premise, videos, and listing parameters.

### What You Can Scrape

- Flats, houses, land, commercial properties, and other real estate
- Sale, rental, auction, and share listings
- Listings by Czech region
- Detailed property types such as apartment layouts, family houses, building plots, offices, warehouses, garages, and more
- English or Czech Sreality URL variants
- Optional detail data from individual listing pages

### Common Use Cases

- Track real estate prices across Czech regions
- Build a dataset of active Sreality listings
- Monitor sale and rental inventory by category
- Enrich market analysis with location, price, image, and seller data
- Validate listing detail URLs during scraper QA runs

### Input

The actor accepts slug-based inputs. Empty arrays mean "all supported values".

#### Basic Example

```json
{
  "AREA": ["praha"],
  "CATEGORIES": ["for-sale"],
  "SUBCATEGORIES": ["apartments"],
  "PROPERTY_TYPES": ["1+kt", "2+kt"],
  "maxPages": 5,
  "LANGUAGE_EN": true,
  "GET_DETAILS": false,
  "IGNORE": ["raw", "images", "pagination", "searchUrl", "searchPage"],
  "TEST_URL_DETAIL": false,
  "DEBUG": false
}
```

#### Scrape All Supported Searches For One Page for every area

```json
{
  "AREA": [],
  "CATEGORIES": [],
  "SUBCATEGORIES": [],
  "PROPERTY_TYPES": [],
  "maxPages": 1,
  "LANGUAGE_EN": true,
  "GET_DETAILS": false,
  "IGNORE": [
    "pagination",
    "searchPage",
    "searchUrl",
    "raw",
    "images",
    "premiseLogo",
    "hasMatterport",
    "hasVideo",
    "discountShow",
    "seller.image",
    "premise.retargetingId",
    "premise.askId",
    "premise.isSosCustomAdvertCard",
    "premise.logo",
    "premise.webVisibleUrl",
    "premise.premisePaidFirmy",
    "premise.companySubjectId",
    "videos"
  ]
}
```

#### Czech Example

```json
{
  "AREA": ["praha", "jihomoravsky-kraj"],
  "CATEGORIES": ["prodej", "pronajem"],
  "SUBCATEGORIES": ["byty", "domy"],
  "PROPERTY_TYPES": ["1+kk", "2+kk"],
  "maxPages": 3,
  "LANGUAGE_EN": false
}
```

### Input Fields

| Field | Type | Description |
| --- | --- | --- |
| `AREA` | array | Region slugs to scrape. Leave empty to scrape all supported regions. |
| `CATEGORIES` | array | Listing categories. Supports English and Czech slugs. Leave empty for all categories. |
| `SUBCATEGORIES` | array | Main real estate categories. Supports English and Czech slugs. Leave empty for all subcategories. |
| `PROPERTY_TYPES` | array | Detailed property types such as apartment layouts, family houses, building plots, offices, or garages. Supports English and Czech slugs. Leave empty for all supported property types. |
| `maxPages` | integer | Maximum number of search result pages per generated search. Use `0` to scrape all available pages reported by Sreality. |
| `LANGUAGE_EN` | boolean | `true` requests English Sreality pages and outputs English detail URLs. `false` requests Czech pages and outputs Czech detail URLs. |
| `GET_DETAILS` | boolean | Fetch each listing detail JSON and append detail fields. |
| `IGNORE` | array | Dot-separated output paths to remove from each dataset item before saving. |

### Supported Values

#### Areas

```text
praha
stredocesky-kraj
jihocesky-kraj
jihomoravsky-kraj
karlovarsky-kraj
kralovehradecky-kraj
liberecky-kraj
moravskoslezsky-kraj
olomoucky-kraj
pardubicky-kraj
plzensky-kraj
ustecky-kraj
vysocina-kraj
zlinsky-kraj
```

#### Categories

| English | Czech |
| --- | --- |
| `for-sale` | `prodej` |
| `to-rent` | `pronajem` |
| `auction` | `drazby` |
| `shares` | `podily` |

#### Subcategories

| English | Czech |
| --- | --- |
| `apartments` | `byty` |
| `houses` | `domy` |
| `lands` | `pozemky` |
| `commercial-properties` | `komercni` |
| `other-real-estates` | `ostatni` |

#### Property Types

`PROPERTY_TYPES` supports both English and Czech Sreality slugs. Examples:

```text
1+kt / 1+kk
2+kt / 2+kk
family-houses / rodinne-domy
building-plots / stavebni-parcely
office-spaces / kancelare
warehouses / sklady
garages / garaze
parking-places / garazova-stani
```

Leave `PROPERTY_TYPES` empty to include all supported detailed property types for the selected subcategories.

### Output

The actor saves one dataset item per listing. The exact fields depend on `IGNORE` and whether `GET_DETAILS` is enabled.

#### Example Output Item

```json
{
  "id": 1896579148,
  "date": "2026-06-13",
  "url": "https://www.sreality.cz/en/detail/sale/land/field/oslavicka-oslavicka-/1896579148",
  "name": "For sale farm lands 7413 m2",
  "priceCzk": 363237,
  "priceCzkPerSqM": 49,
  "priceSummaryCzk": 363237,
  "priceUnit": "per property",
  "priceSummaryUnit": "per property",
  "categoryType": "Sale",
  "categoryTypeValue": 1,
  "categoryMain": "Land",
  "categoryMainValue": 3,
  "categorySub": "Fields",
  "categorySubValue": 20,
  "city": "Oslavicka",
  "cityPart": "Oslavicka",
  "district": "Zdar nad Sazavou",
  "region": "Vysocina region",
  "street": "",
  "houseNumber": null,
  "streetNumber": null,
  "latitude": 49.3154067822499,
  "longitude": 15.9668425899982,
  "premiseId": 33825,
  "imageUrls": [
    "https://d18-a.sdn.cz/d_18/c_img_qB_E/kQMlcCt5zmBDp4maqGuWudT/be45.jpeg?fl=res,1200,1200,1|wrm,/watermark/sreality.png,10|shr,,20|webp,80"
  ]
}
```

#### Main Output Fields

- `id`, `date`, `url`, `name`
- `priceCzk`, `priceCzkPerSqM`, `priceSummaryCzk`, `priceUnit`, `priceSummaryUnit`
- `categoryType`, `categoryMain`, `categorySub` and their numeric values
- `city`, `cityPart`, `district`, `region`, `street`, `houseNumber`, `streetNumber`
- `latitude`, `longitude`, `locality`
- `premiseId`, `premiseLogo`
- `images`, `imageUrls`
- `searchPage`, `searchUrl`, `pagination`
- `raw`, containing the original listing object from Sreality

When `GET_DETAILS` is enabled, the actor can also append:

- `dataUpdatedAt`
- `description`
- `premise`
- `seller`
- `rus`
- `videos`
- `isExclusively`
- `params`

### Field Filtering With IGNORE

Use `IGNORE` to remove fields from the dataset before saving.

Examples:

- `raw` removes the original Sreality listing object.
- `images` removes normalized image objects while keeping `imageUrls` if you do not ignore it.
- `pagination` removes pagination metadata.
- `seller.image` removes only the nested seller image when `GET_DETAILS` is enabled.
- `premise.logo` removes only the nested premise logo.

If a rule enters an array, the remaining path is applied to every object in that array.

### Pagination And Empty Searches

Missing arrays and empty arrays mean all supported values. For broad searches, the actor splits requests by area and subcategory instead of sending one huge combined search. This helps avoid Sreality result limits and keeps pagination more predictable.

`maxPages` applies per generated search. For example, `AREA: []`, `SUBCATEGORIES: []`, and `maxPages: 1` can still produce many requests because the actor creates separate searches for each area and subcategory pair.

### Detail Enrichment Notes

`GET_DETAILS` gives richer data but increases request volume. If Sreality rate-limits or blocks detail requests, reduce `GET_DETAILS_CONCURRENCY`.

When detail fetching is enabled, listings whose detail JSON request fails are skipped instead of being saved without details.

### Migration Notes

Version `v1.3` uses the current Sreality and a new slug-based input model.

Legacy fields such as `CITY`, `PROPERTY_TYPE`, `APARTMENTS`, `HOUSES`, `LANDS`, `SELLING`, `LANGUAGE_CZ`, `DATASET_NAME`, `DROP_DATASET`, `SAVE_ALL_TEXTS`, and `ENRICHER_TEXTS` are not part of the current Store input. Use `AREA`, `CATEGORIES`, `SUBCATEGORIES`, `PROPERTY_TYPES`, `LANGUAGE_EN`, `IGNORE`, and `GET_DETAILS` instead.

Legacy output fields such as `Hash_id`, `Datum`, `Cena`, and `URL_AD` were replaced with normalized API-oriented fields such as `id`, `date`, `priceCzk`, and `url`.

### Notes And Limitations

- The actor scrapes data available from Sreality web.
- Available fields can vary by listing category and by what Sreality returns for a specific ad.
- Broad searches can create many page requests. Use `maxPages` for sampling or controlled runs.
- URL validation is intended for debugging and QA. It adds extra network requests.

### Legal

This actor is not affiliated with Sreality.cz. Use it responsibly and make sure your usage complies with applicable laws, Sreality's terms, and Apify's platform rules.

# Changelog

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

# Actor input Schema

## `AREA` (type: `array`):

Sreality area slugs to scrape. Leave empty to scrape all supported areas.

## `CATEGORIES` (type: `array`):

Listing categories. English and Czech Sreality slugs are accepted. Leave empty to include all categories.

## `SUBCATEGORIES` (type: `array`):

Main property categories. English and Czech Sreality slugs are accepted. Leave empty to include all property categories.

## `PROPERTY_TYPES` (type: `array`):

Detailed property type slugs, such as apartment layouts, house types, land types, and commercial property types. English and Czech Sreality slugs are accepted. Leave empty to include all supported property types for the selected categories.

## `GET_DETAILS` (type: `boolean`):

Fetch each listing detail JSON and append fields such as description, premise, seller, videos, rus, isExclusively, and params.

## `LANGUAGE_EN` (type: `boolean`):

When true, request English Sreality search pages and output English detail URLs. When false, request Czech pages and output Czech detail URLs.

## `IGNORE` (type: `array`):

Dot-separated output field paths to remove from each saved dataset item.

## `TELEGRAM_BOT_TOKEN` (type: `string`):

Optional Telegram bot token. When provided with TELEGRAM_CHAT_ID, the actor sends a scrape completion message.

## `TELEGRAM_CHAT_ID` (type: `string`):

Optional Telegram chat ID. When provided with TELEGRAM_BOT_TOKEN, the actor sends a scrape completion message.

## Actor input object example

```json
{
  "AREA": [
    "stredocesky-kraj"
  ],
  "CATEGORIES": [
    "to-rent"
  ],
  "SUBCATEGORIES": [
    "apartments"
  ],
  "PROPERTY_TYPES": [
    "1+1"
  ],
  "GET_DETAILS": false,
  "LANGUAGE_EN": true,
  "IGNORE": [
    "pagination",
    "searchPage",
    "images.restbType",
    "videos"
  ]
}
```

# Actor output Schema

## `results` (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 = {
    "AREA": [
        "stredocesky-kraj"
    ],
    "CATEGORIES": [
        "to-rent"
    ],
    "SUBCATEGORIES": [
        "apartments"
    ],
    "PROPERTY_TYPES": [
        "1+1"
    ],
    "IGNORE": [
        "pagination",
        "searchPage",
        "images.restbType",
        "videos"
    ]
};

// Run the Actor and wait for it to finish
const run = await client.actor("bebich/sreality-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 = {
    "AREA": ["stredocesky-kraj"],
    "CATEGORIES": ["to-rent"],
    "SUBCATEGORIES": ["apartments"],
    "PROPERTY_TYPES": ["1+1"],
    "IGNORE": [
        "pagination",
        "searchPage",
        "images.restbType",
        "videos",
    ],
}

# Run the Actor and wait for it to finish
run = client.actor("bebich/sreality-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 '{
  "AREA": [
    "stredocesky-kraj"
  ],
  "CATEGORIES": [
    "to-rent"
  ],
  "SUBCATEGORIES": [
    "apartments"
  ],
  "PROPERTY_TYPES": [
    "1+1"
  ],
  "IGNORE": [
    "pagination",
    "searchPage",
    "images.restbType",
    "videos"
  ]
}' |
apify call bebich/sreality-scraper --silent --output-dataset

```

## MCP server setup

```json
{
    "mcpServers": {
        "apify": {
            "type": "http",
            "url": "https://mcp.apify.com/?tools=fetch-actor-details,bebich/sreality-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/7dRVWGXbTHLuneRbQ/builds/h12HcoB95Qoz16y86/openapi.json