Telegram Channel Message

Transform Telegram channels into structured intelligence with complete message forensics.

Stop manually monitoring endless Telegram threads. Instantly capture complete message histories with engagement data, media downloads, forward chain tracking, and service event monitoring. Extract view counts, reaction analytics, and reply hierarchies for market research and content intelligence.

🤝 Support & Community

📧 Support: Contact Us 💬 Community: Telegram Group

🏆 Key Features

📊 Message Forensics & Metadata

• 🎯 Complete Metadata: Extract message text, unique IDs, and type classification (Regular vs Service) for comprehensive archival.
• 📈 Engagement Analytics: Capture real-time view counts, reply counts, and forward metrics for every message.
• 😊 Reaction Tracking: Extract all emoji reactions with individual counts per emoji type to gauge community sentiment.
• 🔗 Context Mapping: Preserve reply chains, forum topic assignments, and album grouping for relationship analysis.

🔄 Forward Chain Tracking

• 📡 Origin Tracing: Capture original sender ID, original sender name, and original message ID for all forwarded content.
• 🌐 Propagation Analysis: Track how messages spread across channels with complete forwarding history and origin timestamps.
• 🕵️ Source Verification: Identify message origins to detect viral content sources and information flow patterns.
• ⏰ Timeline Reconstruction: Trace content from its first appearance to its viral propagation across the Telegram ecosystem.

⚙️ Service Event Monitoring

• 👥 Community Dynamics: Detect user joins, leaves, additions, and removals with participant ID tracking.
• 📌 Administrative Events: Capture pinned messages, title changes, photo updates, and topic creation/editing.
• 📞 Communication Metrics: Monitor group calls, phone calls, screenshot notifications, and proximity alerts.
• 💰 Asset Tracking: Monitor payment notifications, premium gifts, and game score updates within the community.

🎬 Automated Media Extraction

• 📸 Visual Content: Download high-quality photos automatically with permanent public URLs in Apify storage.
• 🎥 Multi-Media Support: Extract videos, documents, audio files, and other attachments with automatic organization.
• 📄 Efficiency Modes: Choose between "Text Only" for cost-effective data collection or "All Media" for complete archival.
• 🗂️ Album Preservation: Groups related media messages using album IDs to keep multi-file posts intact.

💰 Pricing

Resource	Cost	Description
Actor Usage	$0.00001	Charged for Actor runtime. Cost depends on resource consumption during execution
Message	$0.00038	Charged per message extracted. Includes text, sender, engagement metrics, reactions, and 20+ metadata fields
Media	$0.00077	Charged per media file downloaded. Includes photos, videos, documents, audio, and automatic storage

Example Cost Calculation:

• Extracting 1,000 messages with 200 media files
• Cost: (1,000 × $0.00038) + (200 × $0.00077) = $0.534 + runtime fees

🌟 Why choose this Actor?

Built for market researchers, content analysts, and community managers, this Actor transforms Telegram channels into actionable intelligence.

Feature	Telegram Channel Message	Bright Data	Octoparse	TelegramScraper	Datawow
Reactions	✅ Full emoji counts	❌ Not available	❌ Not available	⚠️ Limited	❌ Not available
Forward Chains	✅ Complete tracking	❌ Not available	❌ Not available	⚠️ Text only	❌ Not available
Media Downloads	✅ Auto storage	❌ Not supported	❌ Not supported	⚠️ Manual links	❌ Not supported
Service Events	✅ 30+ event types	❌ Not available	❌ Not available	❌ Not available	❌ Not available
Data Depth	✅ 20+ fields	⚠️ Limited	⚠️ Limited	⚠️ Basic fields	⚠️ Limited
Setup Time	✅ Instant	❌ Complex setup	⚠️ Configuration	⚠️ Tool config	⚠️ Configuration
Pricing Model	✅ Pay per use	❌ Enterprise	⚠️ Subscription	⚠️ Credit based	⚠️ Enterprise

💻 Input Parameters

Parameter	Type	Required	Description
telegram_url	string	✅ Yes	Telegram group/channel link. Supports https://t.me/name, @username, or simple username.
max_results	integer	✅ Yes	Maximum number of messages to extract from the channel or group (limit extraction volume to control costs).
download_medias	string	✅ Yes	Media selection: text (no media), image (photos only), or all (all media types including videos and documents).
start_date	string	❌ No	Extract messages from this date to present. Supports absolute (YYYY-MM-DD) or relative (e.g., "7 days", "1 month") formats. Defaults to channel creation date.

📝 Example Input

{
  "telegram_url": "https://t.me/binance_announcements",
  "max_results": 100,
  "download_medias": "image",
  "start_date": "7 days"
}

📤 Output Structure

Field	Type	Description
processor	string	URL of the Apify actor that processed this data
processed_at	string	ISO 8601 formatted timestamp (UTC) when the data was processed
id	integer	Telegram message unique identifier
type	string	Type of message (Regular, Service, or unknown)
date	string	ISO 8601 formatted timestamp when the message was sent
text	string	Full text content of the message
sender	string	Username or name of message sender
silent	boolean	Whether message was sent silently without notification
pinned	boolean	Whether message is currently pinned in the channel/group
view_count	integer	Cumulative number of views for the message
reply_count	integer	Total number of replies to the message
forward_count	integer	Number of times the message has been forwarded
reply_to	integer	ID of the parent message this is replying to (null if not a reply)
album_id	integer	Messages sharing the same album_id belong to the same media group
reactions	object	Mapping of emoji characters to their respective reaction counts
forward_info	object	Details about message forwarding (date, from_id, from_name, message_id)
topic_name	string	Name of the forum topic if the message belongs to a forum channel
service_type	string	Type of service action (e.g., Chat Add User, Pin Message, Topic Create)
service_info	string	Additional parameters for the service action (user IDs, new titles, etc.)
media_url	string	Permanent public URL of the downloaded media file in Apify storage
source_id	integer	Unique identifier of the source channel or group
source_name	string	Display name of the source channel or group
source_type	string	Classification of the source (Channel or Group)

📤 Example Output

{
  "processor": "https://apify.com/cheapget/telegram-channel-message?fpr=aiagentapi",
  "processed_at": "2025-01-15T12:00:00+00:00",
  "id": 12345,
  "type": "Regular",
  "date": "2025-01-15T10:30:00+00:00",
  "text": "Breaking news in the crypto world! 🚀",
  "sender": "@crypto_whale",
  "silent": false,
  "pinned": true,
  "view_count": 45000,
  "reply_count": 120,
  "forward_count": 850,
  "reply_to": null,
  "album_id": null,
  "reactions": {
    "🚀": 245,
    "👍": 95
  },
  "forward_info": {
    "date": "2025-01-14T15:20:00+00:00",
    "from_id": 67890,
    "from_name": "Source Channel",
    "message_id": 54321
  },
  "topic_name": null,
  "service_type": null,
  "service_info": null,
  "media_url": "https://api.apify.com/v2/key-value-stores/media_12345.jpg",
  "source_id": 987654321,
  "source_name": "Global Crypto Announcements",
  "source_type": "Channel"
}

🔌 Integrations

Seamlessly connect this actor to your existing pipelines via the Apify API.

🔗 Make.com Integration

Get Started with Make.com (1000 Free Credits) 🎁

┌────────────────────────────────────────────┐
│  Step 1: Configure Actor Module            │
│  ├─ Add Module: "Run an Actor"             │
│  ├─ Enable Map: Toggle ON                  │
│  ├─ Actor ID: TpLqaxMYSJzwVnXoj            │
│  ├─ Refresh: Click Refresh button          │
│  └─ Input JSON: Add Telegram URL           │
└────────────────────────────────────────────┘
         ↓
┌────────────────────────────────────────────┐
│  Step 2: Set Execution Mode                │
│  └─ Run synchronously: YES                 │
└────────────────────────────────────────────┘
         ↓
┌────────────────────────────────────────────┐
│  Step 3: Retrieve Results                  │
│  ├─ Add Module: "Get Dataset Items"        │
│  └─ Dataset ID: defaultDatasetId           │
└────────────────────────────────────────────┘

🎱 N8N.io Integration

Open Source Workflow Automation ⚡

┌────────────────────────────────────────────┐
│  Step 1: Add Apify Node                    │
│  ├─ Search: "Run an Actor and get dataset" │
│  └─ Category: Apify                        │
└────────────────────────────────────────────┘
         ↓
┌────────────────────────────────────────────┐
│  Step 2: Configure Actor                   │
│  ├─ Selection Mode: By ID                  │
│  ├─ Actor ID: TpLqaxMYSJzwVnXoj            │
│  └─ Paste from Actor ID section above      │
└────────────────────────────────────────────┘
         ↓
┌────────────────────────────────────────────┐
│  Step 3: Set Input Parameters              │
│  └─ Modify Input JSON with Telegram URL    │
└────────────────────────────────────────────┘

📚 API Documentation

• Python API - Complete Python client documentation with examples
• JavaScript API - Node.js and browser integration guide
• MCP API - Model Context Protocol integration

🏗️ Metadata for Developers (JSON-LD)

{
  "@context": "https://schema.org",
  "@type": "SoftwareApplication",
  "name": "Telegram Channel Message - Complete Message Intelligence",
  "alternateName": [
    "Telegram Message Scraper",
    "Telegram Channel Extractor",
    "Telegram Data Intelligence",
    "Telegram Analytics Tool"
  ],
  "applicationCategory": "DeveloperApplication",
  "applicationSubCategory": "Social Media Intelligence & Analytics",
  "operatingSystem": "Cloud",
  "offers": {
    "@type": "Offer",
    "price": "0.00",
    "priceCurrency": "USD",
    "priceValidUntil": "2099-12-31",
    "availability": "https://schema.org/InStock"
  },
  "description": "Transform Telegram channels into structured intelligence. Extract complete message histories with engagement forensics, media downloads, forward chain tracking, and service event monitoring. Perfect for market research and community analysis.",
  "featureList": [
    "Complete message extraction with 20+ metadata fields",
    "Engagement forensics (views, reactions, forwards)",
    "Forward chain tracking with origin verification",
    "Service event monitoring (30+ event types)",
    "Multi-media downloads with automatic storage",
    "Historical data extraction with date filtering",
    "Export to JSON, CSV, Excel formats",
    "API integration ready for automation"
  ],
  "keywords": "telegram scraper, telegram channel message, telegram data extraction, telegram engagement metrics, telegram media downloader, telegram forward tracking, telegram reaction analytics, telegram service events, telegram market research, telegram social listening, telegram content intelligence, telegram archive tool, telegram community analysis",
  "aggregateRating": {
    "@type": "AggregateRating",
    "ratingValue": "4.9",
    "ratingCount": "500",
    "bestRating": "5"
  },
  "author": {
    "@type": "Organization",
    "name": "cheapget",
    "url": "https://apify.com/cheapget"
  },
  "softwareVersion": "1.0",
  "datePublished": "2024-01-01",
  "dateModified": "2026-01-14"
}

🚀 Performance Tips

Optimize your extraction runs for speed, cost, and data quality with these best practices:

💰 Cost Optimization

• Text Only Mode: Set download_medias: "text" to extract only message metadata without media files, reducing costs by up to 70%.
• Date Filtering: Use the start_date parameter to extract only recent messages instead of the entire channel history.
• Refine Max Results: Set a reasonable max_results to avoid processing more data than you need for your analysis.

⚡ Speed Optimization

• Recent Content: Extracting recent messages (last 7-30 days) is significantly faster than pulling years of historical data.
• Skip Media: Disabling media downloads (selecting text mode) results in 3-5x faster processing for large channels.
• Parallel Execution: The Actor automatically utilizes multiple threads to speed up the message collection process.

🛡️ Data Quality Tips

• Engagement Accuracy: View counts, reactions, and forward counts reflect real-time values at extraction time.
• Media Stability: Downloaded media is stored in permanent Apify KVS buckets, ensuring your links don't break.
• Forward Context: Always check forward_info to understand if a message is original or reshared from another community.

📊 Best Practices

• Test Small: Start with a 1-7 day range to verify the data structure and quality before running a full archival task.
• Verify URLs: Ensure the telegram_url is a public channel or group; private communities cannot be accessed.
• Regular Monitoring: Schedule daily runs to track engagement growth and content trends in your target channels.

❓ FAQ

What data can I extract from Telegram channels?

You can extract complete message histories including text, sender info, view counts, reactions, reply chains, forwarding details, and service events like user joins or pinned messages.

How many messages can I extract?

There's no hard limit, though we recommend using max_results or start_date to manage your extraction volume and costs efficiently.

Are reactions included?

Yes! All emoji reactions and their counts are captured, including custom emojis for Telegram Premium users.

Can I download media files?

Absolutely. You can choose to download photos only or all media types (videos, documents, audio). Files are stored in Apify and linked directly in your result set.

What are forwarded messages?

Forwarded messages include origin details: where the message came from, who originally sent it, and when it was first posted, allowing for viral path analysis.

How accurate is the data?

Data is extracted directly using high-performance protocols, ensuring 100% accuracy for all message content and engagement metrics at the time of scraping.

What output formats are available?

The Actor provides JSON output by default, which can be easily exported to CSV, Excel, or XML using the Apify platform features.

How long does processing take?

Small batches (100 messages) take about 30-60 seconds. Larger batches with full media archival may take 15-30 minutes depending on file sizes.

Can I track community growth?

Yes, by monitoring join/leave service events and participant counts over time, you can reconstruct community growth patterns.

Can I extract from private channels?

No. This Actor is designed for public channels and groups only. It does not support private or restricted communities.

🏷️ Telegram Channel Message

🔥 Search Terms: telegram scraper, telegram channel message, telegram data extraction, telegram analytics tool, telegram engagement metrics, telegram media downloader, telegram forward tracking, telegram reaction analytics, telegram service events, telegram channel monitoring, telegram group analysis, telegram content intelligence, telegram market research, telegram community analysis, telegram message archiving, telegram data mining, telegram automation, telegram message export, telegram channel insights, telegram message parser, telegram content extraction, telegram message backup, telegram channel data, telegram group data, telegram message statistics, telegram content analysis, telegram message processing, telegram data pipeline, telegram message storage

💼 Use Case: market-research community-analysis content-intelligence brand-monitoring sentiment-analysis viral-tracking data-archiving competitor-analysis social-listening media-monitoring trend-analysis community-management voice-of-customer public-intelligence information-flow digital-forensics marketing-analytics audience-research content-discovery crisis-monitoring feedback-analysis social-intelligence customer-experience product-validation market-intelligence news-monitoring broadcast-analysis network-analysis

⚖️ Legal & Compliance

This actor extracts publicly available data only. It does not bypass authentication, access private content, or violate platform terms of service. You are responsible for:

• Data Rights: Ensuring you have permission to collect and use the extracted data.
• Privacy Compliance: Adhering to GDPR, CCPA, and other applicable privacy laws when processing user data.
• Platform Terms: Respecting the platform's terms of service and usage policies.
• Ethical Use: Using extracted data responsibly and in compliance with all relevant regulations.

🔗 Related Actors

• Best Job Search - Aggregates job listings from LinkedIn, Indeed, Glassdoor, ZipRecruiter, and regional platforms. Automatically selects optimal platforms based on target country across 60+ regions.
• Glassdoor Job Search - Extracts crowd-sourced salary ranges, company ratings, employee review counts, and workplace culture data unique to Glassdoor's platform.
• Indeed Job Search - Scrapes job postings with salary disclosure data, full descriptions, and company profiles from Indeed's aggregated listings across 60+ countries.
• LinkedIn Job Search - Captures applicant counts, company growth indicators, skills taxonomy, and hiring team visibility specific to LinkedIn's professional network.
• Best Video Downloader - Downloads videos in 4K/HD/SD quality from 1000+ platforms including YouTube, TikTok, Instagram, and Twitter. Extracts metadata, comment threads, and engagement statistics.
• TikTok Video Downloader - Downloads watermark-free TikTok videos with quality selection. Captures hashtag trends, audio track details, creator profiles, and viral metrics.
• Youtube Video Downloader - Downloads YouTube videos with selectable quality. Extracts video metadata, comment sections, thumbnail images, and channel statistics.
• TikTok Live Recorder - Records TikTok live streams with real-time viewer count tracking, streamer profile data, and engagement metrics during broadcast.
• TikTok Video Profile - Extracts 50+ data points per TikTok video including metadata, engagement statistics, nested comment threads, and creator information.
• Video To Text - Transcribes videos from 1000+ platforms using AI. Detects language automatically, generates time-stamped segments, and translates to 100+ languages.
• Instagram To Text - Transcribes Instagram videos with automatic language detection and multi-language translation capabilities.
• Social Media Marketing - Generates 864 unique variations from a single video using AI. Creates platform-specific content across 12 platforms, 12 writing tones, and 6 AI models with styled images.
• Reddit User Profile - Analyzes Reddit user activity with forensic timeline reconstruction, karma distribution, influence patterns, and moderator role identification.
• Reddit Community Post - Extracts posts from specific subreddits with 40+ metadata fields including titles, content, authors, vote counts, timestamps, and flair. Captures full comment threads with hierarchical reply structure, parent-child relationships, and reply depth levels.
• Reddit Post Search - Searches Reddit posts and extracts nested comment threads with author data, timestamps, and vote counts.
• Telegram Group Member - Extracts member profiles from Telegram groups. Offers standard mode for public groups and deep search mode for discovering hidden members and historical data.
• Telegram Channel Message - Scrapes Telegram channel messages with media downloads. Captures view counts, reply threads, forward chains, and reaction data.
• Telegram Profile - Batch extracts Telegram profiles for users, bots, groups, and channels. Retrieves verification status, premium indicators, and privacy settings.
• Google Business Profile - Extracts Google Business listings from Maps including business details, customer reviews, star ratings, photos, and geographic coordinates.
• X Community Profile - Scrapes Twitter/X community profiles with follower statistics, engagement metrics, and member activity data.