Terabox Downloader

Turn any Terabox share link into a clean, structured file list — names, sizes, types, thumbnails, MD5, and modified dates — for a single file or a whole shared folder. Shared folders are expanded automatically. 100% cookieless, no login, no keys to bring, MCP-ready.

What it does

Paste one or more Terabox share URLs. The actor resolves each share and returns one structured record per file. Shared folders are expanded recursively into every file inside them. For videos, a playable stream URL is included when Terabox exposes one. Everything runs cookieless — you never provide a login, cookie, or API key.

When to use it

• Resolve Terabox links into a structured file list (name, size, type, thumbnail, MD5).
• Expand a shared folder into all of its files in one run.
• Catalog or archive Terabox shares with consistent metadata.
• Get a video stream URL for a Terabox video share.
• Feed Terabox links to an AI agent / automation and get back clean JSON.

Not for: logging into a TeraBox account, uploading, or accessing private files you don't have permission to. It resolves public share links you provide.

Supported domains

terabox.com, 1024terabox.com, teraboxapp.com, terabox.app, terafileshare.com, teraboxlink.com, 4funbox.com, mirrobox.com, teraboxshare.com, and other mirrors. Both /s/1xxxx and ?surl=xxxx formats are accepted.

Output

Field	Description
fileName	Original file name
category	video, audio, image, document, application, other
sizeBytes / sizeReadable	File size in bytes and human-readable
directDownloadUrl	Direct link when Terabox exposes it for the share (best-effort)
streamUrl	HLS stream URL for videos when available
thumbnailUrl	Preview thumbnail (largest available)
fsId / md5	File system ID and MD5 hash
path	Path inside the share
modifiedAt	Last-modified timestamp (ISO 8601)
shareId / uk	Share identifiers
status	SUCCESS, NO_FILES, or FAILED
error	Reason a share/file failed (omitted on success)

Example record

{
  "sourceUrl": "https://www.terabox.com/s/1AbCdEf",
  "shareUrl": "https://www.terabox.com/s/1AbCdEf",
  "resolvedDomain": "https://www.terabox.com",
  "shareId": "123456789",
  "uk": "987654321",
  "status": "SUCCESS",
  "fileName": "holiday-clip.mp4",
  "fsId": "11122233344455",
  "sizeBytes": 84561234,
  "sizeReadable": "80.64 MB",
  "category": "video",
  "categoryCode": 1,
  "md5": "d41d8cd98f00b204e9800998ecf8427e",
  "path": "/holiday-clip.mp4",
  "modifiedAt": "2025-11-04T09:21:00.000Z",
  "thumbnailUrl": "https://data.terabox.com/thumbnail/..."
}

Input

Field	Type	Default	Notes
startUrls	string[]	—	Required. Terabox share links, one per line.
maxFiles	integer	200	Per-share cap (each extracted file is billed).
recursive	boolean	true	Expand folders into all files.
proxyCountry	string	—	Optional ISO country for the proxy exit.
proxyConfiguration	object	Residential	Proxy used (residential recommended).

Minimal input

{
  "startUrls": ["https://www.terabox.com/s/1AbCdEf"]
}

Pricing

Pay-per-event:

• Actor start — $0.00005 per run.
• File extracted — $0.004 per file returned.

Resolving a single file costs about $0.004. A 50-file folder costs about $0.20. The maxFiles cap protects you from runaway cost on large folders. Pay-per-usage (compute + proxy) is also available for very large jobs.

Reliability

Routes through Apify residential proxies (TeraBox blocks most datacenter IPs), tries multiple mirror domains per share, and reports an honest per-file status. A share that resolves but contains no files returns NO_FILES; a deleted, private, or blocked share returns FAILED with a clear error — the run never crashes silently.

Use with AI agents (MCP)

This actor is MCP-ready. Exposed via Apify MCP as apify--terabox-video-downloader, an agent passes a share URL and receives structured file records — ideal for cataloging and download-automation agents. No cookies or keys required.

Legal

Use this actor only to access content you are authorized to access, and in compliance with TeraBox's Terms of Service and applicable law. It resolves public share links you provide; it does not bypass authentication or access private files. You are responsible for how you use the data and links returned. This actor is not affiliated with, endorsed by, or operated by TeraBox / Flextech.