Telegram Media Downloader

Get Telegram media URLs fast

Telegram Media Downloader gets direct media URLs and post data from public Telegram posts, channels, and groups. Add Telegram post links, channel links, t.me/s archive links, or @handles, then export photos, videos, documents, post text, dates, views, source links, and thumbnails to an Apify dataset.

Use it when you need a clean Telegram media scraper for content review, research, backup, media tracking, or social media work. You do not need a Telegram login, cookies, or an API key. The Actor works with public Telegram pages only.

What this Telegram media downloader does

• Downloads public Telegram media links from single post URLs.
• Scans recent public posts from channel or group targets.
• Saves one dataset row per media item, so photos and videos are easy to sort, filter, and export.
• Gets post text, post URL, channel handle, author name, date, views, media type, file extension, thumbnail URL, and scrape status.
• Lets you filter for all media, videos, photos, or documents.
• Can save clear status rows for private, missing, or empty targets so you can see what happened.

Who it is for

• Researchers who need Telegram post media with source links.
• Social media teams that need Telegram videos or images in CSV, JSON, Excel, or through the Apify API.
• Content teams that want to check recent media from public Telegram channels.
• Developers who need simple Telegram media extraction for a workflow, webhook, or integration.

How to run it

1. Paste one or more Telegram targets in Telegram targets.
2. For channel or group targets, set Post limit per channel.
3. Set Total media item limit if you want a small test run.
4. Choose media types: all media, videos, photos, or documents.
5. Start the Actor and open the dataset.

For a quick first run, keep the default target and a small media limit. Post URLs process only that post. Channel and group URLs scan recent public posts up to your post limit.

Input

Field	What to enter
targets	Public Telegram post URLs, channel URLs, group URLs, t.me/s archive URLs, or @handles.
maxPostsPerChannel	How many recent posts to inspect for each channel or group target.
maxMediaItems	Optional cap for saved media rows across the run.
mediaTypes	all, video, photo, or document.
includePostText	Save visible post text with each media row.
includeThumbnails	Save thumbnail URLs when Telegram shows them.
skipDuplicateMedia	Skip the same media URL if it appears more than once.
includeFailedTargets	Save status rows for targets that cannot return media.

Output

Each media item is saved as its own row. This makes the output easy to use in spreadsheets, APIs, and automation tools.

{
	"rowType": "media",
	"target": "https://t.me/example/123",
	"postUrl": "https://t.me/example/123",
	"postId": "123",
	"channelHandle": "example",
	"authorName": "Example Channel",
	"postText": "Post text shown by Telegram",
	"postDate": "2026-05-20T10:00:00+00:00",
	"viewsText": "1.2K",
	"mediaUrl": "https://cdn4.telesco.pe/file/video.mp4",
	"mediaType": "video",
	"extension": "mp4",
	"thumbnailUrl": "https://cdn4.telesco.pe/file/thumb.jpg",
	"status": "ok"
}

Rows can also have rowType: "target-status" when a target is private, missing, unsupported, or has no matching media and Include failed targets is turned on.

Pricing

This Actor uses pay-per-event pricing. You pay for each telegram-media-item saved to the dataset. The public price is $4.45 per 1,000 media items, plus the standard small Actor start charge shown by Apify before you run it.

Limits and access

This Actor works with public Telegram posts, channels, and groups. It does not use Telegram accounts, cookies, or API keys. Private Telegram links, deleted posts, and login-only content are not supported.

Telegram may show less data for some posts. In those cases, the Actor saves the fields Telegram exposes and leaves the rest empty.

FAQ

Can I download media from private Telegram channels?

No. This Actor is for public Telegram pages only. Private channels, private groups, and /c/ links are skipped.

Can I use channel handles instead of full URLs?

Yes. You can use @handle, https://t.me/handle, or https://t.me/s/handle.

Does it return files or media URLs?

It returns direct media URLs and metadata in the dataset. You can export the rows or use the URLs in your own workflow.

Can I get only Telegram videos?

Yes. Set Media types to Videos.

Why do some fields come back empty?

Telegram does not show every field on every public page. For example, a photo may not have a quality value, and some posts may not show a timestamp field.

Support

Open an issue on the Actor page if a public Telegram target does not work as expected. Include the target URL, your input settings, and what output you expected.