Features API Providers Pricing Documentation FAQ Login Sign Up

PlayTeraBox API

PlayTeraBox extracts metadata, download links and streaming URLs from TeraBox links with under 200ms response time and 4K HLS streaming support.

On this page
Overview ยท Authentication ยท Parameters ยท Code samples ยท Responses ยท Errors ยท Rate limits

API Overview

Make a GET request to the proxy endpoint with your API key as the secret parameter and the TeraBox URL as the url parameter. The API returns a JSON object containing a list array with file details.

โœ”
Success guarantee โ€” you are only charged for requests that return a successful 200 OK status. Errors are on us.

Key Features

  • Under 200ms response time โ€” one of the fastest TeraBox APIs available.
  • 4K HLS streaming support โ€” stream at 360p, 480p, 720p and beyond.
  • Fast download links โ€” both normal and fast download URLs returned.
  • Subtitles & thumbnails โ€” subtitle URL and thumbnail URL included.
  • No artificial rate limits โ€” send as many requests as you need.
  • Pay-as-you-go โ€” usage only limited by your wallet balance.

Authentication

All API requests are authenticated with your personal API key. Get your key instantly from the developer dashboard.

KeyValue
AuthorizationBearer YOUR_API_KEY
Content-Typeapplication/json (POST)
โš 
Keep your API key secure. Never expose it in client-side code or public repositories.

Request Credits

Each successful request deducts 2 credits (provider rate $0.000100/request). Credits never expire and only reduce with usage.

๐Ÿ’Ž
Lifetime validity โ€” no 30-day expiry. Buy from โ‚น90 = 10,000 requests and stack anytime.

Endpoint

MethodEndpointDescription
POSThttps://teraboxdevapi.in/api/terabox.phpExtract TeraBox link data (JSON body)
GEThttps://teraboxdevapi.in/api/terabox.php?url=...&key=...Query-string alternative

Query Parameters

ParameterTypeRequiredDescription
urlstringYesThe TeraBox file or folder URL to process (e.g. https://terabox.com/s/...)
providerstringNoSet to playterabox to force this provider (default when using X-Provider: playterabox)
keystringAltAPI key alternative to the Authorization header

cURL Example

# GET request (query-string style)
curl -G "https://teraboxdevapi.in/api/terabox.php" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  --data-urlencode "url=https://1024terabox.com/s/1sMvGvA-DkxjhpC1AS3uLlg" \
  --data-urlencode "provider=playterabox"
curl -X POST "https://teraboxdevapi.in/api/terabox.php" \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "X-Provider: playterabox" \
  -d '{"url":"https://1024terabox.com/s/1sMvGvA-DkxjhpC1AS3uLlg"}'
const res = await fetch('https://teraboxdevapi.in/api/terabox.php', {
  method: 'POST',
  headers: {
    'Content-Type': 'application/json',
    'Authorization': 'Bearer YOUR_API_KEY',
    'X-Provider': 'playterabox'
  },
  body: JSON.stringify({ url: 'https://1024terabox.com/s/1sMvGvA-DkxjhpC1AS3uLlg' })
});
const data = await res.json();
console.log(data);
import requests

url = "https://teraboxdevapi.in/api/terabox.php"
headers = { "Authorization": "Bearer YOUR_API_KEY", "X-Provider": "playterabox" }
params = { "url": "https://1024terabox.com/s/1sMvGvA-DkxjhpC1AS3uLlg" }
res = requests.post(url, json=params, headers=headers)
print(res.json())
<?php
$ch = curl_init();
curl_setopt_array($ch, [
    CURLOPT_URL => "https://teraboxdevapi.in/api/terabox.php",
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_POST => true,
    CURLOPT_POSTFIELDS => json_encode(["url" => "https://1024terabox.com/s/1sMvGvA-DkxjhpC1AS3uLlg"]),
    CURLOPT_HTTPHEADER => ["Content-Type: application/json", "Authorization: Bearer YOUR_API_KEY", "X-Provider: playterabox"]
]);
$res = curl_exec($ch);
curl_close($ch);
echo $res;

PHP (cURL) โ€” GET style

<?php
$baseUrl = "https://teraboxdevapi.in/api/terabox.php";
$params = http_build_query([
    'url' => 'https://1024terabox.com/s/1sMvGvA-DkxjhpC1AS3uLlg',
    'provider' => 'playterabox'
]);

$ch = curl_init($baseUrl . '?' . $params);
curl_setopt_array($ch, [
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_HTTPHEADER => ["Authorization: Bearer YOUR_API_KEY"]
]);
$response = curl_exec($ch);
curl_close($ch);
echo $response;

Response Structure

The API returns a JSON object containing the list array with file details.

Example Response

// Example Response
{
  "status": "success",
  "total_files": 1,
  "list": [
    {
      "fs_id": 1234567890,
      "name": "example_video.mp4",
      "size": 98085682,
      "size_formatted": "93.54 MB",
      "type": "video",
      "is_dir": "0",
      "duration": "10:18",
      "quality": "720p",
      "download_link": "https://.../download?token=...",
      "fast_download_link": "https://.../download?token=...",
      "stream_url": "https://.../stream?token=...",
      "fast_stream_url": {
        "360p": "https://.../fast_stream?token=...m3u8",
        "480p": "https://.../fast_stream?token=...m3u8",
        "720p": "https://.../fast_stream?token=...m3u8"
      },
      "subtitle_url": "https://.../subtitle?token=...",
      "thumbnail": "https://.../thumbnail?token=...",
      "folder": "root"
    }
  ]
}

Response Fields

FieldTypeDescription
statusstring"success" or "error"
total_filesintegerNumber of files in the response
fs_idintegerTeraBox file ID
namestringOriginal file name
size / size_formattedint / stringFile size in bytes and human-readable format
typestringFile type (video, audio, document, etc.)
is_dirstring"0" = file, "1" = folder
durationstringVideo duration in MM:SS format
qualitystringVideo resolution (up to 4K supported)
download_linkstringNormal download link
fast_download_linkstringFast download link
stream_urlstringPrimary stream URL
fast_stream_urlobjectHLS m3u8 streams per quality (360p/480p/720p+)
subtitle_urlstringSubtitle file URL
thumbnailstringVideo thumbnail URL

Error Handling

API errors return JSON with status and message. Common error codes:

CodeMeaning
401Invalid or missing API key
402Insufficient credit balance โ€” top up now
403Key disabled / account suspended / not subscribed to this API
422Invalid request parameters
429Too many requests in a short window
500Upstream provider error โ€” you are not charged

Rate Limits

  • No artificial rate limits on your API usage.
  • No request limits โ€” send as many requests as you need.
  • Pay-as-you-go โ€” usage is only limited by your credit balance.
  • High performance โ€” infrastructure scales for high concurrency.

Ready to integrate PlayTeraBox?

Buy lifetime credits and get your key instantly.

๐Ÿ’Ž Top Up Credits