API Document
View your API key →Account Info
| Name | Description | Example | Format | Required |
|---|---|---|---|---|
| api_key | API key | 106616nzdp9q106rynvzm0 | STRING |
{
"msg": "OK",
"server_time": "2026-01-08 00:46:36",
"status": 200,
"result": {
"username": "username",
"email": "email",
"premium": "expired",
"premium_expire": "expired",
"storage_left": "unlimited",
"storage_used": 392554,
"videos_total": 847
}
}
Upload Server
| Name | Description | Example | Format | Required |
|---|---|---|---|---|
| api_key | API key | 106616nzdp9q106rynvzm0 | STRING |
{
"msg": "OK",
"status": 200,
"result": {
"upload_server": "https://s1.vidara.so/api/upload"
}
}
Upload Video
| Name | Description | Example | Format | Required |
|---|---|---|---|---|
| key | Your API key | 106616nzdp9q106rynvzm0 | STRING | |
| file | Video file to upload | video.mp4 | FILE |
<form method="POST" enctype="multipart/form-data" action="https://s1.vidara.so/api/upload">
<input type="hidden" name="api_key" value="106616nzdp9q106rynvzm0">
<input type="file" name="file">
<input type="submit">
</form>
curl -X POST https://s1.vidara.so/upload/01 -F "api_key=106616nzdp9q106rynvzm0" -F "file=@/path/to/video.mp4"
{
"url": "https://vidara.so/v/AbC123xY",
"title": "video.mp4",
"video_id": 2494951,
"filecode": "AbC123xY"
}
Upload URL
| Name | Description | Example | Format | Required |
|---|---|---|---|---|
| api_key | API key | 106616nzdp9q106rynvzm0 | STRING | |
| url | Direct URL to the video file | https://example.com/video.mp4 | STRING |
{
"msg": "OK",
"server_time": "2021-08-12 20:56:47",
"status": 200,
"data": {
"filecode": "a1b2c3d4e5f6",
"title": "video",
"size": 52428800
}
}
Upload Thumbnail
| Name | Description | Example | Format | Required |
|---|---|---|---|---|
| api_key | API key | 106616nzdp9q106rynvzm0 | STRING | |
| filecode | File code of the video | AbC123xY | STRING | |
| thumb_url | Direct URL to the thumbnail image (jpg, png, gif, webp) | https://example.com/thumb.jpg | STRING |
{
"msg": "OK",
"server_time": "2026-01-08 01:05:32",
"status": 200
}
Upload Subtitle
| Name | Description | Example | Format | Required |
|---|---|---|---|---|
| api_key | API key | 106616nzdp9q106rynvzm0 | STRING | |
| filecode | File code of the video | AbC123xY | STRING | |
| sub_lang | Language of the subtitle | English | STRING | |
| sub_url | Direct URL to the subtitle file (SRT or VTT) | https://example.com/subtitle.srt | STRING |
{
"msg": "OK",
"server_time": "2026-01-08 01:05:32",
"status": 200
}
File Info
| Name | Description | Example | Format | Required |
|---|---|---|---|---|
| api_key | API key | 106616nzdp9q106rynvzm0 | STRING | |
| filecode | File code of the video | AbC123xY | STRING | |
| status | Filter by file status: active, blocked, error | active | STRING | No |
{
"server_time": "2026-01-08 01:05:32",
"status": 200,
"result": [
{
"player_img": "https://vidara.so/thumb.jpg",
"status": "active",
"filecode": "AbC123xY",
"link": "https://vidara.so/AbC123xY",
"video_length": "12",
"video_title": "My Video Title",
"video_views": 1543,
"video_created": "2025-08-18",
"file_active": 1
},
{
"status": "active",
"filecode": "AbC123xY"
}
]
}
File List
| Name | Description | Example | Format | Required |
|---|---|---|---|---|
| api_key | API key | 106616nzdp9q106rynvzm0 | STRING | |
| page | Page number (starts from 1) | 1 | INTEGER | No |
| limit | Files per page (max 200) | 100 | INTEGER | No |
| title | Filter videos by title (partial match) | vacation | STRING | No |
| fld_id | Filter videos by folder ID | 5 | INTEGER | No |
| status | Filter by file status: active, blocked, error | active | STRING | No |
{
"msg": "OK",
"server_time": "2026-01-08 01:05:32",
"status": 200,
"result": {
"videos": [
{
"vid_id": 123456,
"filecode": "AbC123xY",
"title": "My Video Title",
"thumbnail": "https://vidara.so/thumb.jpg",
"length": "12",
"link": "https://vidara.so/AbC123xY",
"views": 1543,
"uploaded": "2025-08-18",
"status": "active",
"file_active": 1
}
],
"results": 1,
"page": 1,
"per_page": 100,
"total_pages": 9,
"total": 847
}
}
Video Clone
| Name | Description | Example | Format | Required |
|---|---|---|---|---|
| api_key | API key | 106616nzdp9q106rynvzm0 | STRING | |
| filecode | Source filecode | AbC123xY | STRING |
{
"msg": "OK",
"status": 200,
"result": {
"url": "https://vidara.so/dE4fG5hI6jK7l",
"filecode": "dE4fG5hI6jK7l"
}
}
Account Stats
Per-day views and earnings. Days with no activity are omitted.
| Name | Description | Example | Format | Required |
|---|---|---|---|---|
| api_key | API key | 106616nzdp9q106rynvzm0 | STRING | |
| last | Number of days to report. Defaults to 7, capped at 365. | 7 | INTEGER | No |
{
"msg": "OK",
"server_time": "2026-01-08 00:46:36",
"status": 200,
"result": {
"stats": [
{
"day": "2026-01-08",
"views": 1543,
"earnings": "0.7215"
}
],
"results": 1,
"days": 7
}
}
Encoding Status
Encoding progress for one video. Poll this after an upload until progress_percentage reaches 100%. Returns "encodings": null once nothing is in progress.
| Name | Description | Example | Format | Required |
|---|---|---|---|---|
| api_key | API key | 106616nzdp9q106rynvzm0 | STRING | |
| filecode | Video filecode | AbC123xY | STRING |
{
"msg": "OK",
"status": 200,
"result": {
"encodings": [
{
"filecode": "AbC123xY",
"type": "encode",
"progress_percentage": "42%",
"last_update": "3m",
"created_at": "2026-01-08 01:05:32"
}
],
"total": 1
}
}
File Rename
Changes a video's title. Deleted videos cannot be renamed.
| Name | Description | Example | Format | Required |
|---|---|---|---|---|
| api_key | API key | 106616nzdp9q106rynvzm0 | STRING | |
| filecode | Video filecode | AbC123xY | STRING | |
| title | New title. Must not be empty. | New title | STRING |
{
"msg": "OK",
"server_time": "2026-01-08 00:46:36",
"status": 200,
"result": {
"filecode": "AbC123xY",
"title": "New title"
}
}
File Move
Moves a video into one of your folders. Pass fld_id=0, or omit it, to move the video back to the root.
| Name | Description | Example | Format | Required |
|---|---|---|---|---|
| api_key | API key | 106616nzdp9q106rynvzm0 | STRING | |
| filecode | Video filecode | AbC123xY | STRING | |
| fld_id | Destination folder, which must be yours. 0 or omitted moves the video to the root. | 5 | INTEGER | No |
{
"msg": "OK",
"server_time": "2026-01-08 00:46:36",
"status": 200,
"result": {
"filecode": "AbC123xY",
"fld_id": 5
}
}
File Delete
Deletes a video. The delete is soft — the video stops playing and leaves your file list, but it remains listed by Deleted Files.
| Name | Description | Example | Format | Required |
|---|---|---|---|---|
| api_key | API key | 106616nzdp9q106rynvzm0 | STRING | |
| filecode | Video filecode | AbC123xY | STRING |
{
"msg": "OK",
"server_time": "2026-01-08 00:46:36",
"status": 200,
"result": {
"filecode": "AbC123xY",
"deleted": true
}
}
Deleted Files
Your deleted videos, newest first.
| Name | Description | Example | Format | Required |
|---|---|---|---|---|
| api_key | API key | 106616nzdp9q106rynvzm0 | STRING | |
| limit | Rows to return. Defaults to 50, capped at 500. | 50 | INTEGER | No |
{
"msg": "OK",
"server_time": "2026-01-08 00:46:36",
"status": 200,
"result": {
"files": [
{
"filecode": "AbC123xY",
"title": "My Video",
"deleted": "2026-01-08 01:05:32"
}
],
"results": 1
}
}
DMCA Reports
Your videos with an upheld copyright report against them.
| Name | Description | Example | Format | Required |
|---|---|---|---|---|
| api_key | API key | 106616nzdp9q106rynvzm0 | STRING |
{
"msg": "OK",
"server_time": "2026-01-08 00:46:36",
"status": 200,
"result": {
"files": [
{
"filecode": "AbC123xY",
"title": "My Video",
"date": "2026-01-08 01:05:32"
}
],
"results": 1
}
}
Folder List
All your folders, ordered by name. Folders are flat — there is no nesting.
| Name | Description | Example | Format | Required |
|---|---|---|---|---|
| api_key | API key | 106616nzdp9q106rynvzm0 | STRING |
{
"msg": "OK",
"server_time": "2026-01-08 00:46:36",
"status": 200,
"result": {
"folders": [
{
"fld_id": 5,
"name": "Vacation",
"code": 5,
"videos": 12,
"created": "2026-01-08 01:05:32"
}
],
"results": 1
}
}
Folder Create
| Name | Description | Example | Format | Required |
|---|---|---|---|---|
| api_key | API key | 106616nzdp9q106rynvzm0 | STRING | |
| name | Folder name | Vacation | STRING |
{
"msg": "OK",
"status": 200,
"result": {
"folder_id": 5,
"name": "Vacation"
}
}
Folder Rename
| Name | Description | Example | Format | Required |
|---|---|---|---|---|
| api_key | API key | 106616nzdp9q106rynvzm0 | STRING | |
| fld_id | Folder to rename, which must be yours | 5 | INTEGER | |
| name | New folder name | Holiday | STRING |
{
"msg": "OK",
"server_time": "2026-01-08 00:46:36",
"status": 200,
"result": {
"fld_id": 5,
"name": "Holiday"
}
}
Folder Delete
Deletes the folder only. The videos inside it are kept and moved back to the root.
| Name | Description | Example | Format | Required |
|---|---|---|---|---|
| api_key | API key | 106616nzdp9q106rynvzm0 | STRING | |
| fld_id | Folder to delete, which must be yours | 5 | INTEGER |
{
"msg": "OK",
"server_time": "2026-01-08 00:46:36",
"status": 200,
"result": {
"fld_id": 5,
"deleted": true
}
}