Youtube Transcript Fetcher
Overview
Fetch transcripts from YouTube videos. Provide a video URL or video ID and receive the full transcript text saved as a downloadable JSON file. Supports language selection and optional timestamped segments.
Actions
fetch
Retrieve the transcript for a YouTube video. The transcript is saved to cloud storage and a signed download URL is returned.
Required fields (one of the following):
video_url(string) — Full YouTube URL. Supported formats includehttps://www.youtube.com/watch?v=VIDEO_ID,https://youtu.be/VIDEO_ID, shorts, embeds, and live URLs.video_id(string) — The 11-character YouTube video ID. Takes precedence overvideo_urlif both are provided.
Optional fields:
language(string) — Language code for the transcript (e.g.,en,es,fr). If omitted, the video's default language is used.include_timestamps(boolean, default:false) — Whentrue, the saved transcript file includes timestamped segments with start time and duration for each line.include_raw_response(boolean, default:false) — Whentrue, the saved transcript file includes the full raw provider response (useful for debugging; may be large).
Example — Fetch by video URL:
{
"action": "fetch",
"video_url": "https://www.youtube.com/watch?v=dQw4w9WgXcQ"
}
Example — Fetch by video ID with timestamps in Spanish:
{
"action": "fetch",
"video_id": "dQw4w9WgXcQ",
"language": "es",
"include_timestamps": true
}
Example — Fetch with raw response for debugging:
{
"action": "fetch",
"video_id": "dQw4w9WgXcQ",
"include_raw_response": true
}
Response fields:
video_id— The resolved video ID.video_title— Title of the video (when available).language— The requested language code (or null if default).transcript_file— Object containingfile_id,filename,signed_url,signed_url_expires_in,expiration_date,size_bytes, andcontent_type. Usesigned_urlto download the full transcript JSON.transcript_summary— Object withcharacter_count,word_count, andsegment_count.timestamps_saved— Whether timestamped segments were included in the file.
Common Workflows
- Get a video transcript for summarization — Use
fetchwith a video URL, then download the transcript file from thesigned_urlto read or summarize the content. - Multilingual transcript retrieval — Set the
languagefield to fetch transcripts in a specific language (the video must have that language available). - Detailed analysis with timestamps — Set
include_timestampstotrueto get per-segment timing data, useful for creating subtitles or referencing specific moments.
Important Notes
- You must provide either
video_urlorvideo_id. If both are given,video_idtakes precedence. - The transcript is returned as a stored JSON file with a signed download URL, not inline in the response. Use the
signed_urlto access the full text. - Not all YouTube videos have transcripts available. Videos without captions or transcripts will return an error.
- The
signed_urlis temporary and will expire (seesigned_url_expires_inandexpiration_datein the response). - Supported URL formats: standard watch URLs, short youtu.be links, shorts, embeds, and live URLs.







