API Documentation

Introduction


DoodStream provides a simple HTTP API to integrate ours into your business or application.
All requests to the API should be only GET or POST
You can find your API key here - https://doodstream.com/settings

Rate limits

API requests are rate limited to 10 per second - for more requests contact us

Response
{"msg":"Too Many Requests","status":"429"}

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.co/snaps/xxx.jpg",
      "status": 200,
      "filecode": "xxx",
      "splash_img": "https://img.doodcdn.co/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

Create 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"
  }
}

Rename folder

List all folders

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"
}

List Folders & Files

List all folders

GET https://doodapi.com/api/folder/list?key={your_api_key}
Parameter
Description
Required
key
Your API Key
Yes
fld_id
Folder ID
Yes
only_folders
To list only folders (0 or 1)
No
Response
{
    "msg":"OK",
    "status":200,
    "result":{
        "folders":[
            {
            "name":"Folder name",
            "code":"67299gduj3",
            "fld_id":"123"
            },
        ],
        "files": [
              {
                "download_url": "https://dood.to/d/xxx",
                "single_img": "https://img.doodcdn.co/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"
              }
            ],
    },
        "server_time":"2023-10-17 07:31:01"
}

Manage Files

List 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 (Max 200)
no
fld_id
Videos inside a folder
no
created
Show files uploaded after timestamp (Ex : 2021-10-07 03:15:19)
Or specify number to show only files uploaded X minutes ago
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.co/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.co/snaps/xxx.jpg",
      "status": 200,
      "filecode": "xxx",
      "splash_img": "https://img.doodcdn.co/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.co/snaps/xxx.jpg",
      "thumb_img": "https://img.doodcdn.co/thumbnails/xxx.jpg",
      "splash_img": "https://img.doodcdn.co/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 move

Move your file from one folder to another

GET https://doodapi.com/api/file/move?key={your_api_key}
Parameter
Description
Required
key
Your API Key
Yes
file_code
File code
Yes
fld_id
Folder ID to move the file (set 0 to / directory)
Yes
Response
{
  "msg": "OK",
  "server_time": "2017-08-11 04:30:07",
  "status": 200,
  "result": "true"
}

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

Unofficial PHP client

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

Unofficial Python client

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