Skip to main content
Send a YouTube video link to Scrape and 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

  • audio and video need an API key. Without one, the call returns 401 apiKeyRequired.
  • audio and video work only for a YouTube video link. Any other URL returns 400 invalidRequest with a message that starts formats: 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 invalidRequest and says what to send instead.
  • audio and video with zeroDataRetention return 400 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.