Skip to content

YouTube: Get Captions

Plugin ID: eca_youtube_get_caption

Available since: 1.0.0

Downloads a specific video caption from YouTube using a caption ID. Use ListCaptions first to get available caption IDs. Requires OAuth2 authentication and only works for videos you own.

Fields

<div class="messages messages--warning"><strong>Important:</strong> This action requires OAuth2 authentication and only works for videos you own or have permission to access. It will not work for other users' videos.</div>

Authentication Type — config key: auth_type

Choose between API Client (OAuth2) or Service Account authentication.

Type: select · Required: yes · Default: api_client

Allowed values: api_client, service_account

Authentication Source — config key: auth_from

Choose whether to select authentication directly or use a token for dynamic selection.

Type: select · Required: yes · Default: direct

Allowed values: direct, token

API Client — config key: api_client_id

Search and select an API Client for OAuth2 authentication.

Type: textfield · Required: no · Default: empty string

Service Account — config key: service_account_id

Search and select a Service Account for server-to-server authentication.

Type: textfield · Required: no · Default: empty string

Client ID from Token — config key: auth_client_from_token

Token that resolves to a client ID (e.g., [user:field_google_client_id]). The token should contain just the client ID, not the auth type prefix.
This field supports tokens.

Type: textfield · Required: no · Default: empty string

Video ID or URL — config key: video_input

Enter a YouTube video ID or full YouTube URL for a video you own. Supports token replacement.
This field supports tokens.

Type: textfield · Required: yes · Default: empty string

Captions ID — config key: caption_id

The captions track ID to download. Use the List Captions action first to get available IDs, then use a token like [captions:captions:0:id] for the first caption or [captions:captions:1:id] for the second, etc.
This field supports tokens.

Type: textfield · Required: yes · Default: empty string

Caption Format — config key: caption_format

The format to download the caption in.

Type: select · Required: no · Default: empty string

Allowed values: '', srt, vtt, ttml

Caption Token Name — config key: caption_token_name

Optional token name to store caption data. Accessible as [token_name:content], [token_name:format], [token_name:video_id].
This field supports tokens.

Type: textfield · Required: no · Default: empty string