Telegram Chat Scraper - Telegram Message Intelligence & Media History API

Extract structured message history from Telegram channels and groups with 23+ metadata fields, media downloads, and engagement analytics. This Telegram messages API delivers full message history with reactions, forward chains, sender metadata, and service events. JSON output for compliance archives, moderation review, and OSINT pipelines.

---

Why Choose This Telegram Messages API

Enterprise-Grade Telegram Message Extraction with Media & Analytics

🔍 Complete Message History Extraction Extract unlimited message history from any public Telegram channel or group. Access messages back to channel creation with no time limitations — supports absolute dates, relative periods, and full-history extraction modes.

📊 23+ Metadata Fields Per Message Each message includes comprehensive intelligence: reactions, forward chains, reply threads, view counts, sender details, service actions, forum topics, media URLs, and source tracking.

📱 Automatic Media Download & Storage Download photos, videos, documents, and audio files with automatic cloud storage and URL generation. Select text-only, text+images, or text+all-media modes per run.

⚡ High-Throughput Processing Process 15-50 messages per second with stable pagination and enterprise-scale extraction throughput.

🤖 AI-Ready JSON Output Structured data optimized for sentiment analysis, content intelligence, compliance archiving, and NLP pipelines. Pre-formatted for LangChain, CrewAI, and custom AI workflows.

---

Why Choose This API

This actor is designed for structured output, repeatable automation, and downstream integration in monitoring, enrichment, or ingestion pipelines.

Quick Start Guide

How to Extract Telegram Messages in 3 Steps

Step 1: Configure Your Extraction

Select media download mode, date range, and paste the Telegram channel/group identifier.

Open Actor Input

Step 2: Run the Actor

Click "Start" and the actor will extract messages, download media (if selected), and produce structured JSON output with 23+ fields per message.

Step 3: Download Results

Access your message data as structured JSON with engagement metrics, media URLs, and sender intelligence.

Example Input

{
  "download_medias": "image",
  "start_date": "7 days",
  "telegram_target": "https://t.me/Apify_Actor"
}

---

Input Parameters

Parameter	Type	Required	Description
📥 Download Medias	String	Yes	Media download mode: text (text only), image (text + images), or all (text + all media)
📅 Start Date	String	No	Extract messages from this date to present. Use none for complete history, YYYY-MM-DD for absolute date, or N days/weeks/months for relative period
🎯 Telegram Target	String	Yes	Telegram channel/group identifier: @username or https://t.me/username

---

Output Data Schema

Each extracted message contains 23+ structured data fields:

Open Actor Input

Field	Type	Description
id	Integer	Telegram message unique identifier
type	String	Message type (regular, service, unknown)
date	String	ISO timestamp when the message was sent
text	String	Text content of the message
sender	String	Username or name of message sender
silent	Boolean	Whether message was sent silently
pinned	Boolean	Whether message is pinned
view_count	Integer	Number of views
reply_count	Integer	Number of replies
forward_count	Integer	Number of forwards
reply_to	Integer	ID of parent message
album_id	Integer	Album group identifier
reactions	Object	Emoji-to-count reaction mapping
forward_info	Object	Forwarding source details (date, from_id, from_name, message_id)
topic_name	String	Forum topic name
service_type	String	Service action type
service_info	String	Service action details
media_url	String	Downloaded media file URL
source_id	Integer	Source channel/group ID
source_name	String	Source channel/group name
source_type	String	Source type (Channel, Group)
processor	String	Apify actor URL
processed_at	String	ISO processing timestamp

Example Output

{
  "id": 12345,
  "type": "Regular",
  "date": "2024-01-15T10:30:00Z",
  "text": "Message content here...",
  "sender": "@username",
  "view_count": 1250,
  "reply_count": 12,
  "forward_count": 45,
  "reactions": { "👍": 15, "❤️": 8 },
  "media_url": "https://api.apify.com/v2/key-value-stores/.../photo.jpg",
  "source_name": "Binance Official",
  "source_type": "Channel",
  "processor": "https://apify.com/agentx/telegram-chat-scraper?fpr=aiagentapi",
  "processed_at": "2024-01-15T10:35:00Z"
}

---

Integration Examples

Python Integration Example

from apify_client import ApifyClient

client = ApifyClient("YOUR_API_TOKEN")

run_input = {
    "download_medias": "image",
    "start_date": "7 days",
    "telegram_target": "https://t.me/Apify_Actor"
}

run = client.actor("CTS2Fv7KyZuiQeSJ8").call(run_input=run_input)
dataset_items = client.dataset(run["defaultDatasetId"]).list_items().items

for item in dataset_items:
    print(f"[{item['date']}] {item['sender']}: {item['text'][:100]}")

JavaScript/Node.js Integration

import { ApifyClient } from "apify-client";

const client = new ApifyClient({ token: "YOUR_API_TOKEN" });

const input = {
  download_medias: "image",
  start_date: "7 days",
  telegram_target: "https://t.me/Apify_Actor",
};

const run = await client.actor("CTS2Fv7KyZuiQeSJ8").call(input);
const { items } = await client.dataset(run.defaultDatasetId).listItems();

items.forEach((item) =>
  console.log(`[${item.date}] ${item.sender}: ${item.text?.substring(0, 100)}`),
);

Actor ID for Platform Integration

CTS2Fv7KyZuiQeSJ8

Ⓜ️ Make.com Setup:

1. Login to Make.com (Get 1000 Free Credits)
2. Add module "Run an Actor"
3. Turn 'Map' on - right side of the 'Actor*'
4. Paste Actor ID - from above
5. Click the '⟳ Refresh' - left side of Map
6. Input JSON* - Modify the parameters as needed
7. Set "Run synchronously" to YES
8. Add module "Get Dataset Items" - receive the result
9. In Dataset ID* select defaultDatasetId

🎱 N8N.io Setup:

1. Add 'Run an Actor and get dataset' - from the apify node
2. Actor → By ID → Paste Actor ID - from above
3. Input JSON - Modify the parameters as needed

JSON-LD Metadata

{
  "@context": "https://schema.org",
  "@type": "SoftwareApplication",
  "name": "Telegram Chat Scraper",
  "description": "Telegram message history extraction API with media downloads and 23+ metadata fields",
  "applicationCategory": "Developer Tools",
  "operatingSystem": "Cloud",
  "url": "https://apify.com/agentx/telegram-chat-scraper?fpr=aiagentapi",
  "dateModified": "2026-04-21",
  "offers": {
    "@type": "Offer",
    "price": "0.00043",
    "priceCurrency": "USD"
  }
}

---

Pricing & Cost Calculator

Transparent Pay-Per-Use Model

Event Type	Price	Description
Actor Usage	$0.00001	Charged for runtime based on resource consumption
Message	$0.00043	Per message extracted with full metadata including text, sender, views, reactions, and timestamps
Media	$0.00096	Per media file downloaded including photos, videos, documents, and audio

Cost Examples

Small Scale (1,000 messages, text only):

• Messages: 1,000 × $0.00043 = $0.43
• Total: ~$0.43

Medium Scale (10,000 messages + 2,000 images):

• Messages: 10,000 × $0.00043 = $4.30
• Media: 2,000 × $0.00096 = $1.92
• Total: ~$6.22

Large Scale (100,000 messages + 20,000 media files):

• Messages: 100,000 × $0.00043 = $43.00
• Media: 20,000 × $0.00096 = $19.20
• Total: ~$62.20

Competitive Pricing Comparison

Feature	Telegram Chat Scraper	Bright Data	ScrapingBee	Octoparse
Cost per 1K Messages	$0.43 ⭐	$2.50	$1.50	$4.00
Metadata Fields	23+ ⭐	12	8	10
Media Download	Auto Cloud ⭐	Manual	Basic	Limited
API Quality	Enterprise ⭐	Complex	Basic	No API

---

Use Cases & Applications

Market Research & Competitive Intelligence

Channel Content Analysis Monitor competitor Telegram channels and industry groups to track announcements, product launches, and market signals. Structured message data enables automated competitive intelligence dashboards.

Sentiment Analysis Pipelines Feed message text and reaction data into NLP models for sentiment scoring, topic clustering, and trend detection across Telegram communities.

Compliance & Archiving

Regulatory Compliance Archives Extract and archive complete message histories for regulatory compliance, audit trails, and legal discovery. Structured JSON with timestamps and sender metadata meets enterprise archival requirements.

Content Moderation Intelligence Analyze message patterns, service events, and media content for content moderation workflows and community safety monitoring.

AI & Data Science

Training Data Collection Extract structured conversation data for training chatbots, language models, and conversational AI systems. 23+ metadata fields per message provide rich context for model training.

OSINT Pipelines Build open-source intelligence workflows with message forward chains, sender metadata, and cross-channel content tracking.

---

FAQ

Can I extract messages from private groups?

This actor extracts messages from public Telegram channels and groups. For private group extraction, see Telegram Private Group Scraper.

How far back can I extract messages?

You can extract the complete message history back to channel creation. Set start_date to none for full history extraction.

What media types are supported for download?

Photos, videos, documents, and audio files are automatically downloaded and stored in Apify cloud storage with direct URL access. Select image for photos only or all for complete media.

How are rate limits handled?

Telegram API restrictions are handled automatically. Messages are processed at 15-50 per second with controlled pacing.

Can I filter messages by sender or content?

The actor extracts all messages within the specified date range. Use downstream processing (Python, Make.com, etc.) to filter by sender, content keywords, or other criteria.

What happens if media download fails?

Individual media download failures don't affect message extraction. The media_url field will be empty for failed downloads while all message metadata is still captured.

---

SEO Keywords & Search Terms

Primary Keywords

Telegram scraper API, Telegram message extraction, Telegram channel scraper, Telegram data extraction, Telegram chat API, Telegram message history

Long-Tail Keywords

how to extract Telegram channel messages, download Telegram group history, Telegram message data API, automated Telegram message scraper, Telegram media downloader API, Telegram chat extraction 23 fields reactions forward chains, Telegram message history structured JSON compliance archive, Telegram group OSINT sentiment analysis pipeline, bulk Telegram channel scraper media metadata extraction

Industry Terms

message intelligence, compliance archiving, OSINT pipeline, sentiment analysis, content moderation, social media monitoring, conversation data extraction

Use Case Keywords

Telegram market research, Telegram competitive intelligence, Telegram compliance archive, Telegram AI training data, Telegram sentiment analysis

---

Trust & Certifications

• ✅ Enterprise Ready - Handles 1M+ message histories with 99.9% uptime
• ✅ GDPR Compliant - EU data protection standards and privacy regulations
• ✅ Cloud Storage - Automatic media upload to Apify key-value store
• ✅ Regular Updates - Continuous maintenance for Telegram platform changes

---

Legal & Compliance

Data Rights & Usage

All data extracted by this actor originates from publicly available Telegram channels and groups. Users are responsible for ensuring their use of extracted data complies with applicable laws and regulations in their jurisdiction.

Privacy Compliance

• GDPR: Compliant with EU General Data Protection Regulation. No personal data is stored beyond the extraction session.
• CCPA: Compliant with California Consumer Privacy Act requirements. Data processing follows privacy-by-design principles.

Platform Terms of Service

Users must review and comply with Telegram's Terms of Service when using extracted data. This tool accesses only publicly available information from public channels and groups.

Enterprise Support

For enterprise licensing, custom integrations, or compliance inquiries, contact our team:

• Telegram: @AiAgentApi

---

Related Tools

Jobs & Hiring

• All Job Scraper - Multi-Platform Job Data Extraction API
• Indeed Hiring Scraper - Indeed Job Extraction & Market Intelligence
• LinkedIn Hiring Scraper - LinkedIn Job Data Extraction & Talent Intelligence
• Glassdoor Hiring Scraper - Glassdoor Salary Intelligence & Company Reviews

LinkedIn

• LinkedIn Company Scraper - LinkedIn Company Data Extraction & Firmographic Intelligence
• LinkedIn Profile Scraper - LinkedIn Profile Data Extraction & Professional Intelligence

Reddit

• Reddit Author Scraper - Reddit Author Profile Extraction & Activity Analysis
• Reddit Viral Scraper - Reddit Viral Content Extraction & Trend Intelligence
• SubReddit Info Scraper - Subreddit Metadata Extraction & Community Intelligence
• SubReddit Post Scraper - Subreddit Post Extraction & Content Analysis
• Subreddit Member Scraper - Subreddit Member Extraction & Audience Analysis

Telegram

• Telegram Chat Scraper - Telegram Chat Message Extraction & Content Analysis (This Tool)
• Telegram Group Inviter - Telegram Group Member Invitation & Management
• Telegram Info Scraper - Telegram Entity Metadata Extraction & Intelligence
• Telegram Member Scraper - Telegram Group Member Extraction & Audience Data
• Telegram Private Group Scraper - Telegram Private Group Data Extraction & Analysis

Instagram

• Instagram Creator Scraper - Instagram Profile Data Extraction & Creator Intelligence
• Instagram Post Reel Scraper - Instagram Feed Post & Reel Extraction API
• Instagram Trending Scraper - Instagram Explore Trending Content Extraction API

X / Twitter

• Twitter Community Scraper - Twitter Community Extraction & Member Analysis
• Twitter Info Scraper - X/Twitter Profile Extraction & User Intelligence

TikTok

• TikTok Creator Scraper - TikTok Creator Profile Extraction & Analytics
• TikTok Live Downloader - TikTok Live Stream Recording & Download
• TikTok Transcript - TikTok Video Transcription & Content Extraction

Video & Content

• All Video Scraper - Multi-Platform Video Download & Extraction (1000+ Sites)
• Video Caption Scraper - Video Caption Extraction & Subtitle Data
• Video Transcript - Universal Video Transcription & AI Training Data
• Video to Social Post - Video Content Conversion & Social Media Repurposing
• Live Stream Transcript - Live Stream Transcription & Real-Time Content Extraction

YouTube

• YouTube Transcript - YouTube Video Transcription & Speech Extraction
• YouTube Market Intelligence - YouTube Channel & Video Metadata Extraction

Real Estate

• Realtor Property Scraper - Realtor.com Property Data Extraction & Market Intelligence
• Zillow For Sale Scraper - Zillow Property Listing Extraction & Real Estate Data

Maps & Local

• Google Maps Store Scraper - Google Maps Business Data Extraction & Local Intelligence

---

Support & Community

• 👥 Community: @Apify_Actor
• 👤 Contact Team: @AiAgentApi

---

Last Updated: April 21, 2026