How to build a Telegram video downloader bot

aiogram talks to Telegram, httpx makes the API call. Nothing else is needed on your side: there is no scraping stack, no headless browser and no cookie jar to keep alive.

pip install aiogram httpx

One GET with your key in the Authorization header. The endpoint detects the platform from the URL itself, so the bot does not branch on the domain — an Instagram reel, a TikTok video and a Likee clip all go through this same function.

import httpx

API = "https://api.saveapi.org/v1/download"
KEY = "sk_live_xxxx"

client = httpx.AsyncClient(timeout=30)

async def resolve(link: str) -> dict:
    r = await client.get(
        API,
        params={"url": link},
        headers={"Authorization": f"Bearer {KEY}"},
    )
    return r.json()

The response tells you what it is. Check medias[0].type instead of assuming a video: a TikTok slideshow and an Instagram carousel come back as images, and a Telegram bot has to call a different method for those. meta.title makes a reasonable caption.

from aiogram import Bot, Dispatcher, F
from aiogram.types import Message

dp = Dispatcher()

@dp.message(F.text.startswith("http"))
async def on_link(message: Message):
    data = await resolve(message.text.strip())

    if not data["success"]:
        await message.answer(EXPLAIN.get(data["error"]["code"], "Try another link."))
        return

    media = data["medias"][0]
    if media["type"] == "video":
        await message.answer_video(media["url"], caption=data["meta"]["title"])
    else:
        await message.answer_photo(media["url"])

Users paste private posts and dead links all day. Map the stable error codes to sentences a person understands — a bot that says "That account is private" gets a different link, a bot that says "Error 403" gets an angry message. A private post or one with no media costs 0.1 credits instead of the full 1.5.

EXPLAIN = {
    "PRIVATE_CONTENT": "That account is private — I can only fetch public posts.",
    "MEDIA_NOT_FOUND": "That post has no media, or it was deleted.",
    "UNSUPPORTED_PLATFORM": "I do not know that site yet.",
    "QUOTA_EXCEEDED": "Out of credits for today.",
    "UPSTREAM_TIMEOUT": "The source was slow. Send the link again.",
}

Once Telegram has the file it gives you a file_id, and re-sending that costs nothing and uploads nothing. The media URL is the wrong thing to store: source CDNs sign their links and expire them within hours, so a cache of URLs turns into a cache of 403s overnight.

sent = await message.answer_video(media["url"])
file_id = sent.video.file_id      # BU saqlanadi, media["url"] emas

# Keyingi safar o'sha post so'ralsa:
await message.answer_video(file_id)

Telegram fetches the URL itself, and sometimes the source CDN refuses it — most often for Instagram, and always in a media group. Catch that case, download the bytes yourself and upload them. The 50 MB bot upload limit still applies, which is why this is a fallback and not the default path.

from aiogram.types import BufferedInputFile

async def send_bytes(message: Message, url: str):
    r = await client.get(url, follow_redirects=True)
    file = BufferedInputFile(r.content, filename="video.mp4")
    await message.answer_video(file)