{ "openapi": "3.0.1", "info": { "title": "Sreality.cz Real Estate Scraper", "description": "[💰 $3.8 / 1K] Extract real estate listings from Sreality.cz, the largest Czech property portal. Search apartments, houses, land, and commercial properties for sale, rent, or auction by city or region. Get prices, GPS coordinates, room layouts, area, photos, agency contacts, and full descriptions.", "version": "1.0", "x-build-id": "xDnoXCZpzenxbXkDR" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/solidcode~sreality-cz-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-solidcode-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/solidcode~sreality-cz-scraper/runs": { "post": { "operationId": "runs-sync-solidcode-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/solidcode~sreality-cz-scraper/run-sync": { "post": { "operationId": "run-sync-solidcode-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", "properties": { "startUrls": { "title": "Start URLs", "type": "array", "description": "Paste Sreality.cz URLs directly — either a search-results page (with your filters already applied in the browser) or a single property page. Any filters in the URL are kept automatically. The Deal Type, Property Type, and price/area settings below do NOT apply to URLs — those come from the URL itself.", "items": { "type": "string" } }, "searchLocations": { "title": "Search Locations", "type": "array", "description": "Type Czech city or region names to search, e.g. 'Praha', 'Brno', 'Ostrava', or a whole region like 'Jihomoravský kraj'. Diacritics are optional ('Plzen' also works). Add several to scrape multiple places in one run. Leave empty if you are using URLs above.", "items": { "type": "string" } }, "dealType": { "title": "Deal Type", "enum": [ "sale", "rent", "auction" ], "type": "string", "description": "Whether to find properties for sale, for rent, or in auction. Only applies to Search Locations — ignored when using URLs (the URL sets its own deal type).", "default": "sale" }, "propertyType": { "title": "Property Type", "enum": [ "apartments", "houses", "land", "commercial", "other" ], "type": "string", "description": "The kind of property to find. Only applies to Search Locations — ignored when using URLs.", "default": "apartments" }, "minPrice": { "title": "Minimum Price (CZK)", "minimum": 0, "type": "integer", "description": "Only include properties priced at or above this amount, in Czech koruna (CZK). Leave empty for no lower limit." }, "maxPrice": { "title": "Maximum Price (CZK)", "minimum": 0, "type": "integer", "description": "Only include properties priced at or below this amount, in Czech koruna (CZK). Leave empty for no upper limit." }, "minArea": { "title": "Minimum Area (m²)", "minimum": 0, "type": "integer", "description": "Only include properties with at least this usable area, in square metres. Leave empty for no lower limit." }, "maxArea": { "title": "Maximum Area (m²)", "minimum": 0, "type": "integer", "description": "Only include properties with at most this usable area, in square metres. Leave empty for no upper limit." }, "maxResults": { "title": "Max Results", "minimum": 0, "type": "integer", "description": "Maximum number of listings to return across all URLs and searches. Set to 0 for unlimited. A 50,000 safety ceiling always applies — higher values are capped to 50,000. Tip: start with 10-50 to test, then increase.", "default": 100 }, "includeDetails": { "title": "Include Full Property Details", "type": "boolean", "description": "Open each listing to collect richer data: full description, building material, condition, ownership type, floor, energy rating, and the complete photo set. Slower but much more detailed. When off, only the data shown in search results is returned.", "default": true } } }, "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 } } } } } } } } } }