Documentation · v2

Welcome to 『 𝗡⋆𝗧⋆𝗠 』 API

The fastest way to turn a TeraBox sharing link into a direct download URL, an HLS stream or a ready-made player link — in a single request.

Don't have a token yet? Message @ntmteraapi on Telegram, pick a plan, and yours is issued in minutes.

Base URL

https://api.yourdomain.com/

Replace it with your custom domain if one has been assigned to you.

Authentication

Every request needs a valid token sent in the Authorization header using the Bearer scheme.

HTTP header

Authorization: Bearer <your_token>

Tokens use a split format: token_id.secret. The part before the dot identifies the token; the secret after it is hashed server-side and never stored in plain text.

a1b2c3d4.8f9e7d6c-5b4a-3c2d-1e0f-9a8b7c6d5e4f

Security: keep your token out of client-side code. Rotate it from the dashboard immediately if it is ever exposed.

Resolve a sharing link

Returns every file behind a TeraBox sharing link, including direct download and streaming URLs.

Request

curl -X GET "https://api.yourdomain.com/?url=https://www.terabox.com/sharing/link?surl=xxxxx" \
  -H "Authorization: Bearer YOUR_TOKEN"

200 · application/json

[
  {
    "file_id": "abc123",
    "file_name": "video.mp4",
    "size": "1024 MB",
    "sizebytes": 1073741824,
    "direct_link": "https://.../fast-download?file_id=abc123",
    "m3u8_url": "https://.../stream?file_id=abc123",
    "stream_url": "https://player.example.xyz/watch?file_id=abc123"
  }
]

Field	Type	Description
`file_id`	string	Unique ID used by download and stream endpoints
`file_name`	string	Original file name
`size`	string	Human-readable size (e.g. 1024 MB)
`sizebytes`	number	Exact size in bytes
`direct_link`	string	Ready-to-use direct download URL
`m3u8_url`	string	HLS playlist for video files
`stream_url`	string	Hosted player link for instant playback

Direct download

Streams the file as binary with the correct content-disposition, ready to hand straight to a user's browser.

Request

GET /fast-download?file_id={file_id}
optional: &strategy=cloudflare (default) | direct

Tip: use strategy=direct for large files when you want to bypass the CDN cache layer.

Streaming

For video files, returns an M3U8 playlist that plugs into any HLS player (hls.js, VLC, ExoPlayer, AVPlayer…).

Request

GET /stream?file_id={file_id}
Authorization: Bearer YOUR_TOKEN

Health check

Confirms that the API and database are both responding.

Response

{ "status": "healthy" }

Error codes

Code	Meaning	What to do
`400`	Missing or invalid url	Check the TeraBox sharing link format
`401`	Missing/invalid bearer token	Send the full token_id.secret
`404`	File or link not found	The share may have expired
`429`	Request limit reached	Top up or upgrade on Telegram
`500`	Upstream error	Retry with backoff; report if persistent

FAQ

Which TeraBox domains are supported?

terabox.com, 1024tera.com, terabox.app, teraboxlink.com, terabox.ph and the regional mirrors. If a domain is missing, send it to us on Telegram and we'll add it.

Are folders supported?

Yes — folder shares resolve to an array with every file inside, each carrying its own file_id and direct link.

How do I raise my rate limit?

Message @ntmteraapi. Upgrades apply to your existing token immediately — no migration needed.

Is there an SDK?

The API is plain REST, so any HTTP client works. Python, JS/Node, Go and PHP snippets are shown below — copy and adapt them.

Language snippets

Python

import requests

resp = requests.get(
    "https://api.yourdomain.com/",
    params={"url": "https://www.terabox.com/sharing/link?surl=xxxxx"},
    headers={"Authorization": "Bearer YOUR_TOKEN"},
)
print(resp.json()[0]["direct_link"])

JavaScript (Node)

const api = new URL("https://api.yourdomain.com/");
api.searchParams.set("url", "https://www.terabox.com/sharing/link?surl=xxxxx");

const res = await fetch(api, {
  headers: { Authorization: "Bearer YOUR_TOKEN" },
});
const files = await res.json();
console.log(files[0].direct_link);

Need help wiring this into your bot or app? @ntmteraapi — we answer in minutes.