get_transcript_chunk
Retrieve a subset of transcript entries to paginate through large YouTube transcripts. Iterate entry-by-entry using start index and chunk size.
Instructions
Get a chunk of transcript entries for pagination.
Retrieves a subset of transcript entries for large transcripts.
Useful for iterating through transcripts entry-by-entry.
Cached permanently as transcript content doesn't change.
Args:
video_id: YouTube video ID (e.g., "dQw4w9WgXcQ")
start_index: Starting entry index (0-based, default: 0)
chunk_size: Number of entries to return (default: 50)
language: Language code (e.g., "en"). If empty, uses first available
Returns:
TranscriptChunk dictionary with:
- video_id, language, start_index, chunk_size
- entries: List of transcript entries in this chunk
- total_entries: Total entries in full transcript
- has_more: Whether more entries available after this chunk
Example:
>>> chunk = get_transcript_chunk("nLwbNhSxLd4", start_index=0, chunk_size=10)
>>> print(len(chunk["entries"]))
10
>>> print(chunk["has_more"])
True
>>> # Get next chunk
>>> chunk2 = get_transcript_chunk("nLwbNhSxLd4", start_index=10, chunk_size=10)
Note:
- Uses no YouTube API quota
- Cached permanently in youtube.content namespace
- Use for iterating through large transcriptsCaching 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
| Name | Required | Description | Default |
|---|---|---|---|
| language | No | ||
| video_id | Yes | ||
| chunk_size | No | ||
| start_index | No |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
No arguments | |||