Pulls the transcript of a YouTube video and returns it as Markdown with timestamps. Use this whenever the user provides a YouTube URL and wants to summarise, quote, search, or otherwise process the video's spoken content.

Costs credits on first fetch (1 credit ≤15min, 2 credits 15–45min, 4 credits 45min–2h, 8 credits 2h+). Cached extractions are free — videos other Scribefy users have already extracted are cached for 30 days.

Returns the title, channel, duration, language, and the transcript itself split into segments with clickable timestamps.

Search YouTube for videos matching a query string. Returns up to limit results (default 10, max 25) with title, channel, duration, view count, and URL. Free — no credits charged. Use this when the user asks 'find me videos about X' before chaining into extract_transcript on a specific result.

Look up title, channel, duration, view count, upload date, and available caption tracks for a video. Does NOT pull the transcript — use extract_transcript for that. Free — no credits charged. Useful to inspect a video before deciding whether to extract, or to discover which caption languages are available.

Return the videos YouTube recommends after a given video — the 'Up next' / 'Related' feed. Returns up to limit results (default 10, max 25). Free — no credits charged. Use this to expand research from a single starting video, or to find adjacent content.