Telegram Chat Scraper avatar

Telegram Chat Scraper

Pricing

from $0.51 / 1,000 messages

Go to Apify Store
Telegram Chat Scraper

Telegram Chat Scraper

Replay any public Telegram channel or group like a paginated archive: pull up to 1,000,000 messages with sender, timestamp, reactions, forward chain, reply linkage, and service events. Choose text-only, text+images, or text+all media β€” large attachments are pushed straight to your key-value store.

Pricing

from $0.51 / 1,000 messages

Rating

5.0

(4)

Developer

AgentX

AgentX

Maintained by Community

Actor stats

4

Bookmarked

177

Total users

14

Monthly active users

5 days ago

Last modified

Share

Telegram Chat Scraper - Telegram Message Intelligence API

Telegram Chat Scraper is a Telegram message intelligence API that extracts structured public-channel and group messages, engagement metrics, forward chains, and reaction counts in a single channel/group-driven run β€” no Telegram authentication required. Telegram Chat Scraper returns structured records per message, including message ID, full text, sender ID and metadata, view count, reply count, forward count, reaction counts per emoji, hashtags array, URLs array, media URLs, forward origin channel and message ID, service event type, album ID, post date, and message permalink. Coverage spans all public Telegram channels and groups globally with date-range scoping (absolute and relative). Built for compliance archives, brand monitoring, community sentiment analysis, OSINT research, viral-content tracking, regulated-industry message logging, and NLP training-data pipelines. Per-message pay-per-result pricing at $0.00053 with no monthly minimum.

Telegram Message Intelligence Chat Analytics


Why Choose This API

Structured Telegram Message Data for B2B Intelligence Pipelines

πŸ“Š Engagement Signal Extraction The view_count, reply_count, and forward_count fields deliver per-message engagement signals β€” enabling reach scoring, virality detection, content impact ranking, and message engagement benchmarking for social intelligence pipelines.

πŸ”— Forward Chain Intelligence The forward_info object captures the origin channel name, source message ID, and source date for every forwarded message β€” enabling content propagation mapping, information network analysis, and cross-channel message attribution.

πŸ˜€ Reaction Metadata The reactions field captures emoji reaction counts per message β€” enabling sentiment signal extraction, emotional response analysis, and audience reaction profiling for community intelligence workflows.

🏷️ Hashtag & URL Extraction The hashtags and urls arrays are pre-parsed per message β€” enabling topic taxonomy mapping, outbound link intelligence, and content categorization without additional text parsing.

πŸ“… Date-Range Extraction The start_date parameter supports absolute and relative date expressions (e.g., 1 day, 2026-01-01) β€” enabling time-scoped historical archives, event-window extraction, and incremental monitoring pipelines.

🎬 Media Download Control Three media modes β€” text, image, all β€” allow precise cost-performance optimization: extract text-only for high-volume NLP workflows, or include media files for comprehensive content archives.


Quick Start Guide

How to Extract Telegram Chat Messages in 3 Steps

Step 1: Find the Target Channel or Group

Enter the Telegram URL, @username, or plain username (e.g., https://t.me/aipost, @aipost, or aipost).

Step 2: Configure Date Range and Volume

Open Actor Input

Set start_date, max_results, and download_medias mode, then click Start.

Step 3: Download Message Data

Export results as JSON or CSV, or access programmatically via the Apify dataset API.


Input Parameters

Configuration Fields

ParameterTypeRequiredDescriptionExample Values
telegram_urlstringβœ…Telegram channel/group URL, @username, or plain username"https://t.me/aipost", "@crypto_news"
download_mediasselectβœ…Media download scope: text / image / all"text", "image", "all"
start_datedatepicker❌Extract messages from this date to present (absolute or relative)"1 day", "2026-01-01"
max_resultsintegerβœ…Maximum number of messages to extract (10–1,000,000)100, 1000, 50000

Example Input Configuration

{
"telegram_url": "https://t.me/aipost",
"download_medias": "text",
"start_date": "7 day",
"max_results": 1000
}

Output Data Schema

Complete Message Record Structure

Each extracted Telegram message record contains the following fields:

Open Actor Output

Core Message Fields

FieldTypeDescription
processorstringApify actor URL that processed this record
processed_atstringISO 8601 timestamp (UTC) when scraped
idintegerTelegram message unique identifier
typestringMessage type (Regular / Service)
datestringMessage send timestamp (ISO 8601)
textstringFull message text content
senderstringUsername or display name of sender
silentbooleanSilent message flag
pinnedbooleanPin status
view_countintegerTotal message views
reply_countintegerNumber of replies
forward_countintegerNumber of forwards
reply_tointegerParent message ID if reply
album_idintegerMedia album grouping ID
topic_namestringForum topic name (forum groups)
edit_datestringLast edit timestamp
urlsarrayURLs found in message text
hashtagsarrayHashtags found in message text
service_typestringService event type (Pin / ChatAddUser etc.)
service_infostringService event additional details
forward_infoobjectOrigin channel/message for forwarded posts
reactionsarrayEmoji reaction counts per message

Example JSON Output

{
"processor": "https://apify.com/agentx/telegram-chat-scraper?fpr=aiagentapi",
"processed_at": "2026-05-01T10:30:00.000Z",
"id": 12345,
"type": "Regular",
"date": "2026-04-30T14:22:00+00:00",
"text": "Major LLM benchmark update dropped today. Thread below.",
"sender": "@aipost",
"view_count": 45000,
"reply_count": 120,
"forward_count": 850,
"hashtags": ["#AI", "#LLM"],
"urls": ["https://arxiv.org/abs/2505.12345"],
"reactions": [{ "emoji": "πŸ”₯", "count": 340 }]
}

Export Formats

  • JSON - Complete structured data with all engagement metadata
  • CSV - Spreadsheet-compatible for BI and analytics tools
  • API Access - Programmatic access via Apify Client SDK
  • Cloud Storage - Automatic upload to Apify Dataset

Integration Examples

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

Python Integration Example

from apify_client import ApifyClient
client = ApifyClient('YOUR_API_TOKEN')
run_input = {
"telegram_url": "https://t.me/aipost",
"download_medias": "text",
"start_date": "7 day",
"max_results": 1000
}
run = client.actor("CTS2Fv7KyZuiQeSJ8").call(run_input=run_input)
for item in client.dataset(run["defaultDatasetId"]).iterate_items():
print(item)

JavaScript/Node.js Integration

import { ApifyClient } from "apify-client";
const client = new ApifyClient({ token: "YOUR_API_TOKEN" });
const input = {
telegram_url: "@crypto_news",
download_medias: "text",
max_results: 500,
};
const run = await client.actor("CTS2Fv7KyZuiQeSJ8").call(input);
const { items } = await client.dataset(run.defaultDatasetId).listItems();
items.forEach((item) => console.log(item));

JSON-LD Metadata

{
"@context": "https://schema.org",
"@graph": [
{
"@type": "SoftwareApplication",
"@id": "https://apify.com/agentx/telegram-chat-scraper#software",
"name": "Telegram Chat Scraper",
"description": "Telegram Chat Scraper is a Telegram message intelligence API extracting structured chat data with engagement metrics, forward chains, reaction counts, hashtags, URLs, media, and sender metadata for social listening and compliance archive pipelines.",
"applicationCategory": "BusinessApplication",
"applicationSubCategory": "Web Scraping API",
"operatingSystem": "Web, Cloud",
"url": "https://apify.com/agentx/telegram-chat-scraper?fpr=aiagentapi",
"softwareVersion": "1.0.0",
"datePublished": "2024-08-01",
"dateModified": "2026-05-01",
"featureList": [
"Full message text and sender metadata",
"Views, replies, forwards, reaction counts",
"Forward chain origin (channel + message ID)",
"Hashtags, URLs, and media URLs",
"Album ID and service event type",
"Date-range scoping (absolute and relative)",
"Per-message pay-per-result at $0.00053",
"Native integrations with Make.com, n8n, LangChain, and CrewAI"
],
"offers": {
"@type": "Offer",
"price": "0.00053",
"priceCurrency": "USD",
"availability": "https://schema.org/InStock"
},
"author": { "@id": "https://apify.com/agentx#person" },
"publisher": { "@id": "https://apify.com#organization" }
},
{
"@type": "Person",
"@id": "https://apify.com/agentx#person",
"name": "AgentX",
"url": "https://apify.com/agentx",
"sameAs": [
"https://apify.com/agentx",
"https://t.me/AiAgentApi",
"https://t.me/Apify_Actor"
],
"knowsAbout": [
"web scraping",
"Telegram",
"message intelligence",
"chat analytics",
"OSINT"
]
},
{
"@type": "BreadcrumbList",
"itemListElement": [
{
"@type": "ListItem",
"position": 1,
"name": "Apify",
"item": "https://apify.com"
},
{
"@type": "ListItem",
"position": 2,
"name": "AgentX",
"item": "https://apify.com/agentx"
},
{
"@type": "ListItem",
"position": 3,
"name": "Telegram Chat Scraper",
"item": "https://apify.com/agentx/telegram-chat-scraper"
}
]
}
]
}

Pricing & Cost Calculator

Pay-Per-Result Pricing

EventRate
Actor Start$0.08 per GB memory
Message (per message)$0.00053 (BRONZE)
Media (per file downloaded)$0.001

Cost Calculator Examples

MessagesMedia DownloadsEstimated Cost
100 messages0 media~$0.13
1,000 messages0 media~$0.61
10,000 messages0 media~$5.38
10,000 messages500 media~$5.88
50,000 messages0 media~$26.57

Set download_medias: "text" to eliminate media download charges for text-only extraction.


Use Cases & Applications

Brand Monitoring & Social Listening

Telegram Brand Channel Monitoring Extract messages from brand-relevant Telegram channels β€” building structured brand mention archives, monitoring product discussions, and tracking competitor channel activity for social listening pipelines.

Community Sentiment Analysis Extract message text with view_count and reactions from niche topic channels β€” building sentiment datasets, audience reaction corpora, and community mood timelines for NLP analysis.

Compliance & OSINT Research

Channel Message Archiving Use start_date for precise historical window extraction β€” building point-in-time channel archives, compliance records, and regulatory evidence collections for legal and compliance workflows.

Information Propagation Analysis The forward_info object reveals cross-channel message propagation β€” enabling information source attribution, network spread mapping, and misinformation tracing for OSINT research pipelines.

Hashtag & Topic Monitoring The hashtags array enables tag-based filtering post-extraction β€” building topic frequency timelines, hashtag trend analysis, and community topic calendars for strategic intelligence workflows.


FAQ

Does this require Telegram authentication?

No β€” this actor extracts data from public Telegram channels and groups without any Telegram account or API credentials.

What does download_medias: "all" include?

Photos, videos, documents, audio files, and other media attachments found in messages. Each media file is charged at $0.001. Use "text" mode to skip all media downloads.

How does the start_date field work?

Supports absolute dates ("2026-01-01") and relative expressions ("1 day", "2 weeks") β€” enabling both historical range extraction and rolling monitoring windows.

Can I monitor a private channel?

This actor extracts data from publicly accessible Telegram channels and groups. See Telegram Private Group Scraper for private group extraction.


SEO Keywords & Search Terms

Primary Keywords

Telegram chat scraper API, Telegram message extractor, Telegram channel message API, Telegram group chat data API, Telegram message intelligence, Telegram chat history API, Telegram channel scraper, Telegram message dataset, Telegram community content API, structured Telegram message data

Long-Tail Keywords

how to extract Telegram channel messages programmatically, Telegram chat message monitoring API, Telegram channel history extractor, Telegram group message scraper, Telegram forward chain analysis API, Telegram reaction data extractor, Telegram hashtag monitoring API, Telegram message sentiment analysis, Telegram channel compliance archive, Telegram OSINT message intelligence

Industry Terms

Telegram message intelligence API, channel content archiving, social listening pipeline, forward chain propagation, reaction sentiment signals, OSINT chat intelligence, compliance message archive, brand monitoring data, NLP training corpus, community sentiment analysis


Trust & Certifications

  • βœ… Production-Grade Infrastructure β€” runs on the Apify cloud platform with managed proxy rotation and automatic retries
  • βœ… GDPR & CCPA-Region Aligned β€” extracts only publicly available Telegram channel and group messages; no personal contact data retained beyond the run session
  • βœ… Pay-Per-Result Billing β€” transparent $0.00053 per message with no monthly minimum or seat fees
  • βœ… Continuously Maintained β€” schema and selector updates released as Telegram evolves

Data Rights & Usage

All data extracted by this actor originates from publicly accessible Telegram channels and groups. Users are responsible for ensuring their use of extracted data complies with applicable laws, data protection regulations, and Telegram's terms of service.

Privacy Compliance

  • GDPR: Compliant with EU GDPR for data processing workflows.
  • CCPA: Compliant with California Consumer Privacy Act requirements.

Platform Terms of Service

Users must review and comply with Telegram's developer terms of service when using extracted data.

Enterprise Support

For enterprise licensing, custom integrations, or compliance inquiries:


Jobs & Hiring

Social Media

Video & Transcript

E-Commerce & Retail

Classifieds & Automotive

Real Estate

Business Intelligence & Reviews

Other


Support & Community


Last Updated: May 01, 2026