Telegram Media Downloader

Telegram Media Downloader

Telegram Media Downloader extracts media download URLs and metadata from public Telegram channel and group posts.

Get Telegram post media URLs, thumbnails, titles, descriptions, media type, file extension, quality labels, and processing status in a structured dataset ready for API access, scheduling, integrations, and export.

Copy to your AI assistant

Copy this block into ChatGPT, Claude, Cursor, or any LLM to start using this actor.

Use Apify Actor parsebird/telegram-media-downloader to extract media URLs from public Telegram posts. Input: {"links":["https://t.me/csifeducacionmadrid/2508"]}. Output fields: url, result.url, result.source, result.title, result.description, result.thumbnail, result.medias[{url,quality,extension,type}], result.type, result.error, result.status, result.time_end. Run with ApifyClient actor("parsebird/telegram-media-downloader").call(run_input={...}); API docs: https://docs.apify.com/api/client/python/docs/quick-start and https://docs.apify.com/api/client/js/docs/quick-start; token: https://console.apify.com/settings/integrations.

What is Telegram Media Downloader?

Telegram Media Downloader is a Telegram media downloader and Telegram scraper for public post URLs such as https://t.me/channel/12345. It fetches the public Telegram embed page, extracts post text, thumbnails, and media CDN URLs, and returns analysis-ready JSON data. Use it as a lightweight Telegram API alternative when you need public post media metadata without logging in.

What can Telegram Media Downloader do?

• Extract media download URLs from public Telegram posts.
• Capture post title, description, thumbnail URL, media type, extension, quality label, and status.
• Process multiple Telegram post links in one run, with a recommended maximum of 100 URLs.
• Run on a schedule with Apify schedules, call from the Apify API, and connect to Apify integrations.
• Export results as JSON, CSV, Excel, XML, RSS, or HTML from Apify datasets.

What data can you extract from Telegram posts?

Field	Description
url	Original Telegram post URL submitted in the input
result.url	Telegram embed URL used for extraction
result.title	Cleaned post text, shortened for title-style display
result.description	Full cleaned post text when available
result.thumbnail	Thumbnail or preview image URL detected on the post
result.medias	List of extracted media objects with URL, quality, extension, and type
result.status	success, no_media, or error
result.time_end	Processing time for that URL in milliseconds

Input parameters

Parameter	Type	Required	Default	Description
links	array	Yes	-	Public Telegram post URLs to process, for example https://t.me/csifeducacionmadrid/2508

Output example

[
  {
    "url": "https://t.me/csifeducacionmadrid/2508",
    "result": {
      "url": "https://t.me/csifeducacionmadrid/2508?embed=1&mode=tme",
      "source": "telegram",
      "title": "CSIF CONVOCA HUELGA EL 13/02...",
      "description": "CSIF CONVOCA HUELGA EL 13/02...",
      "thumbnail": "https://cdn4.cdn-telegram.org/file/example.jpg",
      "medias": [
        {
          "url": "https://cdn4.cdn-telegram.org/file/example.mp4",
          "quality": "HD",
          "extension": "mp4",
          "type": "video"
        }
      ],
      "type": "single",
      "error": false,
      "status": "success",
      "time_end": 692
    }
  }
]

Download the dataset in JSON, CSV, Excel, XML, RSS, or HTML from the Apify dataset export menu.

How to scrape Telegram media URLs

1. Open Telegram Media Downloader on Apify.
2. Paste one or more public Telegram post URLs into links.
3. Start the run.
4. Open the dataset to review titles, descriptions, thumbnails, media URLs, and statuses.
5. Export the dataset or connect the Actor to your workflow through the Apify API, webhooks, or integrations.

Python API example

from apify_client import ApifyClient

client = ApifyClient("YOUR_APIFY_TOKEN")

run = client.actor("parsebird/telegram-media-downloader").call(run_input={
    "links": [
        "https://t.me/csifeducacionmadrid/2508",
    ],
})

for item in client.dataset(run["defaultDatasetId"]).iterate_items():
    print(item)

JavaScript API example

import { ApifyClient } from 'apify-client';

const client = new ApifyClient({ token: 'YOUR_APIFY_TOKEN' });

const run = await client.actor('parsebird/telegram-media-downloader').call({
    links: [
        'https://t.me/csifeducacionmadrid/2508',
    ],
});

const { items } = await client.dataset(run.defaultDatasetId).listItems();
console.log(items);

How much does it cost to scrape Telegram media?

Telegram Media Downloader uses pay-per-event pricing. You pay for processed results and extracted media URLs.

Event	Free / Bronze / Silver	Gold	What counts as an event
result	$0.01 per 1,000	$0.01 per 1,000	One processed input URL pushed to the dataset
media	$3.99 per 1,000	$3.49 per 1,000	One extracted media URL

For example, 1,000 public Telegram post URLs with 1,000 extracted media URLs cost $4.00 on Free, Bronze, or Silver tiers before platform usage charges. If Apify shows a free trial or free platform credits for your account, you can use them to test a small run first.

Use cases

• Archive media URLs from public Telegram announcements.
• Monitor public Telegram channels for posts with images, videos, or documents.
• Build media research datasets for journalism, OSINT, brand monitoring, or social listening.
• Feed Telegram post media metadata into Google Sheets, Make, Zapier, webhooks, or internal APIs.

Is it legal to scrape Telegram?

Scraping publicly available web data is generally legal in many jurisdictions, but you should only process content you are allowed to access and use. Telegram Media Downloader only supports public Telegram channel and group posts; it does not bypass login, private channels, invite-only groups, or access restrictions. Review Telegram's terms and Apify's guide on the legality of web scraping before using extracted data in production.

Other Telegram scrapers and related Actors

• Kick Video Downloader - download Kick VODs and clips.
• YouTube Thumbnail Downloader - extract YouTube thumbnail URLs.
• Pinterest Image Downloader - extract Pinterest image data.
• Unsplash Image Scraper - scrape Unsplash image metadata.

FAQ

Does Telegram Media Downloader work with private Telegram channels? No. It only works with public Telegram channels and groups that expose public t.me post pages.

Does it download and store media files? No. It returns Telegram media URLs and metadata. It does not re-upload files into Apify key-value storage.

What Telegram URL format is supported? Use public post URLs like https://t.me/channel/12345. Invite links, private links, and login-only content are not supported.

What happens when a post has no media? The Actor returns a dataset item with status set to no_media, an empty medias array, and any text metadata it can extract.

Can I schedule recurring Telegram media extraction? Yes. Use Apify schedules to run the Actor hourly, daily, weekly, or at a custom interval.

Can I use Telegram Media Downloader from Python or JavaScript? Yes. Use the Apify API clients for Python or JavaScript with the examples above, or call the Actor through the REST API.

What are the main limitations? Only public Telegram channels and groups are supported. The Actor respects Telegram rate limiting, and a maximum of 100 URLs per run is recommended.