youtube-playlist

Original：🇺🇸 English
Translated
1 scripts

Browse YouTube playlists and fetch video transcripts. Use when the user shares a playlist link, asks "what's in this playlist", "list playlist videos", "browse playlist content", or wants to work with playlist videos and get their transcripts.

5installs
Sourcezeropointrepo/youtube-skills
Added on

NPX Install

npx skill4agent add zeropointrepo/youtube-skills youtube-playlist

Tags

Translated version includes tags in frontmatter
youtube-playlisttranscript-apivideo-transcriptsapi-integrationtool-setup

SKILL.md Content

View Translation Comparison →

YouTube Playlist

Browse playlists and fetch transcripts via TranscriptAPI.com.

Setup

If 
$TRANSCRIPT_API_KEY
is not set, help the user create an account (100 free credits, no card):
Step 1 — Register: Ask user for their email.
bash
node ./scripts/tapi-auth.js register --email USER_EMAIL
→ OTP sent to email. Ask user: "Check your email for a 6-digit verification code."
Step 2 — Verify: Once user provides the OTP:
bash
node ./scripts/tapi-auth.js verify --token TOKEN_FROM_STEP_1 --otp CODE
API key saved to your shell profile and agent config. Ready to use.
Manual option: transcriptapi.com/signup → Dashboard → API Keys.

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.
bash
# First page
curl -s "https://transcriptapi.com/api/v2/youtube/playlist/videos?playlist=PL_PLAYLIST_ID" \
  -H "Authorization: Bearer $TRANSCRIPT_API_KEY"

# Next pages
curl -s "https://transcriptapi.com/api/v2/youtube/playlist/videos?continuation=TOKEN" \
  -H "Authorization: Bearer $TRANSCRIPT_API_KEY"
ParamRequiredValidation
playlist
conditionalPlaylist URL or ID (
PL
/
UU
/
LL
/
FL
/
OL
prefix)
continuation
conditionalnon-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:
json
{
  "results": [
    {
      "videoId": "abc123xyz00",
      "title": "Playlist Video Title",
      "channelId": "UCuAXFkgsw1L7xaCfnd5JJOw",
      "channelTitle": "Channel Name",
      "channelHandle": "@handle",
      "lengthText": "10:05",
      "viewCountText": "1.5M views",
      "thumbnails": [{ "url": "...", "width": 120, "height": 90 }],
      "index": "0"
    }
  ],
  "playlist_info": {
    "title": "Best Science Talks",
    "numVideos": "47",
    "description": "Top science presentations",
    "ownerName": "TED",
    "viewCount": "5000000"
  },
  "continuation_token": "4qmFsgKlARIYVVV1...",
  "has_more": true
}
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

bash
# 1. List playlist videos
curl -s "https://transcriptapi.com/api/v2/youtube/playlist/videos?playlist=PL_PLAYLIST_ID" \
  -H "Authorization: Bearer $TRANSCRIPT_API_KEY"

# 2. Get transcript from a video in the playlist
curl -s "https://transcriptapi.com/api/v2/youtube/transcript\
?video_url=VIDEO_ID&format=text&include_timestamp=true&send_metadata=true" \
  -H "Authorization: Bearer $TRANSCRIPT_API_KEY"

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

CodeMeaningAction
400Both or neither paramsProvide exactly one of playlist or continuation
402No creditstranscriptapi.com/billing
404Playlist not foundCheck if playlist is public
408TimeoutRetry once
422Invalid playlist formatMust be a valid playlist URL or ID
1 credit per page. Free tier: 100 credits, 300 req/min.