{ "openapi": "3.0.1", "info": { "title": "Sreality.cz Real Estate Scraper", "description": "Scrape apartments, houses, land, commercial property, and projects from Sreality.cz. Search by location or paste a Sreality URL, then optionally add full listing details and agent contact information.", "version": "1.0", "x-build-id": "gCXS1J7pqwKVLJSpk" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/rigelbytes~sreality-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-rigelbytes-sreality-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/rigelbytes~sreality-scraper/runs": { "post": { "operationId": "runs-sync-rigelbytes-sreality-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/rigelbytes~sreality-scraper/run-sync": { "post": { "operationId": "run-sync-rigelbytes-sreality-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": "Sreality URLs", "type": "array", "description": "Search, listing, or agent profile URLs from sreality.cz, for example https://www.sreality.cz/en/search/apartments/praha. A search URL is scraped with the filters already applied on that page. A listing URL saves that one property. An agent profile URL saves that agent's listings.", "items": { "type": "object", "required": [ "url" ], "properties": { "url": { "type": "string", "title": "URL of a web page", "format": "uri" } } } }, "searchQueries": { "title": "Locations", "type": "array", "description": "Towns, districts, streets, or addresses, for example Praha, Brno, or Vinohrady. Each location is resolved and searched separately. Filters below apply to these searches.", "items": { "type": "string" } }, "propertyTypes": { "title": "Property types", "type": "array", "description": "Apartments, houses, land, commercial property, other property, or new-build projects. Leave empty to include every type.", "items": { "type": "string", "enum": [ "apartments", "houses", "land", "commercial", "other", "projects" ], "enumTitles": [ "Apartments", "Houses", "Land", "Commercial", "Other", "Projects" ] } }, "offerTypes": { "title": "Offer type", "type": "array", "description": "Sale, lease, auction, or shares. Leave empty to include every offer type.", "items": { "type": "string", "enum": [ "sale", "lease", "auction", "shares" ], "enumTitles": [ "Sale", "Lease", "Auction", "Shares" ] } }, "regions": { "title": "Regions", "type": "array", "description": "Limit filter-only searches to one or more Czech regions. A location in Locations is more specific and replaces the region filter for that search.", "items": { "type": "string", "enum": [ "prague", "central-bohemia", "south-bohemia", "plzen", "karlovy-vary", "usti", "liberec", "hradec-kralove", "pardubice", "vysocina", "south-moravia", "olomouc", "zlin", "moravian-silesia" ], "enumTitles": [ "Prague", "Central Bohemian", "South Bohemian", "Plzeň", "Karlovy Vary", "Ústí", "Liberec", "Hradec Králové", "Pardubice", "Vysočina", "South Moravian", "Olomouc", "Zlín", "Moravian-Silesian" ] } }, "apartmentLayouts": { "title": "Apartment layout", "type": "array", "description": "Apartment sizes such as 2+kt or 3+1. Applied when Apartments is selected.", "items": { "type": "string", "enum": [ "1+kt", "1+1", "2+kt", "2+1", "3+kt", "3+1", "4+kt", "4+1", "5+kt", "5+1", "6-and-more", "unusual", "room" ], "enumTitles": [ "1+kt", "1+1", "2+kt", "2+1", "3+kt", "3+1", "4+kt", "4+1", "5+kt", "5+1", "6 and more", "Unusual", "Room" ] } }, "surroundings": { "title": "In the estate's surroundings", "type": "array", "description": "Keep listings that have the selected places nearby.", "items": { "type": "string", "enum": [ "bus", "atm", "school", "shop", "subway", "train", "medic", "kindergarten", "restaurant", "post-office", "vet", "supermarket", "playground" ], "enumTitles": [ "Bus", "ATM", "School", "Small shop", "Subway", "Train", "Medic", "Kindergarten", "Restaurant", "Post office", "Vet", "Supermarket", "Playground" ] } }, "surroundingsDistanceKm": { "title": "Surroundings distance (km)", "minimum": 1, "maximum": 10, "type": "integer", "description": "Maximum distance for the surroundings filter.", "default": 2 }, "ownership": { "title": "Ownership", "type": "array", "description": "Personal, cooperative, or state-owned / municipal.", "items": { "type": "string", "enum": [ "personal", "cooperative", "state" ], "enumTitles": [ "Personal", "Cooperative", "State-owned / municipal" ] } }, "condition": { "title": "Condition", "type": "array", "description": "Building condition.", "items": { "type": "string", "enum": [ "very-good", "good", "poor", "under-construction", "new-development", "new-homes", "to-be-demolished", "for-renovation", "renovated", "in-renovation" ], "enumTitles": [ "In very good condition", "In good condition", "In poor condition", "Under construction", "New development projects", "New homes", "To be demolished", "For renovation", "Renovated", "In renovation" ] } }, "accessories": { "title": "Accessories", "type": "array", "description": "Listing must include every selected feature.", "items": { "type": "string", "enum": [ "balcony", "terrace", "parking", "barrier-free", "cellar", "garage", "elevator", "garden", "loggia" ], "enumTitles": [ "Balcony", "Terrace", "Parking", "Barrier-free access", "Cellar", "Garage", "Elevator", "Garden", "Loggia" ] } }, "buildingTypes": { "title": "Construction", "type": "array", "description": "Building construction type. Panel is the concrete panel construction used on Sreality.", "items": { "type": "string", "enum": [ "wooden", "brick", "stone", "prefab", "panel", "framed", "mixed", "modular" ], "enumTitles": [ "Wooden", "Brick", "Stone", "Prefab", "Panel", "Framed structure", "Mixed", "Modular" ] } }, "energyRatings": { "title": "Energy efficiency", "type": "array", "description": "Energy performance certificate rating.", "items": { "type": "string", "enum": [ "A", "B", "C", "D", "E", "F", "G" ], "enumTitles": [ "A", "B", "C", "D", "E", "F", "G" ] } }, "priceFrom": { "title": "Minimum price (CZK)", "minimum": 0, "type": "integer", "description": "Lowest price in Czech crowns." }, "priceTo": { "title": "Maximum price (CZK)", "minimum": 0, "type": "integer", "description": "Highest price in Czech crowns." }, "floorFrom": { "title": "Minimum floor", "minimum": 0, "type": "integer", "description": "Lowest floor number." }, "floorTo": { "title": "Maximum floor", "minimum": 0, "type": "integer", "description": "Highest floor number." }, "usableAreaFrom": { "title": "Minimum usable area (m²)", "minimum": 0, "type": "integer", "description": "Lowest usable area in square meters." }, "usableAreaTo": { "title": "Maximum usable area (m²)", "minimum": 0, "type": "integer", "description": "Highest usable area in square meters." }, "keywords": { "title": "Description keywords", "type": "string", "description": "Text that must appear in the listing description, for example \"balkon\" or \"vinohrady\"." }, "language": { "title": "Language", "enum": [ "en", "cs" ], "type": "string", "description": "Language of listing names, descriptions, and public URLs.", "default": "en" }, "includeListingDetails": { "title": "Include listing details", "type": "boolean", "description": "Open each listing and save the full description, areas, condition, energy rating, and features. This is a separate charge (listing-details) and is off by default.", "default": false }, "includeAgentInformation": { "title": "Include agent information", "type": "boolean", "description": "Save the full agent profile: name, email, phone numbers, description, rating, reviews, certificates, photos, and agency. This is a separate charge (agent-information) and is off by default.", "default": false }, "maxItems": { "title": "Maximum listings", "minimum": 0, "type": "integer", "description": "Hard cap on saved listings. Use 0 for no cap.", "default": 100 }, "detailConcurrency": { "title": "Detail concurrency", "minimum": 1, "maximum": 25, "type": "integer", "description": "How many listing-detail and agent-profile requests to run at the same time.", "default": 10 }, "proxyConfiguration": { "title": "Proxy configuration", "type": "object", "description": "Proxy used for search, listing details, and agent profiles. Residential proxies are recommended.", "default": { "useApifyProxy": true, "apifyProxyGroups": [ "RESIDENTIAL" ] } } } }, "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 } } } } } } } } } }