{ "openapi": "3.0.1", "info": { "title": "CZ Reality Properties and Details Scraper", "description": "Permission-gated Czech property listing Actor for Sreality and Bezrealitky. Current written authorization is required for automated retrieval and reuse; the default run makes zero source requests.", "version": "1.1", "x-build-id": "3LqIg0oJZYzVidhmk" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/realestateapi~cz-reality-properties-and-details-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-realestateapi-cz-reality-properties-and-details-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/realestateapi~cz-reality-properties-and-details-scraper/runs": { "post": { "operationId": "runs-sync-realestateapi-cz-reality-properties-and-details-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/realestateapi~cz-reality-properties-and-details-scraper/run-sync": { "post": { "operationId": "run-sync-realestateapi-cz-reality-properties-and-details-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": { "authorizationConfirmed": { "title": "Current written authorization confirmed", "type": "boolean", "description": "Set true only if current written authorization covers automated retrieval and reuse for each selected portal. This attestation does not grant permission. Defaults to false, which makes zero source requests.", "default": false }, "portals": { "title": "Portals", "type": "array", "description": "Property portals to query.", "items": { "type": "string", "enum": [ "sreality", "bezrealitky" ] }, "default": [ "sreality" ] }, "categories": { "title": "Categories", "type": "array", "description": "Property categories to include.", "items": { "type": "string", "enum": [ "domy", "byty", "pozemky", "komercni", "ostatni" ] }, "default": [ "domy" ] }, "offerType": { "title": "Offer type", "type": "array", "description": "Transaction types to include.", "items": { "type": "string", "enum": [ "prodej", "pronajem" ] }, "default": [ "prodej" ] }, "regions": { "title": "Regions", "type": "array", "description": "Optional locality or region text filters.", "items": { "type": "string", "minLength": 1 }, "default": [] }, "maxPrice": { "title": "Maximum price (CZK)", "minimum": 1, "type": "number", "description": "Exclude listings above this price." }, "minArea": { "title": "Minimum area (m²)", "minimum": 1, "type": "number", "description": "Exclude listings below this area in square metres." }, "maxListings": { "title": "Maximum listings per portal", "minimum": 1, "maximum": 200, "type": "integer", "description": "Maximum number of listings emitted per portal.", "default": 20 }, "maxDetails": { "title": "Maximum detail pages per portal", "minimum": 0, "maximum": 50, "type": "integer", "description": "Fetch public property detail pages to add property characteristics, costs, energy, photos, and other details. Set to 0 to use search-page fields only.", "default": 20 }, "enableHistory": { "title": "Track price history", "type": "boolean", "description": "Compare listings with records stored from earlier runs.", "default": false }, "historyStoreId": { "title": "History store ID", "type": "string", "description": "Named key-value store used for optional history tracking.", "default": "cz-reality-history" }, "timeoutMs": { "title": "Request timeout (ms)", "minimum": 5000, "maximum": 120000, "type": "integer", "description": "Maximum time allowed for each public request.", "default": 30000 }, "userAgent": { "title": "User agent", "maxLength": 300, "type": "string", "description": "Optional transparent HTTP user-agent string." }, "proxyConfiguration": { "title": "Proxy configuration", "type": "object", "description": "Accepted for compatibility; public requests remain transparent." } } }, "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 } } } } } } } } } }