youtube_video_transcript
Retrieve publicly available captions or a transcript from a YouTube video or Short by URL, with optional language selection or original-audio captions.
Instructions
youtube: Transcript. GET /v1/youtube/video/transcript. Get publicly available captions or a transcript from a YouTube video or Short Costs 1 credit when it succeeds. Costs 0 credits when transcript is empty. Errors, blocked or timed-out requests, invalid requests and cache hits cost nothing. A not-found or empty result is charged only where that operation's published cost says so.
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": "youtube_video_transcript"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| url | Yes | YouTube video or short URL | |
| language | No | Caption language, e.g. en or en-US; original_audio=true overrides it. Omit for automatic selection. No matching requested or identified original-language captions returns null at no charge. | |
| cache_max_age | No | Use a cached response this old or newer for 0 credits. If none is available, fetch live at the endpoint’s normal price. | |
| original_audio | No | Set true for original-language captions only, overriding language. Unidentified original audio or missing captions returns null at no charge. A returned transcript costs 1 credit; no extra lookup. |