# Sreality.cz Real Estate Scraper (`alwaysprimedev/sreality-cz-scraper`) Actor Scrape Czech property listings (sale, rent, auction) from sreality.cz with prices, areas, addresses, photos, energy class and seller contacts. - **URL**: https://apify.com/alwaysprimedev/sreality-cz-scraper.md - **Developed by:** [Always Prime](https://apify.com/alwaysprimedev) (community) - **Categories:** Automation, Lead generation, Real estate - **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, 1 bookmarks - **User rating**: No ratings yet ## Pricing from $3.50 / 1,000 ads This Actor is paid per event. You are not charged for the Apify platform usage, but only a fixed price for specific events. Learn more: https://docs.apify.com/platform/actors/running/actors-in-store#pay-per-event ## What's an Apify Actor? Actors are a software tools running on the Apify platform, for all kinds of web data extraction and automation use cases. 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. Actors are written with capital "A". ## 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. The best way to integrate Actors is as follows. In JavaScript/TypeScript projects, use official [JavaScript/TypeScript client](https://docs.apify.com/api/client/js.md): ```bash npm install apify-client ``` In Python projects, use official [Python client library](https://docs.apify.com/api/client/python.md): ```bash pip install apify-client ``` In shell scripts, use [Apify CLI](https://docs.apify.com/cli/docs.md): ````bash # MacOS / Linux curl -fsSL https://apify.com/install-cli.sh | bash # Windows irm https://apify.com/install-cli.ps1 | iex ```bash In AI frameworks, you might use the [Apify MCP server](https://docs.apify.com/platform/integrations/mcp.md). If your project is in a different language, use the [REST API](https://docs.apify.com/api/v2.md). For usage examples, see the [API](#api) section below. For more details, see Apify documentation as [Markdown index](https://docs.apify.com/llms.txt) and [Markdown full-text](https://docs.apify.com/llms-full.txt). # README ## 🏠 Sreality.cz Real Estate Scraper > ⚡️ Structured Czech real-estate listings in seconds — sale, rent, auction. Clean JSON, CSV or Excel. ![Apify](https://img.shields.io/badge/Apify-actor-brightgreen) ![Python](https://img.shields.io/badge/Python-3.11-blue) ![Output](https://img.shields.io/badge/Output-JSON%20%7C%20CSV%20%7C%20Excel-orange) Pull every public listing from [sreality.cz](https://www.sreality.cz) — the №1 real-estate portal in Czechia — and get it back as a normalized dataset. Filter by region, property type, deal type, price range; or paste a raw search URL and let the scraper crawl it for you. ### ✨ Why this scraper - 🚀 **Fast.** Direct JSON source — no headless browser, no DOM parsing. - 📦 **Complete.** 30+ fields per listing: price, area, rooms, GPS, full image set, agent contacts, energy class, modification date. - 🎯 **Filterable.** Region, property type, deal type, price range, sort order — all from a clean input form. - 🔁 **Incremental-friendly.** `since` parameter skips listings that haven't changed. - 💰 **Pay only for what you get.** Pay-per-result pricing — every record in the dataset is a record you wanted. ### 🚀 Quick start 1. **Try for free** — click the green Start button. 2. **Pick filters** — choose deal type (sale / rent / auction), property type, regions and an optional price range. 3. **Click Start** — the actor walks the search results and detail pages for you. 4. **Download** — open the dataset and export as JSON, CSV or Excel. ### 🎛 Input | Field | Description | | --- | --- | | `searchType` | Sale (Prodej), Rent (Pronájem), or Auction (Aukce). | | `propertyTypes` | Apartments, Houses, Land, Commercial, Other. Pick one or more. | | `regions` | Czech regions (kraj) by slug: `praha`, `stredocesky`, `jihomoravsky`, etc. | | `minPrice` / `maxPrice` | CZK price range. | | `sortBy` | Newest first, price ascending/descending, or largest area first. | | `maxItems` | Cap on output size. `0` = no limit. | | `scrapeDetails` | Full-fat mode (default) or cheap index-only mode. | | `since` | ISO timestamp — skip listings older than this. | | `concurrency` | Parallel detail requests. Default 5, max 25. | | `startUrls` | Advanced: paste raw search API URLs to override filters. | ### 📦 Sample output ```json { "url": "https://www.sreality.cz/detail/prodej/byt/praha-kamyk-u-kamyku/2812150604", "id": "2812150604", "scraped_at": "2026-05-05T00:45:18Z", "name": "Prodej bytu 4+kk 116 m²", "searchType": "sale", "propertyType": "apartments", "price": 17800000, "priceCurrency": "CZK", "priceUnit": "total", "priceText": "17 800 000", "usableArea": 116, "floorArea": null, "landArea": null, "rooms": "4+kk", "floor": 9, "buildingType": "Cihlová", "condition": "Velmi dobrý", "ownership": "Osobní", "energyRating": "C", "hasElevator": true, "hasParking": true, "hasBalcony": false, "hasTerrace": true, "hasGarden": false, "imageCount": 23, "images": [ "https://d18-a.sdn.cz/.../ec90.jpeg?fl=res,1280,960,3|shr,,20|jpg,90" ], "gps": { "lat": 50.017332896, "lon": 14.435376212 }, "address": "U Kamýku, Praha 4 - Kamýk", "locality": { "region": null, "district": "Kamýk", "municipality": "Praha 4", "street": "U Kamýku" }, "agentName": "Fröhlich Michal", "agentPhone": "+420 296399006", "agentEmail": "info@mmreality.cz", "agentWebsite": "https://www.mmreality.cz/", "modifiedAt": "2026-04-21T00:00:00Z" } ```` ### 💼 Use cases | Who | What for | | --- | --- | | 🏘 Real-estate investors | Comp-set analysis, yield calculations, market timing. | | 🤝 Brokers and agencies | Inventory tracking, competitor pricing, lead generation. | | 🤖 PropTech and ML teams | Training data for valuation models, market-trend dashboards. | | 📈 Market analysts | Time-series of price-per-m² by district, neighborhood-level reports. | | 🏛 Researchers | Housing affordability studies, geographic supply/demand. | ### 💡 Tips & tricks - 🕒 **Daily incremental updates** — schedule the actor with a `since` value of `now - 24h` to grab only listings that changed in the last day. - 💸 **Index-only mode** — set `scrapeDetails: false` to walk just the search pages. You lose detail-only fields (condition, building type, agent contacts, modification date) but pay for ~10× fewer requests, ideal for diff runs. - 🎯 **Multi-region runs** — list every region in a single run; the actor iterates them in turn so you do not need to set up one job per kraj. - 🔗 **Custom queries** — open sreality.cz in your browser, build your perfect search using the website filters, copy the request URL from your browser's network tab and paste it into `startUrls`. ### ❓ FAQ **Does it require an account?** No. The scraper runs anonymously. **Are images full resolution?** Yes — image URLs are returned at 1280×960 by default. Edit the `res,1280,960` segment in the URL to request other sizes. **What about historical listings?** This actor scrapes the *current* live inventory. For history, schedule daily runs and store results — incremental mode (`since`) keeps that cheap. **Why are some prices `null`?** Sreality marks "price on request" listings with a sentinel that we normalize to `null`. The full price text is preserved in `priceText` when present. **Why is `modifiedAt` sometimes missing?** The modification date lives only in the detail-page payload. If the listing has not been updated since publication, the field can be absent — we surface `null` in that case. ### ⚖️ Legal This actor scrapes publicly available information only. Use of the resulting data is subject to sreality.cz Terms of Use, Czech and EU law (including GDPR). You are the data controller of any output you persist; you are responsible for compliance with applicable regulations on your end. The maintainer of this actor is not responsible for downstream uses. ### 📜 Changelog - **0.1** — Initial release. Sale / rent / auction. 30+ fields per listing. Pay-per-result pricing. # Actor input Schema ## `searchType` (type: `string`): Whether to scrape properties for sale (Prodej), for rent (Pronájem), or in auctions (Aukce). Maps to sreality.cz's main category. ## `propertyTypes` (type: `array`): Which property categories to include. You can pick more than one — the actor will iterate them in turn. ## `regions` (type: `array`): List of Czech administrative regions (kraj) to scrape. Use slug names: praha, stredocesky, jihocesky, plzensky, karlovarsky, ustecky, liberecky, kralovehradecky, pardubicky, vysocina, jihomoravsky, olomoucky, zlinsky, moravskoslezsky. ## `minPrice` (type: `integer`): Lower bound on property price in Czech crowns. Leave empty to disable. For rent listings the bound applies to monthly price. ## `maxPrice` (type: `integer`): Upper bound on property price in Czech crowns. Leave empty to disable. ## `sortBy` (type: `string`): Order in which the listings are walked. Newest first is best for incremental runs; price ascending is best for bargain hunting. ## `maxItems` (type: `integer`): Maximum number of listings to scrape across the whole run. Set to 0 to disable the limit and scrape every match (use with care on large regions). ## `scrapeDetails` (type: `boolean`): When enabled (default), each listing's detail endpoint is fetched to populate building type, condition, ownership, energy rating, agent contacts and floor. Disable for a cheap index-only mode that uses search-page data only. ## `since` (type: `string`): Optional ISO 8601 timestamp (e.g. 2026-04-01T00:00:00Z). Listings whose last modification date is older are skipped. Requires Scrape detail pages to be enabled — modification date is only available on detail records. ## `concurrency` (type: `integer`): Number of detail requests to run in parallel. Default 5 is polite and reliable; increase for faster runs at the cost of higher chance of rate-limiting (cap 25). ## `startUrls` (type: `array`): Advanced override. Provide raw sreality.cz API URLs (https://www.sreality.cz/api/cs/v2/estates?...) instead of using the searchType/propertyTypes/regions filters. Useful when you've crafted a complex query in the website UI and copied the network call. ## Actor input object example ```json { "searchType": "sale", "propertyTypes": [ "apartments" ], "regions": [ "praha" ], "minPrice": 5000000, "maxPrice": 25000000, "sortBy": "newest", "maxItems": 50, "scrapeDetails": true, "concurrency": 5 } ``` # Actor output Schema ## `listings` (type: `string`): No description ## `listingsCsv` (type: `string`): No description ## `listingsXlsx` (type: `string`): No description ## `consoleView` (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 '' with your token const client = new ApifyClient({ token: '', }); // Prepare Actor input const input = { "searchType": "sale", "propertyTypes": [ "apartments" ], "regions": [ "praha" ], "maxItems": 50 }; // Run the Actor and wait for it to finish const run = await client.actor("alwaysprimedev/sreality-cz-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 '' with your token. client = ApifyClient("") # Prepare the Actor input run_input = { "searchType": "sale", "propertyTypes": ["apartments"], "regions": ["praha"], "maxItems": 50, } # Run the Actor and wait for it to finish run = client.actor("alwaysprimedev/sreality-cz-scraper").call(run_input=run_input) # Fetch and print Actor results from the run's dataset (if there are any) print("💾 Check your data here: https://console.apify.com/storage/datasets/" + run["defaultDatasetId"]) for item in client.dataset(run["defaultDatasetId"]).iterate_items(): print(item) # 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/python/docs/quick-start ``` ## CLI example ```bash echo '{ "searchType": "sale", "propertyTypes": [ "apartments" ], "regions": [ "praha" ], "maxItems": 50 }' | apify call alwaysprimedev/sreality-cz-scraper --silent --output-dataset ``` ## MCP server setup ```json { "mcpServers": { "apify": { "command": "npx", "args": [ "mcp-remote", "https://mcp.apify.com/?tools=alwaysprimedev/sreality-cz-scraper", "--header", "Authorization: Bearer " ] } } } ``` ## OpenAPI specification ```json { "openapi": "3.0.1", "info": { "title": "Sreality.cz Real Estate Scraper", "description": "Scrape Czech property listings (sale, rent, auction) from sreality.cz with prices, areas, addresses, photos, energy class and seller contacts.", "version": "0.1", "x-build-id": "0zWixI2KRWAc6m5lz" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/alwaysprimedev~sreality-cz-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-alwaysprimedev-sreality-cz-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/alwaysprimedev~sreality-cz-scraper/runs": { "post": { "operationId": "runs-sync-alwaysprimedev-sreality-cz-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/alwaysprimedev~sreality-cz-scraper/run-sync": { "post": { "operationId": "run-sync-alwaysprimedev-sreality-cz-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", "required": [ "searchType" ], "properties": { "searchType": { "title": "Type of deal", "enum": [ "sale", "rent", "auction" ], "type": "string", "description": "Whether to scrape properties for sale (Prodej), for rent (Pronájem), or in auctions (Aukce). Maps to sreality.cz's main category.", "default": "sale" }, "propertyTypes": { "title": "Property types", "uniqueItems": true, "type": "array", "description": "Which property categories to include. You can pick more than one — the actor will iterate them in turn.", "items": { "type": "string", "enum": [ "apartments", "houses", "land", "commercial", "other" ], "enumTitles": [ "Apartments (Byty)", "Houses (Domy)", "Land (Pozemky)", "Commercial", "Other" ] }, "default": [ "apartments" ] }, "regions": { "title": "Czech regions", "uniqueItems": true, "type": "array", "description": "List of Czech administrative regions (kraj) to scrape. Use slug names: praha, stredocesky, jihocesky, plzensky, karlovarsky, ustecky, liberecky, kralovehradecky, pardubicky, vysocina, jihomoravsky, olomoucky, zlinsky, moravskoslezsky.", "items": { "type": "string" }, "default": [ "praha" ] }, "minPrice": { "title": "Minimum price (CZK)", "minimum": 0, "type": "integer", "description": "Lower bound on property price in Czech crowns. Leave empty to disable. For rent listings the bound applies to monthly price." }, "maxPrice": { "title": "Maximum price (CZK)", "minimum": 0, "type": "integer", "description": "Upper bound on property price in Czech crowns. Leave empty to disable." }, "sortBy": { "title": "Sort order", "enum": [ "newest", "price_asc", "price_desc", "area_desc" ], "type": "string", "description": "Order in which the listings are walked. Newest first is best for incremental runs; price ascending is best for bargain hunting.", "default": "newest" }, "maxItems": { "title": "Maximum items", "minimum": 0, "type": "integer", "description": "Maximum number of listings to scrape across the whole run. Set to 0 to disable the limit and scrape every match (use with care on large regions).", "default": 50 }, "scrapeDetails": { "title": "Scrape detail pages", "type": "boolean", "description": "When enabled (default), each listing's detail endpoint is fetched to populate building type, condition, ownership, energy rating, agent contacts and floor. Disable for a cheap index-only mode that uses search-page data only.", "default": true }, "since": { "title": "Only listings modified since", "type": "string", "description": "Optional ISO 8601 timestamp (e.g. 2026-04-01T00:00:00Z). Listings whose last modification date is older are skipped. Requires Scrape detail pages to be enabled — modification date is only available on detail records." }, "concurrency": { "title": "Concurrency", "minimum": 1, "maximum": 25, "type": "integer", "description": "Number of detail requests to run in parallel. Default 5 is polite and reliable; increase for faster runs at the cost of higher chance of rate-limiting (cap 25).", "default": 5 }, "startUrls": { "title": "Start URLs (advanced)", "type": "array", "description": "Advanced override. Provide raw sreality.cz API URLs (https://www.sreality.cz/api/cs/v2/estates?...) instead of using the searchType/propertyTypes/regions filters. Useful when you've crafted a complex query in the website UI and copied the network call.", "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 } } }, "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 } } } } } } } } } } ```