Extract a YouTube transcript
extract_transcriptExtracts a YouTube video transcript with timestamps for summarizing, searching, or quoting spoken content. Returns title, channel, duration, and segment captions in Markdown.
Instructions
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.
Tool call template
Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {
"url": "<url>"
},
"name": "extract_transcript"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| url | Yes | Full YouTube URL — youtube.com/watch?v=…, youtu.be/…, or shorts. Required. | |
| lang | No | BCP-47 language code for the captions (e.g. 'en', 'es', 'fr', 'zh-Hans'). Defaults to 'en' if omitted. |