Use when a YouTube playlist is involved: pasted playlist links or IDs, requests to list playlist videos, browse playlist contents, or work through a playlist for transcripts or research. Also use when the user wants all videos from a series, course, or collection. Not for creating playlists or accou

YouTube Playlist Browse playlists and fetch transcripts via [TranscriptAPI.com](https://transcriptapi.com). Setup If $TRANSCRIPT API KEY is not set, read [references/auth setup.md](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](https://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. 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: Pagination flow: 1. First request: ?playlist=PLxxx — returns first 100 videos + continuation token 2. Next request: ?continuation=TOKEN — returns next 100 + new token 3. Repeat until has more: false or continuation token: null Workflow: Playlist → Transcripts Extract playlist ID from URL From https://www.youtube.com/playlist?list=PLrAXtmErZgOeiKm4sgNOknGvNjby9efdf , the playlist ID is PLrAXtmErZgOeiKm4sgNOknGvNjby9efdf . You can also pass the full URL directly to the playlist parameter. Errors Code Meaning Action 400 Both or neither params Provide exactly one of playlist or continuation 402 No credits transcriptapi.com/billing 403/1010 Cloudflare block Add or fix User Agent header 404 Playlist not found Check if playlist is public 408 Timeout Retry once 422 Invalid playlist format Must be a valid playlist URL or ID 1 credit per page. Free tier: 100 credits, 300 req/min. Copy paste examples Every request in this file as a ready to run one liner: [references/curl examples.md](references/curl examples.md)

youtube-playlist