Bestdebrid

Documentazione API

Sblocca link premium, espandi cartelle e playlist, gestisci i torrent e integra BestDebrid nelle tue applicazioni. Riferimento completo degli endpoint REST della build 1.07.

JSON via HTTPS Chiave API 70 link / 24 h Build 1.07
In questa pagina

Introduzione

L'API BestDebrid è un'interfaccia REST che restituisce JSON via HTTPS. La maggior parte degli endpoint accetta GET e POST, con parametri in query string o nel corpo della richiesta.

Le tabelle tecniche (parametri, campi, esempi di codice) sono in inglese.

URL di base

https://bestdebrid.com/api/v1

Struttura della risposta

Ogni endpoint restituisce un oggetto JSON con un intero error (0 = successo) e un message: testo leggibile in caso di errore, oppure il payload (stringa, array, oggetto) in caso di successo. Gli endpoint più ricchi aggiungono i propri campi accanto a error.

{
  "error": 0,
  "message": "OK"
  // additional fields depending on the endpoint
}

Autenticazione

Tutti gli endpoint tranne /, /time e /regex richiedono la tua chiave API. Due modi per inviarla:

Opzione 1 — header HTTP (consigliato)

Authorization: YOUR_API_KEY

Opzione 2 — query string

?auth=YOUR_API_KEY
Dove trovare la chiave: accedi, è mostrata nel tuo profilo (sezione API). Rigenerala in qualsiasi momento con /newkey. /newkey
Tieni segreta la chiave. Non esporla mai in codice lato client, repository pubblici o estensioni distribuite. In caso di fuga, rigenerala subito.
La tua chiave API per le prove Usata dai blocchi «Prova» di questa pagina, mai salvata.

Gestione degli errori

Il campo error indica l'esito. Un valore diverso da zero è accompagnato da un message descrittivo. I codici sono riutilizzati tra endpoint; il significato è nel messaggio.

0Successo — la richiesta è stata completata.
1Parametro mancante o non valido (link vuoto, chiave API errata, password mancante).
2Formato URL non valido — il link deve iniziare con http:// o https://.
3Link non supportato, magnet non valido o utente non connesso.
4Gli account gratuiti non possono sbloccare questo hoster (solo premium).
5Troppi torrent attivi (max 5) o errore del server torrent.
6Limite giornaliero gratuito raggiunto, torrent duplicato o hoster in manutenzione.
7Dimensione del file oltre il limite gratuito, o errore nella generazione del link.
8Dimensione del torrent non determinabile, o torrent oltre 90 GiB.
9Quota dell'hoster raggiunta prima della generazione (link giornalieri su questo hoster).
10Generazione fallita — l'hoster ha restituito un errore.
19Limite dell'hoster raggiunto dopo la generazione del link.
21Piano premium richiesto per l'accesso API.
22Accesso API bloccato su questo account.
55Servizio in manutenzione, o tipo di parametro non valido (es. isFile non numerico).
56Indirizzo IP non valido, tempo di attesa non trascorso, o quota giornaliera gratuita.
121Quota giornaliera di download raggiunta (70 link unici / 24 h).
122Troppi sblocchi in corso — riprova tra ~1 min.
632VPN/proxy rilevato (vietato per gli account gratuiti).
Quota giornaliera: ogni account è limitato a 70 file unici ogni 24 h, web e API inclusi (errore 121). Anche gli sblocchi in corso contano (errore 122).

Radice — elenco degli endpoint

Restituisce un array JSON di stringhe che descrivono ogni endpoint della build corrente. Utile per verifiche rapide.

GEThttps://bestdebrid.com/api/v1/
Nessuna autenticazione richiesta.

Esempio di risposta

[
  "time ( function : time of bestdebrid.com )",
  "newkey ( function : renew api key, params [ auth=apikey, pass=password of account ] )",
  "user ( function : user infos, params [ auth=apikey ] )",
  "...",
  "** api build [1.07]  **"
]
Prova

Esempi di codice

curl https://bestdebrid.com/api/v1/
<?php
$data = json_decode(file_get_contents('https://bestdebrid.com/api/v1/'), true);
print_r($data);
const res  = await fetch('https://bestdebrid.com/api/v1/');
const data = await res.json();
console.log(data);

Ora del server

Restituisce l'ora corrente del server. Utile per sincronizzare i client o rilevare derive dell'orologio.

GEThttps://bestdebrid.com/api/v1/time
Nessuna autenticazione richiesta.

Esempio di risposta

{
  "error": 0,
  "message": "2025-04-19 14: 22: 03"
}
Prova

Esempi di codice

curl https://bestdebrid.com/api/v1/time
<?php
$res = file_get_contents('https://bestdebrid.com/api/v1/time');
echo json_decode($res, true)['message'];
const r = await fetch('https://bestdebrid.com/api/v1/time');
console.log((await r.json()).message);

Espressioni regolari degli hoster

Restituisce l'elenco delle espressioni regolari (PCRE) che riconoscono i link supportati. Permette di filtrare gli URL lato client prima di chiamare /generateLink.

GEThttps://bestdebrid.com/api/v1/regex
Nessuna autenticazione richiesta.

Schema della risposta

CampoTipoDescrizione
[]string[]Flat JSON array of PCRE patterns (PHP preg_match syntax, with delimiters). The last pattern matches base64-encoded http(s):// links.

Esempio di risposta

[
  "/(http|https):\\/\\/(\\w+\\.)?rapidgator\\.net\\/file\\/[0-9a-z]+/",
  "/(http|https):\\/\\/(\\w+\\.)?gofile\\.io\\/d\\/[0-9A-Za-z]+/",
  "..."
]
Client-side filtering: patterns use PHP delimiters (/…/). Strip the leading and trailing slash before feeding them to another regex engine.
Prova

Esempi di codice

curl https://bestdebrid.com/api/v1/regex
<?php
$patterns = json_decode(file_get_contents('https://bestdebrid.com/api/v1/regex'), true);
$supported = false;
foreach ($patterns as $re) {
    if (preg_match($re, $url)) { $supported = true; break; }
}
const patterns = await (await fetch('https://bestdebrid.com/api/v1/regex')).json();
const supported = patterns.some(p => new RegExp(p.slice(1, -1)).test(url));

Informazioni utente

Restituisce il profilo dell'utente autenticato: stato premium, scadenza e se l'account bypassa i limiti API.

GEThttps://bestdebrid.com/api/v1/user

Parametri

ParametroTipoDescrizione
authobbligatoriostringYour API key — as Authorization header or ?auth= query param.

Schema della risposta

CampoTipoDescrizione
errorinteger0 on success, 1 if the key is invalid.
usernamestringAccount username.
emailstringAccount email.
creditintegerRemaining credits on the account.
IDintegerInternal user ID.
premiumbooleantrue if the account has an active premium plan (expire in the future).
expirestring|nullPremium expiry date in Y-m-d H:i:s, or null if not premium.
bypass_api_limitbooleantrue for accounts allowed to bypass per-host unrestrict limits.

Esempio di risposta

{
  "error": 0,
  "username": "john_doe",
  "email": "john@example.com",
  "credit": 0,
  "ID": 12345,
  "premium": true,
  "expire": "2026-09-14 10: 20: 00",
  "bypass_api_limit": false
}
Prova

Esempi di codice

curl -H 'Authorization: YOUR_API_KEY' \
  https://bestdebrid.com/api/v1/user
<?php
$ctx = stream_context_create(['http' => ['header' => "Authorization: YOUR_API_KEY\r\n"]]);
$user = json_decode(file_get_contents('https://bestdebrid.com/api/v1/user', false, $ctx), true);
const res  = await fetch('https://bestdebrid.com/api/v1/user', {
  headers: { 'Authorization': 'YOUR_API_KEY' }
});
const user = await res.json();

Rigenera la chiave API

Genera una nuova chiave API. La precedente è invalidata immediatamente. Restituisce la stringa letterale true in caso di successo.

GEThttps://bestdebrid.com/api/v1/newkey

Parametri

ParametroTipoDescrizione
authobbligatoriostringYour current API key (or Authorization header).
passobbligatoriostringYour account password (or Password-X header). Confirms the rotation.

Esempi di risposta

// Success (plain text, not JSON)
true

// Failure
{
  "error": 0,
  "message": "Invalid credentials"
}
Headers alternative: the key is also accepted as Authorization and the password as Password-X. When both headers and query params are present, headers win.
Note: on failure the envelope currently returns "error": 0 with an error message — test the body for the literal true rather than the error field.
Azione irreversibile: nessun blocco «Prova» per questo endpoint.

Esempi di codice

curl -H 'Authorization: YOUR_API_KEY' -H 'Password-X: YOUR_PASSWORD' \
  https://bestdebrid.com/api/v1/newkey
<?php
$ctx = stream_context_create(['http' => ['header' => "Authorization: YOUR_API_KEY\r\nPassword-X: YOUR_PASSWORD\r\n"]]);
$res = file_get_contents('https://bestdebrid.com/api/v1/newkey', false, $ctx);

if (trim($res) === 'true') {
    // success — read the new key from your profile page
}
const res = await fetch('https://bestdebrid.com/api/v1/newkey', {
  headers: { 'Authorization': 'YOUR_API_KEY', 'Password-X': 'YOUR_PASSWORD' }
});
const ok = (await res.text()).trim() === 'true';

Cronologia dei download

Restituisce gli ultimi link sbloccati dell'utente come oggetto indicizzato da "1" (non un array JSON).

GEThttps://bestdebrid.com/api/v1/downloadsHistory

Parametri

ParametroTipoDescrizione
authobbligatoriostringYour API key — as Authorization header or ?auth= query param.
numfacoltativointegerNumber of entries to return. Default 10, capped at 300.

Schema della risposta (per voce)

CampoTipoDescrizione
namestringFilename of the downloaded file.
linkstringGenerated unrestricted download link.
originalstringOriginal hoster URL you submitted.
ipstringClient IP that triggered the download.
datestringTimestamp Y-m-d H:i:s.

Esempio di risposta

{
  "1": {
    "name": "Video.mkv",
    "link": "https://debrid2.bestdebrid.com/dl/TY/abc.../Video.mkv",
    "original": "https://rapidgator.net/file/abc123",
    "ip": "1.2.3.4",
    "date": "2025-04-18 22: 13: 07"
  },
  "2": {
    "name": "Archive.zip",
    "link": "https://debrid1.bestdebrid.com/dl/TY/def.../Archive.zip",
    "original": "https://k2s.cc/file/def456",
    "ip": "1.2.3.4",
    "date": "2025-04-18 21: 02: 55"
  }
}
Prova

Esempi di codice

curl -H 'Authorization: YOUR_API_KEY' \
  'https://bestdebrid.com/api/v1/downloadsHistory?num=20'
<?php
$ctx = stream_context_create(['http' => ['header' => "Authorization: YOUR_API_KEY\r\n"]]);
$history = json_decode(file_get_contents('https://bestdebrid.com/api/v1/downloadsHistory?num=20', false, $ctx), true);

foreach ($history as $entry) {
    echo $entry['name'] . "\n";
}
const res  = await fetch('https://bestdebrid.com/api/v1/downloadsHistory?num=20', {
  headers: { 'Authorization': 'YOUR_API_KEY' }
});
const history = await res.json();
Object.values(history).forEach(e => console.log(e.name));

Hoster supportati

Elenco completo degli hoster premium con stato, icone, domini e un flag hostfolder che indica quali supportano l'espansione delle cartelle via /hostfolder.

GEThttps://bestdebrid.com/api/v1/hosts

Parametri

ParametroTipoDescrizione
authobbligatoriostringYour API key — as Authorization header or ?auth= query param.

Schema della risposta (per voce)

CampoTipoDescrizione
namestringHoster identifier (e.g. rapidgator, mega).
statusstringup or down.
picturestringRelative path to the standard icon (img/hosters/name.png).
picture_100_100stringRelative path to the 100×100 icon.
lastcheckstringTimestamp of the last availability check.
downsincedatestringTimestamp since the hoster is down (empty string if up).
hostfolderbooleantrue if the hoster supports folder/playlist expansion via /hostfolder (gofile, youtube, mega, terabox).
domainsstring[]Domain aliases handled as this hoster (e.g. rapidgator.net, rg.to).

Esempio di risposta

[
  {
    "name": "rapidgator",
    "status": "up",
    "picture": "img/hosters/rapidgator.png",
    "picture_100_100": "img/hosters/100_100/rapidgator.png",
    "lastcheck": "2025-04-19 14: 00: 12",
    "downsincedate": "",
    "hostfolder": false,
    "domains": ["rapidgator.net", "rg.to"]
  },
  {
    "name": "mega",
    "status": "up",
    "picture": "img/hosters/mega.png",
    "picture_100_100": "img/hosters/100_100/mega.png",
    "lastcheck": "2025-04-19 14: 00: 14",
    "downsincedate": "",
    "hostfolder": true,
    "domains": ["mega.io", "mega.nz", "mega.co.nz"]
  }
]
Prova

Esempi di codice

curl -H 'Authorization: YOUR_API_KEY' https://bestdebrid.com/api/v1/hosts
<?php
$ctx = stream_context_create(['http' => ['header' => "Authorization: YOUR_API_KEY\r\n"]]);
$hosts = json_decode(file_get_contents('https://bestdebrid.com/api/v1/hosts', false, $ctx), true);

// Quick lookup: domain -> hoster entry
$byDomain = [];
foreach ($hosts as $h) {
    foreach ($h['domains'] as $d) $byDomain[$d] = $h;
}
const hosts = await (await fetch('https://bestdebrid.com/api/v1/hosts', {
  headers: { 'Authorization': 'YOUR_API_KEY' }
})).json();

const expandable = hosts
  .filter(h => h.hostfolder && h.status === 'up')
  .map(h => h.name);

Conteggi degli hoster

Numero di hoster premium online e offline. Ideale per dashboard di stato.

GEThttps://bestdebrid.com/api/v1/hostscount

Parametri

ParametroTipoDescrizione
authobbligatoriostringYour API key — as Authorization header or ?auth= query param.

Schema della risposta

CampoTipoDescrizione
totalhostsintegerTotal number of premium hosters.
hostsupintegerHosters currently marked up.
hostsdownintegerHosters currently marked down.

Esempio di risposta

{
  "totalhosts": 87,
  "hostsup": 81,
  "hostsdown": 6
}
Prova

Esempi di codice

curl -H 'Authorization: YOUR_API_KEY' https://bestdebrid.com/api/v1/hostscount
<?php
$ctx = stream_context_create(['http' => ['header' => "Authorization: YOUR_API_KEY\r\n"]]);
$counts = json_decode(file_get_contents('https://bestdebrid.com/api/v1/hostscount', false, $ctx), true);
const counts = await (await fetch('https://bestdebrid.com/api/v1/hostscount', {
  headers: { 'Authorization': 'YOUR_API_KEY' }
})).json();

Limiti per hoster

Limiti giornalieri per hoster (numero di download e banda) come mostrati agli utenti.

GEThttps://bestdebrid.com/api/v1/hostslimits

Parametri

ParametroTipoDescrizione
authobbligatoriostringYour API key — as Authorization header or ?auth= query param.

Schema della risposta (per voce)

CampoTipoDescrizione
namestringHoster identifier.
linksperdayintegerMax daily unrestricts visible to users.
bandwidthstringDaily bandwidth cap with units (e.g. "150 GB"); "∞" when unlimited.
picturestringRelative path to the standard icon.
picture_100_100stringRelative path to the 100×100 icon.

Esempio di risposta

[
  {
    "name": "rapidgator",
    "linksperday": 25,
    "bandwidth": "150 GB",
    "picture": "img/hosters/rapidgator.png",
    "picture_100_100": "img/hosters/100_100/rapidgator.png"
  },
  {
    "name": "k2s",
    "linksperday": 50,
    "bandwidth": "∞",
    "picture": "img/hosters/k2s.png",
    "picture_100_100": "img/hosters/100_100/k2s.png"
  }
]
Prova

Esempi di codice

curl -H 'Authorization: YOUR_API_KEY' https://bestdebrid.com/api/v1/hostslimits
<?php
$ctx = stream_context_create(['http' => ['header' => "Authorization: YOUR_API_KEY\r\n"]]);
$limits = json_decode(file_get_contents('https://bestdebrid.com/api/v1/hostslimits', false, $ctx), true);
const limits = await (await fetch('https://bestdebrid.com/api/v1/hostslimits', {
  headers: { 'Authorization': 'YOUR_API_KEY' }
})).json();

Espandi una cartella / playlist

Risolve una cartella, una condivisione o una playlist in URL di file da passare a /generateLink. Supporta Gofile, TeraBox (e alias), playlist YouTube e cartelle Mega.

POSThttps://bestdebrid.com/api/v1/hostfolder
Funziona sia in GET che in POST.

Parametri

ParametroTipoDescrizione
authobbligatoriostringYour API key — as Authorization header or ?auth= query param.
linkobbligatoriostringThe folder / playlist URL.
listfacoltativostringYouTube playlist ID — only needed if link is a YouTube URL missing list=.
dirfacoltativostringTeraBox sub-path inside the share.
pathfacoltativostringAlias for dir.
fsidfacoltativostringTeraBox file ID — filters a single file from the share.
fileNamefacoltativostringTeraBox filename filter (use with fsid).

Schema della risposta

CampoTipoDescrizione
errorinteger0 on success, 1 on failure.
messagestring[] | stringArray of resolved URLs on success; human-readable error message on failure.

Esempi di risposta

// Gofile
{
  "error": 0,
  "message": [
    "https://gofile.io/download/abc123?server=store1",
    "https://gofile.io/download/def456?server=store2"
  ]
}

// Non-supported hoster — link echoed back
{
  "error": 0,
  "message": ["https://rapidgator.net/file/abc123"]
}

// Folder with no direct files (TeraBox)
{
  "error": 1,
  "message": "This link contains folders only. We can only unrestrict folders that contain actual files. Please open your link and navigate through the folders until you reach a folder that contains files."
}
Safe to pipe every URL through /hostfolder. If the URL isn't a known folder type, the endpoint echoes it back wrapped in the message array — your client can always expand → unrestrict without branching.
Prova

Esempi di codice

curl -X POST https://bestdebrid.com/api/v1/hostfolder \
  -H 'Authorization: YOUR_API_KEY' \
  --data-urlencode 'link=https://gofile.io/d/XXXXX'
<?php
$ch = curl_init('https://bestdebrid.com/api/v1/hostfolder');
curl_setopt_array($ch, [
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_POST           => true,
    CURLOPT_HTTPHEADER     => ['Authorization: YOUR_API_KEY'],
    CURLOPT_POSTFIELDS     => http_build_query(['link' => $folderLink]),
]);
$response = json_decode(curl_exec($ch), true);
curl_close($ch);

$files = ($response['error'] === 0) ? $response['message'] : [];
const res = await fetch('https://bestdebrid.com/api/v1/hostfolder', {
  method : 'POST',
  headers: { 'Authorization': 'YOUR_API_KEY' },
  body   : new URLSearchParams({ link: folderLink })
});
const { error, message } = await res.json();
const files = error === 0 ? message : [];

Aggiungi torrent / magnet

Mette in coda un link magnet o un file .torrent. I file scaricati sono poi serviti in HTTPS via /gettorrentFile.

POSThttps://bestdebrid.com/api/v1/torrentFile

Parametri

ParametroTipoDescrizione
authobbligatoriostringYour API key — as Authorization header or ?auth= query param.
magnetobbligatoriostringMagnet URI, or base64-encoded .torrent file bytes when isFile=1.
isFilefacoltativointeger1 if magnet is a base64 torrent file, 0 for a magnet URI (default). Must be numeric — otherwise error 55.
nocheckfacoltativobooleanSkip the duplicate check (adding the same torrent twice otherwise returns error 6). Default false.
ipfacoltativostringIP address allowed to later download the resulting files. Must be a valid IPv4/IPv6.

Schema della risposta

CampoTipoDescrizione
errorinteger0 on success.
messagestring"OK" on success.
torrent_idstringTorrent infohash — use it with /gettorrentFile and /deltorrentFile.
torrent_linkstringHTML-escaped torrent name.

Esempio di risposta

{
  "error": 0,
  "message": "OK",
  "torrent_id": "dc6521c4fec8641eaa5901164c8e57e16a790e05",
  "torrent_link": "Ubuntu.22.04.LTS.iso"
}
Limits: premium plan required · max 5 active torrents (error 5) · max 90 GiB per torrent (error 8) · duplicate within 4 days → error 6 unless nocheck=true · if the total size can't be read from the swarm within ~30 s the torrent is removed and error 8 is returned.

Esempi di codice

# magnet URI
curl -X POST https://bestdebrid.com/api/v1/torrentFile \
  -H 'Authorization: YOUR_API_KEY' \
  --data-urlencode 'magnet=magnet:?xt=urn:btih:dc6521c4fec8641eaa5901164c8e57e16a790e05' \
  --data 'isFile=0'
<?php
// Adding a magnet
$ch = curl_init('https://bestdebrid.com/api/v1/torrentFile');
curl_setopt_array($ch, [
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_POST           => true,
    CURLOPT_HTTPHEADER     => ['Authorization: YOUR_API_KEY'],
    CURLOPT_POSTFIELDS     => http_build_query([
        'magnet' => 'magnet:?xt=urn:btih:...',
        'isFile' => 0,
    ]),
]);
$response = json_decode(curl_exec($ch), true);
curl_close($ch);

// Adding a .torrent file
$encoded = base64_encode(file_get_contents('/path/to/file.torrent'));
// ... POST with magnet=$encoded & isFile=1
// magnet
await fetch('https://bestdebrid.com/api/v1/torrentFile', {
  method : 'POST',
  headers: { 'Authorization': 'YOUR_API_KEY' },
  body   : new URLSearchParams({ magnet: 'magnet:?xt=urn:btih:...', isFile: '0' })
});

// .torrent file
const buf = await fetch('/my.torrent').then(r => r.arrayBuffer());
const b64 = btoa(String.fromCharCode(...new Uint8Array(buf)));
await fetch('https://bestdebrid.com/api/v1/torrentFile', {
  method : 'POST',
  headers: { 'Authorization': 'YOUR_API_KEY' },
  body   : new URLSearchParams({ magnet: b64, isFile: '1' })
});

Elenca i torrent attivi

Restituisce fino ai 5 torrent attivi più recenti dell'account (completati, in corso o in coda — non quelli eliminati).

GEThttps://bestdebrid.com/api/v1/gettorrentList

Parametri

ParametroTipoDescrizione
authobbligatoriostringYour API key — as Authorization header or ?auth= query param.

Schema della risposta (per voce)

CampoTipoDescrizione
idstringTorrent infohash (use as torrentid in other endpoints).
namestringTorrent display name.
ipstringIP that was locked to this torrent.
datestringTimestamp when the torrent was added.

Esempio di risposta

[
  {
    "id": "dc6521c4fec8641eaa5901164c8e57e16a790e05",
    "name": "Ubuntu.22.04.LTS.iso",
    "ip": "1.2.3.4",
    "date": "2025-04-19 10: 12: 34"
  }
]
Prova

Esempi di codice

curl -H 'Authorization: YOUR_API_KEY' https://bestdebrid.com/api/v1/gettorrentList
<?php
$ctx = stream_context_create(['http' => ['header' => "Authorization: YOUR_API_KEY\r\n"]]);
$list = json_decode(file_get_contents('https://bestdebrid.com/api/v1/gettorrentList', false, $ctx), true);
const list = await (await fetch('https://bestdebrid.com/api/v1/gettorrentList', {
  headers: { 'Authorization': 'YOUR_API_KEY' }
})).json();

Dettagli di un torrent

Dettagli completi di un torrent: avanzamento, ratio, dimensione, velocità e — al termine — l'elenco dei file scaricabili più un archivio ZIP.

GEThttps://bestdebrid.com/api/v1/gettorrentFile

Parametri

ParametroTipoDescrizione
authobbligatoriostringYour API key — as Authorization header or ?auth= query param.
torrentidobbligatoriostringTorrent infohash returned by /torrentFile or /gettorrentList.

Schema della risposta

CampoTipoDescrizione
errorinteger0 on success.
idstringTorrent infohash.
messagestring"OK".
filenamestringTorrent display name.
img-progressstringRelative path to a status icon (img/torrents/ok.gif, deb-loading.gif, wait.png, error.gif).
progressfloatPercent done (0–1).
ratiofloat | stringUpload ratio; empty string when unknown.
seedersintegerNumber of connected peers.
sizeintegerTotal size in bytes.
sizeStringstringHuman-readable size (e.g. "3.2 GB").
speedstringCurrent download speed (e.g. "4.52 MB/s").
serverIDintegerInternal ID of the seedbox storing the torrent.
linksobject | stringOnce finished, an object with zip (URL of the full ZIP) and files (array of per-file URLs). While downloading, the literal string "Waiting...".

Esempio di risposta

{
  "error": 0,
  "id": "dc6521c4fec8641eaa5901164c8e57e16a790e05",
  "message": "OK",
  "filename": "Ubuntu.22.04.LTS.iso",
  "img-progress": "img/torrents/ok.gif",
  "progress": 1,
  "ratio": 1.23,
  "seeders": 12,
  "size": 3489660928,
  "sizeString": "3.25 GB",
  "speed": "0.00 MB/s",
  "serverID": 4,
  "links": {
    "zip": "https://seedbox.bestdebrid.com/index.php?zip=dc6521...&filename=Ubuntu.22.04.LTS.iso",
    "files": [
      "https://seedbox.bestdebrid.com/index.php?filename=dc6521...&id=Ubuntu.22.04.LTS.iso"
    ]
  }
}
ZIP endpoint: links.zip downloads the whole torrent content as a single archive — convenient for multi-file releases.
Prova

Esempi di codice

curl -H 'Authorization: YOUR_API_KEY' \
  'https://bestdebrid.com/api/v1/gettorrentFile?torrentid=dc6521c4...'
<?php
$ctx = stream_context_create(['http' => ['header' => "Authorization: YOUR_API_KEY\r\n"]]);
$t = json_decode(file_get_contents('https://bestdebrid.com/api/v1/gettorrentFile?torrentid=' . $hash, false, $ctx), true);

if ($t['error'] === 0 && is_array($t['links'])) {
    $zip   = $t['links']['zip'];
    $files = $t['links']['files'];
}
const t = await (await fetch('https://bestdebrid.com/api/v1/gettorrentFile?torrentid=' + hash, {
  headers: { 'Authorization': 'YOUR_API_KEY' }
})).json();

if (t.error === 0 && typeof t.links === 'object') {
  const zipUrl = t.links.zip;
  const files  = t.links.files;
}

Elimina un torrent

Rimuove un torrent dall'account. I file sono cancellati dalla seedbox solo se nessun altro utente lo ha aggiunto negli ultimi 4 giorni e il ratio è ≥ 1.

DELhttps://bestdebrid.com/api/v1/deltorrentFile

Parametri

ParametroTipoDescrizione
authobbligatoriostringYour API key — as Authorization header or ?auth= query param.
torrentidobbligatoriostringTorrent infohash to delete.

Esempio di risposta

{
  "error": 0,
  "message": "Torrent deleted"
}
Irreversible. The torrent entry and any generated download links will no longer be accessible from your account.
Azione irreversibile: nessun blocco «Prova» per questo endpoint.

Esempi di codice

curl -H 'Authorization: YOUR_API_KEY' \
  'https://bestdebrid.com/api/v1/deltorrentFile?torrentid=dc6521c4...'
<?php
$ctx = stream_context_create(['http' => ['header' => "Authorization: YOUR_API_KEY\r\n"]]);
$r = json_decode(file_get_contents('https://bestdebrid.com/api/v1/deltorrentFile?torrentid=' . $hash, false, $ctx), true);
await fetch('https://bestdebrid.com/api/v1/deltorrentFile?torrentid=' + hash, {
  headers: { 'Authorization': 'YOUR_API_KEY' }
});
Quota raggiunta o chiave mancante? Chiave e piano sono nel tuo profilo.