Build a TeraBox Downloader Telegram Bot with the TeraBox API

mkdir terabox-bot && cd terabox-bot
pip install python-telegram-bot requests python-dotenv

import os
import re
import requests
from dotenv import load_dotenv
from telegram import Update
from telegram.ext import ApplicationBuilder, CommandHandler, MessageHandler, filters, ContextTypes

load_dotenv()

TELEGRAM_TOKEN = os.getenv("TELEGRAM_TOKEN")
TERABOX_API_KEY = os.getenv("TERABOX_API_KEY")

TERABOX_PATTERN = re.compile(
    r"https?://(www.)?(terabox.com|1024terabox.com|4funbox.com)/s/\S+"
)

async def start(update: Update, ctx: ContextTypes.DEFAULT_TYPE):
    await update.message.reply_text(
        "👋 Send me any TeraBox share link and I'll give you a direct download URL!"
    )

async def handle_link(update: Update, ctx: ContextTypes.DEFAULT_TYPE):
    text = update.message.text or ""
    match = TERABOX_PATTERN.search(text)

    if not match:
        await update.message.reply_text("❌ No TeraBox link detected. Please send a valid share link.")
        return

    share_url = match.group(0)
    msg = await update.message.reply_text("⏳ Fetching your link…")

    try:
        res = requests.post(
            "https://api.teraboxdl.site/v1/api",
            headers={"X-API-Key": TERABOX_API_KEY},
            json={"url": share_url},
            timeout=15
        )
        data = res.json()
    except Exception as e:
        await msg.edit_text(f"⚠️ Network error: {e}")
        return

    if not data.get("ok"):
        await msg.edit_text(f"❌ API error: {data.get('error', 'Unknown error')}")
        return

    reply = (
        f"✅ *{data['file_name']}*\n"
        f"📦 Size: {round(data['size'] / 1_048_576, 1)} MB\n\n"
        f"[⬇️ Direct Download]({data['download_url']})\n"
        f"[▶️ HLS Stream]({data['stream_url']})"
    )
    await msg.edit_text(reply, parse_mode="Markdown", disable_web_page_preview=True)

if __name__ == "__main__":
    app = ApplicationBuilder().token(TELEGRAM_TOKEN).build()
    app.add_handler(CommandHandler("start", start))
    app.add_handler(MessageHandler(filters.TEXT & ~filters.COMMAND, handle_link))
    print("Bot is running…")
    app.run_polling()

python bot.py