Telegram Message

A powerful Telegram message extraction API that aggregates data from any public Telegram channel or group, providing comprehensive message content, engagement metrics, and media downloads in a unified format.

This Actor streamlines Telegram data collection by extracting complete message information including text content, metadata, engagement statistics, service actions, and media files through a single, efficient API endpoint.

Key Features

• Multi-Channel Support: Extract data from any public Telegram channel or group
• Complete Message Data: Full message content including text, metadata, timestamps, and sender information
• Engagement Analytics: Comprehensive engagement metrics with views, forwards, replies, and reaction data
• Media Downloads: Automatic photo and media file downloads with direct storage links
• Service Action Tracking: Monitor channel events like user joins, admin actions, and channel updates
• Advanced Date Filtering: Flexible date filtering with both relative and absolute date ranges
• Real-time Processing: Fast batch processing with concurrent message extraction
• Multiple Output Formats: Export data in JSON, CSV, Excel, or any preferred format

Configuration

Required Parameters

Parameter	Type	Description
telegram_target	string	Telegram channel or group URL/username to scrape
download_files	string	File download preference for message media content

Telegram Target Examples:

• Username format: "@channel_name", "group_name"
• Share link format: "t.me/channel_name"
• Full URL format: "https://t.me/channel_name"

Download Files Options:

• "none": 🚫 No file downloads
• "photo": 📸 Photos only
• "all": 📂 All files (photos, videos, documents)

Optional Parameters

Parameter	Type	Description
start_date	string	Extract messages from this date onwards (UTC format)

Start Date Examples:

• ISO format: "2024-01-01", "2024-01-01T12:00:00Z"
• Relative dates: "7 days", "2 weeks", "1 month"
• Leave empty for all available messages

Usage Example

{
  "telegram_target": "https://t.me/binance_announcements",
  "download_files": "photo",
  "start_date": "7 days"
}

Data Output

The Actor returns an array of message objects with comprehensive information from the target Telegram channel or group. Output is available in multiple formats including JSON, CSV, Excel, and more.

Data Fields

Message Core Data

Field	Type	Description
id	integer	Telegram message unique identifier
type	string	Type of message (regular, service, etc.)
date	ISO date	ISO formatted timestamp when message was sent
text	string	Text content of the message
sender	string	Username or name of message sender

Engagement Metrics

Field	Type	Description
views	integer	Number of views for the message
forwards	integer	Number of times message was forwarded
replies	integer	Number of replies to the message
reactions	object	Message reactions (emoji to count mapping)

Message Properties

Field	Type	Description
silent	boolean	Whether message was sent silently
pinned	boolean	Whether message is pinned

Context Information

Field	Type	Description
reply_to_id	integer	ID of message this is replying to
grouped_id	integer	Messages with same grouped_id belong to album
forward_details	object	Details about message forwarding

Service Actions

Field	Type	Description
service_action	string	Service message action type (e.g., chat_add_user, pin_message)

Media Content

Field	Type	Description
file	string	Empty string (no file), file type (photo, image/jpeg), or file URL

Example Output

{
  "id": 2847,
  "type": "regular",
  "date": "2024-01-15T14:23:45.123Z",
  "text": "🚀 BREAKING: New cryptocurrency listing announcement! Trading starts tomorrow at 12:00 UTC. Get ready for the next big opportunity! #Crypto #Trading",
  "sender": "@crypto_announcements",
  "silent": false,
  "pinned": false,
  "views": 15420,
  "forwards": 847,
  "replies": 156,
  "reactions": {
    "🚀": 234,
    "🔥": 189,
    "💎": 78,
    "📈": 145
  },
  "service_action": null,
  "forward_details": {
    "date": "2024-01-15T14:20:15.000Z",
    "from_id": 1234567890,
    "from_name": "Crypto News Daily",
    "message_id": 1250
  },
  "reply_to_id": 2845,
  "grouped_id": null,
  "file": "https://apify.com/storage/kv/photo_2847_1642251625.jpg"
}

Supported Platforms

• Public Channels: Full access to all public Telegram channels with complete message history
• Public Groups: Access to public group discussions with full conversation context
• Broadcast Channels: Extract from news channels, announcement channels, and media channels