logo

API Documentation

Introduction

DoodStream 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://doodstream.com/settings

Account

Account Info Get basic info of your account

GET https://doodapi.com/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": {
      "email": "email@test.com",
      "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://doodapi.com/api/account/stats?key={your_api_key}
Parameter
Description
Required
key
Your API Key
Yes
last
Last x days report
No
from_date
From date - YYYY-MM-DD
No
to_date
To date - YYYY-MM-DD
No
Response
{
  "msg": "OK",
  "server_time": "2017-08-11 04:30:07",
  "status": 200,
  "result": [
    {
      "profit_views": "0.00000",
      "downloads": "0",
      "views": "0",
      "day": "2017-08-11",
      "profit_total": "0.00000"
    },
    {
      "profit_views": "0.00000",
      "downloads": "0",
      "views": "0",
      "day": "2017-08-12",
      "profit_total": "0.00000"
    }
  ]
}

DMCA List Get DMCA reported files list (500 results per page)

GET https://doodapi.com/api/dmca/list?key={your_api_key}
Parameter
Description
Required
key
Your API Key
Yes
per_page
Results per page (default 500)
No
page
Pagination
No
Response
{
  "msg": "OK",
  "server_time": "2017-08-11 04:30:07",
  "status": 200,
  "result": [
    {
      "reported_on": "2017-08-11 04:30:07",
      "protected_download": "yyy",
      "protected_embed": "zzz",
      "file_code": "xxx",
      "fld_id": "0",
      "disabled_on": "2017-08-11 05:00:07"
    }
  ]
}

Upload

Local upload Upload local files using API

GET https://doodapi.com/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.dood.video/upload/01"
}
Example to use (cURL)
curl -X POST -F 'api_key={your_api_key}' -F 'file=@file.mp4' https://xxx.dood.video/upload/01?{your_api_key}
Example to use (HTML)
<form enctype="multipart/form-data" action="https://xxx.dood.video/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",
  "server_time": "2017-08-11 04:30:07",
  "status": 200,
  "result": [
    {
      "download_url": "https://dood.to/d/xxx",
      "single_img": "https://img.doodcdn.com/snaps/xxx.jpg",
      "status": 200,
      "filecode": "xxx",
      "splash_img": "https://img.doodcdn.com/splash/xxx.jpg",
      "canplay": 1,
      "size": "123456",
      "length": "123456",
      "uploaded": "2017-08-11 04:30:07",
      "protected_embed": "https://dood.to/e/yyy",
      "protected_dl": "https://dood.to/d/zzz",
      "title": "test_file"
    }
  ]
}

Copy or Clone Copy / Clone your's or other's file

GET https://doodapi.com/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
Response
{
  "msg": "OK",
  "server_time": "2017-08-11 04:30:07",
  "status": 200,
  "result": {
    "embed_url": "https://dood.la/e/xxx",
    "download_url": "https://dood.la/d/xxx",
    "protected_download": "https://dood.la/d/yyy",
    "protected_embed": "https://dood.la/e/zzz",
    "filecode": "xxx"
  }
}

Remote Upload

Add link Upload files using direct links

GET https://doodapi.com/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
new_title
To set new title
No
Response
{
  "msg": "OK",
  "server_time": "2017-08-11 04:30:07",
  "new_title": "",
  "status": 200,
  "total_slots": "100",
  "result": {
    "filecode": "98zukoh5jqiw"
  },
  "used_slots": "0"
}

Remote upload list Remote Upload List & Status

GET https://doodapi.com/api/urlupload/list?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": [
    {
      "bytes_total": "0",
      "created": "2017-08-11 04:30:07",
      "remote_url": "https://dropbox.com/hukbasd7k3fd",
      "status": "working",
      "file_code": "98zukoh5jqiw",
      "bytes_downloaded": "0",
      "folder_id": "0"
    }
  ]
}

Remote upload status Remote Upload Status

GET https://doodapi.com/api/urlupload/status?key={your_api_key}
Parameter
Description
Required
key
Your API Key
Yes
file_code
File code of the file
Yes
Response
{
  "msg": "OK",
  "server_time": "2017-08-11 04:30:07",
  "status": 200,
  "result": [
    {
      "bytes_total": "0",
      "created": "2017-08-11 04:30:07",
      "remote_url": "https://dropbox.com/hukbasd7k3fd",
      "status": "working",
      "file_code": "hjsnr087johj",
      "bytes_downloaded": "0",
      "folder_id": "0"
    }
  ]
}

Remote upload slots Get total & used remote upload slots

GET https://doodapi.com/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://doodapi.com/api/urlupload/actions?key={your_api_key}
Parameter
Description
Required
key
Your API Key
Yes
restart_errors
Restart all errors
Yes
clear_errors
Clear all errors
No
clear_all
Clear all
No
delete_code
Delete a transfer, pass file_code
No
Response
{
  "msg": "Errors restarted",
  "server_time": "2017-08-11 04:30:07",
  "status": 200
}

Manage folders

Folder Create a folder

GET https://doodapi.com/api/folder/create?key={your_api_key}
Parameter
Description
Required
key
Your API Key
Yes
name
Name of the folder
Yes
parent_id
Parent folder ID
No
Response
{
  "msg": "OK",
  "server_time": "2017-08-11 04:30:07",
  "status": 200,
  "result": {
    "fld_id": "1234567"
  }
}

Folder Rename folder

GET https://doodapi.com/api/folder/rename?key={your_api_key}
Parameter
Description
Required
key
Your API Key
Yes
fld_id
Folder ID
Yes
name
New name of the folder
Yes
Response
{
  "msg": "OK",
  "server_time": "2017-08-11 04:30:07",
  "status": 200,
  "result": "true"
}

Manage Files

Files List all files

GET https://doodapi.com/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
Response
{
  "msg": "OK",
  "server_time": "2017-08-11 04:30:07",
  "status": 200,
  "result": {
    "total_pages": 1,
    "files": [
      {
        "download_url": "https://dood.to/d/xxx",
        "single_img": "https://img.doodcdn.com/snaps/xxx.jpg",
        "file_code": "xxx",
        "canplay": 1,
        "length": "1234",
        "views": "1",
        "uploaded": "2017-08-11 04:30:07",
        "public": "1",
        "fld_id": "0",
        "title": "test_file"
      }
    ],
    "results_total": "1",
    "results": 1
  }
}

File status Check status of your file

GET https://doodapi.com/api/file/check?key={your_api_key}
Parameter
Description
Required
key
Your API Key
Yes
file_code
File code
Yes
Response
{
  "msg": "OK",
  "server_time": "2017-08-11 04:30:07",
  "status": 200,
  "result": [
    {
      "status": "Active",
      "filecode": "xxx"
    }
  ]
}

File info Get file info

GET https://doodapi.com/api/file/info?key={your_api_key}
Parameter
Description
Required
key
Your API Key
Yes
file_code
File code
Yes
Response
{
  "msg": "OK",
  "server_time": "2017-08-11 04:30:07",
  "status": 200,
  "result": [
    {
      "single_img": "https://img.doodcdn.com/snaps/xxx.jpg",
      "status": 200,
      "filecode": "xxx",
      "splash_img": "https://img.doodcdn.com/splash/xxx.jpg",
      "canplay": 1,
      "size": "123456",
      "views": "0",
      "length": "123456",
      "uploaded": "2017-08-11 04:30:07",
      "last_view": "",
      "protected_embed": "/e/yyy",
      "protected_dl": "/d/zzz",
      "title": "test_file"
    }
  ]
}

File image Get file splash, single or thumbnail image

GET https://doodapi.com/api/file/image?key={your_api_key}
Parameter
Description
Required
key
Your API Key
Yes
file_code
File code
Yes
Response
{
  "msg": "OK",
  "server_time": "2017-08-11 04:30:07",
  "status": 200,
  "result": [
    {
      "status": 200,
      "filecode": "xxx",
      "title": "test_file",
      "single_img": "https://img.doodcdn.com/snaps/xxx.jpg",
      "thumb_img": "https://img.doodcdn.com/thumbnails/xxx.jpg",
      "splash_img": "https://img.doodcdn.com/splash/xxx.jpg"
    }
  ]
}

File rename Rename your file

GET https://doodapi.com/api/file/rename?key={your_api_key}
Parameter
Description
Required
key
Your API Key
Yes
file_code
File code
Yes
title
New file name
Yes
Response
{
  "msg": "OK",
  "server_time": "2017-08-11 04:30:07",
  "status": 200,
  "result": "true"
}

File search Search your files

GET https://doodapi.com/api/search/videos?key={your_api_key}
Parameter
Description
Required
key
Your API Key
Yes
search_term
Search term
Yes
Response
{
  "msg": "OK",
  "server_time": "2017-08-11 04:30:07",
  "status": 200,
  "result": "true"
}

Extras

Remote splash image Load splash image via URL directly

URL https://dood.so/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://dood.so/e/xxx?c1_file=https://example.com/sub.vtt&c1_label=English
Parameter
Description
Required
c1_file
Subtitle URL (srt or vtt)
Yes
c1_label
Subtitle language or any lable
Yes

Remote subtitle JSON Load multiple subtitles via URL in JSON format

URL https://dood.so/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"}
]

Clients

SDK Unofficial PHP client

GITHUB https://github.com/Marchay/doodstream-PHP-library

SDK Unofficial Python client

pypi https://pypi.org/project/doodstream/