markdown returns a short document about the video: its title, channel, publish date, length, views, likes and description. Add audio or video to also get the file.
Make a request
Get an API key in the Quickstart. This request reads a video and asks for its audio.Read the response
markdown is the video document. audio is a link to an M4A file that works for 1 hour. This real response is cut: the description and the link are shortened.
metadata.title, description and ogImage come from the video. To keep the audio, download it within the hour.
Options
Supported links are
watch?v=, youtu.be/, /shorts/, /embed/ and /live/ URLs, on youtube.com, www.youtube.com, m.youtube.com and music.youtube.com.
More from a video
A scrape returns the document above, not the transcript, the comments or the channel. For those, use the YouTube parsers, which return a video’s transcript, comments, channel, playlist and search results as data. See Pre-built parsers.Limits and errors
audioandvideoneed an API key. Without one, the call returns401 apiKeyRequired.audioandvideowork only for a YouTube video link. Any other URL returns400 invalidRequestwith a message that startsformats: audio and video are available for YouTube video links.- An audio file larger than 40 MB, or a video file larger than 100 MB, returns
400 invalidRequestand says what to send instead. audioandvideowithzeroDataRetentionreturn400 invalidRequest, because the file is kept for an hour.- If YouTube does not provide a video’s file, the call fails with
503 sourceUnavailable. Nothing is charged, and you can retry.
Price
$1 per 1,000 videos.audio and video add nothing to the price.
Related
- Pre-built parsers read a video’s transcript, comments and channel.
- Markdown is the format that returns the video document.
- Summary summarizes the video document.
- Scrape overview lists every format and option.