# Sreality Property Search Scraper (`stealth_mode/sreality-property-search-scraper`) Actor Scrape property listings from Sreality.cz — the Czech Republic's leading real estate portal. Collect names, prices, localities, images, and 19+ fields per listing. Perfect for analysts, investors, and proptech developers needing structured housing market data. - **URL**: https://apify.com/stealth\_mode/sreality-property-search-scraper.md - **Developed by:** [Stealth mode](https://apify.com/stealth_mode) (community) - **Categories:** Automation, Developer tools, Real estate - **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, NaN bookmarks - **User rating**: No ratings yet ## Pricing from $3.00 / 1,000 results 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/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 Property Search Scraper: Extract Czech Real Estate Listings at Scale --- ### What Is Sreality.cz? Sreality.cz is the largest real estate portal in the Czech Republic, aggregating thousands of property listings including apartments, houses, and commercial spaces. It serves buyers, renters, and investors looking for properties across the country. Manually collecting listing data from search results is tedious and error-prone — the **Sreality.cz Property Search Scraper** automates this entirely, turning paginated search results into clean, structured records. --- ### Overview The **Sreality Property Scraper** crawls Sreality.cz search result pages and extracts detailed listing metadata for each property found. It is built for: - **Real estate analysts** tracking price trends by locality or property type - **Proptech developers** feeding listing data into custom platforms or dashboards - **Investors** monitoring market availability and price-per-sqm benchmarks - **Researchers** studying Czech housing market dynamics Key features include configurable item limits, graceful URL failure handling, and support for any Sreality search URL — filtered by category, location, or price range. --- ### Input Format The scraper accepts a simple JSON configuration: ```json { "urls": ["https://www.sreality.cz/hledani/byty?strana=3"], "ignore_url_failures": true, "max_items_per_url": 50 } ```` | Field | Type | Default | Description | |---|---|---|---| | `urls` | `array` | — | One or more Sreality search result page URLs to scrape. Supports any search filter combination (property type, region, price, etc.). Add URLs one by one or via bulk edit. | | `ignore_url_failures` | `boolean` | `true` | If `true`, the scraper continues running when a URL fails instead of stopping the entire run. Recommended for bulk jobs. | | `max_items_per_url` | `integer` | `20` | Maximum number of listings to extract per URL. Increase for deeper pagination coverage. | > **Tip:** You can scrape multiple search pages by adding paginated URLs to the `urls` array (e.g., `?strana=1`, `?strana=2`, etc.), or apply Sreality's built-in filters for city, district, price range, or property size before copying the URL. *** ### Output Format #### Sample Output Record ```json { "category_main_cb": { "name": "Byty", "value": 1 }, "category_sub_cb": { "name": "3+1", "value": 7 }, "category_type_cb": { "name": "Pronájem", "value": 2 }, "discount_show": false, "id": 2685837388, "has_matterport": false, "has_video": false, "images": [ { "url": "//d18-a.sdn.cz/d_18/c_img_qB_A/nCTUX1iX5BWZuTBM4yGiQRGT/1333.jpeg", "restb_type": 2, "order": null }, { "url": "//d18-a.sdn.cz/d_18/c_img_qB_A/nCTUX1iX5CFdAHBOC3GiQRGx/c19d.jpeg", "restb_type": 3, "order": null }, { "url": "//d18-a.sdn.cz/d_18/c_img_qB_A/nCTUX1iX5CNPfpBllsGiQRHm/1c58.jpeg", "restb_type": 0, "order": null }, { "url": "//d18-a.sdn.cz/d_18/c_img_qB_A/kcHp2YdDtBM3KVBCHDGiQRIE/7751.jpeg", "restb_type": 10, "order": null }, { "url": "//d18-a.sdn.cz/d_18/c_img_qB_A/kcHp2YdDtDrxR2BDE0GiQRIv/b023.jpeg", "restb_type": 4, "order": null }, { "url": "//d18-a.sdn.cz/d_18/c_img_qB_A/nCTUX1iX5CNPfpBlfGGiQRJM/7c8e.jpeg", "restb_type": 0, "order": null }, { "url": "//d18-a.sdn.cz/d_18/c_img_qB_A/nCTUX1iX5CoHumBNfHGiQRJg/7e00.jpeg", "restb_type": 6, "order": null }, { "url": "//d18-a.sdn.cz/d_18/c_img_qB_A/nCTUX1iX5CDciVBke2GiQRJ2/06c3.jpeg", "restb_type": 6, "order": null }, { "url": "//d18-a.sdn.cz/d_18/c_img_qB_A/kcHp2YdDtEDuRmHFMGiQRKR/7781.jpeg", "restb_type": 22, "order": null }, { "url": "//d18-a.sdn.cz/d_18/c_img_qB_A/nCTUX1iX5BWZuTBMzXGiQRKn/4063.jpeg", "restb_type": 30, "order": null }, { "url": "//d18-a.sdn.cz/d_18/c_img_qB_A/nCTUX1iX5CFdAHBOC3GiQRK5/415d.jpeg", "restb_type": 0, "order": null }, { "url": "//d18-a.sdn.cz/d_18/c_img_qB_A/nCTUX1iX5CoHumBNfIGiQRLU/5d7a.jpeg", "restb_type": 9, "order": null }, { "url": "//d18-a.sdn.cz/d_18/c_img_qB_A/kcHp2YdDtEDuRmHFNGiQRLr/36f7.jpeg", "restb_type": 0, "order": null }, { "url": "//d18-a.sdn.cz/d_18/c_img_qB_A/kcHp2YdDtEBMvIBA40GiQRMC/9ac5.jpeg", "restb_type": 0, "order": null }, { "url": "//d18-a.sdn.cz/d_18/c_img_qB_A/kcHp2YdDtDgLT0BDCMGiQRMb/9bcb.jpeg", "restb_type": 28, "order": null }, { "url": "//d18-a.sdn.cz/d_18/c_img_qB_A/nCTUX1iX5CFdAHBOCWGiQRM4/0693.jpeg", "restb_type": 28, "order": null }, { "url": "//d18-a.sdn.cz/d_18/c_img_qB_A/kcHp2YdDtBM3KVBCHDGiQRNP/8303.jpeg", "restb_type": 28, "order": null }, { "url": "//d18-a.sdn.cz/d_18/c_img_qB_A/nCTUX1iX5Do9kXBM7eGiQRNp/e25a.jpeg", "restb_type": 28, "order": null }, { "url": "//d18-a.sdn.cz/d_18/c_img_qB_A/kcHp2YdDtBRc2UEjCGiQROB/0fba.jpeg", "restb_type": 28, "order": null }, { "url": "//d18-a.sdn.cz/d_18/c_img_qB_A/nCTUX1iX5DwDWzBlC0GiQROX/93fc.jpeg", "restb_type": 28, "order": null }, { "url": "//d18-a.sdn.cz/d_18/c_img_qB_A/nCTUX1iX5CFdAHBODiGiQROu/a502.jpeg", "restb_type": 28, "order": null }, { "url": "//d18-a.sdn.cz/d_18/c_img_qB_A/nCTUX1iX5CFdAHBODiGiQRPE/7c23.jpeg", "restb_type": 28, "order": null }, { "url": "//d18-a.sdn.cz/d_18/c_img_qB_A/kcHp2YdDtBM3KVBCG4GiQRPc/7165.jpeg", "restb_type": 28, "order": null }, { "url": "//d18-a.sdn.cz/d_18/c_img_qB_A/kcHp2YdDtzYqGBDt8GiQRP1/f3ba.jpeg", "restb_type": 28, "order": null }, { "url": "//d18-a.sdn.cz/d_18/c_img_qB_A/nCTUX1iX5CoHumBNa2GiQRQN/1b89.jpeg", "restb_type": 0, "order": null }, { "url": "//d18-a.sdn.cz/d_18/c_img_qB_A/nCTUX1iX5BWZuTBM4yGiQRQy/7a65.jpeg", "restb_type": 28, "order": null }, { "url": "//d18-a.sdn.cz/d_18/c_img_qB_A/kcHp2YdDtBRc2UEi2GiQRRP/92ba.jpeg", "restb_type": 28, "order": null }, { "url": "//d18-a.sdn.cz/d_18/c_img_qB_A/nCTUX1iX5CoHumBNfHGiQRRk/7231.jpeg", "restb_type": 19, "order": null } ], "locality": { "city": "Praha", "city_seo_name": "praha", "city_part": "Nové Město", "city_part_seo_name": "nove-mesto", "country": "Česká republika", "country_id": 112, "district": "Praha 2", "district_id": 5002, "district_seo_name": "praha-2", "entity_type": "address", "geo_hash": "u2fkbh76dw", "house_number": "289", "inaccuracy_type": "gps", "latitude": 50.077522, "longitude": 14.418634, "municipality": null, "municipality_id": 3468, "municipality_seo_name": null, "quarter": "Praha 2", "quarter_id": 88, "region": "Hlavní město Praha", "region_id": 10, "region_seo_name": "hlavni-mesto-praha", "street": "Odborů", "street_id": 121209, "street_number": "10", "street_seo_name": "odboru", "ward": null, "ward_id": 14959, "ward_seo_name": null, "zip": null }, "name": "Pronájem bytu 3+1 81 m²", "premise_logo": "", "premise_id": 20262, "premise": { "seo_name": "prime-property", "ward_seo_name": "vinohrady", "quarter_seo_name": "praha-2", "city_seo_name": "praha" }, "price_czk": 41000, "price_czk_per_sq_m": 506, "price_summary_czk": 41000, "price_summary_unit_cb": { "name": "za měsíc", "value": 2 }, "price_unit_cb": { "name": "za měsíc", "value": 2 }, "watchdog_badge": "none", "from_url": "https://www.sreality.cz/hledani/byty?strana=3" } ``` Each scraped listing returns a record with up to 19 fields: #### Identification & Classification | Field | Meaning | |---|---| | `ID` | Unique Sreality internal identifier for the listing | | `Name` | Full listing title as shown in search results (e.g., *"Prodej bytu 2+kk, 52 m², Praha 3"*) | | `Category Main CB` | Top-level property category code (e.g., residential, commercial) | | `Category Sub CB` | Sub-category code (e.g., apartment, house, land) | | `Category Type CB` | Transaction type code (e.g., sale, rent) | #### Location | Field | Meaning | |---|---| | `Locality` | Property location string — typically city, district, or street | #### Pricing | Field | Meaning | |---|---| | `Price CZK` | Listed price in Czech Koruna (CZK) | | `Price CZK Per Sq M` | Price per square metre in CZK — useful for cross-listing comparisons | | `Price Summary CZK` | Full price summary value (may include fees or total cost) | | `Price Summary Unit CB` | Unit code for the price summary (e.g., total, monthly) | | `Price Unit CB` | Unit code for the base price (e.g., per month, per property) | #### Media | Field | Meaning | |---|---| | `Images` | Array of image URLs for the listing's photo gallery | | `Has Video` | Boolean — whether the listing includes a video tour | | `Has Matterport` | Boolean — whether a Matterport 3D virtual tour is available | #### Agency / Developer | Field | Meaning | |---|---| | `Premise ID` | Internal ID of the real estate agency or developer | | `Premise` | Name of the agency or developer managing the listing | | `Premise Logo` | Logo image URL of the agency/developer | #### Listing Flags | Field | Meaning | |---|---| | `Discount Show` | Whether the listing displays a discounted/reduced price badge | | `Watchdog Badge` | Whether a price-drop watchdog alert is active on this listing | *** ### How to Use 1. **Build your search URL** — Go to Sreality.cz, apply your filters (type, location, price, size), and copy the resulting URL. 2. **Paste into `urls`** — Add one or more search page URLs to the input array. 3. **Set item limit** — Adjust `max_items_per_url` based on how many listings you need (Sreality typically shows 20–60 per page). 4. **Run the scraper** — Start the actor and monitor progress in the run log. 5. **Export** — Download results as JSON, CSV, or Excel for further analysis. **Best practices:** - For multi-page scraping, add consecutive paginated URLs (`?strana=1` through `?strana=N`). - Set `ignore_url_failures: true` for uninterrupted bulk runs. - If a URL returns no results, verify it resolves correctly in your browser and that filters haven't excluded all listings. *** ### Use Cases & Business Value - **Market analysis:** Track average price-per-sqm trends by district or property type over time - **Investment screening:** Filter and monitor listings matching specific price and location criteria - **Proptech pipelines:** Populate internal databases or listing aggregators with fresh Sreality data - **Academic research:** Study supply and demand patterns in the Czech residential market The scraper eliminates repetitive manual data collection, delivering consistent, machine-readable records that plug directly into spreadsheets, BI tools, or custom applications. *** ### Conclusion The **Sreality.cz Property Search Scraper** is a practical tool for anyone needing structured Czech real estate data at scale. With 19 output fields covering pricing, location, media, and agency metadata, it provides the foundation for meaningful market intelligence. Start with any Sreality search URL and turn listings into actionable data within minutes. # Actor input Schema ## `urls` (type: `array`): Add the URLs of the tour list urls you want to scrape. You can paste URLs one by one, or use the Bulk edit section to add a prepared list. ## `ignore_url_failures` (type: `boolean`): If true, the scraper will continue running even if some URLs fail to be scraped. ## `max_items_per_url` (type: `integer`): The maximum number of items to scrape per URL. ## Actor input object example ```json { "urls": [ "https://www.sreality.cz/hledani/byty?strana=3" ], "ignore_url_failures": true, "max_items_per_url": 20 } ``` # 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 = { "urls": [ "https://www.sreality.cz/hledani/byty?strana=3" ], "ignore_url_failures": true, "max_items_per_url": 20 }; // Run the Actor and wait for it to finish const run = await client.actor("stealth_mode/sreality-property-search-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 = { "urls": ["https://www.sreality.cz/hledani/byty?strana=3"], "ignore_url_failures": True, "max_items_per_url": 20, } # Run the Actor and wait for it to finish run = client.actor("stealth_mode/sreality-property-search-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 '{ "urls": [ "https://www.sreality.cz/hledani/byty?strana=3" ], "ignore_url_failures": true, "max_items_per_url": 20 }' | apify call stealth_mode/sreality-property-search-scraper --silent --output-dataset ``` ## MCP server setup ```json { "mcpServers": { "apify": { "command": "npx", "args": [ "mcp-remote", "https://mcp.apify.com/?tools=stealth_mode/sreality-property-search-scraper", "--header", "Authorization: Bearer " ] } } } ``` ## OpenAPI specification ```json { "openapi": "3.0.1", "info": { "title": "Sreality Property Search Scraper", "description": "Scrape property listings from Sreality.cz — the Czech Republic's leading real estate portal. Collect names, prices, localities, images, and 19+ fields per listing. Perfect for analysts, investors, and proptech developers needing structured housing market data.", "version": "0.0", "x-build-id": "DQpPElkI1cmjIbsia" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/stealth_mode~sreality-property-search-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-stealth_mode-sreality-property-search-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/stealth_mode~sreality-property-search-scraper/runs": { "post": { "operationId": "runs-sync-stealth_mode-sreality-property-search-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/stealth_mode~sreality-property-search-scraper/run-sync": { "post": { "operationId": "run-sync-stealth_mode-sreality-property-search-scraper", "x-openai-isConsequential": false, "summary": "Executes an Actor, waits for completion, and returns the OUTPUT from Key-value store in response.", "tags": [ "Run Actor" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/inputSchema" } } } }, "parameters": [ { "name": "token", "in": "query", "required": true, "schema": { "type": "string" }, "description": "Enter your Apify token here" } ], "responses": { "200": { "description": "OK" } } } } }, "components": { "schemas": { "inputSchema": { "type": "object", "properties": { "urls": { "title": "URLs of the tour list urls to scrape", "type": "array", "description": "Add the URLs of the tour list urls you want to scrape. You can paste URLs one by one, or use the Bulk edit section to add a prepared list.", "items": { "type": "string" } }, "ignore_url_failures": { "title": "Continue running even if some URLs fail to be scraped", "type": "boolean", "description": "If true, the scraper will continue running even if some URLs fail to be scraped." }, "max_items_per_url": { "title": "Max items per URL", "type": "integer", "description": "The maximum number of items to scrape per URL." } } }, "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 } } } } } } } } } } ```