---

✨ Telegram Video Downloader & Metadata Extractor

Download high-quality videos and extract rich metadata from public Telegram posts automatically. This actor stores videos securely and provides structured output ready for automation, archiving, or analytics.

Built for creators, researchers, marketers, and automation workflows on Apify.

---

🚀 Features & Overview

• ✨ Download videos from public Telegram posts
• 🖼️ Extract thumbnails automatically
• 🎵 Generate downloadable audio (when available)
• 📊 Structured metadata output for automation
• 📦 Files stored safely for easy download
• ⚡ Supports multiple URLs per run
• 🌍 Works globally with proxy support

This actor is ideal for:

• Content archiving
• Social media monitoring
• Dataset creation
• Media collection automation
• Research and analytics

---

📊 What Data This Actor Provides

The actor returns both media files and structured metadata.

🎬 Media Files

• High-quality video file
• Thumbnail image
• Audio file (when available)

🧾 Metadata

• Video title
• Channel/username
• Upload date
• Duration
• Video category type
• Format details
• Direct download links

---

📤 Output Fields Explanation

Here is what each output field means:

Field	Description
original_url	The Telegram post URL you submitted
video Title	Title or caption of the video
Username	Channel or publisher name
thumbnail	Direct image preview link
duration	Video length in seconds
video_type	Category label (short clip or full video)
upload_time	Publication date
video_format_details	Technical format information
download_links.video	Direct video file URL

---

🏆 Benefits & Advantages

• ✔ Saves hours of manual downloading
• ✔ Provides ready-to-use structured data
• ✔ Enables automation pipelines
• ✔ Works with multiple URLs simultaneously
• ✔ Useful for agencies, researchers, and creators
• ✔ No login required for public content

---

🧩 Input Example

{
    
    "startUrls": [
        {
            "url": "https://t.me/prank/4487"
        },
        {
            "url": "https://t.me/prank/4486"
        },
        {
            "url": "https://t.me/csifeducacionmadrid/2508"
        }
    ]

    "proxyConfiguration": {
        "useApifyProxy": false,
        "apifyProxyGroups": []
    },
}

• You can add one or many Telegram post links.

---

📥 Output Example

[
  {
    "original_url": "https://t.me/prank/4487",
    "video Title": "Super sexy 😂  🆕 Crypto News @Money 😁 Crypto Game @Egame 🇺🇸 US News @America 🇯🇵 Japan News @Japan 🇦🇪 UAE News @Dubai ▶ Popular Movies @Videos 😜 Best Funny Video @Funnys",
    "Username": "Best Funny Prank Video",
    "thumbnail": "https://api.apify.com/v2/key-value-stores/RTkhbYrk43EHoxYzv/records/db47aefec39aeb1dcd51269e961aca83.jpg?disableRedirect=true",
    "duration": "9.0s",
    "video_type": "reel",
    "upload_time": "March 16, 2025",
    "video_format_details": {
      "ext": "mp4",
      "protocol": "https",
      "video_ext": "mp4",
      "dynamic_range": "SDR"
    },
    "download_links": {
      "video": "https://api.apify.com/v2/key-value-stores/RTkhbYrk43EHoxYzv/records/db47aefec39aeb1dcd51269e961aca83.mp4?disableRedirect=true"
    }
  },
  {
    "original_url": "https://t.me/prank/4486",
    "video Title": "Beatbox Prank 😂  🆕 Crypto News @Money 😁 Crypto Game @Egame 🇺🇸 US News @America 🇯🇵 Japan News @Japan 🇦🇪 UAE News @Dubai ▶ Popular Movies @Videos 😜 Best Funny Video @Funnys",
    "Username": "Best Funny Prank Video",
    "thumbnail": "https://api.apify.com/v2/key-value-stores/RTkhbYrk43EHoxYzv/records/7335db1a7e769962892e6f0e94729850.jpg?disableRedirect=true",
    "duration": "59.0s",
    "video_type": "reel",
    "upload_time": "March 16, 2025",
    "video_format_details": {
      "ext": "mp4",
      "protocol": "https",
      "video_ext": "mp4",
      "dynamic_range": "SDR"
    },
    "download_links": {
      "video": "https://api.apify.com/v2/key-value-stores/RTkhbYrk43EHoxYzv/records/7335db1a7e769962892e6f0e94729850.mp4?disableRedirect=true"
    }
  },
  {
    "original_url": "https://t.me/csifeducacionmadrid/2508",
    "video Title": "CSIF CONVOCA HUELGA EL 13/02  📢 𝗖𝗦𝗜𝗙 convoca una jornada de huelga el día 13 de febrero 𝗽𝗼𝗿 𝗹𝗮 𝗶𝗻𝗰𝗲𝗿𝘁𝗶𝗱𝘂𝗺𝗯𝗿𝗲 𝗲𝗻 𝗠𝘂𝗳𝗮𝗰𝗲.  ▫️Miguel Borra, presidente de CSIF: \"Vamos a parar la Administración del Estado\".  ▫️Lamentamos el perjuicio que esta huelga pueda generar sobre los ciudadanos, pero nos vemos obligados a elevar el tono de la protesta para defender el derecho de nuestros/as funcionarios a recibir una asistencia sanitaria, en el marco de la ley del mutualismo administrativo.  ➕INFO👇🏻 https://tinyurl.com/35fnkjsz  ➡️ Síguenos en nuestras Redes Sociales: ▫️Telegram: https://t.me/csifeducacionmadrid ▫️Resto de RRSS: https://linktr.ee/csifeducacionmadrid",
    "Username": "CSIF Educación Madrid",
    "thumbnail": "https://api.apify.com/v2/key-value-stores/RTkhbYrk43EHoxYzv/records/6902c80def446853ec5f56412985ef3f.jpg?disableRedirect=true",
    "duration": "25.0s",
    "video_type": "reel",
    "upload_time": "January 28, 2025",
    "video_format_details": {
      "ext": "mp4",
      "protocol": "https",
      "video_ext": "mp4",
      "dynamic_range": "SDR"
    },
    "download_links": {
      "video": "https://api.apify.com/v2/key-value-stores/RTkhbYrk43EHoxYzv/records/6902c80def446853ec5f56412985ef3f.mp4?disableRedirect=true"
    }
  }
]

---

💡 Best Practices

• ✔ Use datacenter proxies for stable performance
• ✔ Run again if network interruption occurs
• ✔ Provide clean public Telegram URLs only
• ✔ Avoid extremely large batch runs in one execution
• ✔ Store dataset outputs for future automation

---

⚠️ Possible Errors & How to Avoid Them

❌ Private or restricted posts

Only public Telegram content can be processed.

Solution: Use public channel links.

---

❌ Proxy connection issues

Sometimes proxies may fail or be slow.

Solution: Switch proxy group or rerun actor.

---

❌ Network timeout

Large videos may take longer to process.

Solution: Simply rerun the actor to complete missing items.

---

❌ Invalid URLs

Incorrect links will not produce results.

Solution: Make sure links follow this format: https://t.me/channel/postID

---

🔎 Keywords

Telegram video downloader, Telegram video scraper, Telegram metadata extractor, Telegram post downloader, Telegram automation tool, Apify Telegram scraper, Telegram media extractor,

---

📌 Use Cases

• 📚 Media archiving systems
• 📰 Monitoring Telegram channels
• 📈 Market intelligence collection
• 🤖 Automation workflows
• 🎬 Content reuse pipelines

---

🏁 Final Notes

This actor is designed to make Telegram media extraction simple, fast, and automation-friendly. Perfect for teams, creators, and developers needing reliable Telegram video access.

---

Here my another actors:

Youtube Iteams:

• 🎶 Youtube Audio Downloader (Video/Shorts)
• Youtube Video Downloader Advanced
• Youtube Video Downloader ( Soundless )
• Youtube Video Downloader
• Youtube Video Details Scraper
• Youtube Transcript Ninja (Subtitles)
• Youtube Thumbnails Downloader & Scraper
• Youtube Tags or Hashtags Scraper
• Youtube Tags Scraper
• Youtube Shorts Scraper lite
• Youtube Shorts Downloader Pro
• Youtube Shorts Comments Scraper
• Youtube Community Posts Scraper
• Youtube Channel Id Scraper Pro
• Youtube Video Transcript Scraper ( Subtitles )
• Youtube Video Comments Scraper
• Youtube Shorts Scraper Pro
• Youtube Shorts Scraper
• Youtube Channel Scraper
• YouTube Video Description Extractor
• YouTube Hashtag Scraper
• YouTube Description Scraper pro
• YouTube Comments Scraper | Pay Per Result
• YouTube Channel ID Scraper

Tiktok Iteams:

• Tiktok Video Downloader
• Tiktok Video Details Scraper Pro
• Tiktok Profile Scraper
• TikTok Video Scraper
• TikTok Profile Videos Scraper
• TikTok Profile Scraper pro
• TikTok Audio Downloader 🎵

Snapchat Iteams:

• Snapchat Video Downloader (Spotlight )
• Snapchat Video Details Scraper (Spotlight)
• Snapchat Followers Scraper
• Snapchat Profile Scraper
• Snapchat Profile Scraper Mini

Instagram Iteams:

• Instagram video Downloader + Scraper
• Instagram Video Downloader (Soundlss)
• Instagram Thumbnail Scraper Video & Reels
• Instagram Reels Downloader
• Instagram Profile URL to Username Converter & Extractor
• Instagram Profile Scraper
• Instagram Post Videos Downloader
• Instagram Followers Scraper
• Instagram Audio Downloader
• Instagram Video Scraper + Downloader
• Instagram Video scraper Advanced
• Instagram Video Details scraper
• Instagram Reels Details scraper
• Instagram Followers Scraper Pro

Facebook Iteams:

• Facebook reels Downloader (Separate audio or video)
• Facebook Video Downloader advanced
• Facebook Video Details Scraper Advanced
• Facebook Video Details Scraper
• Facebook Transcript & Subtitle scraper
• Facebook Thumbnail Downloader Video & Reels
• Facebook Reels Downloader Advanced
• Facebook Reels Details Scraper Best and Affordable
• Facebook Reels Details Scraper
• Facebook Page Details Scraper
• Facebook Audio Downloader

Amazon Iteams:

• Amazon Search Scraper
• Amazon Product Details Scraper