{ "openapi": "3.0.1", "info": { "title": "CZ Zoning Plan Amendment Watcher", "description": "Watches Czech municipal notice boards (úřední desky) for zoning postings: zoning plan amendments, new plans, studies, public consultations and planning decisions. Classifies notices, links cadastral areas and parcels, matches your watchlist. Informational only — not legal advice.", "version": "1.0", "x-build-id": "aXfWJyRFRMW7z81eI" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/atlas-data~cz-zoning-amendment-watcher/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-atlas-data-cz-zoning-amendment-watcher", "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/atlas-data~cz-zoning-amendment-watcher/runs": { "post": { "operationId": "runs-sync-atlas-data-cz-zoning-amendment-watcher", "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/atlas-data~cz-zoning-amendment-watcher/run-sync": { "post": { "operationId": "run-sync-atlas-data-cz-zoning-amendment-watcher", "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": { "mode": { "title": "Run mode", "enum": [ "incremental", "full" ], "type": "string", "description": "incremental: emits zoning-relevant notices that appeared since the previous run (the very first run establishes the baseline and emits the current backlog flagged baselineEstablished=true). full: re-emits every classified notice currently visible on the boards regardless of state.", "default": "incremental" }, "boards": { "title": "Boards to monitor", "maxItems": 25, "type": "array", "description": "Array of built-in board IDs (\"praha\", \"ostrava\", \"liberec\") and/or custom objects {\"name\": \"Municipality\", \"url\": \"https://…official board page…\"} parsed by a conservative generic parser. Maximum 25 boards per run.", "default": [ "praha", "ostrava", "liberec" ] }, "cadastralWatchlist": { "title": "Cadastral area watchlist", "maxItems": 200, "type": "array", "description": "Katastrální území names you care about (e.g. Strašnice, Hrušov). Notices mentioning any watched name are prioritized and tagged with watchlistMatches. Matching folds Czech diacritics and respects word boundaries. Leave empty to simply receive all classified planning notices.", "default": [], "items": { "type": "string" } }, "daysBack": { "title": "Lookback window (days)", "minimum": 1, "maximum": 90, "type": "integer", "description": "Notices whose official posting date is older than this many days are skipped (they are already archived on the board). Notices without an extractable date are always kept. This bounds the first-run backlog.", "default": 14 }, "maxItems": { "title": "Maximum notice records per run", "minimum": 1, "maximum": 10000, "type": "integer", "description": "Hard cap on zoning_notice dataset records per run (run summary and per-board health rows always fit as well). Anything cut by this cap stays pending and is retried on the next run — no silent data loss.", "default": 500 } } }, "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 } } } } } } } } } }