📨Telegram Message (Photo & Video Downloader)

Professional Telegram message scraper and media downloader with advanced analytics capabilities. Extract messages from Telegram groups and channels, download media files (images, videos, documents), and analyze comprehensive message metadata including engagement metrics, sender information, reactions, and forwarding data with enterprise-grade reliability and scalable performance.

🏆 Key Features

📥 Multi-Media Downloads

• 📄 Text Only - Extract message text content without media
• 📸 Images - Download photos and images from messages
• 🎬 All Media - Download all media types (videos, documents, audio, etc.)

🔍 Comprehensive Message Analysis

• 📊 Message Metadata - ID, type, date, text content, sender information
• 👤 Sender Details - Username, display name, user ID
• 📈 Engagement Metrics - Views, replies, forwards, reactions
• 📝 Message Context - Reply chains, topic information, album grouping
• 🔄 Forward Information - Original source and forwarding details
• ⚙️ Service Actions - Chat events, user actions, system messages
• 📱 Media Files - Downloaded media with public URLs

💻 Input Parameters

Parameter	Type	Required	Description	Example
telegram_target	string	✅	Telegram group/channel identifier (URL or username)	https://t.me/binance_announcements or @binance_announcements
download_medias	string	✅	Select media download type: Text only, Images, or All media	"text", "image", "all"
start_date	string	❌	Extract messages from this date to present (YYYY-MM-DD or relative format)	"2024-01-15" or "7 days"

🎛️ Media Download Options

Option	Description	Use Case
text	Text Only (No Media)	Message analysis, text mining
image	Images Only	Photo collection, image analysis
all	All Media Types	Complete media archive

Default Value: download_medias defaults to "text" if not specified (matches schema prefill)

📤 Output Structure

{
  "id": 12345,
  "type": "Regular",
  "date": "2024-01-15T10:30:00Z",
  "text": "Check out this amazing announcement! 🚀",
  "sender": "@binance_official",
  "silent": false,
  "pinned": true,
  "view_count": 50000,
  "reply_count": 150,
  "forward_count": 1200,
  "reply_to": 12340,
  "album_id": null,
  "topic_name": "General Announcements",
  "service_type": null,
  "service_info": null,
  "forward_info": {
    "date": "2024-01-14T15:20:00Z",
    "from_id": 67890,
    "from_name": "Binance Team",
    "message_id": 54321
  },
  "reactions": {
    "🚀": 250,
    "👍": 180,
    "❤️": 95
  },
  "media_url": "https://apify.com/kv-store/image_12345.jpg",
  "source_id": 987654321,
  "source_name": "Binance Announcements",
  "source_type": "Channel",
  "processor": "https://apify.com/nextapi/telegram-message-scraper",
  "processed_at": "2024-01-15T10:30:05Z"
}

📊 Output Fields Description

Field	Type	Description
id	integer	Telegram message unique identifier
type	string	Type of message (regular, service, unknown)
date	string	ISO formatted 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 for the message
reply_count	integer	Number of replies to the message
forward_count	integer	Number of times message was forwarded
reply_to	integer	ID of message this is replying to
album_id	integer	Messages with same album_id belong to the same album
reactions	object	Message reactions (emoji to count mapping)
forward_info	object	Details about message forwarding
forward_info.date	string	Original message date
forward_info.from_id	integer	Original sender ID
forward_info.from_name	string	Original sender name
forward_info.message_id	integer	Original message ID
topic_name	string	Name of the forum topic (if message is in a forum topic)
service_type	string	Type of service action (e.g., Chat Add User, Pin Message, etc.)
service_info	string	Additional information about the service action
media_url	string	Downloaded media file URL from Apify storage, or empty string if no media
source_id	integer	Unique identifier of the channel or group where the message was extracted from
source_name	string	Name of the channel or group where the message was extracted from
source_type	string	Type of the source (Channel, Group, etc.)
processor	string	URL of the Apify actor that processed this data
processed_at	string	ISO formatted timestamp when the data was processed

🎯 Use Cases

📊 Business Intelligence & Market Research

• Competitor Analysis - Monitor competitor Telegram channels for product launches, announcements, and strategies
• Brand Monitoring - Track mentions and discussions about your brand across Telegram groups and channels
• Market Research - Analyze community discussions to understand market trends and customer sentiment
• Crisis Management - Monitor public channels for potential issues or negative sentiment

🎓 Education & Research

• Academic Research - Collect data from educational Telegram channels for research purposes
• Content Analysis - Study communication patterns and engagement metrics in different communities
• Language Learning - Extract conversations from language learning groups for analysis
• Case Study Development - Gather real-world examples for business and communication studies

🔧 Technical & Analytics

• Data Science Projects - Extract message data for machine learning and natural language processing
• Social Media Analytics - Build custom dashboards for Telegram engagement analysis
• API Integration - Connect with existing analytics platforms and business intelligence tools
• Automated Monitoring - Set up continuous monitoring of important channels and groups

📱 Community Management

• Content Moderation - Analyze message patterns to identify spam, inappropriate content, or policy violations
• Engagement Analysis - Track which types of content generate the most engagement in your community
• User Behavior Studies - Understand how users interact with different types of messages and media
• Historical Archive - Create comprehensive archives of important community discussions and announcements

💰 Pricing

Resource	Cost	Description
Actor Usage	$0.0001	Base execution cost
Message Scraping	$0.00039	Per 1,000 messages scraped
Photo Download	$0.00086	Per 1,000 photos downloaded
Media Download	$0.0025	Per 1,000 media files downloaded

❓ FAQ

Q: Can I scrape private or restricted Telegram groups?

A: No, only public groups and channels can be scraped. Private groups require authentication and may have access restrictions.

Q: How long does processing take?

A: Message extraction: ~2-5 seconds per 100 messages. Media downloads: 10-30 seconds per file depending on size. Processing time varies based on message volume and media content.

Q: Does this work with all Telegram message types?

A: Yes, the scraper captures regular messages, service messages, forwarded content, and various media types including photos, videos, documents, and audio files.

Q: Can I scrape messages from a specific date range?

A: Yes, use the start_date parameter to specify when to start scraping. You can use absolute dates (YYYY-MM-DD) or relative formats (e.g., "7 days", "1 month").

🛠️ Troubleshooting

• Access denied: Telegram group/channel is private or requires authentication
• Budget exceeded: Task execution exceeds your Apify budget limit
• Processing timeout: Large groups with many messages may take longer to process
• Invalid target: Ensure the Telegram target is a valid group/channel URL or username
• Rate limiting: Telegram may temporarily limit requests for very active scraping

🤝 Support & Community

• 📧 Support: Contact us
• 💬 Community: Telegram Group