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_medias	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 Medias Options:

• "text": 📄 Text only (no media downloads)
• "image": 📸 Text + Images
• "all": 🎬 Text + All media files (images, 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/binanceexchange",
  "download_medias": "image",
  "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
view_count	integer	Number of views for the message
forward_count	integer	Number of times message was forwarded
reply_count	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	integer	ID of message this is replying to
album_id	integer	Messages with same album_id belong to album
forward_info	object	Details about message forwarding

Service Actions

Field	Type	Description
service_type	string	Service message action type (e.g., chat_add_user, pin_message)
service_info	string	Additional information about the service action

Media Content

Field	Type	Description
media_url	string	Downloaded media file URL from Apify storage, or empty string if no media

Source Information

Field	Type	Description
source_id	integer	Unique identifier of the channel or group where message was extracted
source_name	string	Name of the channel or group where message was extracted from
source_type	string	Type of the source (Channel, Group, etc.)

Processing Information

Field	Type	Description
topic_name	string	Name of the forum topic (if message is in a forum topic)
processor	string	Identifier of the processing system that extracted this message
processed_at	string	ISO formatted timestamp when the message was processed

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,
  "view_count": 15420,
  "forward_count": 847,
  "reply_count": 156,
  "reactions": {
    "🚀": 234,
    "🔥": 189,
    "💎": 78,
    "📈": 145
  },
  "service_type": null,
  "service_info": null,
  "forward_info": {
    "date": "2024-01-15T14:20:15.000Z",
    "from_id": 1234567890,
    "from_name": "Crypto News Daily",
    "message_id": 1250
  },
  "reply_to": 2845,
  "album_id": null,
  "media_url": "https://apify.com/storage/kv/photo_2847_1642251625.jpg",
  "source_id": 1234567890,
  "source_name": "Binance",
  "source_type": "Channel",
  "topic_name": null,
  "processor": "https://apify.com/nextapi/telegram-message",
  "processed_at": "2024-01-15T14:24:00.000Z"
}