UpStream - HLS Video Streaming API reference

ACCOUNT UPLOAD FILE FOLDER

Account Info

REQUEST

GET https://upstream.to/api/account/info?key=45e5klg7a5jehthn9

PARAMETERS

Name	Description	Example	Format	Required
key	API key	45e5klg7a5jehthn9	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=45e5klg7a5jehthn9

PARAMETERS

Name	Description	Example	Format	Required
key	API key	45e5klg7a5jehthn9	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=45e5klg7a5jehthn9

PARAMETERS

Name	Description	Example	Format	Required
key	API key	45e5klg7a5jehthn9	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	45e5klg7a5jehthn9	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="45e5klg7a5jehthn9">
<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=45e5klg7a5jehthn9' -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=45e5klg7a5jehthn9&url={url}

PARAMETERS

Name	Description	Example	Format	Required
key	API key	45e5klg7a5jehthn9	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=45e5klg7a5jehthn9&file_code={file_code}

PARAMETERS

Name	Description	Example	Format	Required
key	API key	45e5klg7a5jehthn9	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=45e5klg7a5jehthn9&file_code={file_code}&file_title={file_title}

PARAMETERS

Name	Description	Example	Format	Required
key	API key	45e5klg7a5jehthn9	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=45e5klg7a5jehthn9

PARAMETERS

Name	Description	Example	Format	Required
key	API key	45e5klg7a5jehthn9	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=45e5klg7a5jehthn9&file_code={file_code}

PARAMETERS

Name	Description	Example	Format	Required
key	API key	45e5klg7a5jehthn9	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=45e5klg7a5jehthn9&last={last}

PARAMETERS

Name	Description	Example	Format	Required
key	API key	45e5klg7a5jehthn9	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=45e5klg7a5jehthn9&last={last}

PARAMETERS

Name	Description	Example	Format	Required
key	API key	45e5klg7a5jehthn9	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=45e5klg7a5jehthn9&fld_id={fld_id}&files=1

PARAMETERS

Name	Description	Example	Format	Required
key	API key	45e5klg7a5jehthn9	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=45e5klg7a5jehthn9&name={name}&parent_id={parent_id}

PARAMETERS

Name	Description	Example	Format	Required
key	API key	45e5klg7a5jehthn9	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=45e5klg7a5jehthn9&fld_id={fld_id}&name={name}

PARAMETERS

Name	Description	Example	Format	Required
key	API key	45e5klg7a5jehthn9	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=45e5klg7a5jehthn9

PARAMETERS

Name	Description	Example	Format	Required
key	API key	45e5klg7a5jehthn9	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"}
	]
}