# Terabox Video Downloader (`khadinakbar/terabox-video-downloader`) Actor Resolve Terabox share URLs into file metadata and direct download links. Cookieless, expands folders, MCP-ready. - **URL**: https://apify.com/khadinakbar/terabox-video-downloader.md - **Developed by:** [Khadin Akbar](https://apify.com/khadinakbar) (community) - **Categories:** Videos, MCP servers, Automation - **Stats:** 1 total users, 0 monthly users, 0.0% runs succeeded, 0 bookmarks - **User rating**: No ratings yet ## Pricing from $4.00 / 1,000 file extracteds This Actor is paid per event and usage. You are charged both the fixed price for specific events and for Apify platform usage. Learn more: https://docs.apify.com/platform/actors/running/actors-in-store#pay-per-event ## What's an Apify Actor? Actors are web data automations that power AI and operations. They run on the Apify platform to scrape websites, process data, connect APIs, and automate workflows. In Batch mode, an Actor accepts a well-defined JSON input, performs an action which can take anything from a few seconds to a few hours, and optionally produces a well-defined JSON output, datasets with results, or files in key-value store. In Standby mode, an Actor provides a web server which can be used as a website, API, or an MCP server. Actors are written with capital "A". ## How to integrate an Actor? If asked about integration, you help developers integrate Actors into their projects. You adapt to their stack and deliver integrations that are safe, well-documented, and production-ready. The best way to integrate Actors is as follows. In JavaScript/TypeScript projects, use official [JavaScript/TypeScript client](https://docs.apify.com/api/client/js/docs.md): ```bash npm install apify-client ``` In Python projects, use official [Python client library](https://docs.apify.com/api/client/python/docs.md): ```bash pip install apify-client ``` In shell scripts, use [Apify CLI](https://docs.apify.com/cli/docs.md): ````bash # MacOS / Linux curl -fsSL https://apify.com/install-cli.sh | bash # Windows irm https://apify.com/install-cli.ps1 | iex ```bash In AI frameworks, you might use the [Apify MCP server](https://docs.apify.com/integrations/mcp.md). If your project is in a different language, use the [REST API](https://docs.apify.com/api/v2.md). For usage examples, see the [API](#api) section below. For more details, see Apify documentation as [Markdown index](https://docs.apify.com/llms.txt) and [Markdown full-text](https://docs.apify.com/llms-full.txt). # README ## 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 ```json { "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 ```json { "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. # Actor input Schema ## `startUrls` (type: `array`): List of Terabox share links to resolve, one entry per line (e.g. 'https://www.terabox.com/s/1AbCdEf' or 'https://1024terabox.com/s/1AbCdEf'). All mirror domains are accepted (terabox.com, 1024terabox.com, teraboxapp.com, terabox.app, terafileshare.com, etc.). A link pointing at a shared folder is auto-expanded into every file inside it. NOT a TeraBox account login — this resolves PUBLIC share links only. ## `maxFiles` (type: `integer`): Upper bound on how many files to extract from each share link, protecting cost on large folders (each extracted file is billed). Defaults to 200; range 1–5000. For a single video set this to 1. This is a per-share cap, NOT a total across all shares. ## `recursive` (type: `boolean`): When the share is a folder, recurse into every subfolder and return all files found (up to 'maxFiles'). Defaults to true. Set false to return only top-level files. Has no effect on single-file shares. ## `proxyCountry` (type: `string`): Two-letter ISO country code for the residential proxy exit (e.g. 'US', 'IN', 'ID', 'JP'). Leave empty to let Apify auto-pick. Set this when a share is region-locked or when default exits get blocked. NOT a language setting. ## `proxyConfiguration` (type: `object`): Proxy used for all requests. Residential is strongly recommended — TeraBox blocks most datacenter IPs. Defaults to Apify Residential. Override only if you have a reason. ## Actor input object example ```json { "startUrls": [ "https://1024terabox.com/s/1AbCdEf" ], "maxFiles": 200, "recursive": true, "proxyCountry": "US", "proxyConfiguration": { "useApifyProxy": true, "apifyProxyGroups": [ "RESIDENTIAL" ] } } ``` # Actor output Schema ## `files` (type: `string`): All extracted file records with direct download links. ## `summary` (type: `string`): Final OUTPUT summary in the key-value store. ## `runSummary` (type: `string`): Terminal outcome, diagnostic-row counts, and PPE reconciliation. # API You can run this Actor programmatically using our API. Below are code examples in JavaScript, Python, and CLI, as well as the OpenAPI specification and MCP server setup. ## JavaScript example ```javascript import { ApifyClient } from 'apify-client'; // Initialize the ApifyClient with your Apify API token // Replace the '' with your token const client = new ApifyClient({ token: '', }); // Prepare Actor input const input = { "startUrls": [ "https://1024terabox.com/s/1LNr3tyl5pI5KUM8BecGtyQ" ], "maxFiles": 200 }; // Run the Actor and wait for it to finish const run = await client.actor("khadinakbar/terabox-video-downloader").call(input); // Fetch and print Actor results from the run's dataset (if any) console.log('Results from dataset'); console.log(`💾 Check your data here: https://console.apify.com/storage/datasets/${run.defaultDatasetId}`); const { items } = await client.dataset(run.defaultDatasetId).listItems(); items.forEach((item) => { console.dir(item); }); // 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/js/docs ``` ## Python example ```python from apify_client import ApifyClient # Initialize the ApifyClient with your Apify API token # Replace '' with your token. client = ApifyClient("") # Prepare the Actor input run_input = { "startUrls": ["https://1024terabox.com/s/1LNr3tyl5pI5KUM8BecGtyQ"], "maxFiles": 200, } # Run the Actor and wait for it to finish run = client.actor("khadinakbar/terabox-video-downloader").call(run_input=run_input) # Fetch and print Actor results from the run's dataset (if there are any) print("💾 Check your data here: https://console.apify.com/storage/datasets/" + run["defaultDatasetId"]) for item in client.dataset(run["defaultDatasetId"]).iterate_items(): print(item) # 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/python/docs/quick-start ``` ## CLI example ```bash echo '{ "startUrls": [ "https://1024terabox.com/s/1LNr3tyl5pI5KUM8BecGtyQ" ], "maxFiles": 200 }' | apify call khadinakbar/terabox-video-downloader --silent --output-dataset ``` ## MCP server setup ```json { "mcpServers": { "apify": { "command": "npx", "args": [ "mcp-remote", "https://mcp.apify.com/?tools=khadinakbar/terabox-video-downloader", "--header", "Authorization: Bearer " ] } } } ``` ## OpenAPI specification ```json { "openapi": "3.0.1", "info": { "title": "Terabox Video Downloader", "description": "Resolve Terabox share URLs into file metadata and direct download links. Cookieless, expands folders, MCP-ready.", "version": "0.1", "x-build-id": "wCPqYIMhHtzvjJ4Od" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/khadinakbar~terabox-video-downloader/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-khadinakbar-terabox-video-downloader", "x-openai-isConsequential": false, "summary": "Executes an Actor, waits for its completion, and returns Actor's dataset items in response.", "tags": [ "Run Actor" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/inputSchema" } } } }, "parameters": [ { "name": "token", "in": "query", "required": true, "schema": { "type": "string" }, "description": "Enter your Apify token here" } ], "responses": { "200": { "description": "OK" } } } }, "/acts/khadinakbar~terabox-video-downloader/runs": { "post": { "operationId": "runs-sync-khadinakbar-terabox-video-downloader", "x-openai-isConsequential": false, "summary": "Executes an Actor and returns information about the initiated run in response.", "tags": [ "Run Actor" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/inputSchema" } } } }, "parameters": [ { "name": "token", "in": "query", "required": true, "schema": { "type": "string" }, "description": "Enter your Apify token here" } ], "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/runsResponseSchema" } } } } } } }, "/acts/khadinakbar~terabox-video-downloader/run-sync": { "post": { "operationId": "run-sync-khadinakbar-terabox-video-downloader", "x-openai-isConsequential": false, "summary": "Executes an Actor, waits for completion, and returns the OUTPUT from Key-value store in response.", "tags": [ "Run Actor" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/inputSchema" } } } }, "parameters": [ { "name": "token", "in": "query", "required": true, "schema": { "type": "string" }, "description": "Enter your Apify token here" } ], "responses": { "200": { "description": "OK" } } } } }, "components": { "schemas": { "inputSchema": { "type": "object", "required": [ "startUrls" ], "properties": { "startUrls": { "title": "Terabox share URLs", "type": "array", "description": "List of Terabox share links to resolve, one entry per line (e.g. 'https://www.terabox.com/s/1AbCdEf' or 'https://1024terabox.com/s/1AbCdEf'). All mirror domains are accepted (terabox.com, 1024terabox.com, teraboxapp.com, terabox.app, terafileshare.com, etc.). A link pointing at a shared folder is auto-expanded into every file inside it. NOT a TeraBox account login — this resolves PUBLIC share links only.", "items": { "type": "string" } }, "maxFiles": { "title": "Max files per share", "minimum": 1, "maximum": 5000, "type": "integer", "description": "Upper bound on how many files to extract from each share link, protecting cost on large folders (each extracted file is billed). Defaults to 200; range 1–5000. For a single video set this to 1. This is a per-share cap, NOT a total across all shares.", "default": 200 }, "recursive": { "title": "Expand folders", "type": "boolean", "description": "When the share is a folder, recurse into every subfolder and return all files found (up to 'maxFiles'). Defaults to true. Set false to return only top-level files. Has no effect on single-file shares.", "default": true }, "proxyCountry": { "title": "Proxy country (optional)", "type": "string", "description": "Two-letter ISO country code for the residential proxy exit (e.g. 'US', 'IN', 'ID', 'JP'). Leave empty to let Apify auto-pick. Set this when a share is region-locked or when default exits get blocked. NOT a language setting." }, "proxyConfiguration": { "title": "Proxy configuration", "type": "object", "description": "Proxy used for all requests. Residential is strongly recommended — TeraBox blocks most datacenter IPs. Defaults to Apify Residential. Override only if you have a reason.", "default": { "useApifyProxy": true, "apifyProxyGroups": [ "RESIDENTIAL" ] } } } }, "runsResponseSchema": { "type": "object", "properties": { "data": { "type": "object", "properties": { "id": { "type": "string" }, "actId": { "type": "string" }, "userId": { "type": "string" }, "startedAt": { "type": "string", "format": "date-time", "example": "2025-01-08T00:00:00.000Z" }, "finishedAt": { "type": "string", "format": "date-time", "example": "2025-01-08T00:00:00.000Z" }, "status": { "type": "string", "example": "READY" }, "meta": { "type": "object", "properties": { "origin": { "type": "string", "example": "API" }, "userAgent": { "type": "string" } } }, "stats": { "type": "object", "properties": { "inputBodyLen": { "type": "integer", "example": 2000 }, "rebootCount": { "type": "integer", "example": 0 }, "restartCount": { "type": "integer", "example": 0 }, "resurrectCount": { "type": "integer", "example": 0 }, "computeUnits": { "type": "integer", "example": 0 } } }, "options": { "type": "object", "properties": { "build": { "type": "string", "example": "latest" }, "timeoutSecs": { "type": "integer", "example": 300 }, "memoryMbytes": { "type": "integer", "example": 1024 }, "diskMbytes": { "type": "integer", "example": 2048 } } }, "buildId": { "type": "string" }, "defaultKeyValueStoreId": { "type": "string" }, "defaultDatasetId": { "type": "string" }, "defaultRequestQueueId": { "type": "string" }, "buildNumber": { "type": "string", "example": "1.0.0" }, "containerUrl": { "type": "string" }, "usage": { "type": "object", "properties": { "ACTOR_COMPUTE_UNITS": { "type": "integer", "example": 0 }, "DATASET_READS": { "type": "integer", "example": 0 }, "DATASET_WRITES": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_READS": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_WRITES": { "type": "integer", "example": 1 }, "KEY_VALUE_STORE_LISTS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_READS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_WRITES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_INTERNAL_GBYTES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_EXTERNAL_GBYTES": { "type": "integer", "example": 0 }, "PROXY_RESIDENTIAL_TRANSFER_GBYTES": { "type": "integer", "example": 0 }, "PROXY_SERPS": { "type": "integer", "example": 0 } } }, "usageTotalUsd": { "type": "number", "example": 0.00005 }, "usageUsd": { "type": "object", "properties": { "ACTOR_COMPUTE_UNITS": { "type": "integer", "example": 0 }, "DATASET_READS": { "type": "integer", "example": 0 }, "DATASET_WRITES": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_READS": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_WRITES": { "type": "number", "example": 0.00005 }, "KEY_VALUE_STORE_LISTS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_READS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_WRITES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_INTERNAL_GBYTES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_EXTERNAL_GBYTES": { "type": "integer", "example": 0 }, "PROXY_RESIDENTIAL_TRANSFER_GBYTES": { "type": "integer", "example": 0 }, "PROXY_SERPS": { "type": "integer", "example": 0 } } } } } } } } } } ```