Initializes (processes) the audio download of a YouTube video, using the video ID.
The response of this request will be a video download resource, with an ID that can be used in the Get A Download method, to retrieve the actual file URL for download.
After the video download is created, a background job will start processing the request and fetch the audio file from YouTube servers. This process could be fast for short videos, but could take up to 10 minutes for long videos.
The MP3 file will be available anytime for download, once the process has been completed. If you want a new download link generated, you simply need to send another ‘Get A Download’ request with the downloadID.
If you initialize a download more than once and we have a successful download existing for the file, we will return the download object instead of initiating the process again - this avoids accidental duplicate credit charges for the user.
<https://dashboard.transcriptdownloader.com/api/downloads/audio>
{
"youtube_video_id": "<string>"
}
Successful response, when the download process has been initialized.
{
"data": {
"id": "01JW72M0AGW3M6R3QDCS30RD2P",
"youtube_video_id": "Fqdz6A-5d04",
"type": "audio",
"duration": "01:47:55",
"cost": "1.079",
"status": "pending",
"created_at": "2025-01-23T00:30:50.000000Z",
"audio_url": null
}
}
Subsequent response prior to completion, processing the audio and readying for download
{
"error": "You already have a pending download for this video",
"id": "01JW72M0AGW3M6R3QDCS30RD2P"
}
A download can be accessed through the API by using the following endpoint: