Telegram Channel Posts Scraper – Comments & Media
Pricing
from $0.23 / 1,000 post extracteds
Export public Telegram channel posts, comment counts and optional public comments with text, authors, dates, media, views, filters, and monitoring fields.
You can access the Telegram Channel Posts Scraper – Comments & Media programmatically from your own applications by using the Apify API. You can also choose the language preference from below. To use the Apify API, you’ll need an Apify account and your API token, found in API & Integrations in Apify Console.
{ "openapi": "3.0.1", "info": { "version": "0.1", "x-build-id": "4Kw8OfVPav1M5GipZ" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/fetch_cat~telegram-channel-posts-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-fetch_cat-telegram-channel-posts-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/fetch_cat~telegram-channel-posts-scraper/runs": { "post": { "operationId": "runs-sync-fetch_cat-telegram-channel-posts-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/fetch_cat~telegram-channel-posts-scraper/run-sync": { "post": { "operationId": "run-sync-fetch_cat-telegram-channel-posts-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": "Channels", "minItems": 1, "type": "array", "description": "Public Telegram channel usernames or URLs. Examples: telegram, @telegram, https://t.me/s/telegram, https://t.me/telegram.", "items": { "type": "string" } }, "maxPosts": { "title": "Maximum posts", "minimum": 1, "maximum": 10000, "type": "integer", "description": "Maximum number of posts to save across all channels.", "default": 20 }, "sinceDate": { "title": "Only posts since date", "type": "string", "description": "Optional ISO date. The actor skips older visible posts when timestamps are available, for example 2026-01-01." }, "untilDate": { "title": "Only posts until date", "type": "string", "description": "Optional ISO date. The actor skips newer visible posts when timestamps are available, for example 2026-06-01." }, "includeMedia": { "title": "Include media URLs", "type": "boolean", "description": "Extract public image/video preview URLs when Telegram exposes them in the public preview HTML.", "default": true }, "includeComments": { "title": "Include public comments", "type": "boolean", "description": "Fetch public comments for posts whose linked discussion is publicly available. Private, deleted, login-gated, or disabled discussions are not accessed.", "default": false }, "maxPostsPerChannel": { "title": "Maximum posts per channel", "minimum": 1, "maximum": 10000, "type": "integer", "description": "Optional per-channel cap for balanced multi-channel runs. The overall maxPosts limit still applies." }, "maxPagesPerChannel": { "title": "Maximum history pages per channel", "minimum": 1, "maximum": 500, "type": "integer", "description": "Safety cap for Telegram history pagination. Increase it for older date windows while keeping the run-time limit in mind.", "default": 100 }, "afterPostId": { "title": "Only posts after ID", "minimum": 0, "type": "integer", "description": "Optional exclusive message-ID lower bound for incremental monitoring. Use afterPostIds when channels need different checkpoints." }, "afterPostIds": { "title": "Per-channel post ID checkpoints", "type": "object", "description": "Optional object mapping channel usernames to exclusive last-seen post IDs, for example {\"telegram\": 430, \"durov\": 350}.", "additionalProperties": true }, "includeRawHtmlSnippet": { "title": "Include raw HTML snippet", "type": "boolean", "description": "Advanced debugging option. Adds a short raw HTML snippet for each post.", "default": false }, "includeCommentCount": { "title": "Include comment count", "type": "boolean", "description": "Fetch the accurate public discussion count for each post. Enabled by default; disable it to reduce requests when replyCount is not needed.", "default": true }, "maxCommentsPerPost": { "title": "Maximum comments per post", "minimum": 1, "maximum": 500, "type": "integer", "description": "Maximum number of the most recent public comments to include in each post row when Include public comments is enabled.", "default": 20 }, "minComments": { "title": "Minimum comments", "minimum": 0, "maximum": 1000000, "type": "integer", "description": "Keep only posts with at least this many public comments. A value above 0 checks Telegram's public discussion count for each candidate post.", "default": 0 }, "proxyConfiguration": { "title": "Proxy configuration", "type": "object", "description": "Optional Apify Proxy settings.", "default": { "useApifyProxy": false } }, "runTimeSecs": { "title": "Safe run-time limit", "minimum": 30, "maximum": 285, "type": "integer", "description": "Stop before the platform timeout, preserve saved posts, and write RUN_SUMMARY diagnostics.", "default": 270 } } }, "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 } } } } } } } } }}OpenAPI is a standard for designing and describing RESTful APIs, allowing developers to define API structure, endpoints, and data formats in a machine-readable way. It simplifies API development, integration, and documentation.
OpenAPI is effective when used with AI agents and GPTs by standardizing how these systems interact with various APIs, for reliable integrations and efficient communication.
By defining machine-readable API specifications, OpenAPI allows AI models like GPTs to understand and use varied data sources, improving accuracy. This accelerates development, reduces errors, and provides context-aware responses, making OpenAPI a core component for AI applications.
You can download the OpenAPI definitions for Telegram Channel Posts Scraper – Comments & Media from the options below:
If you’d like to learn more about how OpenAPI powers GPTs, read our blog post.
You can also check out our other API clients: