UpStream - HLS Video Streaming API reference
ACCOUNT
UPLOAD
FILE
FOLDER
RESPONSE
RESPONSE
RESPONSE
Minimal HTML form upload sample:
RESPONSE
returns future filecode that will work after upload complete
RESPONSE
RESPONSE
RESPONSE
RESPONSE
RESPONSE
RESPONSE
RESPONSE
RESPONSE
RESPONSE
RESPONSE
Account Info
REQUESTGET https://upstream.to/api/account/info?key=45pec4tkbs7fmq7sePARAMETERS
Name | Description | Example | Format | Required |
---|---|---|---|---|
key | API key | 45pec4tkbs7fmq7se | STRING | yes |
{ "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
REQUESTGET https://upstream.to/api/account/stats?key=45pec4tkbs7fmq7sePARAMETERS
Name | Description | Example | Format | Required |
---|---|---|---|---|
key | API key | 45pec4tkbs7fmq7se | STRING | yes |
last | show stats for last X days (default: 7) | 14 | INT |
{ "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
REQUESTGET https://upstream.to/api/upload/server?key=45pec4tkbs7fmq7sePARAMETERS
Name | Description | Example | Format | Required |
---|---|---|---|---|
key | API key | 45pec4tkbs7fmq7se | STRING | yes |
{ "msg": "OK", "server_time": "2021-08-11 04:29:54", "status": 200, "result": "https://s01.upstreamcdn.co/upload/01" }
Upload File to Server
PARAMETERSName | Description | Example | Format | Required |
---|---|---|---|---|
key | API key | 45pec4tkbs7fmq7se | 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 |
<form method="POST" enctype="multipart/form-data" action="https://s01.upstreamcdn.co/upload/01"> <input type="hidden" name="key" value="45pec4tkbs7fmq7se"> <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=45pec4tkbs7fmq7se' -F 'file=@1.avi' -F 'file=@2.avi' https://s01.upstreamcdn.co/upload/01Upload 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/01Response:
{ "msg": "OK", "status": 200, "files": [{ "filecode": "u9150wqzvhxj", "filename": "1.avi", "status": "OK" }, { "filecode": "gzky98gfg6hn", "filename": "2.avi", "status": "OK" }] }
Upload by URL
REQUESTGET https://upstream.to/api/upload/url?key=45pec4tkbs7fmq7se&url={url}PARAMETERS
Name | Description | Example | Format | Required |
---|---|---|---|---|
key | API key | 45pec4tkbs7fmq7se | 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 |
{ "msg":"OK", "server_time":"2021-08-12 20:56:47", "status":200, "result":{ "filecode":"fb5asfuj2snh" } }
File Info
REQUESTGET https://upstream.to/api/file/info?key=45pec4tkbs7fmq7se&file_code={file_code}PARAMETERS
Name | Description | Example | Format | Required |
---|---|---|---|---|
key | API key | 45pec4tkbs7fmq7se | STRING | yes |
file_code | file code, or list separated by comma | gi4o0tlro01u,gi4o0tlro012 | STRING | yes |
{ "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
REQUESTGET https://upstream.to/api/file/edit?key=45pec4tkbs7fmq7se&file_code={file_code}&file_title={file_title}PARAMETERS
Name | Description | Example | Format | Required |
---|---|---|---|---|
key | API key | 45pec4tkbs7fmq7se | 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 |
{ "msg":"OK", "server_time":"2021-08-13 20:17:12", "status":200, "result":"true" }
File List
REQUESTGET https://upstream.to/api/file/list?key=45pec4tkbs7fmq7sePARAMETERS
Name | Description | Example | Format | Required |
---|---|---|---|---|
key | API key | 45pec4tkbs7fmq7se | 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 |
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 |
{ "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
REQUESTGET https://upstream.to/api/file/clone?key=45pec4tkbs7fmq7se&file_code={file_code}PARAMETERS
Name | Description | Example | Format | Required |
---|---|---|---|---|
key | API key | 45pec4tkbs7fmq7se | STRING | yes |
file_code | File code | 04nolnuszhph | STRING | yes |
file_title | New file title if required | New video title | STRING |
{ "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
REQUESTGET https://upstream.to/api/file/deleted?key=45pec4tkbs7fmq7se&last={last}PARAMETERS
Name | Description | Example | Format | Required |
---|---|---|---|---|
key | API key | 45pec4tkbs7fmq7se | STRING | yes |
last | Show files deleted in last X hours | 24 | INT |
{ "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
REQUESTGET https://upstream.to/api/file/dmca?key=45pec4tkbs7fmq7se&last={last}PARAMETERS
Name | Description | Example | Format | Required |
---|---|---|---|---|
key | API key | 45pec4tkbs7fmq7se | STRING | yes |
last | Show files reported last X hours only | 24 | INT |
{ "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
REQUESTGET https://upstream.to/api/folder/list?key=45pec4tkbs7fmq7se&fld_id={fld_id}&files=1PARAMETERS
Name | Description | Example | Format | Required |
---|---|---|---|---|
key | API key | 45pec4tkbs7fmq7se | STRING | yes |
fld_id | Parent folder id, default=0 | 25 | INT | |
files | Show file list in this folder | 1 | INT |
{ "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
REQUESTGET https://upstream.to/api/folder/create?key=45pec4tkbs7fmq7se&name={name}&parent_id={parent_id}PARAMETERS
Name | Description | Example | Format | Required |
---|---|---|---|---|
key | API key | 45pec4tkbs7fmq7se | STRING | yes |
name | Folder name | New Videos | STRING | yes |
parent_id | Parent Folder ID | 0 | INT | |
descr | Folder description | new stuff | STRING |
{ "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
REQUESTGET https://upstream.to/api/folder/edit?key=45pec4tkbs7fmq7se&fld_id={fld_id}&name={name}PARAMETERS
Name | Description | Example | Format | Required |
---|---|---|---|---|
key | API key | 45pec4tkbs7fmq7se | 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 |
{ "msg":"OK", "server_time":"2021-08-18 21:21:44", "status":200, "result":"true" }
File Encodings
Get current encoding queues
REQUESTGET https://upstream.to/api/file/encodings?key=45pec4tkbs7fmq7sePARAMETERS
Name | Description | Example | Format | Required |
---|---|---|---|---|
key | API key | 45pec4tkbs7fmq7se | STRING | yes |
code | Filter by File code | fb5asfuj2snh | STRING |
{ "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"} ] }