UpStream - HLS Video Streaming API reference

ACCOUNT UPLOAD FILE FOLDER

Account Info

REQUEST
GET https://upstream.to/api/account/info?key=45p5sji9cul3sx8w3
PARAMETERS
Name Description Example Format Required
key API key 45p5sji9cul3sx8w3 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": "megauploader21@gmail.com",
        "premium_expire":"2022-10-15 04:46:59",
        "balance":"108.00000",
        "premium":1,
        "storage_used":"685101"
    }
}

Account Stats

REQUEST
GET https://upstream.to/api/account/stats?key=45p5sji9cul3sx8w3
PARAMETERS
Name Description Example Format Required
key API key 45p5sji9cul3sx8w3 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"
    }
  ]
}

Get Upload Server

REQUEST
GET https://upstream.to/api/upload/server?key=45p5sji9cul3sx8w3
PARAMETERS
Name Description Example Format Required
key API key 45p5sji9cul3sx8w3 STRING yes
RESPONSE
{
  "msg": "OK",
  "server_time": "2021-08-11 04:29:54",
  "status": 200,
  "result": "https://s01.upstreamcdn.co/upload/01"
}

Upload File to Server

PARAMETERS
Name Description Example Format Required
key API key 45p5sji9cul3sx8w3 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 800KB) 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://s01.upstreamcdn.co/upload/01">
<input type="hidden" name="key" value="45p5sji9cul3sx8w3">
<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=45p5sji9cul3sx8w3' -F 'file=@1.avi' -F 'file=@2.avi' https://s01.upstreamcdn.co/upload/01
Upload video with custom title and snapshot:
curl -X POST -F 'key=1l5ftrilhllgwx2bo' -F 'file_title="Hola!"' -F 'file=@1.avi' -F 'snapshot=@1.jpg' http://s01.upstreamcdn.co/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

REQUEST
GET https://upstream.to/api/upload/url?key=45p5sji9cul3sx8w3&url={url}
PARAMETERS
Name Description Example Format Required
key API key 45p5sji9cul3sx8w3 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"
	}
}

File Info

REQUEST
GET https://upstream.to/api/file/info?key=45p5sji9cul3sx8w3&file_code={file_code}
PARAMETERS
Name Description Example Format Required
key API key 45p5sji9cul3sx8w3 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://s01.upstreamcdn.co/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

REQUEST
GET https://upstream.to/api/file/edit?key=45p5sji9cul3sx8w3&file_code={file_code}&file_title={file_title}
PARAMETERS
Name Description Example Format Required
key API key 45p5sji9cul3sx8w3 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

REQUEST
GET https://upstream.to/api/file/list?key=45p5sji9cul3sx8w3
PARAMETERS
Name Description Example Format Required
key API key 45p5sji9cul3sx8w3 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://s01.upstreamcdn.co/fb5asfuj2snh_t.jpg",
				"link":"http:/s01.upstreamcdn.co/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

REQUEST
GET https://upstream.to/api/file/clone?key=45p5sji9cul3sx8w3&file_code={file_code}
PARAMETERS
Name Description Example Format Required
key API key 45p5sji9cul3sx8w3 STRING yes
file_code File code 04nolnuszhph STRING yes
file_title New file title if required New video title STRING
RESPONSE
{
	"msg":"OK",
	"server_time":"2021-08-14 19:39:58",
	"status":200,
	"result":
	{
		"url":"http://s01.upstreamcdn.co/u405p6qz5xpi",
		"filecode":"u405p6qz5xpi"
	}
}

Deleted Files

Get last deleted files list

REQUEST
GET https://upstream.to/api/file/deleted?key=45p5sji9cul3sx8w3&last={last}
PARAMETERS
Name Description Example Format Required
key API key 45p5sji9cul3sx8w3 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 scheduled for DMCA delete

REQUEST
GET https://upstream.to/api/file/dmca?key=45p5sji9cul3sx8w3&last={last}
PARAMETERS
Name Description Example Format Required
key API key 45p5sji9cul3sx8w3 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"
		}
	]
}

Folder List

REQUEST
GET https://upstream.to/api/folder/list?key=45p5sji9cul3sx8w3&fld_id={fld_id}&files=1
PARAMETERS
Name Description Example Format Required
key API key 45p5sji9cul3sx8w3 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://s01.upstreamcdn.co/04nolnuszhph_t.jpg",
				"link":"http://s01.upstreamcdn.co/04nolnuszhph.html",
				"file_code":"04nolnuszhph",
				"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

REQUEST
GET https://upstream.to/api/folder/create?key=45p5sji9cul3sx8w3&name={name}&parent_id={parent_id}
PARAMETERS
Name Description Example Format Required
key API key 45p5sji9cul3sx8w3 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 won't be updated

REQUEST
GET https://upstream.to/api/folder/edit?key=45p5sji9cul3sx8w3&fld_id={fld_id}&name={name}
PARAMETERS
Name Description Example Format Required
key API key 45p5sji9cul3sx8w3 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"
}

File Encodings

Get current encoding queues

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