YouTube Playlist

Browse playlists and fetch transcripts via TranscriptAPI.com.

Setup

If $TRANSCRIPT_API_KEY is not set, read references/auth-setup.md and follow the instructions there to get and store the key.

Required Headers

Every request needs two headers:

• Authorization: Bearer $TRANSCRIPT_API_KEY
• User-Agent: your agent's name and version if known (e.g. HermesAgent/0.11.0, ClaudeCode/1.0). Version is optional, agent name alone is fine. Do not omit this header or send a bare default, Cloudflare will return a 403 (error code 1010) and block the request.

API Reference

Full OpenAPI spec: transcriptapi.com/openapi.json, consult this for the latest parameters and schemas.

GET /api/v2/youtube/playlist/videos, 1 credit/page

Paginated playlist video listing (100 per page). Accepts playlist, a YouTube playlist URL or playlist ID.

# First page
curl -s "https://transcriptapi.com/api/v2/youtube/playlist/videos?playlist=PL_PLAYLIST_ID" \
  -H "Authorization: Bearer $TRANSCRIPT_API_KEY" \
  -H "User-Agent: YourAgent/1.0"

# Next pages
curl -s "https://transcriptapi.com/api/v2/youtube/playlist/videos?continuation=TOKEN" \
  -H "Authorization: Bearer $TRANSCRIPT_API_KEY" \
  -H "User-Agent: YourAgent/1.0"

Param	Required	Validation
playlist	conditional	Playlist URL or ID (PL/UU/LL/FL/OL prefix)
continuation	conditional	non-empty string

Provide exactly one of playlist or continuation, not both.

Accepted playlist ID prefixes:

• PL, user-created playlists
• UU, channel uploads playlist
• LL, liked videos
• FL, favorites
• OL, other system playlists

Response: