ACCOUNT
Account Info
Account Stats
UPLOAD
Get Upload Server
Upload File
Upload by URL
Upload Subtitle
FILE
File Info
File Edit
File List
File Clone
File Direct Link
File Delete
Deleted Files
DMCA Files
Encodings
URL Uploads
URL Uploads Actions
FOLDER
Folder List
Folder Create
Folder Edit
Folder Delete
Account Info
REQUEST
GET https://viddly.stream/api/account/info?key=45gjptx6j0dv9hhgg
PARAMETERS
Name |
Description |
Example |
Format |
Required |
key |
API key |
45gjptx6j0dv9hhgg |
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
REQUEST
GET https://viddly.stream/api/account/stats?key=45gjptx6j0dv9hhgg
PARAMETERS
Name |
Description |
Example |
Format |
Required |
key |
API key |
45gjptx6j0dv9hhgg |
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://viddly.stream/api/upload/server?key=45gjptx6j0dv9hhgg
PARAMETERS
Name |
Description |
Example |
Format |
Required |
key |
API key |
45gjptx6j0dv9hhgg |
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
PARAMETERS
Name |
Description |
Example |
Format |
Required |
key |
API key |
45gjptx6j0dv9hhgg |
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="45gjptx6j0dv9hhgg">
<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=45gjptx6j0dv9hhgg' -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.xvs.tt/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://viddly.stream/api/upload/url?key=45gjptx6j0dv9hhgg&url={url}
PARAMETERS
Name |
Description |
Example |
Format |
Required |
key |
API key |
45gjptx6j0dv9hhgg |
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
REQUEST
GET https://viddly.stream/api/upload/sub?key=45gjptx6j0dv9hhgg&file_code={file_code}&sub_lang={sub_lang}&sub_url={url}
PARAMETERS
Name |
Description |
Example |
Format |
Required |
key |
API key |
45gjptx6j0dv9hhgg |
STRING |
yes |
file_code |
file code |
gi4o0tlro01u |
STRING |
yes |
sub_lang |
Subtitle language code |
eng |
STRING |
yes |
sub_url |
URL to subtitle file |
https://xvs.tt/1.srt |
STRING |
|
sub_file |
Subtitle file attachment |
1.vtt |
FILE |
|
CURL subtitle file upload sample:
curl -X POST -F 'key=45gjptx6j0dv9hhgg' -F 'file_code=cnypqbf2t79l' -F 'sub_lang=eng' -F '[email protected]' https://xvs.tt/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
}
File Info
REQUEST
GET https://viddly.stream/api/file/info?key=45gjptx6j0dv9hhgg&file_code={file_code}
PARAMETERS
Name |
Description |
Example |
Format |
Required |
key |
API key |
45gjptx6j0dv9hhgg |
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.xvs.tt/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://viddly.stream/api/file/edit?key=45gjptx6j0dv9hhgg&file_code={file_code}&file_title={file_title}
PARAMETERS
Name |
Description |
Example |
Format |
Required |
key |
API key |
45gjptx6j0dv9hhgg |
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://viddly.stream/api/file/list?key=45gjptx6j0dv9hhgg
PARAMETERS
Name |
Description |
Example |
Format |
Required |
key |
API key |
45gjptx6j0dv9hhgg |
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.xvs.tt/fb5asfuj2snh_t.jpg",
"link":"http://xvs.tt/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 Direct Link
REQUEST
GET https://viddly.stream/api/file/direct_link?key=45gjptx6j0dv9hhgg&file_code={file_code}
PARAMETERS
Name |
Description |
Example |
Format |
Required |
key |
API key |
45gjptx6j0dv9hhgg |
STRING |
yes |
file_code |
File code |
fb5asfuj2snh |
STRING |
yes |
q |
Video quality if available. Possible values: n , h , l, o |
n |
STRING |
|
hls |
Generate HLS manifest URL (HLS mod required) |
1 |
INT |
|
RESPONSE
{
"msg":"OK",
"server_time":"2022-11-12 05:32:27",
"status":200,
"result":
{
"versions":[
{"url":"http://s1.xvs.tt/zqsccwdttqsal2eyd2pjrlvodgh7iyejldkogrnzwypvlnajbosxsuchfurq/v.mp4","name":"n","size":"120755726"},
{"url":"http://s1.xvs.tt/zqsccwdttqsal2eyd2pjrlvodgh7iyejldkogrnzwapvlnajbostzwskpx4a/v.mp4","name":"h","size":"135481436"},
{"url":"http://s1.xvs.tt/zqsccwdttqsal2eyd2pjrlvodgh7iyejldkogrnzwqpvlnajbosrpvmuh5la/v.mp4","name":"l","size":"34744877"},
{"url":"http://s1.xvs.tt/zqsccwdttqsal2eyd2pjrlvodgh7iyejldkogrnzw4pvlnajbosyx264xtsq/v.mp4","name":"o","size":"319256576"}
],
"file_length":"1560",
"player_img":"http://img.xvs.tt/abnormamorph.jpg",
"hls_direct":"http://s1.xvs.tt/hls/zqsccwdttqsal2eyd2pjrlvodgh7iyejldkogrnzw,qpvlnajbosrpvmuh5la,ypvlnajbosxsuchfurq,apvlnajbostzwskpx4a,.urlset/master.m3u8"
}
}
File Clone
REQUEST
GET https://viddly.stream/api/file/clone?key=45gjptx6j0dv9hhgg&file_code={file_code}
PARAMETERS
Name |
Description |
Example |
Format |
Required |
key |
API key |
45gjptx6j0dv9hhgg |
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://xvs.tt/u405p6qz5xpi",
"filecode":"u405p6qz5xpi"
}
}
File Delete
REQUEST
GET https://viddly.stream/api/file/delete?key=45gjptx6j0dv9hhgg&file_code={file_code}
PARAMETERS
Name |
Description |
Example |
Format |
Required |
key |
API key |
45gjptx6j0dv9hhgg |
STRING |
yes |
file_code |
File code |
abnormamorph |
STRING |
yes |
RESPONSE
{
"msg":"OK",
"server_time":"2022-11-12 19:39:58",
"status":200
}
Deleted Files
Get last deleted files list
REQUEST
GET https://viddly.stream/api/file/deleted?key=45gjptx6j0dv9hhgg&last={last}
PARAMETERS
Name |
Description |
Example |
Format |
Required |
key |
API key |
45gjptx6j0dv9hhgg |
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://viddly.stream/api/file/dmca?key=45gjptx6j0dv9hhgg&last={last}
PARAMETERS
Name |
Description |
Example |
Format |
Required |
key |
API key |
45gjptx6j0dv9hhgg |
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://viddly.stream/api/folder/list?key=45gjptx6j0dv9hhgg&fld_id={fld_id}&files=1
PARAMETERS
Name |
Description |
Example |
Format |
Required |
key |
API key |
45gjptx6j0dv9hhgg |
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.xvs.tt/abnormamorph_t.jpg",
"link":"http://xvs.tt/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
REQUEST
GET https://viddly.stream/api/folder/create?key=45gjptx6j0dv9hhgg&name={name}&parent_id={parent_id}
PARAMETERS
Name |
Description |
Example |
Format |
Required |
key |
API key |
45gjptx6j0dv9hhgg |
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://viddly.stream/api/folder/edit?key=45gjptx6j0dv9hhgg&fld_id={fld_id}&name={name}
PARAMETERS
Name |
Description |
Example |
Format |
Required |
key |
API key |
45gjptx6j0dv9hhgg |
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 folder. Folder should be empty and have no files / subfolders.
REQUEST
GET https://viddly.stream/api/folder/delete?key=45gjptx6j0dv9hhgg&fld_id={fld_id}
PARAMETERS
Name |
Description |
Example |
Format |
Required |
key |
API key |
45gjptx6j0dv9hhgg |
STRING |
yes |
fld_id |
Folder ID |
25 |
INT |
yes |
RESPONSE
{
"msg":"OK",
"server_time":"2021-08-18 21:21:44",
"status":200
}
File Encodings
Get current encoding queues
REQUEST
GET https://viddly.stream/api/file/encodings?key=45gjptx6j0dv9hhgg
PARAMETERS
Name |
Description |
Example |
Format |
Required |
key |
API key |
45gjptx6j0dv9hhgg |
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://xvs.tt/fb5asfuj2snh.html","progress":15,"status":"ENCODING","title":"Test video","quality":"h","file_code":"fb5asfuj2snh"},
{"link":"http://xvs.tt/fb5asfuj2snh.html","progress":0,"status":"PENDING","title":"Test video","quality":"l","file_code":"fb5asfuj2snh"}
]
}
File URL Uploads
Get current encoding queues
REQUEST
GET https://viddly.stream/api/file/url_uploads?key=45gjptx6j0dv9hhgg
PARAMETERS
Name |
Description |
Example |
Format |
Required |
key |
API key |
45gjptx6j0dv9hhgg |
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://xvs.tt/1.mp4","progress":0,"status":"PENDING","file_code":"","fld_id":"0"},
{"remote_url":"https://xvs.tt/2.mp4","progress":0,"status":"PENDING","file_code":"xyayxm9ajlys","fld_id":"7"}
]
}
File URL Uploads Actions
Get current encoding queues
REQUEST
GET https://viddly.stream/api/file/url_actions?key=45gjptx6j0dv9hhgg
PARAMETERS
Name |
Description |
Example |
Format |
Required |
key |
API key |
45gjptx6j0dv9hhgg |
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
}