Skip to main content
YouTube Transcript logo
  • Category: audio & speech
  • Auth: API_KEY
  • Composio-managed OAuth available? N/A
  • Tools: 9
  • Triggers: 0
  • Slug: YOUTUBE_TRANSCRIPT
  • Version: 20261014_00

Tools

Slug: YOUTUBE_TRANSCRIPT_GET_STORED_TRANSCRIPTRead a transcript already stored in the connected account without submitting new transcription work or consuming retrieval credits.

Input Parameters

string ("auto" | "manual" | "asr")
Restrict the stored transcript to an automatic-caption, manual-caption, or ASR source.
string
Preferred stored transcript language as an ISO 639-1 code.
string
required
YouTube video ID whose stored transcript should be read.
string
Specific stored transcript or job UUID when multiple records exist for the video.
boolean
Include timestamp segments. Stored timestamp capability may remain true when segments are omitted.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: YOUTUBE_TRANSCRIPT_GET_VIDEO_TRANSCRIPTFetch captions for one YouTube video and store the resulting transcript in the connected account. This consumes provider credits, but never starts ASR. The tool waits up to 20 seconds for asynchronous caption jobs; if one is still processing, use GET_VIDEO_TRANSCRIPT_JOB_STATUS with the job_id from the timeout.

Input Parameters

string
required
YouTube video URL or 11-character video ID.
string ("auto" | "manual")
Caption source preference. ASR is intentionally unavailable in this tool.
string
Preferred ISO 639-1 caption language; omit to let the provider choose.
boolean
Include word-level timing when available.
boolean
Include paragraph grouping when available.
boolean
Include timestamped segments; start and end values are milliseconds.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: YOUTUBE_TRANSCRIPT_GET_VIDEO_TRANSCRIPT_JOB_STATUSRead one transcript job’s current processing, completed, failed, or requires-ASR-confirmation state without creating work or waiting. Use this one-shot read when GET_VIDEO_TRANSCRIPT times out, passing the same include flags to recover the requested transcript shape.

Input Parameters

string
required
Provider job UUID returned by GET_VIDEO_TRANSCRIPT, including in its polling-timeout error.
boolean
Include word-level transcript timing in a completed job result. Use the original create request value during timeout recovery.
boolean
Include timestamped transcript segments in a completed job result. Keep this aligned with the original GET_VIDEO_TRANSCRIPT include_timestamps value when recovering from a polling timeout.
boolean
Include paragraph-grouped transcript ranges in a completed job result. Use the original create request value during timeout recovery.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: YOUTUBE_TRANSCRIPT_GET_VIDEO_TRANSCRIPTS_BATCHFetch and store captions for 1-10 YouTube videos. Each uncached video can consume provider credits, so cost scales with the request size. ASR never starts. This creates one batch and waits up to 20 seconds for a terminal result; if it is still processing, use GET_VIDEO_TRANSCRIPTS_BATCH_STATUS with the batch_id from the timeout.

Input Parameters

string ("auto" | "manual")
Caption source preference. ASR is unavailable and never starts.
string
Preferred ISO 639-1 caption language; omit to let the provider choose.
array
required
One to ten unique 11-character YouTube video IDs. URLs are not accepted. Cost can increase with every uncached video, so include only videos needed.
boolean
Include word-level timing when available.
boolean
Include paragraph grouping when available.
boolean
Include timestamped segments; false keeps each result compact.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: YOUTUBE_TRANSCRIPT_GET_VIDEO_TRANSCRIPTS_BATCH_STATUSRead the current state and available per-video results for a transcript batch without creating work or waiting. Use this one-shot read to recover when GET_VIDEO_TRANSCRIPTS_BATCH times out while the provider is still processing.

Input Parameters

string
required
Provider batch UUID returned by GET_VIDEO_TRANSCRIPTS_BATCH, including in its polling-timeout error.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: YOUTUBE_TRANSCRIPT_LIST_STORED_TRANSCRIPTSList and search transcripts already stored in the connected account, one bounded page at a time.

Input Parameters

integer
Maximum records in this page (1-100).
Search video IDs, titles, and transcript text.
string
Exact-match stored transcript status filter. Common observed values are queued, processing, succeeded, and failed. Other strings are accepted; an unmatched value returns an empty list. Omit for the provider default.
string
Include records created at or before this ISO 8601 timestamp.
string
Filter by ISO 639-1 language code.
string
Include records created at or after this ISO 8601 timestamp.
string
Opaque cursor returned by the previous call. Omit for the first page and pass it back unchanged to fetch the next page.
boolean
Include transcript segments in each list item; false keeps responses compact.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: YOUTUBE_TRANSCRIPT_LIST_TRANSCRIPT_LANGUAGESList stored languages and YouTube translation target languages for one owned video transcript.

Input Parameters

string
required
YouTube video ID whose transcript languages should be listed.
boolean
Include the video’s default YouTube language in the result.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: YOUTUBE_TRANSCRIPT_RESOLVE_CHANNEL_VIDEOSRequires Basic or higher. Resolve a YouTube channel into bounded upload metadata without transcribing the videos. This may count against the account’s monthly channel allowance.

Input Parameters

integer
Maximum video metadata items to resolve (1-100).
string
YouTube handle with or without a leading @. Provide exactly one channel identifier.
string
YouTube channel ID. Provide exactly one channel identifier.
string
Full YouTube channel URL. Provide exactly one channel identifier.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: YOUTUBE_TRANSCRIPT_RESOLVE_PLAYLIST_VIDEOSRequires Basic or higher. Resolve a YouTube playlist into bounded video metadata without transcribing the videos. This may count against the account’s monthly playlist allowance.

Input Parameters

integer
Maximum video metadata items to resolve (1-100).
string
YouTube playlist ID. Provide exactly one of playlist_id or playlist_url.
string
Full YouTube playlist URL. Provide exactly one of playlist_url or playlist_id.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not