API Documentation

Rate Limit

Maximum request rate allowed per API key.

3-4 requests / second

API Key

Get your API key from your account settings.

Dashboard → Settings → API Details

Bugs/Errors/Changes

Please report if something is not as desired. We appreciate your feedback to improve our API.

Account

Account Info

Endpoint

https://api-v2.ddownload.com/api/account/info?key=key

Parameters

key

String

API key Example: 1hj124iod23j12gd3

Response

{
        "msg": "OK",
        "server_time": "2018-08-11 04:30:07",
        "status": 200,
        "result": {
            "storage_left": "inf",
            "premium_traffic_left": 102400,
            "email": "[email protected]",
            "premium_expire": "2018-01-22 18:00:00",
            "balance": "100",
            "traffic_used": "120",
            "traffic_left": "12000",
            "storage_used": "34001"
        }
    }

Account Stats

Endpoint

https://api-v2.ddownload.com/api/account/stats?key=key&last=last

Parameters

key

String

API key Example: 1hj124iod23j12gd3

last

Number

show stats for last X days Default: 7.

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": "2017-09-12",
                "profit_total": "0.00000",
                "views_prem": "0"
            }
        ]
    }

Upload

Upload Form

HTML Example

<form enctype="multipart/form-data" action="UPLOAD_SERVER_URL" method="post">
        <input name="sess_id" value="3qr5wkukoy31pd1g">
        <input name="file" type="file">
    </form>

Upload Server

Endpoint

https://api-v2.ddownload.com/api/upload/server?key=key

Parameters

key

String

API key Example: 1hj124iod23j12gd3

Response

{
        "msg": "OK",
        "server_time": "2017-08-11 04:29:54",
        "status": 200,
        "result": "https://s1.ddownload.com/upload/01"
    }

Files

Get File Info

Endpoint

https://api-v2.ddownload.com/api/file/info?key=key&file_code=file_code

Parameters

key

String

API key Example: 1hj124iod23j12gd3

file_code

String

file code, or list separated by comma Example: gi4o0tlro01u,gi4o0tlro012.

Response

{
        "msg": "OK",
        "server_time": "2017-08-11 04:28:53",
        "status": 200,
        "result": [
            {
                "status": 200,
                "filecode": "gi4o0tlro01u",
                "name": "4K Time Lapse in the EOS 6D Mark II",
                "download": "0",
                "size": "200",
                "uploaded": "2017-08-10 05:07:17"
            },
            {
                "status": 404,
                "filecode": "gi4o0tlro012"
            }
        ]
    }

Get Files List

Endpoint

https://api-v2.ddownload.com/api/file/list?key=key&page=page&per_page=per_page&fld_id=fld_id&public=public&created=created&name=name

Parameters

key

String

API key Example: 1hj124iod23j12gd3

page

Number

page number Example: 2.

per_page

Number

number of results per page Example: 20.

fld_id

Number

folder id Example: 15.

public

Number

show public (1) or private (0) files only Example: 1.

created

String

show only files uploaded after timestamp. Specify number to show only files uploaded X minutes ago. Example: 2018-06-21 05:07:10.

name

String

filter file names Example: Iron Man.

Response

{
        "msg": "OK",
        "server_time": "2017-08-11 04:28:53",
        "status": 200,
        "result": [
            {
                "status": 200,
                "filecode": "gi4o0tlro01u",
                "name": "4K Time Lapse in the EOS 6D Mark II",
                "downloads": "0",
                "size": "20",
                "uploaded": "2017-08-10 05:07:17"
            },
            {
                "status": 404,
                "filecode": "gi4o0tlro012"
            }
        ]
    }

Check Files (Batch)

Check the status of multiple files at once. Returns whether each file exists, is accessible, or has been removed due to DMCA.

Endpoint

https://api-v2.ddownload.com/api/file/check?key=key&file_code=file_code

Parameters

key

String

API key Example: 1hj124iod23j12gd3

file_code

String

File codes separated by comma (max 500). Example: abc123xyz456,def789ghi012,jkl345mno678

Response

{
        "msg": "OK",
        "server_time": "2024-01-15 12:30:45",
        "status": 200,
        "result": {
            "total": 3,
            "stats": {
                "found": 2,
                "not_found": 0,
                "dmca": 1
            },
            "files": [
                {
                    "file_code": "abc123xyz456",
                    "status": 200,
                    "name": "video.mp4",
                    "size": 104857600,
                    "downloads": 150,
                    "uploaded": "2024-01-10 08:15:30"
                },
                {
                    "file_code": "def789ghi012",
                    "status": 200,
                    "name": "document.pdf",
                    "size": 2048000,
                    "downloads": 50,
                    "uploaded": "2024-01-12 14:22:00"
                },
                {
                    "file_code": "jkl345mno678",
                    "status": 451,
                    "msg": "Unavailable for legal reasons"
                }
            ]
        }
    }

Status Codes

200 = File exists and accessible | 404 = File not found | 451 = Removed (DMCA/Copyright)

File Exists (Duplicate Check)

Check if a file already exists in your account before uploading. Search by MD5 hash, filename, or filename + size.

Endpoint

https://api-v2.ddownload.com/api/file/exists?key=key&md5=md5

https://api-v2.ddownload.com/api/file/exists?key=key&name=name

https://api-v2.ddownload.com/api/file/exists?key=key&name=name&size=size

Parameters

key

String

API key Example: 1hj124iod23j12gd3

md5

String

MD5 hash of the file (32 hex characters). Example: d41d8cd98f00b204e9800998ecf8427e

name

String

Filename to search for. Example: video.mp4

size

Number

File size in bytes (optional, for more accurate results). Example: 104857600

Note

You must provide either md5 OR name. Adding size with name makes the search more accurate. MD5 search is the most reliable.

Response (File Found)

{
        "msg": "File exists",
        "server_time": "2024-01-15 12:30:45",
        "status": 200,
        "result": {
            "exists": 1,
            "matches": [
                {
                    "match_type": "md5",
                    "file_code": "abc123xyz456",
                    "name": "video.mp4",
                    "size": 104857600,
                    "uploaded": "2024-01-10 08:15:30",
                    "fld_id": 15,
                    "link": "https://ddownload.com/abc123xyz456"
                }
            ]
        }
    }

Response (File Not Found)

{
        "msg": "File not found",
        "server_time": "2024-01-15 12:30:45",
        "status": 200,
        "result": {
            "exists": 0,
            "matches": []
        }
    }

Response (File Banned)

{
        "msg": "This file hash is blocked due to copyright report",
        "server_time": "2024-01-15 12:30:45",
        "status": 451,
        "result": {
            "banned": 1,
            "md5": "d41d8cd98f00b204e9800998ecf8427e"
        }
    }

Rename File

Endpoint

https://api-v2.ddownload.com/api/file/rename?key=key&file_code=file_code&name=name

Parameters

key

String

API key Example: 1hj124iod23j12gd3

file_code

String

file code, or list separated by comma Example: gi4o0tlro01u,gi4o0tlro012.

name

String

filter file names Example: cool_video.mp4.

Response

{
        "msg": "OK",
        "server_time": "2017-08-11 04:28:53",
        "status": 200,
        "result": [
            {
                "status": 200,
                "filecode": "gi4o0tlro01u",
                "name": "4K Time Lapse in the EOS 6D Mark II",
                "canplay": 1,
                "views_started": "1",
                "downloads": "0",
                "size": "201",
                "uploaded": "2017-08-10 05:07:17"
            },
            {
                "status": 404,
                "filecode": "gi4o0tlro012"
            }
        ]
    }

Set File Folder

Endpoint

https://api-v2.ddownload.com/api/file/set_folder?key=key&file_code=file_code&fld_id=fld_id

Parameters

key

String

API key Example: 1hj124iod23j12gd3

file_code

String

file code, or list separated by comma Example: gi4o0tlro01u,gi4o0tlro012.

fld_id

Number

folder id Example: 15.

Response

{
        "msg": "OK",
        "server_time": "2017-08-11 04:28:53",
        "status": 200
    }

Set File Property

Change file visibility and access settings. You can set files to public/private and/or restrict access to premium users only.

Endpoint

https://api-v2.ddownload.com/api/file/set_property?key=key&file_code=file_code&public=public&premium_only=premium_only

Parameters

key

String

API key Example: 1hj124iod23j12gd3

file_code

String

file code, or list separated by comma (max 500) Example: gi4o0tlro01u,gi4o0tlro012.

public

Number

Set file visibility: 1 = public (visible in your public profile), 0 = private (hidden from public profile). Optional.

premium_only

Number

Restrict download access: 1 = premium users only, 0 = all users can download. Optional.

Note

At least one of public or premium_only must be specified. You can set both in a single request.

Response

{
        "msg": "OK",
        "server_time": "2024-01-15 12:30:45",
        "status": 200,
        "result": {
            "updated": 2,
            "requested": 2
        }
    }

Examples

Make files private:

https://api-v2.ddownload.com/api/file/set_property?key=YOUR_KEY&file_code=abc123xyz456&public=0

Set files to premium-only:

https://api-v2.ddownload.com/api/file/set_property?key=YOUR_KEY&file_code=abc123xyz456&premium_only=1

Make files public and available to all users:

https://api-v2.ddownload.com/api/file/set_property?key=YOUR_KEY&file_code=abc123xyz456,def789ghi012&public=1&premium_only=0

Get Deleted Files

Endpoint

https://api-v2.ddownload.com/api/files/deleted?key=key&last=last

Parameters

key

String

API key Example: 1hj124iod23j12gd3

last

Number

number of files limit Example: 20.

Response

{
        "msg": "OK",
        "server_time": "2017-08-11 04:28:53",
        "status": 200,
        "result": [
            {
                "file_code": "gtl2mhgw4is7",
                "name": "1mb.bin",
                "deleted": "2017-08-11 20:00:01",
                "deleted_ago_sec": "194316"
            },
            {
                "file_code": "uoyagho8c707",
                "name": "2mb.bin",
                "deleted": "2017-08-10 20:30:02",
                "deleted_ago_sec": "278915"
            }
        ]
    }

Folders

Get Folder/File List

Endpoint

https://api-v2.ddownload.com/api/folder/list?key=key&fld_id=fld_id

Parameters

key

String

API key Example: 1hj124iod23j12gd3

fld_id

Number

folder id Example: 15.

Response

{
        "msg": "OK",
        "server_time": "2017-08-11 04:28:53",
        "status": 200,
        "result": {
            "folders": [
                {
                    "name": "Sub1",
                    "fld_id": "24"
                }
            ],
            "files": [
                {
                    "link": "https://ddownload.com/4w0sy8e63f0c",
                    "uploaded": "2017-07-18 04:06:39",
                    "file_code": "4w0sy8e63f0c",
                    "fld_id": "16",
                    "name": "100mb.bin"
                }
            ]
        }
    }

Create New Folder

Endpoint

https://api-v2.ddownload.com/api/folder/create?key=key&parent_id=parent_id&name=name

Parameters

key

String

API key Example: 1hj124iod23j12gd3

parent_id

Number

parent folder id Example: 15.

name

String

folder name Example: New Folder.

Response

{
        "msg": "OK",
        "server_time": "2017-08-11 04:28:53",
        "status": 200,
        "result": {
            "fld_id": "26"
        }
    }

Rename Folder

Endpoint

https://api-v2.ddownload.com/api/folder/rename?key=key&fld_id=fld_id&name=name

Parameters

key

String

API key Example: 1hj124iod23j12gd3

fld_id

Number

folder id Example: 15.

name

String

folder name Example: New Folder.

Response

{
        "msg": "OK",
        "server_time": "2017-08-11 04:28:53",
        "status": 200,
        "result": "true"
    }

Delete Folder

Delete a folder. If the folder contains files or subfolders, use force=1 to move them and delete anyway.

Endpoint

https://api-v2.ddownload.com/api/folder/delete?key=key&fld_id=fld_id

Parameters

key

String

API key Example: 1hj124iod23j12gd3

fld_id

Number

Folder ID to delete. Example: 15

force

Number

Set to 1 to force delete. Files will be moved to root, subfolders to parent.

Response (Success)

{
        "msg": "OK",
        "server_time": "2024-01-15 12:30:45",
        "status": 200,
        "result": {
            "deleted_folder": "My Folder",
            "files_moved_to_root": 5,
            "subfolders_moved_to_parent": 2
        }
    }

Response (Folder Not Empty)

{
        "msg": "Folder contains 5 files. Use force=1 to move files to root and delete folder.",
        "server_time": "2024-01-15 12:30:45",
        "status": 400,
        "result": {
            "files": 5
        }
    }

Move Folder

Move a folder to a different parent folder. Use parent_id=0 to move to root.

Endpoint

https://api-v2.ddownload.com/api/folder/move?key=key&fld_id=fld_id&parent_id=parent_id

Parameters

key

String

API key Example: 1hj124iod23j12gd3

fld_id

Number

Folder ID to move. Example: 15

parent_id

Number

New parent folder ID. Use 0 for root. Example: 20

Response

{
        "msg": "OK",
        "server_time": "2024-01-15 12:30:45",
        "status": 200,
        "result": {
            "moved": 1,
            "folder_name": "My Folder",
            "old_parent_id": 0,
            "new_parent_id": 20,
            "new_parent_name": "Archive"
        }
    }

Note

You cannot move a folder into itself or into one of its own subfolders (circular reference protection).