{ "openapi": "3.0.1", "info": { "title": "Telegram Group & Channel Scraper — Messages, Media & Stats", "description": "Scrape public Telegram channels and groups without an API key. Extract messages, views, forwards, media URLs, member counts, and channel metadata. Supports pagination for historical data. Uses multiple fallback strategies (t.me/s/ public preview, web embeds, directory sites) for maximum reliability.", "version": "1.0", "x-build-id": "DVGCodGTesNveWZR9" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/sovereigntaylor~telegram-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-sovereigntaylor-telegram-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/sovereigntaylor~telegram-scraper/runs": { "post": { "operationId": "runs-sync-sovereigntaylor-telegram-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/sovereigntaylor~telegram-scraper/run-sync": { "post": { "operationId": "run-sync-sovereigntaylor-telegram-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": [ "channelUrls" ], "properties": { "channelUrls": { "title": "Channel / Group URLs", "type": "array", "description": "List of public Telegram channel or group URLs to scrape. Accepted formats: 'https://t.me/channelname', 't.me/channelname', or just the channel username like 'channelname'. Each channel will be scraped independently.", "items": { "type": "string" }, "default": [ "https://t.me/duaborern" ] }, "maxMessages": { "title": "Max Messages Per Channel", "minimum": 0, "maximum": 100000, "type": "integer", "description": "Maximum number of messages to scrape from each channel. The scraper retrieves messages starting from the most recent. Set to 0 for unlimited (use with caution — large channels can have millions of messages).", "default": 10 }, "includeMedia": { "title": "Include Media URLs", "type": "boolean", "description": "When enabled, the scraper extracts URLs for photos, videos, documents, and other media attached to messages. Media files are not downloaded — only URLs are captured.", "default": true }, "includeComments": { "title": "Include Comment Counts", "type": "boolean", "description": "When enabled, the scraper attempts to extract reply/comment counts for each message. This may slow down scraping as it requires additional parsing. Only available for channels with discussions enabled.", "default": false }, "includeReactions": { "title": "Include Reactions", "type": "boolean", "description": "When enabled, the scraper extracts emoji reaction counts for each message (e.g., thumbs up: 42, heart: 15). Only available on channels that have reactions enabled.", "default": true }, "dateFrom": { "title": "Date From (YYYY-MM-DD)", "type": "string", "description": "Only scrape messages posted on or after this date. Format: YYYY-MM-DD (e.g., '2025-01-01'). Leave empty to scrape from the most recent messages backwards." }, "dateTo": { "title": "Date To (YYYY-MM-DD)", "type": "string", "description": "Only scrape messages posted on or before this date. Format: YYYY-MM-DD (e.g., '2026-03-01'). Leave empty for no upper date limit." }, "searchQuery": { "title": "Search Query", "type": "string", "description": "Optional text filter — only messages containing this text will be included in the output. Case-insensitive. Leave empty to scrape all messages.", "default": "coffee shop" }, "maxConcurrency": { "title": "Max Concurrency", "minimum": 1, "maximum": 5, "type": "integer", "description": "Maximum number of concurrent page requests. Lower values are safer from rate limiting. Recommended: 2-3 for Telegram.", "default": 2 }, "proxyConfiguration": { "title": "Proxy Configuration", "type": "object", "description": "Apify proxy configuration. Recommended for scraping multiple channels or large message volumes to avoid IP-based rate limiting.", "default": { "useApifyProxy": true } } } }, "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 } } } } } } } } } }