Telegram Post Scraper · Media Downloader, Stats & Metadata Bulk-extract everything you need from any public Telegram message or topic thread. --- ## 🚀 Features * Full post contents – text (with paragraph breaks), emojis, hashtags, tags, mentions * Media download – photos (JPEG / PNG), voice messages (OGG/MP3) and videos up to 60 sec (MP4) * Rich engagement stats – per-emoji reaction counts (free & paid), total reactions, views * Deep metadata – channel name, publication date (ISO 8601), verification badge, reply / forward links * Unlimited URLs – crawl hundreds of posts in one run, fully async with automatic retries * Flexible output – JSON (dataset default), plus one-click export to CSV, XLSX or Parquet inside Apify * Works with topic threads (https://t.me/channel/1234/5678) as well as regular posts --- ## ⚙️ Input json { "urls": [ "https://t.me/varlamov_news/62415", "https://t.me/OZON_int/13451/28364" ] } | Field | Type | Required | Description | | ------ | -------------- | -------- | --------------------------------------------------- | | urls | array | ✅ | One Telegram post URL per line (threads supported). | --- ## 📊 Output Each item in the dataset contains: | Key | Example | Notes | | ---------------------- | ----------------------------------------------- | -------------------------------------- | | url | https://t.me/varlamov_news/62415 | Original link | | channel_name | Varlamov News | — | | publish_datetime_iso | 2025-07-12T11:57:20+00:00 | UTC | | is_verified | true | Blue-tick channel | | text | "Why is Stalin’s popularity growing?\n\n..." | Clean text | | photos | ["https://.../file/abc.jpg"] | Unique list | | videos | ["https://.../file/clip.mp4"] | ≤ 60 s | | audios | ["https://.../file/voice.ogg"] | Voice msgs | | hashtags | ["#history","#politics"] | Order preserved | | mentions | ["@varlamov"] | From links & plain text | | forwarded_from | https://t.me/varlamov/9250 | Empty if none | | reply_to | https://t.me/varlamov/9249 | Empty if none | | views | 171000 | Integer | | reactions | { "🔥":1050, "❤‍🔥":204, "😁":41} | Dict | | paid_reactions | 5 | (paid = sum of super-reactions) | | total_reactions | 1385 | Paid + regular | | username | varlamov_news | Parsed from URL | | message_id | 62415 --- ## 🚦 Usage 1. Create a task for this Actor on Apify. 2. Paste your list of Telegram URLs into the Input field. 3. Click Run. 4. Download results from the Dataset tab in JSON, CSV, XLSX or Parquet. --- ## 📌 Typical use cases * Social-media analytics – monitor post performance across competitors or markets. * Media backup – bulk-download images, short videos and voice notes for archiving. * Market research – track hashtags, mentions and reaction sentiment over time. * Content republishing – retrieve assets and captions for newsletters, blogs or other channels. --- ## ⚠️ Limitations * Videos longer than 60 seconds and file attachments (documents, GIFs, etc.) cannot be downloaded. * Private or deleted posts cannot be accessed. * The actor respects Telegram rate limits; extremely large batches may take longer. --- ## ❓ FAQ | Question | Answer | | -------------------------------------- | -------------------------------------------------------------------------------------------------------------- | | Do I need a Telegram API key? | No – we scrape the public web widgets, so no login is required. | | Can I use proxies? | Yes. Configure proxy settings in the Apify Run tab for better geodiversity or to avoid local blocking. | | How many URLs can I submit? | Practically unlimited. The actor processes them asynchronously and pushes each result immediately. | | What happens if a link is invalid? | You’ll receive an item with "status":"error" and the original url preserved, so your pipeline won’t break. | --- Made with ❤️ by data engineers who spend too much time on Telegram.