Skip to content

POST request: convert

Michael V edited this page Oct 8, 2021 · 3 revisions

Converts a youtube video into mp3 or mp4

Parameter Required Type Description
url Yes string The full youtubelink of the video you want to download.
format No (default = mp3) string: mp3 or mp4 The format to download

Success response (status 200)

Parameter Type Description
error boolean, false Whether or not an error occured
youtube_id string The youtube identifier of the video
title string The title of the youtube video
alt_title string An alternative title of the youtube video
duration integer The duration of the youtube video in seconds
file string The path to the converted file for stream/download
uploaded_at datetime The date and time of when the youtube video got uploaded

Example response

{
    "error": false,
    "youtube_id": "gUJKs1m7Y8M",
    "title": "Devin Wild & Sub Zero Project - Meltdown (Official Videoclip)",
    "alt_title": "Meltdown",
    "duration": 210,
    "file": "http://michaelbelgium.me/storage/gUJKs1m7Y8M.mp3",
    "uploaded_at": {
        "date": "2016-10-13 20:59:06.000000",
        "timezone_type": 3,
        "timezone": "Europe/Berlin"
    }
}

Error response (status 400)

Parameter Type Description
error boolean, true Whether or not an error occured
message string A description of the error
OR
error_messages object An object with arrays according to which field has an validation error