API Documentation

Introduction

Veev.to provides a simple HTTP API to integrate ours into your business or application.
All requests to the API shall be GET or POST
You can find your API key here - https://veev.to/settings

Account

Account Info

Get basic info of your account

GET https://veev.to/api/account/info?key={your_api_key}
Parameter
Description
Required
key
Your API Key
Yes
Response
{
  "msg": "OK",
  "server_time": "2017-08-11 04:30:07",
  "status": 200,
  "result": {
  		"login":"prouploader",
  		"files_total":"31",
      "email": "[email protected]",
      "balance": "0.00000",
      "storage_used" :"24186265",
      "storage_left": 128824832615,
      "premim_expire": "2025-10-24 21:00:00
  }
}

Account Reports

Get reports of your account (default last 7 days)

GET https://veev.to/api/account/stats?key={your_api_key}
Parameter
Description
Required
key
Your API Key
Yes
last
Last x days report
No
Response
{
  "msg": "OK",
  "server_time": "2017-08-11 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"
    },
    {
      "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-13",
      "profit_total": "0.00000",
      "views_prem": "0"
    }
  ]
}

Upload

Local upload

Upload local files using API

GET https://veev.to/api/upload/server?key={your_api_key}
Parameter
Description
Required
key
Your API Key
Yes
Response
{
  "msg": "OK",
  "server_time": "2017-08-11 04:30:07",
  "status": 200,
  "result": "https://xxx.veev.to/upload/01"
}

Local to Fileserver

Specifications for uploading files to fileservers obtained from previous step

POST https://xxx.veev.to/upload/01
Parameter
Description
Required
key
Your API Key
Yes
file
Vide file(s)
Yes
file_title
Title of your video
No
file_descr
Description of your video
No
fld_id
Folder ID
No
snapshot
Custom video snapshot (up to 300KB)
No
file_public
Public flag
No
file_adult
Adult flag
No
html_redirect
Use old style HTML redirect output instead of JSON
No
Example to use (cURL)
curl -X POST -F 'api_key={your_api_key}' -F '[email protected]' -F '[email protected]' https://xxx.veev.to/upload/01?{your_api_key}
Example to use with custom title and snapshot (cURL)
curl -X POST -F 'api_key={your_api_key}' -F 'file_title="Funny cat video"' -F '[email protected]' -F '[email protected]' https://xxx.veev.to/upload/01?{your_api_key}
Example to use (HTML)
<form enctype="multipart/form-data" action="https://xxx.veev.to/upload/01?{your_api_key}" method="post">
<input type="hidden" name="api_key" value="{your_api_key}">
<input name="file" type="file">
<input type="submit">
</form>
After upload response
{
    "msg": "OK",
    "status": 200,
    "files": [{
        "filecode": "u9150wqzvhxj",
        "filename": "1.avi",
        "status": "OK"
    }, {
        "filecode": "gzky98gfg6hn",
        "filename": "2.avi",
        "status": "OK"
    }]
}

Copy or Clone

Copy / Clone your's or other's file

GET https://veev.to/api/file/clone?key={your_api_key}
Parameter
Description
Required
key
Your API Key
Yes
file_code
File code
Yes
fld_id
Folder ID (to copy inside the folder)
No
file_title
New file title
No
Response
{
  "msg":"OK",
  "server_time":"2022-11-12 19:39:58",
  "status":200,
  "result":
  {
    "url":"https://veev.to/u405p6qz5xpi",
    "filecode":"u405p6qz5xpi"
  }
}

Remote Upload

Add link

Upload files using direct links

GET https://veev.to/api/upload/url?key={your_api_key}&url={upload_url}
Parameter
Description
Required
key
Your API Key
Yes
url
URL to upload
Yes
fld_id
To upload inside a folder
No
file_public
Public flag
No
file_adult
Adult flag
No
Response
{
  "msg":"OK",
  "server_time":"2021-08-12 20:56:47",
  "status":200,
  "result":{
    "filecode":"fb5asfuj2snh"
  }
}

Remote upload list

Remote Upload List & Status

GET https://veev.to/api/urlupload/list?key={your_api_key}
Parameter
Description
Required
key
Your API Key
Yes
file_code
Filter by File code
No
Response
{
  "requests_available":2,
  "msg":"OK",
  "server_time":"2022-06-14 20:30:20",
  "status":200,
  "result":[
    {
    	"remote_url":"https://direct.video/1.mp4",
    	"progress":0,
    	"status":"PENDING",
    	"file_code":"",
    	"fld_id":"0"
    },
    {
    	"remote_url":"https://direct.video/2.mp4",
    	"progress":0,
    	"status":"PENDING",
    	"file_code":"xyayxm9ajlys",
    	"fld_id":"7"
    }
  ]
}

Remote upload slots

Get total & used remote upload slots

GET https://veev.to/api/urlupload/slots?key={your_api_key}
Parameter
Description
Required
key
Your API Key
Yes
Response
{
  "msg": "OK",
  "server_time": "2017-08-11 04:30:07",
  "status": 200,
  "total_slots": "100",
  "used_slots": "10"
}

Remote upload actions

Perform various actions on remote upload

GET https://veev.to/api/urlupload/actions?key={your_api_key}
Parameter
Description
Required
key
Your API Key
Yes
restart_errors
Restart all errors
Yes
delete_errors
Clear all errors
No
delete_all
Clear all
No
delete_code
Delete a transfer, pass file_code
No
Response
{
  "requests_available":2,
  "msg":"OK",
  "server_time":"2022-06-14 20:30:20",
  "status":200
}

Manage folders

List folders

List your folders

GET https://veev.to/api/folder/list?key={your_api_key}&fld_id={fld_id}&files=1
Parameter
Description
Required
key
Your API Key
Yes
fld_id
Parent folder id, default=0
No
files
Show file list in this folder
No
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.veev.to/abnormamorph_t.jpg",
        "link":"https://veev.to/abnormamorph",
        "file_code":"abnormamorph",
        "file_code_protected":"qxsadcjnaosdnczjndsfidnzicizncizsducniu",
        "canplay":1,
        "length":"1560",
        "views":"10",
        "uploaded":"2021-08-20 20:37:22",
        "public":"0",
        "fld_id":"0",
        "title":"Tri pljus dva 2012 SATRip"
      }
    ]
  }
}

Create folder

Create a folder

GET https://veev.to/api/folder/create?key={your_api_key}&name={name}&parent_id={parent_id}
Parameter
Description
Required
key
Your API Key
Yes
name
Name of the folder
Yes
parent_id
Parent folder ID (default to 0)
No
descr
Folder description
No
Response
{
  "msg": "OK",
  "server_time": "2017-08-11 04:30:07",
  "status": 200,
  "result": {
    "fld_id": "1234567"
  }
}

Edit folder

Update folder details, skipped fields won't be updated

GET https://veev.to/api/folder/edit?key={your_api_key}&fld_id={fld_id}&name={name}
Parameter
Description
Required
key
Your API Key
Yes
fld_id
Folder ID
Yes
name
New name of the folder
Yes
parent_id
Parent Folder ID
No
descr
Folder description
No
Response
{
  "msg":"OK",
  "server_time":"2021-08-18 21:21:44",
  "status":200,
  "result":"true"
}

Delete folder

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

GET https://veev.to/api/folder/delete?key={your_api_key}&fld_id={fld_id}
Parameter
Description
Required
key
Your API Key
Yes
fld_id
Folder id
Yes
Response
{
  "msg":"OK",
  "server_time":"2021-08-18 21:21:44",
  "status":200
}

Manage Files

List files

List all files

GET https://veev.to/api/file/list?key={your_api_key}
Parameter
Description
Required
key
Your API Key
Yes
page
Pagination
no
per_page
Max videos per page
no
fld_id
Videos inside a folder
no
title
Filter videos by title
no
created
Show only videos uploaded after timestamp. Specify number to show videos uploaded X minutes ago
no
public
Show public (1) or private (0) videos only, empty to show all
no
adult
Show adult (1) or safe (0) videos only, empty to show all
no
Response
{
  "msg":"OK",
  "server_time":"2021-08-13 20:35:18",
  "status":200,
  "result":
  {
    "files":[
      {
        "thumbnail":"http://img.veev.to/fb5asfuj2snh_t.jpg",
        "link":"https://veev.to/fb5asfuj2snh",
        "file_code":"fb5asfuj2snh",
        "file_code_protected":"wxzafdasfnaosdnczjndsfidnzicizncizsducniu",
        "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 info

Get file info

GET https://veev.to/api/file/info?key={your_api_key}&file_code={file_code}
Parameter
Description
Required
key
Your API Key
Yes
file_code
File code
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.veev.to/fb5asfuj2snh.jpg",
    "status":200,
    "file_code":"fb5asfuj2snh",
    "file_code_protected":"qxsadcjnaosdnczjndsfidnzicizncizsducniu",
    "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

Edit your file

GET https://veev.to/api/file/edit?key={your_api_key}&file_code={file_code}&file_title={file_title}
Parameter
Description
Required
key
Your API Key
Yes
file_code
File code
Yes
file_title
New file name
No
file_descr
New file description
No
file_fld_id
New folder id
No
file_public
Set public flag
No
file_adult
Set adult flag
No
Response
{
  "msg": "OK",
  "server_time": "2017-08-11 04:30:07",
  "status": 200,
  "result": "true"
}

Delete file

Delete a file

GET https://veev.to/api/file/delete?key={your_api_key}&file_code={file_code}
Parameter
Description
Required
key
Your API Key
Yes
file_code
File code
Yes
Response
{
  "msg":"OK",
  "server_time":"2022-11-12 19:39:58",
  "status":200
}

Deleted files

Get last deleted files list

GET https://veev.to/api/file/deleted?key={your_api_key}&last={last}
Parameter
Description
Required
key
Your API Key
Yes
last
Show files deleted in last X hours
No
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

GET https://veev.to/api/file/dmca?key={your_api_key}&last={last}
Parameter
Description
Required
key
Your API Key
Yes
last
Show files reported last X hours only
No
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 current encoding queues

GET https://veev.to/api/file/encodings?key={your_api_key}
Parameter
Description
Required
key
Your API Key
Yes
file_code
Filter by File code
No
Response
{
  "msg":"OK",
  "server_time":"2021-08-18 21:44:09",
  "status":200,
  "result":[
    {"link":"https://veev.to/fb5asfuj2snh","progress":15,"status":"ENCODING","title":"Test video","quality":"h","file_code":"fb5asfuj2snh"},
    {"link":"https://veev.to/fb5asfuj2snh","progress":0,"status":"PENDING","title":"Test video","quality":"l","file_code":"fb5asfuj2snh"}
  ]
}

Upload Subtitle

Upload subtitles for videos

POST https://veev.to/api/file/subtitle?key={your_api_key}&file_code={file_code}&sub_lang={sub_lang}&sub_url={url}
Parameter
Description
Required
key
Your API Key
Yes
file_code
File code to add subtitle to
Yes
sub_lang
Subtitle language code
Yes
sub_url
URL to subtitle file
No
sub_file
Subtitle file attachment
No
Example to use (CURL)
curl -X POST -F 'key=45ne2alz1m0p21dli' -F 'file_code=cnypqbf2t79l' -F 'sub_lang=eng' -F '[email protected]' https://veev.to/api/file/subtitle
After upload response
{
  "msg":"OK",
  "server_time":"2021-08-12 20:56:47",
  "status":200
}

Extras

Protected file code

Protected file codes can be used to share a temporarily link without exposing your original video. Each time a user visits the original protected link they are redirected to a secondary link that is only valid for 12 hours. If you want to avoid ever sharing your protected link you can setup a task in the background to run every few hours to update the secondary link by sending a request to https://veev.to/d/[file_code_protected] and capturing the redirect destination which will be valid for the next 12 hours.

URL https://veev.to/d/wakjncksjandksahdnaskdhanskdasdaskdmlasmdlk

Remote splash image

Load splash image via URL directly

URL https://veev.to/e/xxx?c_poster=https://example.com/image.jpg
Parameter
Description
Required
c_poster
Splash image
Yes

Remote subtitle

Load multiple subtitles via URL directly

URL https://veev.to/e/xxx?sub1_file=https://example.com/sub.vtt&sub1_label=English
Parameter
Description
Required
sub1_file
Subtitle URL (srt or vtt)
Yes
sub1_label
Subtitle language or any lable
Yes

Remote subtitle JSON

Load multiple subtitles via URL in JSON format

URL https://veev.to/e/xxx?subtitle_json=https://example.com/sub.json
Parameter
Description
Required
subtitle_json
Multiple subtitle in JSON format
Yes
Remote subtitle JSON example
[
 {"src":"https://example.com/name_en.vtt", "label":"English", default: true},
 {"src":"https://example.com/name_fr.vtt", "label":"French"}
]