{ "openapi": "3.0.1", "info": { "title": "Telegram Channel Scraper: Posts, Views, Reactions & Media", "description": "Scrape any public Telegram channel without an account, phone number or API keys. Get posts with full text, views, reactions, media URLs, links, hashtags, forwards and channel stats (subscribers, verified). Date range, keyword search, new-posts-only monitoring. Fast and cheap: $1 per 1,000 posts.", "version": "1.0", "x-build-id": "w99zJyCYBmzwcOsU2" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/classier_wholemeal~telegram-channel-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-classier_wholemeal-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/classier_wholemeal~telegram-channel-scraper/runs": { "post": { "operationId": "runs-sync-classier_wholemeal-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/classier_wholemeal~telegram-channel-scraper/run-sync": { "post": { "operationId": "run-sync-classier_wholemeal-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", "required": [ "channels" ], "properties": { "channels": { "title": "Telegram channels", "type": "array", "description": "Public channel usernames or links, one per line: durov, @telegram, https://t.me/durov or https://t.me/s/durov. Private groups and invite links (t.me/+...) are not supported.", "items": { "type": "string" } }, "maxPostsPerChannel": { "title": "Max posts per channel", "minimum": 1, "maximum": 100000, "type": "integer", "description": "Newest posts first. The scraper pages back through the channel history until this limit or the date limit is reached.", "default": 100 }, "postedWithinDays": { "title": "Only posts from the last N days", "minimum": 1, "type": "integer", "description": "Stop when posts get older than this. Leave empty for no limit." }, "dateFrom": { "title": "Only posts after date", "type": "string", "description": "Stop at posts older than this date (YYYY-MM-DD). Optional." }, "searchQuery": { "title": "Search inside channels", "type": "string", "description": "Use Telegram's own in-channel search (e.g. a ticker, brand or keyword). Leave empty to get all posts." }, "keywords": { "title": "Keep only posts containing", "type": "array", "description": "Case-insensitive. A post is kept if it contains any of these words. Filtered-out posts are not charged.", "items": { "type": "string" } }, "minViews": { "title": "Minimum views", "minimum": 0, "type": "integer", "description": "Skip posts with fewer views (not charged)." }, "excludeForwarded": { "title": "Exclude forwarded posts", "type": "boolean", "description": "Skip posts forwarded from other channels (not charged).", "default": false }, "onlyNewPosts": { "title": "Only new posts since last run (monitoring)", "type": "boolean", "description": "Remembers the newest post per channel in the key-value store. Schedule the Actor and you only get (and pay for) new posts. State is kept in a named key-value store (see below).", "default": false }, "stateStoreName": { "title": "Monitoring state store name", "type": "string", "description": "Named key-value store that remembers the last post seen per channel. Use a different name per monitoring task. Default: telegram-channel-scraper-state." }, "includeChannelInfo": { "title": "Include channel info row", "type": "boolean", "description": "One extra row per channel: title, description, subscribers, photo/video/link counts, verified badge.", "default": true }, "proxyConfiguration": { "title": "Proxy (optional)", "type": "object", "description": "Not needed for normal use. Enable Apify Proxy for very large jobs." } } }, "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 } } } } } } } } } }