Get YouTube transcript
transcriptlab_get_transcriptGet a YouTube transcript from existing captions. Use when the user gives a YouTube link or video ID and wants the transcript. Returns the transcript, or a job id when the request outlives the synchronous window: if a job comes back, poll transcriptlab_get_job_status, then read the text with transcriptlab_retrieve_transcript. The first delivery of each transcript variant can spend credits; later deliveries of that variant are free. Captions only: when the user asks which caption tracks exist use transcriptlab_discover_captions; when the video has no captions, or the source is an attached file or a direct media link, use transcriptlab_transcribe_file or transcriptlab_transcribe_media_url.
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": "transcriptlab_get_transcript"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| url | Yes | YouTube video URL or 11-character video ID. | |
| also | No | Additional formats to include in a JSON response. | |
| lang | No | Caption language. Omit it to get the video's own language (recommended); set it only to request a specific language. | |
| type | No | Caption track type; defaults to any. | |
| format | No | Output format; defaults to json. | |
| cleanup | No | Strip filler words and stray timestamps from the caption text. | |
| metadata | No | Include video metadata when available; defaults to true. | |
| translate | No | Translate captions to this language when available. |