{ "openapi": "3.0.1", "info": { "title": "Telegram Channel Scraper: Messages, Views, Media, No Login", "description": "Scrape messages from public Telegram channels with no login, phone number or API key. Export posts with text, date, views, reactions, media links, polls, replies and forward sources, plus subscriber counts. Keyword and date filters for OSINT, news and crypto monitoring.", "version": "0.1", "x-build-id": "tS9N1pcCmo4xjsCbf" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/thatmike1~telegram-channel-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-thatmike1-telegram-channel-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/thatmike1~telegram-channel-scraper/runs": { "post": { "operationId": "runs-sync-thatmike1-telegram-channel-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/thatmike1~telegram-channel-scraper/run-sync": { "post": { "operationId": "run-sync-thatmike1-telegram-channel-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": { "channels": { "title": "Channels", "type": "array", "description": "Public Telegram channels to scrape, one per line. A username (durov), an @handle (@durov) or a link (https://t.me/durov or https://t.me/s/durov) all work. Only channels with a public web preview at t.me/s/ can be read; private channels, groups, bots and user accounts are skipped with a warning in the log and the run's status message.", "default": [ "telegram", "durov" ], "items": { "type": "string" } }, "maxItems": { "title": "Maximum messages per channel", "minimum": 0, "type": "integer", "description": "How many messages to return for each channel, newest first. This limit is per channel, not per run: 10 channels at 50 is up to 500 messages. The channel record is not counted. Without a keyword filter this is the only size limit, so 1000 returns 1000 messages if the channel has them. Set to 0 for no limit, which with no keyword filter and no date reads the channel's whole history.", "default": 40 }, "keywords": { "title": "Keyword filter", "type": "array", "description": "Only return messages whose text contains at least one of these words or phrases, matched case-insensitively as substrings. Messages that do not match are skipped and not charged. Leave empty to return every message.", "default": [], "items": { "type": "string" } }, "since": { "title": "Only messages posted since", "type": "string", "description": "Skip messages older than this date and stop paging back once the Actor reaches it. Use YYYY-MM-DD (for example 2026-09-01) or a full ISO 8601 timestamp such as 2026-09-01T12:00:00Z. Leave empty for no date limit.", "default": "" }, "onlyNewPosts": { "title": "Only new posts since the last run", "type": "boolean", "description": "For scheduled monitoring. Each channel's newest post id is remembered after a run, in a key-value store named telegram-channel-scraper-last-seen in your account, and later runs stop paging at that post, so only posts published since are saved and charged. Each keyword filter is remembered separately, so changing the keywords starts fresh. The first run behaves like a normal run, limited by Maximum messages per channel and the date. Maximum messages per channel still caps every run: if a channel published more new posts than that since the last run, the newest are saved and the rest are skipped for good, so set it above what a channel posts between two runs. The channel record is only saved when the channel has at least one new post.", "default": false }, "maxScannedMessages": { "title": "Maximum messages scanned per channel", "minimum": 0, "type": "integer", "description": "Only used with a keyword filter: how many messages to read per channel, matching or not, before giving up on finding more matches. It keeps a keyword that rarely matches from walking a channel's whole history. A run without keywords ignores it and is limited by Maximum messages per channel alone. Set to 0 to keep reading until Maximum messages per channel matches are found or the channel ends.", "default": 500 }, "proxyConfiguration": { "title": "Proxy configuration", "type": "object", "description": "The Telegram web preview serves these pages without an anti-bot challenge, so a proxy is optional. Datacenter proxies are enough if you want one.", "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 } } } } } } } } } }