Developer API

Integrate UpBolt Into Your Workflow

Use the UpBolt API to upload videos, manage files and folders, retrieve account data, and automate your video workflow with simple REST endpoints.
Quick Start
All API requests require your API key. Start by authenticating with your key and sending a simple request to fetch your account information.
Base API URL
https://upbolt.to/api
Authentication
?key=<YOUR_API_KEY>
First Request
GET https://upbolt.to/api/account/info?key=45v95blw8pqwra4g4
Authentication
Every request must include your API key using the key query parameter.
GET https://upbolt.to/api/account/info?key=45v95blw8pqwra4g4
Account Endpoints
Use these endpoints to retrieve account information, usage, and statistics.

Account Info

Returns basic account details including storage, balance, premium status, and user information.
REQUEST
GET https://upbolt.to/api/account/info?key=45v95blw8pqwra4g4
PARAMETERS
Name Description Example Format Required
key API key 45v95blw8pqwra4g4 STRING yes
RESPONSE
{
    "msg": "OK",
    "server_time": "2021-09-11 04:30:07",
    "status": 200,
    "result": {
    	"files_total":"31",
    	"storage_left":1288483337,
    	"login":"megauploader21",
        "email": "[email protected]",
        "premium_expire":"2022-10-15 04:46:59",
        "balance":"108.00000",
        "premium":1,
        "storage_used":"685101"
    }
}

Account Stats

Returns account performance statistics such as views, downloads, and profit totals.
REQUEST
GET https://upbolt.to/api/account/stats?key=45v95blw8pqwra4g4
PARAMETERS
Name Description Example Format Required
key API key 45v95blw8pqwra4g4 STRING yes
last show stats for last X days (default: 7) 14 INT
RESPONSE
{
  "msg": "OK",
  "server_time": "2021-09-13 04:30:07",
  "status": 200,
  "result": [
    {
      "downloads": "0",
      "profit_views": "0.00000",
      "views_adb": "1",
      "sales": "0",
      "profit_sales": "0.00000",
      "profit_refs": "0.00000",
      "profit_site": "0.00000",
      "views": "0",
      "refs": "0",
      "day": "2021-09-12",
      "profit_total": "0.00000",
      "views_prem": "0"
    }
  ]
}

Account Summary

Returns a quick account summary including today's profit, monthly/cumulative profit, monthly views, and total files. You can optionally pass fld_id to filter the returned file count and folder statistics by folder.
When using fld_id, files, total_views_monthly, daily_profit, and monthly_profit are scoped to that folder. Folder monthly_profit does not automatically reset on a new calendar month; it keeps counting until you reset that folder using the reset endpoint below.
REQUEST
GET https://upbolt.to/api/account/summary?key=45v95blw8pqwra4g4
REQUEST WITH FOLDER FILTER
GET https://upbolt.to/api/account/summary?key=45v95blw8pqwra4g4&fld_id={fld_id}
PARAMETERS
Name Description Example Format Required
key API key 45v95blw8pqwra4g4 STRING yes
fld_id Folder ID. When present, file count and available statistics are scoped to this folder. 17 INT
RESPONSE
{
  "msg": "OK",
  "server_time": "2026-05-12 22:14:00",
  "status": 200,
  "result": {
    "daily_profit": "0.00000",
    "monthly_profit": "0.02400",
    "total_views_monthly": 44,
    "files": 293,
    "fld_id": 17,
    "files_scope": "folder",
    "stats_scope": "folder",
    "monthly_profit_reset_at": "2026-05-01 10:15:00"
  }
}

Folder Monthly Profit Reset

Resets the accumulated monthly_profit counter for a specific folder. After the reset, /account/summary?fld_id={fld_id} starts counting folder monthly profit again from the reset time.
This action affects only the selected folder summary counter. It does not delete files, account earnings, payment history, or global account statistics.
REQUEST
GET https://upbolt.to/api/account/summary/reset/folder?key=45v95blw8pqwra4g4&fld_id={fld_id}&reset=1
PARAMETERS
Name Description Example Format Required
key API key 45v95blw8pqwra4g4 STRING yes
fld_id Folder ID to reset. 17 INT yes
reset Reset confirmation flag. Send 1 to reset the folder monthly profit counter. 1 INT yes
RESPONSE
{
  "msg": "Folder profit reset completed",
  "server_time": "2026-05-12 22:14:00",
  "status": 200,
  "result": {
    "fld_id": 17,
    "reset_at": "2026-05-12 22:14:00"
  }
}
Upload Endpoints
Upload videos directly, import them by URL, or attach subtitles.

Get Upload Server

Returns the upload server URL to be used for direct file uploads.
REQUEST
GET https://upbolt.to/api/upload/server?key=45v95blw8pqwra4g4
PARAMETERS
Name Description Example Format Required
key API key 45v95blw8pqwra4g4 STRING yes
RESPONSE
{
  "msg": "OK",
  "server_time": "2021-08-11 04:29:54",
  "status": 200,
  "result": "https://s1.myvideo.com/upload/01"
}

Upload File to Server

Upload one or more video files directly to the assigned upload server.
PARAMETERS
Name Description Example Format Required
key API key 45v95blw8pqwra4g4 STRING yes
file Video file(s) 1.avi FILE yes
file_title Title of video New release video STRING
file_descr Description of video This is sample from
our upcoming release
STRING
snapshot Custom video snapshot (up to 300KB) 1.jpg FILE
fld_id Folder ID 25 INT
cat_id Category ID 5 INT
tags Tags list promo, high quality STRING
file_public Public flag 1 INT
file_adult Adult flag 1 INT
html_redirect Use old style HTML redirect output instead of JSON 1 INT
Minimal HTML form upload sample:
<form method="POST" enctype="multipart/form-data" action="https://s1.myvideo.com/upload/01">
				<input type="hidden" name="key" value="45v95blw8pqwra4g4">
				<input type="hidden" name="html_redirect" value="1">
				<input type="file" name="file">
				<input type="submit">
				</form>
CURL file upload sample: Upload 2 videos:
curl -X POST -F 'key=45v95blw8pqwra4g4' -F '[email protected]' -F '[email protected]' https://s1.myvideo.com/upload/01
Upload video with custom title and snapshot:
curl -X POST -F 'key=1l5ftrilhllgwx2bo' -F 'file_title="Hola!"' -F '[email protected]' -F '[email protected]' http://s1.upbolt.to/upload/01
Response:
{
    "msg": "OK",
    "status": 200,
    "files": [{
        "filecode": "u9150wqzvhxj",
        "filename": "1.avi",
        "status": "OK"
    }, {
        "filecode": "gzky98gfg6hn",
        "filename": "2.avi",
        "status": "OK"
    }]
}

Upload by URL

Create a remote upload request from a direct video file URL.
REQUEST
GET https://upbolt.to/api/upload/url?key=45v95blw8pqwra4g4&url={url}
PARAMETERS
Name Description Example Format Required
key API key 45v95blw8pqwra4g4 STRING yes
url URL to video file http://clips.vorwaerts-gmbh.de/big_buck_bunny.mp4 STRING yes
fld_id Folder ID 25 INT
cat_id Category ID 5 INT
file_public Public flag 1 INT
file_adult Adult flag 1 INT
tags Tags list promo, high quality STRING
RESPONSE returns future filecode that will work after upload complete
{
	"msg":"OK",
	"server_time":"2021-08-12 20:56:47",
	"status":200,
	"result":{
		"filecode":"fb5asfuj2snh"
	}
}

Upload Subtitle

Attach subtitles to an existing video using either a remote URL or uploaded subtitle file.
REQUEST PARAMETERS
Name Description Example Format Required
key API key 45v95blw8pqwra4g4 STRING yes
file_code file code gi4o0tlro01u STRING yes
sub_lang Subtitle language code eng STRING yes
sub_file Subtitle file attachment 1.vtt FILE
CURL subtitle file upload sample:
curl -X POST -F 'key=45v95blw8pqwra4g4' -F 'file_code=cnypqbf2t79l' -F 'sub_lang=eng' -F '[email protected]' https://upbolt.to/api/upload/sub
RESPONSE returns future filecode that will work after upload complete
{
	"msg":"OK",
	"server_time":"2021-08-12 20:56:47",
	"status":200
}
Torrent Endpoints
Import videos from magnet links or .torrent files directly into your account. Torrent uploads are processed asynchronously: once the download completes, valid video files are imported into your files automatically.
Torrent API access must be enabled on your account. Only valid video files inside the torrent are imported. Non-video files, samples, subtitles, images, and text files are ignored.

Add Torrent

Add a torrent upload job using either a magnet link or a .torrent file. The job is queued on an available torrent server and will be imported into your account after completion.
REQUEST - MAGNET
POST https://upbolt.to/api/torrent/add
CURL MAGNET SAMPLE
curl -X POST "https://upbolt.to/api/torrent/add" \
  -F "key=45v95blw8pqwra4g4" \
  -F "magnet=magnet:?xt=urn:btih:INFOHASH" \
  -F "callback_url=https://example.com/upbolt-callback" \
  -F "external_id=movie-123"
CURL .TORRENT FILE SAMPLE
curl -X POST "https://upbolt.to/api/torrent/add" \
  -F "key=45v95blw8pqwra4g4" \
  -F "[email protected]" \
  -F "callback_url=https://example.com/upbolt-callback" \
  -F "external_id=movie-123"
PARAMETERS
Name Description Example Format Required
key API key 45v95blw8pqwra4g4 STRING yes
magnet Magnet link. Required if no torrent file is provided. magnet:?xt=urn:btih:INFOHASH STRING yes/no
torrent .torrent file upload. Required if no magnet link is provided. movie.torrent FILE yes/no
fld_id Target folder ID 25 INT
cat_id Category ID 5 INT
file_public Public flag for imported files 1 INT
file_adult Adult flag for imported files 0 INT
tags Tags applied to imported files movies, drama STRING
callback_url Optional webhook URL called after the torrent is completed and files are imported. https://example.com/upbolt-callback URL
external_id Your own ID for matching webhook callbacks with your system records. movie-123 STRING
source_url Optional source/reference URL stored with the torrent job. https://example.com/source-page URL
RESPONSE
{
  "msg": "Torrent added",
  "server_time": "2026-05-08 14:16:35",
  "status": 200,
  "result": {
    "torrent_id": "dd8255ecdc7ca55fb0bbf81323d87062db1f6d1c",
    "server": 10,
    "status": "queued",
    "api_version": "torrent-final-multipart-safe"
  }
}
For some .torrent files, torrent_id may be returned empty at add time. The job can still be queued successfully, and you can track it with /torrent/list.

Torrent Status

Get the current status and progress of a torrent job by its torrent ID / infohash.
REQUEST
GET https://upbolt.to/api/torrent/status?key=45v95blw8pqwra4g4&torrent_id={torrent_id}
PARAMETERS
Name Description Example Format Required
key API key 45v95blw8pqwra4g4 STRING yes
torrent_id Torrent infohash returned by add or list endpoint. dd8255ecdc7ca55fb0bbf81323d87062db1f6d1c STRING yes
RESPONSE
{
  "msg": "OK",
  "server_time": "2026-05-08 14:20:10",
  "status": 200,
  "result": {
    "torrent_id": "dd8255ecdc7ca55fb0bbf81323d87062db1f6d1c",
    "name": "Big Buck Bunny",
    "status": "WORKING",
    "host_id": 10,
    "size": 276134947,
    "downloaded": 134217728,
    "uploaded": 0,
    "download_speed": 5242880,
    "upload_speed": 0,
    "peers": 12,
    "progress": 48.61,
    "files": [],
    "created": "2026-05-08 14:16:35",
    "updated": "2026-05-08 14:20:10"
  }
}

Torrent List

List recent active torrent jobs for your account.
REQUEST
GET https://upbolt.to/api/torrent/list?key=45v95blw8pqwra4g4&limit={limit}
PARAMETERS
Name Description Example Format Required
key API key 45v95blw8pqwra4g4 STRING yes
limit Number of torrent jobs to return. Maximum 100. 20 INT
RESPONSE
{
  "msg": "OK",
  "server_time": "2026-05-08 14:21:12",
  "status": 200,
  "result": [
    {
      "torrent_id": "dd8255ecdc7ca55fb0bbf81323d87062db1f6d1c",
      "name": "Big Buck Bunny",
      "status": "WORKING",
      "host_id": 10,
      "size": 276134947,
      "downloaded": 134217728,
      "uploaded": 0,
      "download_speed": 5242880,
      "upload_speed": 0,
      "peers": 12,
      "progress": 48.61,
      "files": [],
      "created": "2026-05-08 14:16:35",
      "updated": "2026-05-08 14:20:10"
    }
  ]
}

Torrent Webhook Callback

If callback_url is sent with /torrent/add, UpBolt will call your URL after the torrent completes and valid video files are imported into your account.
CALLBACK METHOD
POST callback_url
CALLBACK PAYLOAD
{
  "event": "torrent.completed",
  "status": "completed",
  "torrent_id": "dd8255ecdc7ca55fb0bbf81323d87062db1f6d1c",
  "host_id": 10,
  "user_id": 123,
  "external_id": "movie-123",
  "source_url": "https://example.com/source-page",
  "site_url": "https://upbolt.to",
  "files": [
    {
      "file_code": "ab12cd34ef56",
      "file_name": "Big Buck Bunny.mp4",
      "file_title": "Big Buck Bunny",
      "file_size": 276134947,
      "file_status": "OK",
      "url": "https://upbolt.to/ab12cd34ef56",
      "created": "2026-05-08 14:25:00"
    }
  ]
}
Webhook delivery errors do not stop the file import process. Your application should accept HTTP POST requests with JSON body.
File Endpoints
Manage video files, metadata, links, deletions, encodings, and remote uploads.

File Info

Retrieve metadata, visibility, playback details, and tags for one or more files.
REQUEST
GET https://upbolt.to/api/file/info?key=45v95blw8pqwra4g4&file_code={file_code}
PARAMETERS
Name Description Example Format Required
key API key 45v95blw8pqwra4g4 STRING yes
file_code file code, or list separated by comma gi4o0tlro01u,gi4o0tlro012 STRING yes
RESPONSE
{
	"msg":"OK",
	"server_time":"2021-08-12 21:10:07",
	"status":200,
	"result":[
		{
		"file_views_full":"0",
		"cat_id":"3",
		"player_img":"http://img.upbolt.to/fb5asfuj2snh.jpg",
		"status":200,
		"file_code":"fb5asfuj2snh",
		"file_last_download":"2021-08-12 20:56:54",
		"canplay":1,
		"file_public":"1",
		"file_length":"60",
		"file_title":"big buck bunny",
		"file_views":"0",
		"file_created":"2021-08-102 20:51:52",
		"file_premium_only":"0",
		"file_adult":"1",
		"file_fld_id":"25",
		"tags":"promo, high quality"
		}
	]
}

File Edit

Update file metadata and visibility settings for one or more files.
REQUEST
GET https://upbolt.to/api/file/edit?key=45v95blw8pqwra4g4&file_code={file_code}&file_title={file_title}
PARAMETERS
Name Description Example Format Required
key API key 45v95blw8pqwra4g4 STRING yes
file_code File code or comma separated list gi4o0tlro01u,hqpibyqwxumrt STRING yes
file_title File title The 100 S01E02 STRING
file_descr File description release by MegaDrive STRING
cat_id Category ID 5 INT
file_fld_id Folder ID 25 INT
file_public Public flag 1 INT
file_adult Adult flag 0 INT
tags File tags promo, high quality STRING
RESPONSE
{
	"msg":"OK",
	"server_time":"2021-08-13 20:17:12",
	"status":200,
	"result":"true"
}

File List

List files in your account with optional filters for folder, title, visibility, and pagination.
REQUEST
GET https://upbolt.to/api/file/list?key=45v95blw8pqwra4g4
PARAMETERS
Name Description Example Format Required
key API key 45v95blw8pqwra4g4 STRING yes
fld_id Folder ID 25 INT
title Filter videos by title Iron man STRING
created Show only videos uploaded after timestamp.
Specify number to show videos uploaded X minutes ago
2021-07-21 05:07:10 STRING
public Show public (1) or private (0) videos only, empty to show all 1 INT
adult Show adult (1) or safe (0) videos only, empty to show all 0 INT
per_page Number of results per page 50 INT
page Page number 2 INT
RESPONSE
{
	"msg":"OK",
	"server_time":"2021-08-13 20:35:18",
	"status":200,
	"result":
	{
		"files":[
			{
				"thumbnail":"http://img.upbolt.to/fb5asfuj2snh_t.jpg",
				"link":"http://upbolt.to/fb5asfuj2snh.html",
				"file_code":"fb5asfuj2snh",
				"canplay":1,
				"length":"60",
				"views":"0",
				"uploaded":"2021-07-12 20:56:54",
				"public":"0",
				"fld_id":"0",
				"title":"Test 123"
			}
		],
		"results_total":9,
		"pages":9,
		"results":1
	}
}

File Clone

Clone an existing file into your account, optionally with a new title or folder.
REQUEST
GET https://upbolt.to/api/file/clone?key=45v95blw8pqwra4g4&file_code={file_code}
PARAMETERS
Name Description Example Format Required
key API key 45v95blw8pqwra4g4 STRING yes
file_code Source file code abnormamorph STRING yes
file_title New file title if required New video title STRING
fld_id Target folder id 5 INT
RESPONSE
{
	"msg":"OK",
	"server_time":"2022-11-12 19:39:58",
	"status":200,
	"result":
	{
		"url":"http://upbolt.to/u405p6qz5xpi",
		"filecode":"u405p6qz5xpi"
	}
}

Deleted Files

Get a list of recently deleted files in your account.

Get last deleted files list

REQUEST
GET https://upbolt.to/api/file/deleted?key=45v95blw8pqwra4g4&last={last}
PARAMETERS
Name Description Example Format Required
key API key 45v95blw8pqwra4g4 STRING yes
last Show files deleted in last X hours 24 INT
RESPONSE
{
	"msg":"OK",
	"server_time":"2021-08-15 19:04:06",
	"status":200,
	"result":[
		{
			"file_code":"38j4wvxw164d",
			"deleted_by":"me",
			"deleted_ago_sec":"40",
			"deleted":"2021-08-15 19:03:26",
			"title":"Video 109779195"
		}
	]
}

File DMCA

Get files currently scheduled for DMCA deletion.

Get files scheduled for DMCA delete

REQUEST
GET https://upbolt.to/api/file/dmca?key=45v95blw8pqwra4g4&last={last}
PARAMETERS
Name Description Example Format Required
key API key 45v95blw8pqwra4g4 STRING yes
last Show files reported last X hours only 24 INT
RESPONSE
{
	"msg":"OK",
	"server_time":"2021-08-15 19:31:48",
	"status":200,
	"result":[
		{
			"file_code":"x2q5h0uhfzdu",
			"del_in_sec":"42097",
			"del_time":"2021-08-16 07:13:25"
		}
	]
}

File Encodings

Get the current encoding queue and progress for your files.

Get current encoding queues

REQUEST
GET https://upbolt.to/api/file/encodings?key=45v95blw8pqwra4g4
PARAMETERS
Name Description Example Format Required
key API key 45v95blw8pqwra4g4 STRING yes
file_code Filter by File code fb5asfuj2snh STRING
RESPONSE
{
	"msg":"OK",
	"server_time":"2021-08-18 21:44:09",
	"status":200,
	"result":[
		{"link":"http://upbolt.to/fb5asfuj2snh.html","progress":15,"status":"ENCODING","title":"Test video","quality":"h","file_code":"fb5asfuj2snh"},
		{"link":"http://upbolt.to/fb5asfuj2snh.html","progress":0,"status":"PENDING","title":"Test video","quality":"l","file_code":"fb5asfuj2snh"}
	]
}

File URL Uploads

Check the status of current remote URL upload requests.

Get current encoding queues

REQUEST
GET https://upbolt.to/api/file/url_uploads?key=45v95blw8pqwra4g4
PARAMETERS
Name Description Example Format Required
key API key 45v95blw8pqwra4g4 STRING yes
file_code Filter by File code fb5asfuj2snh STRING
RESPONSE
{
	"requests_available":2,
	"msg":"OK",
	"server_time":"2022-06-14 20:30:20",
	"status":200,
	"result":[
		{"remote_url":"https://upbolt.to/1.mp4","progress":0,"status":"PENDING","file_code":"","fld_id":"0"},
		{"remote_url":"https://upbolt.to/2.mp4","progress":0,"status":"PENDING","file_code":"xyayxm9ajlys","fld_id":"7"}
	]
}

File URL Uploads Actions

Manage pending and failed remote URL uploads.

Get current encoding queues

REQUEST
GET https://upbolt.to/api/file/url_actions?key=45v95blw8pqwra4g4
PARAMETERS
Name Description Example Format Required
key API key 45v95blw8pqwra4g4 STRING yes
restart_errors Restart all failed uploads 1 INT
delete_errors Delete all failed uploads 1 INT
delete_all Delete all current uploads 1 INT
delete_code Delete specific uploads by code xyayxm9ajlys,6bnyg8rnu11e STRING
RESPONSE
{
	"requests_available":2,
	"msg":"OK",
	"server_time":"2022-06-14 20:30:20",
	"status":200
}
Folder Endpoints
Create, update, list, and delete folders in your account.

Folder List

List folders in your account and optionally include files in the selected folder.
REQUEST
GET https://upbolt.to/api/folder/list?key=45v95blw8pqwra4g4&fld_id={fld_id}&files=1
PARAMETERS
Name Description Example Format Required
key API key 45v95blw8pqwra4g4 STRING yes
fld_id Parent folder id, default=0 25 INT
files Show file list in this folder 1 INT
RESPONSE
{
	"msg":"OK",
	"server_time":"2021-08-15 19:54:22",
	"status":200,
	"result":{
		"folders":[
			{
				"name":"Breaking Bad",
				"fld_id":"16",
				"code":"4pwb4yvp7v"
			},
			{
				"name":"Travis",
				"fld_id":"15",
				"code":"68dth39m76"
			}
		],
		"files":[
			{
				"thumbnail":"http://img.upbolt.to/abnormamorph_t.jpg",
				"link":"http://upbolt.to/abnormamorph.html",
				"file_code":"abnormamorph",
				"canplay":1,
				"length":"1560",
				"views":"10",
				"uploaded":"2021-08-20 20:37:22",
				"public":"0",
				"fld_id":"0",
				"title":"Tri pljus dva 2012 SATRip"
			}
		]
	}
}

Folder Create

Create a new folder in your account and optionally assign a parent folder.
REQUEST
GET https://upbolt.to/api/folder/create?key=45v95blw8pqwra4g4&name={name}&parent_id={parent_id}
PARAMETERS
Name Description Example Format Required
key API key 45v95blw8pqwra4g4 STRING yes
name Folder name New Videos STRING yes
parent_id Parent Folder ID 0 INT
descr Folder description new stuff STRING
RESPONSE
{
	"msg":"OK",
	"server_time":"2021-08-18 20:32:46",
	"status":200,
	"result":
	{
		"fld_id":"29"
	}
}

Folder Edit

Update folder details. Skipped fields will not be changed.

Update folder details, skipped fields won't be updated

REQUEST
GET https://upbolt.to/api/folder/edit?key=45v95blw8pqwra4g4&fld_id={fld_id}&name={name}
PARAMETERS
Name Description Example Format Required
key API key 45v95blw8pqwra4g4 STRING yes
fld_id Folder ID 25 INT yes
name Folder name Movies 2021 STRING
parent_id Parent Folder ID 0 INT
descr Folder description old stuff STRING
RESPONSE
{
	"msg":"OK",
	"server_time":"2021-08-18 21:21:44",
	"status":200,
	"result":"true"
}

Folder Delete

Delete an empty folder that contains no files or subfolders.

Delete folder. Folder should be empty and have no files / subfolders.

REQUEST
GET https://upbolt.to/api/folder/delete?key=45v95blw8pqwra4g4&fld_id={fld_id}
PARAMETERS
Name Description Example Format Required
key API key 45v95blw8pqwra4g4 STRING yes
fld_id Folder ID 25 INT yes
RESPONSE
{
	"msg":"OK",
	"server_time":"2021-08-18 21:21:44",
	"status":200
}