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.
Input Schema
TableJSON 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 }); }