{ "openapi": "3.0.1", "info": { "title": "Telegram Channel Monitor: New Messages, Keywords, Webhooks", "description": "Scrape and monitor public Telegram channels without any API key, bot token or phone number. Monitor mode returns only messages that are new since the previous run, with keyword and regex filters and webhook alerts.", "version": "0.1", "x-build-id": "xpL7zBJsgfNFeIINO" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/antndev~telegram-channel-monitor/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-antndev-telegram-channel-monitor", "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/antndev~telegram-channel-monitor/runs": { "post": { "operationId": "runs-sync-antndev-telegram-channel-monitor", "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/antndev~telegram-channel-monitor/run-sync": { "post": { "operationId": "run-sync-antndev-telegram-channel-monitor", "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": [ "channels" ], "properties": { "channels": { "title": "Channels", "type": "array", "description": "Public Telegram channels to read. Accepts a username, @username or a full t.me link, for example durov, @durov or https://t.me/durov.", "default": [ "durov" ], "items": { "type": "string" } }, "maxMessagesPerChannel": { "title": "Max messages per channel", "minimum": 1, "maximum": 3000, "type": "integer", "description": "How far back to read per channel. The actor pages backwards through the channel history until this limit, the date limit or the last-seen message is reached.", "default": 50 }, "monitorMode": { "title": "Monitor mode (only new messages)", "type": "boolean", "description": "For scheduled runs: remembers the last message ID per channel and returns only messages posted since the previous run. This is the cheapest way to run it on a schedule.", "default": false }, "keywords": { "title": "Keywords (optional)", "type": "array", "description": "Only return messages containing these terms. Matched case-insensitively against the message text, link preview title and description, and any links.", "items": { "type": "string" } }, "requireAllKeywords": { "title": "Require all keywords", "type": "boolean", "description": "On: a message must contain every keyword. Off: any keyword is enough.", "default": false }, "regex": { "title": "Regex filter (optional)", "type": "string", "description": "Advanced filter, for example (buy|sell)\\s+signal or \\$[A-Z]{2,6}. Applied case-insensitively in addition to the keywords." }, "minDate": { "title": "Only messages after (YYYY-MM-DD)", "type": "string", "description": "Stop paging backwards once messages are older than this date." }, "includeHtml": { "title": "Include message HTML", "type": "boolean", "description": "Also return the original message HTML, which preserves bold, links and mention markup.", "default": false }, "webhookUrl": { "title": "Webhook URL (optional)", "type": "string", "description": "POSTs the matched messages as JSON to this URL, so you can alert into your own system, bot or dashboard." }, "concurrency": { "title": "Channels in parallel", "minimum": 1, "maximum": 6, "type": "integer", "description": "How many channels to read at the same time. Keep it low to stay polite to Telegram.", "default": 3 } } }, "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 } } } } } } } } } }