TeraBox API Documentation

# API Overview

The TeraBox API resolves any shared TeraBox link into download links, HLS streams (up to 1080p fast / 4K detection), multi-language M3U8 subtitles and complete metadata — all in a single POST request.

# Base URL & Authentication

Every request must carry your personal xAPI-Key header. Create or manage keys in your dashboard → API Keys. Keys are secret — keep them server-side, never in browser code.

# Quick Start

1. Sign up — receive 100 free request credits.
2. Generate an xAPI-Key in the dashboard.
3. POST a TeraBox link → consume the returned stream_url / fast_stream_url / normal_dlink.

You are only charged when the API returns "status": "success" with HTTP 200. Errors are free.

# Resolve a TeraBox Link

Request body

# Code Examples

curl -X POST "https://teraboxdevapi.in/api/terabox" \
  -H "Content-Type: application/json" \
  -H "xAPI-Key: tbx_xxxxxxxx" \
  -d '{"url":"https://1024terabox.com/s/1jV4tzRwAj_9sTwW7b30sXQ"}'

const response = await fetch("https://teraboxdevapi.in/api/terabox", {
  method: "POST",
  headers: {
    "Content-Type": "application/json",
    "xAPI-Key": "tbx_xxxxxxxx"
  },
  body: JSON.stringify({
    url: "https://1024terabox.com/s/1jV4tzRwAj_9sTwW7b30sXQ"
  })
});
const result = await response.json();
console.log(result);

import requests

url = "https://teraboxdevapi.in/api/terabox"
payload = {"url": "https://1024terabox.com/s/1jV4tzRwAj_9sTwW7b30sXQ"}
headers = {
    "Content-Type": "application/json",
    "xAPI-Key": "tbx_xxxxxxxx"
}

response = requests.post(url, json=payload, headers=headers)
print(response.json())

<?php
$curl = curl_init();

curl_setopt_array($curl, [
    CURLOPT_URL => "https://teraboxdevapi.in/api/terabox",
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_POST => true,
    CURLOPT_POSTFIELDS => json_encode([
        "url" => "https://1024terabox.com/s/1jV4tzRwAj_9sTwW7b30sXQ"
    ]),
    CURLOPT_HTTPHEADER => [
        "Content-Type: application/json",
        "xAPI-Key: tbx_xxxxxxxx"
    ]
]);

$response = curl_exec($curl);
curl_close($curl);
echo $response;

# Success Response

{
    "list": [
        {
            "name": "video_example.mp4",
            "size": 43162336,
            "type": "video",
            "folder": "root",
            "is_dir": "0",
            "quality": "480p",
            "duration": "09:16",
            "file_path": "/video_example.mp4",
            "thumbnail": "https://teraboxdevapi.in/api/thumbnail?token=\u2026",
            "stream_url": "https://teraboxdevapi.in/api/stream?token=\u2026",
            "normal_dlink": "https://teraboxdevapi.in/api/download?token=\u2026",
            "subtitle_url": "https://teraboxdevapi.in/api/subtitle?token=\u2026",
            "size_formatted": "41.16 MB",
            "fast_stream_url": {
                "360p": "https://teraboxdevapi.in/api/fast_stream?token=\u2026360.m3u8",
                "480p": "https://teraboxdevapi.in/api/fast_stream?token=\u2026480.m3u8",
                "720p": "https://teraboxdevapi.in/api/fast_stream?token=\u2026720.m3u8",
                "1080p": "https://teraboxdevapi.in/api/fast_stream?token=\u20261080.m3u8"
            }
        }
    ],
    "status": "success",
    "total_files": 1,
    "total_folders": "0"
}

# Response Fields

# Error Codes

Error responses look like {"status":"error","message":"..."}. Errors are never charged.

# Check Your Balance

curl "https://teraboxdevapi.in/api/balance.php" -H "xAPI-Key: tbx_xxxxxxxx"

# → {"status":"success","credits":12500,"level":1,
#    "lifetime_requests":3215,"updated_at":"..."}

# Video Player Integration

Feed fast_stream_url["1080p"] (or the master stream_url) straight into any HLS-capable player — video.js, Plyr, hls.js, ArtPlayer, Telegram inline players:

hls.js example:

const video = document.querySelector('video');
const hls = new Hls();
hls.loadSource(item.fast_stream_url['1080p']); // or item.stream_url
hls.attachMedia(video);
video.play();

// subtitles (multi-language M3U8)
video.appendChild(new VTTCue…); // or track src = item.subtitle_url

# Telegram Bot Recipe

import requests, telebot  # pyTelegramBotAPI

BOT = telebot.Telebot("YOUR_BOT_TOKEN")

@BOT.message_handler(func=lambda m: "terabox" in (m.text or ""))
def handle(m):
    r = requests.post("https://teraboxdevapi.in/api/terabox",
        json={"url": m.text.strip().split()[0]},
        headers={"xAPI-Key": "tbx_xxxxxxxx"}).json()
    if r.get("status") == "success":
        f = r["list"][0]
        BOT.send_video(m.chat.id, f["fast_stream_url"]["720p"],
                       caption=f"{f['name']} · {f['size_formatted']} · {f['quality']}")
    else:
        BOT.reply_to(m, r.get("message", "Failed to resolve link."))

# Rate Limits & Pricing

• 60 requests/minute per key — request higher limits on Telegram.
• $0.00008 per request at Level 1 → 12,500 requests for $1 / ₹90.00.
• Level 2 (500K lifetime requests): $0.00007 → 14,285 per $1. Level 3 (1M): $0.00006 → 16,666 per $1.
• Credits have lifetime validity — they only reduce with usage, never with time.