# Telegram Channel Message (`truefetch/telegram-channel-message`) Actor Archive public Telegram channel messages โ€” full text, media URLs, reaction counts, forwarded-from, reply threads, and 23 fields. Filter by date. No account. $0.38 per 1,000. - **URL**: https://apify.com/truefetch/telegram-channel-message.md - **Developed by:** [TrueFetch](https://apify.com/truefetch) (community) - **Categories:** Social media, News, Videos - **Stats:** 348 total users, 65 monthly users, 100.0% runs succeeded, 15 bookmarks - **User rating**: 4.47 out of 5 stars ## Pricing from $0.30 / 1,000 messages This Actor is paid per event. You are not charged for the Apify platform usage, but only a fixed price for specific events. Since this Actor supports Apify Store discounts, the price gets lower the higher subscription plan you have. Learn more: https://docs.apify.com/platform/actors/running/actors-in-store#pay-per-event ## What's an Apify Actor? Actors are a software tools running on the Apify platform, for all kinds of web data extraction and automation use cases. In Batch mode, an Actor accepts a well-defined JSON input, performs an action which can take anything from a few seconds to a few hours, and optionally produces a well-defined JSON output, datasets with results, or files in key-value store. In Standby mode, an Actor provides a web server which can be used as a website, API, or an MCP server. Actors are written with capital "A". ## How to integrate an Actor? If asked about integration, you help developers integrate Actors into their projects. You adapt to their stack and deliver integrations that are safe, well-documented, and production-ready. The best way to integrate Actors is as follows. In JavaScript/TypeScript projects, use official [JavaScript/TypeScript client](https://docs.apify.com/api/client/js.md): ```bash npm install apify-client ``` In Python projects, use official [Python client library](https://docs.apify.com/api/client/python.md): ```bash pip install apify-client ``` In shell scripts, use [Apify CLI](https://docs.apify.com/cli/docs.md): ````bash # MacOS / Linux curl -fsSL https://apify.com/install-cli.sh | bash # Windows irm https://apify.com/install-cli.ps1 | iex ```bash In AI frameworks, you might use the [Apify MCP server](https://docs.apify.com/platform/integrations/mcp.md). If your project is in a different language, use the [REST API](https://docs.apify.com/api/v2.md). For usage examples, see the [API](#api) section below. For more details, see Apify documentation as [Markdown index](https://docs.apify.com/llms.txt) and [Markdown full-text](https://docs.apify.com/llms-full.txt). # README > **Affiliate disclosure:** Apify links on this page may include referral parameters. If you sign up through one of these links, TrueFetch may earn a commission from Apify at no extra cost to you. Pricing, features, and Actor access are unaffected. [![Telegram Channel Message](https://img.shields.io/badge/Telegram%20Channel%20Message-26A5E4?style=for-the-badge&logo=telegram&logoColor=white)](https://apify.com/TrueFetch/telegram-channel-message?fpr=aiagentapi) [![Telegram Message Scraper](https://img.shields.io/badge/Telegram%20Message%20Scraper-1F8A70?style=for-the-badge)](https://apify.com/TrueFetch/telegram-channel-message?fpr=aiagentapi) [![$0.00038 per Message](https://img.shields.io/badge/$0.00038%20per%20Message-2E8B57?style=for-the-badge)](https://apify.com/TrueFetch/telegram-channel-message?fpr=aiagentapi) [![Text, Reactions & Media](https://img.shields.io/badge/Text%20%7C%20Reactions%20%7C%20Media-555555?style=for-the-badge)](https://apify.com/TrueFetch/telegram-channel-message?fpr=aiagentapi) [![Telegram Support](https://img.shields.io/badge/Telegram-Support-26A5E4?style=for-the-badge&logo=telegram&logoColor=white)](https://t.me/AiAgentApi) [![Telegram Group](https://img.shields.io/badge/Telegram-Group-26A5E4?style=for-the-badge&logo=telegram&logoColor=white)](https://t.me/Apify_Actor) ## Telegram Channel Message โ€” Telegram Message Scraper: Text, Reactions & Media **Provide a Telegram channel URL and extract messages with full metadata including text, sender, views, reactions, hashtags, URLs, and optional media downloads in clean JSON / CSV / Excel.** > **TL;DR (40-word answer):** Telegram Channel Message is a credentials-based Apify Actor that returns structured Telegram channel messages at **$0.00038 per message** ($0.00077 per media file), covering text, sender, view count, reactions, and hashtags for content analysis and monitoring. Last verified 2026-05-02. > **What it is NOT:** Telegram Channel Message is _not_ a real-time notification system, _not_ a bot platform, and _not_ a private message extractor โ€” it scrapes publicly accessible Telegram channel message history via the Telegram API. > **Telegram Channel Message is an Apify Actor that extracts structured message history from Telegram channels, including text, reactions, media URLs, and engagement metrics.** Maintained by TrueFetch on the Apify Store. --- ### ๐Ÿท๏ธ Why choose Telegram Channel Message **Telegram Channel Message is best for** analysts, researchers, and data teams who need structured Telegram channel message data for content monitoring, sentiment analysis, or competitive intelligence. - **๐Ÿ“Š 23 fields per message** โ€” text, sender, views, reply count, forward count, reactions, hashtags, URLs, media URL, topic name, and more. - **๐Ÿ“ธ Optional media download** โ€” download photos, videos, or all media attached to messages. - **โšก Pay-per-result pricing** โ€” **$0.00038 per message** ($0.00077 per media). Free Apify plan includes $5 monthly credits โ‰ˆ 13,000 free messages. --- ### ๐Ÿš€ Quick Start โ€” run in 3 steps #### Run in Apify Console 1. **Open the Actor** โ€” go to [Telegram Channel Message on Apify](https://apify.com/TrueFetch/telegram-channel-message?fpr=aiagentapi) and click **Try for free**. 2. **Configure inputs** โ€” enter a Telegram channel URL, set `download_medias` to `text`, `image`, or `all`, and set a result limit. 3. **Click Start** โ€” the Actor returns structured messages in the default dataset; download as JSON, CSV, or Excel. #### Run via Apify API ```bash curl -X POST "https://api.apify.com/v2/acts/TrueFetch~telegram-channel-message/run-sync-get-dataset-items?token=YOUR_APIFY_TOKEN" \ -H "Content-Type: application/json" \ -d '{ "telegram_url": "https://t.me/example_channel", "download_medias": "text", "max_results": 100 }' ```` #### Run via MCP (for AI agents) Telegram Channel Message is callable from Claude, ChatGPT, Cursor, and any MCP-compatible client through the [Apify MCP Server](https://docs.apify.com/platform/integrations/mcp?fpr=aiagentapi). Reference the Actor as `TrueFetch/telegram-channel-message` and pass the same JSON input as above. *** ### โš™๏ธ Input parameters | Parameter | Type | Required | Default | Description | Example | | ----------------- | ------- | :------: | ------- | ----------------------------------------------------------------------------------- | ------------------------------ | | `telegram_url` | string | โœ… | โ€” | Telegram channel URL (e.g. `https://t.me/channel_name` or `@channel_name`). | `https://t.me/example_channel` | | `download_medias` | string | โœ… | โ€” | Media download mode. One of: `text` (no media), `image` (images only), `all` (all). | `text` | | `max_results` | integer | โœ… | โ€” | Maximum number of messages to return. Minimum 10. | `100` | | `start_date` | string | โŒ | `null` | Optional start date (ISO 8601) to filter messages from. | `2026-01-01` | ```json { "telegram_url": "https://t.me/example_channel", "download_medias": "text", "max_results": 100 } ``` *** ### ๐Ÿ“ฆ Output dataset Each run writes structured message records to the **default Apify dataset**, exportable as JSON, JSONL, CSV, Excel, XML, RSS, or via the dataset API. | Field | Type | Always present? | Description | Example | | --------------- | ------- | :-------------: | ------------------------------------------------------- | ------------------------------------------------------ | | `processor` | string | โœ… | Apify Actor URL that produced this record. | `https://apify.com/TrueFetch/telegram-channel-message` | | `processed_at` | string | โœ… | ISO 8601 UTC timestamp. | `2026-04-24T09:30:00+00:00` | | `id` | integer | optional | Telegram message ID. | `12345` | | `type` | string | optional | Message type (text, photo, video, etc.). | `text` | | `date` | string | optional | Message publication timestamp. | `2026-04-20T12:00:00+00:00` | | `text` | string | optional | Message text content. | `Hello world!` | | `sender` | string | optional | Sender username or channel name. | `@example_channel` | | `silent` | boolean | optional | Whether the message was sent silently. | `false` | | `pinned` | boolean | optional | Whether the message is pinned. | `false` | | `view_count` | integer | optional | Number of views. | `50000` | | `reply_count` | integer | optional | Number of replies. | `42` | | `forward_count` | integer | optional | Number of forwards. | `128` | | `reply_to` | integer | optional | Message ID this message replies to. | `12300` | | `album_id` | integer | optional | Album group ID for media albums. | `987654321` | | `topic_name` | string | optional | Forum topic name (if applicable). | `Announcements` | | `edit_date` | string | optional | Last edited timestamp. | `2026-04-21T08:00:00+00:00` | | `urls` | array | optional | URLs extracted from message text. | `["https://example.com"]` | | `hashtags` | array | optional | Hashtags found in message. | `["#news", "#tech"]` | | `service_type` | string | optional | Type of service message (if applicable). | `null` | | `service_info` | object | optional | Service message metadata. | `null` | | `forward_info` | object | optional | Forward origin metadata. | `{"from": "original_channel"}` | | `reactions` | object | optional | Reaction counts per emoji. | `{"๐Ÿ‘": 120, "โค๏ธ": 45}` | | `media_url` | string | optional | Uploaded media file URL (when download\_medias enabled). | `https://api.apify.com/v2/key-value-stores/...` | #### Sample output ```json { "processor": "https://apify.com/TrueFetch/telegram-channel-message", "processed_at": "2026-04-24T09:30:00+00:00", "text": "Breaking news from Example Channel...", "view_count": 50000, "reactions": { "๐Ÿ‘": 120 } } ``` *** ### ๐Ÿ’ก Use cases #### For analysts monitoring Telegram channels for news and announcements - **Problem:** a research team needs to track messages from 10 Telegram news channels daily. - **How Telegram Channel Message solves it:** schedule runs per channel to collect message history and store structured data in the dataset. - **Outcome:** daily Telegram channel monitoring at **$0.00038 per message** โ€” 1,000 messages/day โ‰ˆ $0.38. #### For NLP teams building Telegram content datasets - **Problem:** a data science team needs a corpus of Telegram channel messages with full metadata for sentiment analysis. - **How Telegram Channel Message solves it:** extract text, sender, reactions, and hashtags for thousands of messages from targeted channels. - **Outcome:** structured Telegram dataset with 23 fields per message for NLP pipelines. #### For AI agents monitoring Telegram for trending topics - **Problem:** LLM agents need to answer "what are people saying on Telegram about X today?" with current data. - **How Telegram Channel Message solves it:** call the Actor over the [Apify MCP Server](https://docs.apify.com/platform/integrations/mcp?fpr=aiagentapi) to retrieve live channel messages on demand. - **Outcome:** grounded Telegram channel data in production AI assistants. *** ### ๐Ÿ’ฐ Pricing, limits, and performance | Fact | Value | | --------------------------- | ---------------------------------------------------------------- | | Pricing model | Pay-per-result (events: `message`, `media`) | | Per-message price | **$0.00038 per message = $0.38 per 1,000** | | Per-media-file price | **$0.00077 per media file = $0.77 per 1,000** | | Free-tier monthly allowance | $5 Apify credits โ‰ˆ **~13,157 free messages** (text only) / month | | Min results per run | 10 | | Output fields per message | **23** | | Login / cookies required | **Telegram API credentials required** (provided by TrueFetch) | | Export formats | JSON, JSONL, CSV, Excel, XML, RSS, dataset API | *** ### โš–๏ธ Compared with alternatives | Capability | **Telegram Channel Message** | Telegram Bot API | Custom Telethon script | | -------------------------------------------- | :--------------------------: | :--------------: | :--------------------: | | Structured messages with reactions and media | โœ… | limited | you build & maintain | | Pay-per-result pricing | **$0.00038 / message** | N/A | infra + dev cost | | Export to CSV / JSON | โœ… | โŒ | you implement | | Setup time to first result | **< 60 seconds** | hoursโ€“days | daysโ€“weeks | **Verdict.** Telegram Channel Message is ideal for analysts and researchers who need structured Telegram channel data without setting up Telethon infrastructure or managing API credentials. *** ### โš ๏ธ Common mistakes to avoid 1. **Missing `telegram_url`.** This field is required. Use a public channel URL like `https://t.me/channel_name` or `@channel_name`. 2. **Invalid `download_medias` value.** Use exactly `text`, `image`, or `all`. 3. **Setting `max_results` below 10.** Minimum value is 10. 4. **Targeting private channels.** The Actor only works with publicly accessible Telegram channels. *** ### ๐Ÿ› ๏ธ Troubleshooting | Problem | Likely cause | Fix | | ---------------------------------------- | ---------------------------------------- | ---------------------------------------------------------------- | | `Missing 'telegram_url' field` | `telegram_url` not provided in input. | Add `"telegram_url": "https://t.me/channel"` to your input JSON. | | `Invalid 'telegram_url' format` | URL does not match Telegram URL pattern. | Use a valid public channel URL or `@username` format. | | `'download_medias' must be one of` | Invalid media mode value. | Use `text`, `image`, or `all`. | | `'max_results' must be an integer >= 10` | `max_results` is below minimum. | Set `max_results` to at least 10. | | `Charge limit reached` | Account-level monthly spend limit hit. | Raise the run / monthly limit in your Apify plan settings. | *** ### โ“ FAQ #### What data does Telegram Channel Message return? Telegram Channel Message returns 23 structured fields including message text, sender, view count, reply count, forward count, reactions, hashtags, extracted URLs, and optional media file URL. #### How much does Telegram Channel Message cost? The Actor charges **$0.00038 per message** and **$0.00077 per media file**. The Apify Free plan includes $5 of monthly platform credits โ€” enough for ~13,000 text messages. #### Does Telegram Channel Message require a Telegram account? The Actor uses Telegram API credentials managed by TrueFetch. You do not need to provide your own Telegram account. #### Can Telegram Channel Message access private channels? No. The Actor only accesses publicly accessible Telegram channels. *** ### ๐Ÿ”Œ Integrations Telegram Channel Message plugs straight into the Apify ecosystem: - **Schedules** โ€” monitor channels on a recurring schedule ([docs](https://docs.apify.com/platform/schedules?fpr=aiagentapi)). - **Webhooks** โ€” POST results to your endpoint on `ACTOR.RUN.SUCCEEDED` ([docs](https://docs.apify.com/platform/integrations/webhooks?fpr=aiagentapi)). - **Apify API** โ€” `run-sync-get-dataset-items` for blocking calls, `runs` for async ([docs](https://docs.apify.com/api/v2?fpr=aiagentapi)). - **MCP Server** โ€” call the Actor from Claude, ChatGPT, or Cursor agents ([docs](https://docs.apify.com/platform/integrations/mcp?fpr=aiagentapi)). - **No-code** โ€” Make, Zapier, n8n, Pipedream, Google Sheets, Airtable. *** ### ๐Ÿงฑ Sister Actors from TrueFetch #### Jobs - [Best Job Search](https://apify.com/TrueFetch/best-job-search?fpr=aiagentapi) - [Glassdoor Job Search](https://apify.com/TrueFetch/glassdoor-job-search?fpr=aiagentapi) - [Glints Company Finder](https://apify.com/TrueFetch/glints-company-finder?fpr=aiagentapi) - [Glints Job Finder](https://apify.com/TrueFetch/glints-job-finder?fpr=aiagentapi) - [Indeed Job Search](https://apify.com/TrueFetch/indeed-job-search?fpr=aiagentapi) - [JobStreet Company Finder](https://apify.com/TrueFetch/jobstreet-company-finder?fpr=aiagentapi) - [JobStreet Job Finder](https://apify.com/TrueFetch/jobstreet-job-finder?fpr=aiagentapi) - [LinkedIn Job Search](https://apify.com/TrueFetch/linkedin-job-search?fpr=aiagentapi) - [StepStone Company Finder](https://apify.com/TrueFetch/stepstone-company-finder?fpr=aiagentapi) - [StepStone Job Finder](https://apify.com/TrueFetch/stepstone-job-finder?fpr=aiagentapi) #### Shopping & Deals - [Amazon Deals Scraper](https://apify.com/TrueFetch/amazon-deals-scraper?fpr=aiagentapi) - [Amazon Store Finder](https://apify.com/TrueFetch/amazon-store-finder?fpr=aiagentapi) - [Argos Deals Scraper](https://apify.com/TrueFetch/argos-deals-scraper?fpr=aiagentapi) - [ASOS Fashion Scraper](https://apify.com/TrueFetch/asos-fashion-scraper?fpr=aiagentapi) - [eBay Deals Scraper](https://apify.com/TrueFetch/ebay-deals-scraper?fpr=aiagentapi) - [eBay Seller Finder](https://apify.com/TrueFetch/ebay-seller-finder?fpr=aiagentapi) - [Flipkart Deals Scraper](https://apify.com/TrueFetch/flipkart-deals-scraper?fpr=aiagentapi) - [John Lewis Deals Scraper](https://apify.com/TrueFetch/john-lewis-deals-scraper?fpr=aiagentapi) - [Lidl Deals Scraper](https://apify.com/TrueFetch/lidl-deals-scraper?fpr=aiagentapi) - [Magalu Deals Scraper](https://apify.com/TrueFetch/magalu-deals-scraper?fpr=aiagentapi) - [MediaMarkt Deals Scraper](https://apify.com/TrueFetch/mediamarkt-deals-scraper?fpr=aiagentapi) - [Mercado Livre Deals Scraper](https://apify.com/TrueFetch/mercado-livre-deals-scraper?fpr=aiagentapi) - [Nykaa Beauty Scraper](https://apify.com/TrueFetch/nykaa-beauty-scraper?fpr=aiagentapi) - [OTTO Deals Scraper](https://apify.com/TrueFetch/otto-deals-scraper?fpr=aiagentapi) - [Target Deals Scraper](https://apify.com/TrueFetch/target-deals-scraper?fpr=aiagentapi) - [TradeIndia Product Finder](https://apify.com/TrueFetch/tradeindia-product-finder?fpr=aiagentapi) - [TradeIndia Supplier Finder](https://apify.com/TrueFetch/tradeindia-supplier-finder?fpr=aiagentapi) - [Walmart Deals Scraper](https://apify.com/TrueFetch/walmart-deals-scraper?fpr=aiagentapi) #### Vehicles - [AutoTrader Car Finder](https://apify.com/TrueFetch/autotrader-car-finder?fpr=aiagentapi) - [AutoTrader Dealer Finder](https://apify.com/TrueFetch/autotrader-dealer-finder?fpr=aiagentapi) - [Cars.com Car Finder](https://apify.com/TrueFetch/carscom-car-finder?fpr=aiagentapi) - [Cars.com Dealer Finder](https://apify.com/TrueFetch/carscom-dealer-finder?fpr=aiagentapi) - [Webmotors Car Finder](https://apify.com/TrueFetch/webmotors-car-finder?fpr=aiagentapi) #### Real Estate - [MagicBricks Builder Finder](https://apify.com/TrueFetch/magicbricks-builder-finder?fpr=aiagentapi) - [MagicBricks Home Finder](https://apify.com/TrueFetch/magicbricks-home-finder?fpr=aiagentapi) - [US Real Estate](https://apify.com/TrueFetch/us-real-estate?fpr=aiagentapi) - [Zillow Real Estate](https://apify.com/TrueFetch/zillow-real-estate?fpr=aiagentapi) #### Local Business & Food - [BBB Business Finder](https://apify.com/TrueFetch/bbb-business-finder?fpr=aiagentapi) - [BBB Review Checker](https://apify.com/TrueFetch/bbb-review-checker?fpr=aiagentapi) - [Google Business Profile](https://apify.com/TrueFetch/google-business-profile?fpr=aiagentapi) - [Reclame Aqui Company Finder](https://apify.com/TrueFetch/reclame-aqui-company-finder?fpr=aiagentapi) - [Zomato Menu Checker](https://apify.com/TrueFetch/zomato-menu-checker?fpr=aiagentapi) - [Zomato Restaurant Finder](https://apify.com/TrueFetch/zomato-restaurant-finder?fpr=aiagentapi) #### Classifieds - [Kleinanzeigen Listing Finder](https://apify.com/TrueFetch/kleinanzeigen-listing-finder?fpr=aiagentapi) - [Kleinanzeigen Seller Finder](https://apify.com/TrueFetch/kleinanzeigen-seller-finder?fpr=aiagentapi) - [OLX Listing Finder](https://apify.com/TrueFetch/olx-listing-finder?fpr=aiagentapi) - [OLX Seller Finder](https://apify.com/TrueFetch/olx-seller-finder?fpr=aiagentapi) #### Social Media - [Find Any Company On LinkedIn](https://apify.com/TrueFetch/find-any-company-on-linkedin?fpr=aiagentapi) - [Find Anyone On LinkedIn](https://apify.com/TrueFetch/find-anyone-on-linkedin?fpr=aiagentapi) - [Instagram Explore](https://apify.com/TrueFetch/instagram-explore?fpr=aiagentapi) - [Instagram Post](https://apify.com/TrueFetch/instagram-post?fpr=aiagentapi) - [Instagram Profile](https://apify.com/TrueFetch/instagram-profile?fpr=aiagentapi) - [Reddit Community Post](https://apify.com/TrueFetch/reddit-community-post?fpr=aiagentapi) - [Reddit Community Profile](https://apify.com/TrueFetch/reddit-community-profile?fpr=aiagentapi) - [Reddit Community User](https://apify.com/TrueFetch/reddit-community-user?fpr=aiagentapi) - [Reddit Post Search](https://apify.com/TrueFetch/reddit-post-search?fpr=aiagentapi) - [Reddit User Profile](https://apify.com/TrueFetch/reddit-user-profile?fpr=aiagentapi) - [Social Media Marketing](https://apify.com/TrueFetch/social-media-marketing?fpr=aiagentapi) - [Telegram Channel Message](https://apify.com/TrueFetch/telegram-channel-message?fpr=aiagentapi) - [Telegram Group Member](https://apify.com/TrueFetch/telegram-group-member?fpr=aiagentapi) - [Telegram Profile](https://apify.com/TrueFetch/telegram-profile?fpr=aiagentapi) - [X Community Profile](https://apify.com/TrueFetch/x-community-profile?fpr=aiagentapi) - [X User Profile](https://apify.com/TrueFetch/x-user-profile?fpr=aiagentapi) #### Videos & Text - [Best Video Downloader](https://apify.com/TrueFetch/best-video-downloader?fpr=aiagentapi) - [Instagram To Text](https://apify.com/TrueFetch/instagram-to-text?fpr=aiagentapi) - [TikTok Live Recorder](https://apify.com/TrueFetch/tiktok-live-recorder?fpr=aiagentapi) - [TikTok Video Downloader](https://apify.com/TrueFetch/tiktok-video-downloader?fpr=aiagentapi) - [TikTok Video Lookup](https://apify.com/TrueFetch/tiktok-video-lookup?fpr=aiagentapi) - [Video Subtitles Downloader](https://apify.com/TrueFetch/video-subtitles-downloader?fpr=aiagentapi) - [Video To Text](https://apify.com/TrueFetch/video-to-text?fpr=aiagentapi) - [YouTube Niche Scraper](https://apify.com/TrueFetch/youtube-niche-scraper?fpr=aiagentapi) - [YouTube Video Downloader](https://apify.com/TrueFetch/youtube-video-downloader?fpr=aiagentapi) #### Content & Articles - [Medium Article Finder](https://apify.com/TrueFetch/medium-article-finder?fpr=aiagentapi) - [Medium Writer Finder](https://apify.com/TrueFetch/medium-writer-finder?fpr=aiagentapi) *** ### ๐Ÿ“ž Support, changelog, last updated #### Support - ๐Ÿ’ฌ **Telegram Group:** [t.me/Apify\_Actor](https://t.me/Apify_Actor) - ๐Ÿ“ง **Direct support:** [t.me/AiAgentApi](https://t.me/AiAgentApi) - ๐Ÿ“– **Actor page & docs:** [apify.com/TrueFetch/telegram-channel-message](https://apify.com/TrueFetch/telegram-channel-message?fpr=aiagentapi) Maintained by **TrueFetch** on the [Apify Store](https://apify.com/TrueFetch?fpr=aiagentapi). > **Cost of doing nothing:** manually reading and archiving Telegram channel messages for research takes hours per channel. Telegram Channel Message returns structured message data at $0.00038 per message via API. โ†’ [Try it free with $5 of Apify credits](https://apify.com/TrueFetch/telegram-channel-message?fpr=aiagentapi). #### Changelog - **2026-05-02** โ€” README rewritten for SEO + GEO; documented all output fields, pricing, troubleshooting matrix, and FAQ. - **2026-04** โ€” Added `reactions`, `hashtags`, and `topic_name` output fields. - **2026-02** โ€” Initial release: Telegram channel message scraper. *** ```json { "@context": "https://schema.org", "@graph": [ { "@type": "SoftwareApplication", "@id": "https://apify.com/TrueFetch/telegram-channel-message#software", "name": "Telegram Channel Message", "description": "Apify Actor that returns structured Telegram channel messages at $0.00038 per message, covering text, sender, view count, reactions, and hashtags.", "applicationCategory": "BusinessApplication", "operatingSystem": "Web, Cloud", "url": "https://apify.com/TrueFetch/telegram-channel-message", "offers": { "@type": "Offer", "price": "0.00038", "priceCurrency": "USD", "availability": "https://schema.org/InStock" }, "author": { "@id": "https://apify.com/TrueFetch#author-TrueFetch" }, "publisher": { "@id": "https://apify.com/TrueFetch#publisher" } }, { "@type": "Organization", "@id": "https://apify.com/TrueFetch#publisher", "name": "TrueFetch", "url": "https://apify.com/TrueFetch", "sameAs": ["https://t.me/Apify_Actor", "https://t.me/AiAgentApi"] }, { "@type": "FAQPage", "mainEntity": [ { "@type": "Question", "name": "What data does Telegram Channel Message return?", "acceptedAnswer": { "@type": "Answer", "text": "Telegram Channel Message returns 23 structured fields including message text, sender, view count, reply count, forward count, reactions, hashtags, extracted URLs, and optional media file URL." } }, { "@type": "Question", "name": "How much does Telegram Channel Message cost?", "acceptedAnswer": { "@type": "Answer", "text": "The Actor charges $0.00038 per message and $0.00077 per media file. The Apify Free plan includes $5 of monthly platform credits โ€” enough for ~13,000 text messages." } }, { "@type": "Question", "name": "Can Telegram Channel Message access private channels?", "acceptedAnswer": { "@type": "Answer", "text": "No. The Actor only accesses publicly accessible Telegram channels." } } ] }, { "@type": "BreadcrumbList", "itemListElement": [ { "@type": "ListItem", "position": 1, "name": "Apify", "item": "https://apify.com" }, { "@type": "ListItem", "position": 2, "name": "Social Media", "item": "https://apify.com/store?category=SOCIAL_MEDIA" }, { "@type": "ListItem", "position": 3, "name": "Telegram Channel Message", "item": "https://apify.com/TrueFetch/telegram-channel-message" } ] } ] } ``` *** **Last Updated:** May 2, 2026 **Schema version:** 1.1 **Maintained by:** [TrueFetch](https://apify.com/TrueFetch?fpr=aiagentapi) ยท ๐Ÿ’ฌ [Telegram Group](https://t.me/Apify_Actor) ยท ๐Ÿ“ง [Support](https://t.me/AiAgentApi) # Actor input Schema ## `telegram_url` (type: `string`): Telegram channel or group link (supports t.me URL, @username, or username) ## `download_medias` (type: `string`): Select what medias to download from messages (text only, text + images, or text + all media) ## `start_date` (type: `string`): Get messages from this date to present ## `max_results` (type: `integer`): Maximum number of messages to get from the channel/group ## Actor input object example ```json { "telegram_url": "https://t.me/binance_announcements", "download_medias": "text", "start_date": "1 day", "max_results": 10 } ``` # Actor output Schema ## `results` (type: `string`): All Telegram messages with full metadata including text, sender, engagement metrics, reactions, and media URLs # API You can run this Actor programmatically using our API. Below are code examples in JavaScript, Python, and CLI, as well as the OpenAPI specification and MCP server setup. ## JavaScript example ```javascript import { ApifyClient } from 'apify-client'; // Initialize the ApifyClient with your Apify API token // Replace the '' with your token const client = new ApifyClient({ token: '', }); // Prepare Actor input const input = { "telegram_url": "https://t.me/binance_announcements", "download_medias": "text", "start_date": "1 day", "max_results": 10 }; // Run the Actor and wait for it to finish const run = await client.actor("truefetch/telegram-channel-message").call(input); // Fetch and print Actor results from the run's dataset (if any) console.log('Results from dataset'); console.log(`๐Ÿ’พ Check your data here: https://console.apify.com/storage/datasets/${run.defaultDatasetId}`); const { items } = await client.dataset(run.defaultDatasetId).listItems(); items.forEach((item) => { console.dir(item); }); // ๐Ÿ“š Want to learn more ๐Ÿ“–? Go to โ†’ https://docs.apify.com/api/client/js/docs ``` ## Python example ```python from apify_client import ApifyClient # Initialize the ApifyClient with your Apify API token # Replace '' with your token. client = ApifyClient("") # Prepare the Actor input run_input = { "telegram_url": "https://t.me/binance_announcements", "download_medias": "text", "start_date": "1 day", "max_results": 10, } # Run the Actor and wait for it to finish run = client.actor("truefetch/telegram-channel-message").call(run_input=run_input) # Fetch and print Actor results from the run's dataset (if there are any) print("๐Ÿ’พ Check your data here: https://console.apify.com/storage/datasets/" + run["defaultDatasetId"]) for item in client.dataset(run["defaultDatasetId"]).iterate_items(): print(item) # ๐Ÿ“š Want to learn more ๐Ÿ“–? Go to โ†’ https://docs.apify.com/api/client/python/docs/quick-start ``` ## CLI example ```bash echo '{ "telegram_url": "https://t.me/binance_announcements", "download_medias": "text", "start_date": "1 day", "max_results": 10 }' | apify call truefetch/telegram-channel-message --silent --output-dataset ``` ## MCP server setup ```json { "mcpServers": { "apify": { "command": "npx", "args": [ "mcp-remote", "https://mcp.apify.com/?tools=truefetch/telegram-channel-message", "--header", "Authorization: Bearer " ] } } } ``` ## OpenAPI specification ```json { "openapi": "3.0.1", "info": { "title": "Telegram Channel Message", "description": "Archive public Telegram channel messages โ€” full text, media URLs, reaction counts, forwarded-from, reply threads, and 23 fields. Filter by date. No account. $0.38 per 1,000.", "version": "1.0", "x-build-id": "tKpgCv4zw6Q8kBhPD" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/truefetch~telegram-channel-message/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-truefetch-telegram-channel-message", "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/truefetch~telegram-channel-message/runs": { "post": { "operationId": "runs-sync-truefetch-telegram-channel-message", "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/truefetch~telegram-channel-message/run-sync": { "post": { "operationId": "run-sync-truefetch-telegram-channel-message", "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": [ "telegram_url", "max_results", "download_medias" ], "properties": { "telegram_url": { "title": "Telegram URL", "type": "string", "description": "Telegram channel or group link (supports t.me URL, @username, or username)" }, "download_medias": { "title": "Download Medias", "enum": [ "text", "image", "all" ], "type": "string", "description": "Select what medias to download from messages (text only, text + images, or text + all media)" }, "start_date": { "title": "Start Date", "pattern": "^(\\d{4})-(0[1-9]|1[0-2])-(0[1-9]|[12]\\d|3[01])$|^(\\d+)\\s*(day|week|month|year)s?$", "type": "string", "description": "Get messages from this date to present" }, "max_results": { "title": "Max Results", "minimum": 10, "maximum": 1000000, "type": "integer", "description": "Maximum number of messages to get from the channel/group" } } }, "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 } } } } } } } } } } ```