{ "openapi": "3.0.1", "info": { "title": "Sreality.cz Listings Scraper", "description": "Scrape Sreality.cz property listings (sale, rent, auction; apartments, houses, land, commercial) by locality name or search URL: price, m², layout, GPS, photos, description, seller contact.", "version": "0.0", "x-build-id": "8ikZXdem7HoMBlmvE" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/nice_dev~sreality-listings-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-nice_dev-sreality-listings-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/nice_dev~sreality-listings-scraper/runs": { "post": { "operationId": "runs-sync-nice_dev-sreality-listings-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/nice_dev~sreality-listings-scraper/run-sync": { "post": { "operationId": "run-sync-nice_dev-sreality-listings-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": { "startUrls": { "title": "Start URLs", "maxItems": 1000, "type": "array", "description": "Sreality.cz search-result URLs (`https://www.sreality.cz/hledani/...` or `/en/search/...`, every filter set on the site is kept, pagination is automatic), single listing URLs (`https://www.sreality.cz/detail/.../`) or raw API search URLs (`https://www.sreality.cz/api/v1/estates/search?...`). Max 1 000 URLs. When this list is not empty, the search fields (locations, transaction, property type, site filters, sort) are ignored; the dates, the Actor's filters, **Max listings per search** and **Only new listings** still apply.", "items": { "type": "object", "required": [ "url" ], "properties": { "url": { "type": "string", "title": "URL of a web page", "format": "uri" } } } }, "location": { "title": "Location", "maxLength": 200, "type": "string", "description": "Region, district, city, city part or street name, e.g. `Praha`, `Brno`, `Karlín`, `Jihomoravský kraj`, `Praha 5`, `Plzeň-město`. Empty = whole Czech Republic. Resolved through Sreality's own location search: the exact name typed wins even when Sreality ranks a longer, similarly-spelled place first; a name shared by several places (there are several `Kamenice`) is told apart by adding a nearby town or region (`Kamenice, Benešov`). Combine with 'Radius (km)' for a circle around a city, city part or street." }, "locations": { "title": "More locations", "maxItems": 100, "uniqueItems": true, "type": "array", "description": "Several locations in one run: one search per location (times each transaction, property type and keyword; max 500 searches). Added to **Location**. A listing found by several searches is saved once; an unknown location stops the run before anything is charged.", "default": [], "items": { "type": "string" } }, "transactions": { "title": "Transaction", "uniqueItems": true, "type": "array", "description": "Sale (`prodej`), rent (`pronajem`), auction (`drazby`) or ownership share (`podily`). Several allowed: one search each. Empty = sale.", "items": { "type": "string", "enum": [ "prodej", "pronajem", "drazby", "podily" ], "enumTitles": [ "For sale (prodej)", "For rent (pronájem)", "Auction (dražby)", "Ownership share (podíly)" ] }, "default": [ "prodej" ] }, "propertyTypes": { "title": "Property type", "uniqueItems": true, "type": "array", "description": "Sreality main category. Several allowed: one search each. Empty = apartments.", "items": { "type": "string", "enum": [ "byty", "domy", "pozemky", "komercni", "ostatni" ], "enumTitles": [ "Apartments (byty)", "Houses (domy)", "Land (pozemky)", "Commercial (komerční nemovitosti)", "Other: garages, parking, cellars… (ostatní reality)" ] }, "default": [ "byty" ] }, "subtypes": { "title": "Layout / sub-type", "uniqueItems": true, "type": "array", "description": "Optional sub-types (several allowed, OR); each property type keeps its own. Apartments: layout `1+kk`…`6-a-vice`, `atypicky`, `pokoj` (room share). Houses: `rodinny`, `vila`, `chalupa`, `chata`… Land: `bydleni` (building plot), `komercni`, `pole`, `les`… Commercial: `kancelare`, `sklad`, `obchodni-prostor`… Other: `garaz`, `garazove-stani`… A sub-type of no chosen property type is ignored with a warning.", "items": { "type": "string", "enum": [ "1+kk", "1+1", "2+kk", "2+1", "3+kk", "3+1", "4+kk", "4+1", "5+kk", "5+1", "6-a-vice", "atypicky", "pokoj", "rodinny", "vila", "chalupa", "chata", "pamatka", "na-klic", "zemedelska-usedlost", "vicegeneracni-dum", "bydleni", "komercni", "pole", "louka", "les", "rybnik", "sady-vinice", "zahrada", "ostatni-pozemky", "kancelare", "sklad", "vyrobni-prostor", "obchodni-prostor", "ubytovani", "restaurace", "zemedelsky", "cinzovni-dum", "virtualni-kancelar", "ostatni-komercni-prostory", "ordinace", "apartman", "garaz", "garazove-stani", "vinny-sklep", "pudni-prostor", "mobilni-domek", "jine-nemovitosti" ], "enumTitles": [ "Apartment 1+kk", "Apartment 1+1", "Apartment 2+kk", "Apartment 2+1", "Apartment 3+kk", "Apartment 3+1", "Apartment 4+kk", "Apartment 4+1", "Apartment 5+kk", "Apartment 5+1", "Apartment 6 rooms and more", "Apartment atypical", "Room (flatshare)", "House: family house", "House: villa", "House: cottage (chalupa)", "House: hut / cabin (chata)", "House: historical property", "House: turnkey project", "House: farmstead", "House: multi-family house", "Land: building plot", "Land: commercial plot", "Land: field", "Land: meadow", "Land: forest", "Land: pond", "Land: orchard / vineyard", "Land: garden", "Land: other", "Commercial: offices", "Commercial: warehouse", "Commercial: production hall", "Commercial: retail premises", "Commercial: accommodation / hotel", "Commercial: restaurant", "Commercial: agricultural", "Commercial: apartment building", "Commercial: virtual office", "Commercial: other", "Commercial: medical surgery", "Commercial: apartments (serviced)", "Other: garage", "Other: parking place", "Other: wine cellar", "Other: attic / loft space", "Other: mobile home", "Other: other property" ] } }, "maxItems": { "title": "Max listings", "minimum": 0, "maximum": 100000, "type": "integer", "description": "Maximum number of listings to save (after deduplication). 0 = no limit. For reference: apartments for sale in Prague ≈ 5 500 listings, whole Czech Republic ≈ 22 000. Searches above 10 000 results are split automatically (by region, then by country for the properties Sreality lists outside the Czech Republic) so the whole search is still reached; the rare case a split cannot cover is reported instead of dropped silently.", "default": 100 }, "maxItemsPerQuery": { "title": "Max listings per search", "minimum": 0, "maximum": 100000, "type": "integer", "description": "Cap for EACH search (one location × transaction × property type × keyword, or one search URL), so that the first search cannot use up the whole **Max listings** budget. 0 = no per-search cap.", "default": 0 }, "priceMin": { "title": "Min price (CZK)", "minimum": 0, "maximum": 1000000000000, "type": "integer", "description": "Minimum total price (sale) or monthly rent (rent), in CZK." }, "priceMax": { "title": "Max price (CZK)", "minimum": 0, "maximum": 1000000000000, "type": "integer", "description": "Maximum total price (sale) or monthly rent (rent), in CZK." }, "areaMin": { "title": "Min area (m²)", "minimum": 0, "maximum": 100000000, "type": "integer", "description": "Minimum usable area in m² (plot area for `pozemky`)." }, "areaMax": { "title": "Max area (m²)", "minimum": 0, "maximum": 100000000, "type": "integer", "description": "Maximum usable area in m² (plot area for `pozemky`)." }, "plotAreaMin": { "title": "Min plot area (m²)", "minimum": 0, "maximum": 100000000, "type": "integer", "description": "Minimum plot (land) area in m², for houses, land, commercial and other properties. Ignored for apartments." }, "plotAreaMax": { "title": "Max plot area (m²)", "minimum": 0, "maximum": 100000000, "type": "integer", "description": "Maximum plot (land) area in m², for houses, land, commercial and other properties. Ignored for apartments." }, "houseRooms": { "title": "Rooms (houses)", "uniqueItems": true, "type": "array", "description": "Houses only: number of rooms (several allowed, OR). Apartments use **Layout / sub-type** instead.", "items": { "type": "string", "enum": [ "1", "2", "3", "4", "5", "atypical" ], "enumTitles": [ "1 room", "2 rooms", "3 rooms", "4 rooms", "5 rooms and more", "Atypical" ] } }, "radiusKm": { "title": "Radius (km)", "minimum": 0, "maximum": 50, "type": "integer", "description": "Search radius around each location, in km (0 = exact administrative area). Only applies to a city, city part or street, not to a region or district.", "default": 0 }, "ownership": { "title": "Ownership", "enum": [ "ALL", "osobni", "druzstevni", "statni-obecni" ], "type": "string", "description": "Apartments and houses: personal (`osobni`), cooperative (`druzstevni`) or state/municipal (`statni-obecni`) ownership.", "default": "ALL" }, "condition": { "title": "Building condition", "uniqueItems": true, "type": "array", "description": "Condition of the property (several allowed, OR).", "items": { "type": "string", "enum": [ "velmi-dobry", "dobry", "spatny", "ve-vystavbe", "projekt", "novostavba", "k-demolici", "pred-rekonstrukci", "po-rekonstrukci", "v-rekonstrukci" ], "enumTitles": [ "Very good", "Good", "Poor", "Under construction", "Project", "New building", "For demolition", "Before renovation", "After renovation", "Under renovation" ] } }, "buildingType": { "title": "Building type", "uniqueItems": true, "type": "array", "description": "Construction material / type (several allowed, OR).", "items": { "type": "string", "enum": [ "drevostavba", "cihlova", "kamenna", "montovana", "panelova", "skeletova", "smisena", "modulova" ], "enumTitles": [ "Wooden", "Brick", "Stone", "Prefabricated", "Panel (concrete)", "Framed", "Mixed", "Modular" ] } }, "furnished": { "title": "Furnished", "enum": [ "ALL", "vybaveny", "nevybaveny", "castecne" ], "type": "string", "description": "Rentals: furnished, unfurnished or partly furnished.", "default": "ALL" }, "features": { "title": "Must have", "uniqueItems": true, "type": "array", "description": "Required features (several allowed, AND).", "items": { "type": "string", "enum": [ "balkon", "terasa", "lodzie", "vytah", "garaz", "parkovani", "sklep", "zahrada", "bazen", "bezbarierovy", "nizkoenergeticky" ], "enumTitles": [ "Balcony", "Terrace", "Loggia", "Elevator", "Garage", "Parking", "Cellar", "Garden", "Pool", "Wheelchair accessible", "Low-energy" ] } }, "keyword": { "title": "Keyword in description", "maxLength": 100, "type": "string", "description": "Full-text word searched in listing descriptions (Sreality's own filter), e.g. `balkon`, `garáž`, `metro`." }, "searchQueries": { "title": "More keywords", "maxItems": 100, "uniqueItems": true, "type": "array", "description": "Several keywords in one run: one search per keyword (times each location, transaction and property type). Added to **Keyword in description**.", "default": [], "items": { "type": "string" } }, "sortBy": { "title": "Sort by", "enum": [ "NEWEST", "PRICE_ASC", "PRICE_DESC", "PRICE_M2_ASC", "PRICE_M2_DESC" ], "type": "string", "description": "Order of the results (matters when maxItems is lower than the number of matching listings). The site's default puts the listings published or updated last first; keep it for **Only new listings**.", "default": "NEWEST" }, "postedAfter": { "title": "Posted after", "type": "string", "description": "Only listings first published on or after this day: `2026-09-01`, or a period before now such as `7 days`, `2 weeks`, `1 month` (API: `24 hours` and full ISO date-times work too). Sreality gives the day of publication, not the hour: the whole day of the bound is included. Read from the listing's `publishedAt`." }, "postedBefore": { "title": "Posted before", "type": "string", "description": "Only listings first published on or before this day (the whole day is included), or older than a period such as `30 days`: finds the listings that have been on the market for a long time." }, "privateSellersOnly": { "title": "Private sellers only (no agencies)", "type": "boolean", "description": "Keep only the listings posted by private persons, about 7 % of the site. Agency listings are skipped from the search results, before their page is opened: not saved. Each agency listing dropped is charged a filter fee, lower than a listing; a listing you keep costs its normal price (see Pricing).", "default": false }, "excludeKeywords": { "title": "Exclude keywords", "maxItems": 50, "uniqueItems": true, "type": "array", "description": "Drop the listings whose title contains one of these words (case and accents ignored), e.g. `dražba`, `podíl`, `rezervace`.", "default": [], "items": { "type": "string" } }, "onlyNew": { "title": "Only new listings", "type": "boolean", "description": "Skip the listings that a previous run (same **Memory key**) already delivered: they are not saved and not charged, and their page is not even opened. First run = everything is new.", "default": false }, "stateKey": { "title": "Memory key", "pattern": "^[a-zA-Z0-9_-]{1,64}$", "maxLength": 64, "type": "string", "description": "Name of the memory used by **Only new listings**. Give each schedule / task its own key (e.g. `praha-rentals`) so that they do not share their memory. Letters, digits, `-` and `_`.", "default": "default" }, "resetState": { "title": "Reset the memory", "type": "boolean", "description": "Forget everything remembered under this **Memory key** before the run: this run returns (and charges) every listing again. Untick it afterwards.", "default": false }, "language": { "title": "Language of labels", "enum": [ "cs", "en" ], "type": "string", "description": "Language of the site's own texts in the output: title, layout / sub-type / condition names (`cs` = Czech, `en` = English). Descriptions are written by the sellers and stay as published.", "default": "cs" }, "extractDetails": { "title": "Extract details", "type": "boolean", "description": "Open each listing (1 extra request per listing) for the description, exact usable / plot area, floor, building type and condition, ownership, energy rating, equipment (heating, water…), publication and update dates, view count, seller name / phone / e-mail, agency rating, photo captions, video, 3D tour, nearby public transport and named places. Off = search-card fields only (price, layout, GPS, address, all photos with their room type, POI distances, agency and broker ids): 1 request per 200 listings, same price.", "default": true }, "enrichEmails": { "title": "Find e-mails on agency websites", "type": "boolean", "description": "Visits the website of each listing's agency (home page + contact / legal pages, 3 pages max, once per agency and per run) and adds the e-mail addresses published there to `websiteEmails` — the agency's general address, other brokers (the broker's own e-mail is already in `contactEmail`). Needs **Extract details** (the agency website is only on the listing page); private sellers have no website. Slower. Included in the listing price: no extra charge.", "default": false }, "privateSellerContacts": { "title": "Include private sellers' name, phone and e-mail", "type": "boolean", "description": "About 7 % of listings are posted by private persons: their name, phone and e-mail are personal data under GDPR. Agencies and their brokers are always included. Turn off to output `contactName` / `contactEmail` / `phones` as null for private sellers.", "default": true }, "proxyConfiguration": { "title": "Proxy configuration", "type": "object", "description": "Apify Proxy or your own proxies. Keep the default: it is included in the price. The residential Apify proxy is not available in this Actor.", "default": { "useApifyProxy": true } }, "maxConcurrency": { "title": "Max concurrency", "minimum": 1, "maximum": 50, "type": "integer", "description": "Maximum number of requests processed in parallel.", "default": 10 }, "maxRequestsPerMinute": { "title": "Max requests per minute", "minimum": 10, "maximum": 2000, "type": "integer", "description": "Global request rate. Lower it if the site answers HTTP 429 / 403 in the log.", "default": 300 }, "maxRequestRetries": { "title": "Max request retries", "minimum": 0, "maximum": 20, "type": "integer", "description": "Retries per request before it is marked as failed.", "default": 5 }, "pageSize": { "title": "Listings per search request", "minimum": 20, "maximum": 1000, "type": "integer", "description": "How many listings one search request brings back (1-1000). Leave the default unless a run needs to be gentler.", "default": 200 }, "debugLog": { "title": "Debug log", "type": "boolean", "description": "Include debug messages in the run log.", "default": false } } }, "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 }, "PROXY_UNBLOCKER_UNITS": { "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 }, "PROXY_UNBLOCKER_UNITS": { "type": "integer", "example": 0 } } } } } } } } } }