get_full_transcript
Get the full transcript of a YouTube video including timestamps and plain text. Automatically handles large transcripts with caching.
Instructions
Get the complete transcript for a YouTube video.
Retrieves the full transcript with all entries and timestamps.
For large transcripts (>2KB), RefCache automatically returns a preview
with a reference that can be paginated using get_cached_result.
Cached permanently as transcript content doesn't change.
Args:
video_id: YouTube video ID (e.g., "dQw4w9WgXcQ")
language: Language code (e.g., "en"). If empty, uses first available
Returns:
FullTranscript dictionary with:
- video_id, language
- transcript: List of entries with text, start time, duration
- full_text: Complete transcript as plain text
Example:
>>> full = get_full_transcript("nLwbNhSxLd4", language="en")
>>> print(len(full["transcript"]))
150
>>> print(full["full_text"][:100])
Note:
- Uses no YouTube API quota
- Cached permanently in youtube.content namespace
- RefCache may return preview + reference for large transcripts
- Use get_transcript_chunk for entry-by-entry paginationCaching Behavior:
Parameters that accept reference strings can accept a
ref_idfrom a previous tool callLarge results return ref_id + preview; use get_cached_result to paginate
All responses include ref_id for future reference
Ref input compatibility: Support depends on the tool's input schema/validation. Some strictly typed parameters may reject string ref_ids before resolution.
Full retrieval: Use get_cached_result(ref_id, full=True) to get the complete value.
Preview Size: server default. Override per-call with get_cached_result(ref_id, max_size=...).
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| language | No | ||
| video_id | Yes |
Output Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
No arguments | |||