Overview
TeraBox Downloader API itu REST API sederhana buat scrape share link TeraBox dan balikin direct download link-nya — tanpa iklan, tanpa redirect. Support file tunggal, folder isi banyak file, dan link yang dikunci password.
Server otomatis handle sesi & token TeraBox di belakang layar (scraping cookie, jsToken, retry kalau sesi mati), jadi dari sisi kamu tinggal kirim satu request GET dan terima JSON berisi daftar file + link download-nya.
Access-Control-Allow-Origin: *), jadi API ini aman dipanggil langsung dari browser / frontend kamu.Autentikasi
Semua request ke /terabox wajib bawa API key. Kirim salah satu dari dua cara ini:
| Cara | Contoh |
|---|---|
| Query param | ?apikey=API_KEY_KAMU |
| Header | X-API-Key: API_KEY_KAMU |
Request tanpa key atau dengan key yang salah bakal ditolak dengan status 401 Unauthorized. API key kamu dapat dari admin ACCEL MARKET — hubungi lewat Telegram kalau belum punya.
Quick Start
Contoh paling minimal — extract satu link TeraBox pakai cURL:
curl "https://api.dockhub.dev/terabox?url=https://1024terabox.com/s/1HcZ4bbKShOS8o69NX7MXFg&apikey=API_KEY_KAMU"
Kalau link-nya butuh kode ekstraksi / password, tambah parameter &pwd=:
curl "https://api.dockhub.dev/terabox?url=https://1024terabox.com/s/xxxxx&pwd=1234&apikey=API_KEY_KAMU"
Extract Link
Endpoint utama. Kirim share URL TeraBox, dapat balik daftar file beserta direct download link-nya.
Query Parameters
| Nama | Wajib | Keterangan |
|---|---|---|
| urlstring | wajib | Share URL TeraBox lengkap, contoh https://1024terabox.com/s/xxxxx. Domain lain seperti terabox.app, terabox.com juga didukung. |
| pwdstring | opsional | Kode ekstraksi, kalau link-nya di-lock password oleh pemilik file. |
| apikeystring | wajib* | API key kamu. *Bisa juga dikirim lewat header X-API-Key alih-alih query param. |
Contoh Response — Sukses
{
"author": "ACCEL MARKET",
"contact": "https://t.me/todict",
"status": "success",
"source": "Terabox",
"request_url": "https://1024terabox.com/s/1HcZ4bbKShOS8o69NX7MXFg",
"extracted_shorturl": "1HcZ4bbKShOS8o69NX7MXFg",
"is_private": false,
"total_files": 1,
"files": [
{
"filename": "video-sample.mp4",
"size": "104857600",
"path": "/video-sample.mp4",
"thumbnail": "https://data.1024tera.com/thumbnail/...",
"download_link": "https://api.dockhub.dev/terabox/dl?url=...&cookie=..."
}
],
"hint": null,
"debug": []
}
Contoh Response — Gagal
{
"author": "ACCEL MARKET",
"contact": "https://t.me/todict",
"status": "error",
"source": "SCRAPED_NEW",
"request_url": "https://1024terabox.com/s/xxxxx",
"extracted_shorturl": "xxxxx",
"is_private": true,
"total_files": 0,
"files": [],
"hint": "File terdeteksi tapi TeraBox tidak memberikan link unduhan (dlink). Ini biasanya berarti link tersebut membutuhkan kode ekstraksi (password).",
"debug": [ "..." ]
}
200, cek field status dan hint di body buat tau alasannya — bukan dari status code.Info API
Endpoint informasi — versi, status server, dan daftar endpoint yang tersedia. Gak perlu API key.
{
"author": "ACCEL MARKET",
"contact": "https://t.me/todict",
"service": "TeraBox Apis Faster",
"version": "3.0.5",
"status": "online",
"endpoints": {
"terabox": "/terabox?url=TERABOX_URL&apikey=YOUR_KEY",
"terabox_with_pwd": "/terabox?url=TERABOX_URL&pwd=PASSWORD&apikey=YOUR_KEY"
}
}
Download Proxy (internal)
Ini bukan endpoint yang biasanya kamu panggil manual. Nilai download_link di setiap objek file pada response /terabox sudah lengkap berisi endpoint ini plus parameter url & cookie yang ter-encode base64 — tinggal buka linknya untuk streaming/download file-nya langsung.
| Nama | Keterangan |
|---|---|
| urlbase64 | Dlink asli TeraBox, di-encode base64url. |
| cookiebase64 | Cookie sesi yang dipakai buat scrape dlink tersebut — wajib sama, karena dlink TeraBox terikat ke sesi/IP yang men-generate-nya. |
/terabox buat dapat download_link yang baru — jangan simpan link ini jangka panjang.Response Object
Field lengkap yang muncul di response /terabox:
| Field | Tipe | Keterangan |
|---|---|---|
| status | string | "success" kalau ada file ketemu, "error" kalau tidak. |
| source | string | Asal sesi yang dipakai — informasi internal, bisa diabaikan. |
| request_url | string | URL persis yang kamu kirim di parameter url. |
| extracted_shorturl | string | Kode short-URL yang berhasil diparse dari link kamu. |
| is_private | boolean | true kalau kamu mengirim parameter pwd. |
| total_files | number | Jumlah file yang ditemukan (termasuk isi folder, sudah di-flatten). |
| files[] | array | Daftar file — lihat tabel di bawah. |
| hint | string | null | Penjelasan human-readable kalau ekstraksi gagal/kosong. Lihat bagian Hint Messages. |
| debug | array | Log internal proses scraping — berguna buat lapor bug, bukan buat dipakai di UI. |
Objek files[]
| Field | Tipe | Keterangan |
|---|---|---|
| filename | string | Nama file asli. |
| size | string | Ukuran file dalam bytes (dikirim sebagai string angka). |
| path | string | Path relatif file di dalam struktur folder TeraBox. |
| thumbnail | string | null | URL thumbnail, cuma ada untuk file media (gambar/video). |
| download_link | string | Direct download link siap pakai — lihat Download Proxy. |
Error & Status Code
API pakai kombinasi HTTP status code (untuk error request-level) dan field status/hint di body (untuk error proses ekstraksi).
status di body — bisa tetap "error" kalau ekstraksi TeraBox-nya gagal.url tidak ada atau formatnya tidak valid / tidak bisa di-parse.apikey atau header X-API-Key./terabox/dl — server gagal menghubungi server TeraBox untuk streaming file.Format body error (400 / 401 / 500)
{
"author": "ACCEL MARKET",
"message": "error",
"error": "Unauthorized: Invalid or missing API key"
}
Hint Messages
Kalau total_files kosong, field hint ngasih tau kenapa. Ini yang paling sering muncul:
| Situasi | Artinya |
|---|---|
File tanpa pwd | File terdeteksi tapi butuh kode ekstraksi — kirim ulang dengan parameter &pwd=. |
File dengan pwd salah | Kode ekstraksi yang dikirim salah, atau sesi TeraBox sedang rate-limited — coba lagi sebentar. |
| errno 2 | Link sudah dihapus atau kadaluarsa. |
| Tidak ada file | Link kadaluarsa, dihapus pemilik, atau butuh password. |
Contoh Kode
Implementasi request ke /terabox dalam beberapa bahasa.
curl -G "https://api.dockhub.dev/terabox" \
--data-urlencode "url=https://1024terabox.com/s/1HcZ4bbKShOS8o69NX7MXFg" \
--data-urlencode "apikey=API_KEY_KAMU"
const params = new URLSearchParams({
url: "https://1024terabox.com/s/1HcZ4bbKShOS8o69NX7MXFg",
apikey: "API_KEY_KAMU"
});
const res = await fetch(`https://api.dockhub.dev/terabox?${params}`);
const data = await res.json();
if (data.status === "success") {
data.files.forEach(f => console.log(f.filename, f.download_link));
} else {
console.log("Gagal:", data.hint);
}
import requests
res = requests.get("https://api.dockhub.dev/terabox", params={
"url": "https://1024terabox.com/s/1HcZ4bbKShOS8o69NX7MXFg",
"apikey": "API_KEY_KAMU",
})
data = res.json()
if data["status"] == "success":
for f in data["files"]:
print(f["filename"], f["download_link"])
else:
print("Gagal:", data["hint"])
const params = new URLSearchParams({
url: "https://1024terabox.com/s/1HcZ4bbKShOS8o69NX7MXFg",
apikey: "API_KEY_KAMU",
});
const data = await fetch(`https://api.dockhub.dev/terabox?${params}`)
.then(r => r.json());
if (data.status === "success") {
for (const f of data.files) console.log(f.filename, f.download_link);
} else {
console.log("Gagal:", data.hint);
}
Catatan & Limit
| Hal | Keterangan |
|---|---|
| Timeout scan | Proses scan folder punya batas waktu ~25 detik. Folder besar bisa balik hasil parsial. |
| Retry otomatis | Kalau sesi TeraBox ketolak, server otomatis coba ulang dengan sesi baru (maksimal 3x) sebelum nyerah. |
| Rate limit | Gak ada limit jumlah request per key saat ini, tapi pemakaian wajar biar sesi TeraBox gak cepat kena block. |
| Folder | Kalau URL yang dikirim adalah folder, semua file di dalamnya (termasuk sub-folder) otomatis di-flatten ke dalam files[]. |