Dokumentasi API

TeraBox Downloader API

Satu endpoint untuk ambil direct download link dari share URL TeraBox — termasuk folder dan file berpassword. Semua response dalam JSON, panggil pakai HTTP GET.

Base URL https://api.dockhub.dev v3.0.5

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.

CORS terbuka untuk semua origin (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:

CaraContoh
Query param?apikey=API_KEY_KAMU
HeaderX-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.

Jangan expose API key di kode frontend publik. Kalau app-nya client-side, proxy request lewat backend kamu sendiri biar key gak kelihatan di network tab.

Quick Start

Contoh paling minimal — extract satu link TeraBox pakai cURL:

terminal
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=:

terminal
curl "https://api.dockhub.dev/terabox?url=https://1024terabox.com/s/xxxxx&pwd=1234&apikey=API_KEY_KAMU"

Extract Link

GET/terabox Perlu API key

Endpoint utama. Kirim share URL TeraBox, dapat balik daftar file beserta direct download link-nya.

Query Parameters

NamaWajibKeterangan
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

200 OK
{
  "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

200 OK · status: error
{
  "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": [ "..." ]
}
Perhatikan: kalau ekstraksi gagal, HTTP status tetap 200, cek field status dan hint di body buat tau alasannya — bukan dari status code.

Info API

GET/api Publik

Endpoint informasi — versi, status server, dan daftar endpoint yang tersedia. Gak perlu API key.

200 OK
{
  "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)

GET/terabox/dl Auto-generated

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.

NamaKeterangan
urlbase64Dlink asli TeraBox, di-encode base64url.
cookiebase64Cookie sesi yang dipakai buat scrape dlink tersebut — wajib sama, karena dlink TeraBox terikat ke sesi/IP yang men-generate-nya.
Link ini biasanya expire setelah beberapa waktu. Kalau sudah kadaluarsa, panggil ulang /terabox buat dapat download_link yang baru — jangan simpan link ini jangka panjang.

Response Object

Field lengkap yang muncul di response /terabox:

FieldTipeKeterangan
statusstring"success" kalau ada file ketemu, "error" kalau tidak.
sourcestringAsal sesi yang dipakai — informasi internal, bisa diabaikan.
request_urlstringURL persis yang kamu kirim di parameter url.
extracted_shorturlstringKode short-URL yang berhasil diparse dari link kamu.
is_privatebooleantrue kalau kamu mengirim parameter pwd.
total_filesnumberJumlah file yang ditemukan (termasuk isi folder, sudah di-flatten).
files[]arrayDaftar file — lihat tabel di bawah.
hintstring | nullPenjelasan human-readable kalau ekstraksi gagal/kosong. Lihat bagian Hint Messages.
debugarrayLog internal proses scraping — berguna buat lapor bug, bukan buat dipakai di UI.

Objek files[]

FieldTipeKeterangan
filenamestringNama file asli.
sizestringUkuran file dalam bytes (dikirim sebagai string angka).
pathstringPath relatif file di dalam struktur folder TeraBox.
thumbnailstring | nullURL thumbnail, cuma ada untuk file media (gambar/video).
download_linkstringDirect 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).

200
OKRequest valid. Cek field status di body — bisa tetap "error" kalau ekstraksi TeraBox-nya gagal.
400
Bad RequestParameter url tidak ada atau formatnya tidak valid / tidak bisa di-parse.
401
UnauthorizedAPI key tidak ada atau tidak valid. Cek parameter apikey atau header X-API-Key.
500
Internal Server ErrorError tak terduga di server. Coba lagi, dan kalau berulang laporkan lewat Telegram.
502
Bad GatewayKhusus di /terabox/dl — server gagal menghubungi server TeraBox untuk streaming file.

Format body error (400 / 401 / 500)

error body
{
  "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:

SituasiArtinya
File tanpa pwdFile terdeteksi tapi butuh kode ekstraksi — kirim ulang dengan parameter &pwd=.
File dengan pwd salahKode ekstraksi yang dikirim salah, atau sesi TeraBox sedang rate-limited — coba lagi sebentar.
errno 2Link sudah dihapus atau kadaluarsa.
Tidak ada fileLink 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

HalKeterangan
Timeout scanProses scan folder punya batas waktu ~25 detik. Folder besar bisa balik hasil parsial.
Retry otomatisKalau sesi TeraBox ketolak, server otomatis coba ulang dengan sesi baru (maksimal 3x) sebelum nyerah.
Rate limitGak ada limit jumlah request per key saat ini, tapi pemakaian wajar biar sesi TeraBox gak cepat kena block.
FolderKalau URL yang dikirim adalah folder, semua file di dalamnya (termasuk sub-folder) otomatis di-flatten ke dalam files[].
Butuh key baru atau nemu bug? Kontak lewat @todict di Telegram.