list_captions
Retrieve caption tracks for a YouTube video, including language, name, status, and draft status. Use this to inspect or manage subtitles.
Instructions
List caption tracks on a video with their language, name, status, and whether they are drafts.
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": {
"video_id": "<video_id>"
},
"name": "list_captions"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| video_id | Yes | Video ID to list captions for. |
Implementation Reference
- src/youtube/client.ts:276-290 (helper)Client helper method that calls the YouTube Data API v3 /captions endpoint with snippet part and videoId to retrieve caption track metadata.
listCaptions(videoId: string): Promise<{ items: Array<{ id: string; snippet?: { name?: string; language?: string; status?: string; isDraft?: boolean; lastUpdated?: string; trackKind?: string; }; }>; }> { return this.dataGet("/captions", { part: "snippet", videoId }); }