API

There is a free API available for everyone. Each user can create up to 1000 downloads per month for free. Please contact me if you need a bigger amount or have your own servers where you need to store the files.


The API is currently in beta phase. That's why manually have to contact me contact me, even if you only want to try it or only have a small amount of requests. Additionally, only downloads (and no converts) are available (this will change in the future though).

For every request, you will need to provide your specific API key. If an error should occur, the API responds with a JSON object with the only field named error. It's a string containing the error message:

{
     "error":  "Site not supported."
}

If there is no error field and the status code is 200, the action succeeded. When you receive an error code < 500 && >= 400, you are using the API wrong. Just check the text which gets returned with content type text/plain.


Legend:

?    –  Optional field
|    –  Or
{{p}}  –  Placeholder
[]   –  Array

List supported sites

Lists all supported sites with their status, alternative domain names, supported actions and other properties.

Request

[POST]

Schema
{
     "key":  String
}
Example
{
     "key":  "{{api-key}}"
}
Response
Schema:
{
     "items": [
        {
             "name":  String,
             "status":  "online|broken|planned",
             "domains":  [String],
             "adult?":  Boolean
        }
    ]
}
Example:
{
     "items": [
        {
             "name":  "YouTube",
             "status":  "online",
             "domains": [
                 "youtube.com",
                 "youtu.be"
            ]
        },
        {
             "name":  "AdultStreamingSite",
             "status":  "broken",
             "domains": [
                 "streaming.site"
            ],
             "adult":  true
        }
    ]
}

Create a download

Creates a download. Set force to download to force downloading the file or inline to stream the file in a browser (streaming also supports range headers). Omit it to let the program decide depending on the user-agent. Use secure to return secure links (https://).

Request

[POST]

Schema
{
     "key":  String,
     "url":  String,
     "force?":  "download|inline",
     "secure?":  Boolean
}
Example
{
     "key":  "{{api-key}}",
     "url":  "https://www.youtube.com/watch?v=_nLGoqqDc0w",
     "force":  "inline",
     "secure":  true
}
Response
Schema:
{
     "id":  String,
     "title":  String,
     "server":  String,
     "format":  String,
     "extractor":  String,
     "url":  String,
     "download":  String,
     "thumbnail?":  String
}
Example:
{
     "id":  "6hf82uw8plj8nrk99031f765zw56d2t9ne8t",
     "title":  "UE4 - Substance Designer",
     "server":  "dl6",
     "format":  "mp4",
     "extractor":  "youtube",
     "url":  "https://www.youtube.com/watch?v=_nLGoqqDc0w",
     "download":  "https://dl6.video-download.online/vdo/dl/6hf82uwdpljwnrk99031f785zw56d2t9neet/UE4%20-%20Substance%20Designer.mp4",
     "thumbnail":  "https://dl6.video-download.online/vdo/tn/sfcuTGuiscgKdz3JZLhW3YoQ2AQYQTHhGeaQ"
}

Item info

Request

[POST]

Schema
{
     "key":  "{{api-key}}",
     "id":  String
}
Example
{
     "key":  "{{api-key}}",
     "id":  "6hf82uw8plj8nrk99031f765zw56d2t9ne8t"
}
Response
Schema:
{
     "id":  String,
     "status":  String,
     "link":  String,
     "date":  "Number",
     "download":  String
}
Example:
{
     "id":  "sfcuTGuiscgKdz3JZLhW3YoQ2AQYQTHhGeaQ",
     "status":  "created",
     "title":  "\"You and I\" (Zeds Dead & Omar LinX) (Official Music Video) | Zeds Dead",
     "server":  "dl2",
     "format":  "mp4",
     "extractor":  "youtube",
     "url":  "https://www.youtube.com/watch?v=WWHInsHJ_EA",
     "thumbnail":  "http://dl2.video-download.online/vdo/tn/sfcuTGuiscgKdz3JZLhW3YoQ2AQYQTHhGeaQ",
     "download":  "http://dl2.video-download.online/vdo/dl/sfcuTGuiscgKdz3JZLhW3YoQ2AQYQTHhGeaQ/%22You%20and%20I%22%20(Zeds%20Dead%20&%20Omar%20LinX)%20(Official%20Music%20Video)%20%7C%20Zeds%20Dead.mp4"
}