Skip to main content
Scrape a YouTube URL with formats.markdown to get a video document. It includes the title, channel, duration, views, description, and available captions with timestamps.

Read a video

Supported URLs

Video URLs include /watch, youtu.be, /shorts, /embed, and /live. Channel URLs include /channel/…, /@handle, /c/…, and /user/…; they return a channel profile with subscriber and video counts. A video without accessible captions still returns metadata and its description. Caption preference is English author-provided, English automatic, another automatic track, then another available track.

Include images or ask a question

Set markdownParams.includeImages: true to include a video thumbnail or channel avatar. Request Highlights with a question to select relevant transcript passages. JSON extraction can structure the video document using your schema. Transcript availability depends on what YouTube exposes for the video. Check the returned document before treating it as a complete transcript.