{ "openapi": "3.0.1", "info": { "title": "SaaS Changelog & Status Page Watcher", "description": "Watch vendor changelog and status pages and get structured diffs when new releases, incidents or maintenance windows appear. Keeps state between runs and can POST to Slack, Discord, Zapier, Make or n8n.", "version": "0.1", "x-build-id": "kqQhYgQykJEee2hRB" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/aibuildersuse~saas-changelog-status-watcher/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-aibuildersuse-saas-changelog-status-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/aibuildersuse~saas-changelog-status-watcher/runs": { "post": { "operationId": "runs-sync-aibuildersuse-saas-changelog-status-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/aibuildersuse~saas-changelog-status-watcher/run-sync": { "post": { "operationId": "run-sync-aibuildersuse-saas-changelog-status-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", "required": [ "urls" ], "properties": { "urls": { "title": "Changelog / status page URLs", "type": "array", "description": "Vendor changelog or status pages to watch. Optional per-URL fields: selector, label, pageKind (changelog|status|auto).", "items": { "type": "object", "required": [ "url" ], "properties": { "url": { "type": "string", "title": "URL of a web page", "format": "uri" } } } }, "cssSelector": { "title": "CSS selector (optional)", "type": "string", "description": "Limit extraction to this CSS selector (e.g. main, #changelog). Per-URL selector overrides this." }, "pageKind": { "title": "Page kind", "enum": [ "auto", "changelog", "status" ], "type": "string", "description": "Hint for labeling extracted events. auto detects from page text.", "default": "auto" }, "renderMode": { "title": "Page rendering", "enum": [ "auto", "http", "browser" ], "type": "string", "description": "auto uses HTTP first and falls back to a headless browser when the page looks empty or blocked. http never uses a browser. browser always renders with Chromium.", "default": "auto" }, "includeUnchanged": { "title": "Output a row for unchanged pages", "type": "boolean", "description": "When on, unchanged pages get one no_change row so every run shows what was checked.", "default": true }, "ignoreTextPatterns": { "title": "Ignore text matching (regex)", "type": "array", "description": "Lines matching these regexes are ignored in text diffs (e.g. rotating dates, visitor counters).", "default": [], "items": { "type": "string" } }, "webhookUrl": { "title": "Webhook URL (optional)", "type": "string", "description": "POST one JSON payload with all detected changes. Works with Slack and Discord incoming webhooks; also includes a full changes array for Zapier/Make/n8n." }, "webhookHeaders": { "title": "Webhook headers (optional)", "type": "object", "description": "Extra HTTP headers to send with the webhook, for example an Authorization header.", "default": {} }, "webhookOnBaseline": { "title": "Send webhook for first-run baselines", "type": "boolean", "description": "By default the first run of a URL only saves a baseline and does not notify. Turn on to also send baseline rows to the webhook.", "default": false }, "stateStoreName": { "title": "State store name", "type": "string", "description": "Named key-value store that keeps snapshots between runs. Letters, digits and hyphens only.", "default": "saas-changelog-status-state" }, "maxConcurrency": { "title": "Max parallel pages", "minimum": 1, "maximum": 10, "type": "integer", "description": "How many pages to check at the same time. Keep it low (1-3) on small memory.", "default": 3 }, "proxyConfiguration": { "title": "Proxy configuration", "type": "object", "description": "Optional. Most changelog/status pages load without a proxy.", "default": { "useApifyProxy": 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 } } } } } } } } } }