YouTube Playlist Scraper

Your all-in-one tool for extracting data from YouTube playlists; including podcasts, courses, and releases. Retrieve rich details such as titles, descriptions, thumbnails, full video and channel metadata, and engagement statistics.

😋 Features 😋

• Get complete playlist details including title, description, thumbnail, full channel and video metadata, and engagement statistics. Works across normal playlists, podcasts, courses, and releases.
• Easily switch proxy country to avoid hidden videos and region-restricted content.
• View a detailed summary stored in the key-value store after each run. Each input URL is categorized as either complete, hasHiddenVideos, incomplete, unavailable, or failed.

Interested in other YouTube scraping tools?

Are you looking for full YouTube video and shorts metadata including engagement statistics and transcripts. Check out our YouTube Metadata Scraper.

👩‍🍳 Input 👩‍🍳

Parameter	Type	Description	Default Value
startURLs	array[link]	One or more Youtube playlist URLs. The maximum number of URLs is 1000.	-
useProxy	boolean	Turn on residential proxy	false
proxyCountry	CountrySelector	Select country for the RESIDENTIAL proxy. This is useful for playlists that contain videos only available in specific regions. Otherwise, the default ANY is recommended.	ANY

Example

{
    "startURLs": [
        "https://www.youtube.com/playlist?list=PLMvsN4LH5cSH-_-FOZVIrkrXa37hNthny"
    ],
    "useProxy": true,
    "proxyCountry": "ANY",
}

🍖 Output 🍖

Parameter	Type	Description
input	link	Input URL given
id	string	Playlist ID
url	link	Playlist URL
title	string	Playlist Title
description	string	Playlist Description
playlistType	Playlist|Podcast|Course|Album	Playlist Type
thumbnail	link	Playlist Thumbnail
videoCount	integer	Number of videos in playlist
viewCount	integer	Number of times the playlist has been viewed
hiddenVideoCount	integer	Number of hidden videos in playlist. You can avoid this by turning on proxy and setting proxyCountry to the exact location where the videos are not restricted.
channelId	string	Playlist Channel ID
channelUrl	link	Playlist Channel URL
channelUsername	string	Playlist Channel Username
channelDisplayName	string	Playlist Channel Display Name
videos	array[video]	Information of each video in the playlist
video.index	integer	Position of video in playlist
video.id	string	Video ID
video.url	link	Video URL
video.title	string	Video Title
video.thumbnail	link	Video Thumbnail (High Quality)
video.length	string	Video length, formatted in hours, minutes and seconds e.g. 3:48. Hours and minute are omitted where they do not apply.
video.lengthSeconds	integer	Video length in seconds
video.viewCount	string	Number of views of video (inexact) e.g. 115K, 1.2M
video.relativeUploadTime	string	Upload time of video, relative to the current time e.g. 1 year ago
video.channelId	string	Video Channel ID
video.channelUrl	link	Video Channel URL
video.channelUsername	string	Video Channel Username
video.channelDisplayName	string	Video Channel Display Name

Example

[
  {
    "input": "https://www.youtube.com/playlist?list=PLQ_voP4Q3cfdvAY-XP1-uq5NzJ1sZGtwj",
    "id": "PLQ_voP4Q3cfdvAY-XP1-uq5NzJ1sZGtwj",
    "url": "https://www.youtube.com/playlist?list=PLQ_voP4Q3cfdvAY-XP1-uq5NzJ1sZGtwj",
    "title": "The Best of Son Heung min",
    "description": null,
    "playlistType": "Playlist",
    "thumbnail": "https://i.ytimg.com/vi/mH5wcYC8oxM/hqdefault.jpg",
    "videoCount": 5,
    "viewCount": 2590,
    "hiddenVideoCount": 0,
    "channelID": "UCG5qGWdu8nIRZqJ_GgDwQ-w",
    "channelURL": "https://www.youtube.com/@premierleague",
    "channelUsername": "premierleague",
    "channelDisplayName": "Premier League",
    "videos": [
      {
        "index": 1,
        "id": "mH5wcYC8oxM",
        "url": "https://www.youtube.com/watch?v=mH5wcYC8oxM",
        "title": "Son Heung-min: 10 Years of Smiles, Goals, and Greatness 🇰🇷",
        "thumbnail": "https://i.ytimg.com/vi/mH5wcYC8oxM/hqdefault.jpg",
        "length": "7:24",
        "lengthSeconds": 444,
        "viewCount": "410K",
        "relativeUploadTime": "2 months ago",
        "channelId": "UCG5qGWdu8nIRZqJ_GgDwQ-w",
        "channelURL": "https://www.youtube.com/@premierleague",
        "channelUsername": "premierleague",
        "channelDisplayName": "Premier League"
      },
      {
        "index": 2,
        "id": "shkGWuni26w",
        "url": "https://www.youtube.com/watch?v=shkGWuni26w",
        "title": "11 of Son Heung-min's Best Moments in the Premier League",
        "thumbnail": "https://i.ytimg.com/vi/shkGWuni26w/hqdefault.jpg",
        "length": "7:06",
        "lengthSeconds": 426,
        "viewCount": "1.1M",
        "relativeUploadTime": "2 months ago",
        "channelId": "UCG5qGWdu8nIRZqJ_GgDwQ-w",
        "channelURL": "https://www.youtube.com/@premierleague",
        "channelUsername": "premierleague",
        "channelDisplayName": "Premier League"
      },
      {
        "index": 3,
        "id": "2NaoEy7VszY",
        "url": "https://www.youtube.com/watch?v=2NaoEy7VszY",
        "title": "Son's Triple Seals Victory | Spurs 6-2 Leicester City | 2022/23 Premier League Highlights",
        "thumbnail": "https://i.ytimg.com/vi/2NaoEy7VszY/hqdefault.jpg",
        "length": "8:29",
        "lengthSeconds": 509,
        "viewCount": "101K",
        "relativeUploadTime": "8 months ago",
        "channelId": "UCG5qGWdu8nIRZqJ_GgDwQ-w",
        "channelURL": "https://www.youtube.com/@premierleague",
        "channelUsername": "premierleague",
        "channelDisplayName": "Premier League"
      },
      {
        "index": 4,
        "id": "BXDp8iMF7J0",
        "url": "https://www.youtube.com/watch?v=BXDp8iMF7J0",
        "title": "Son Heung-min names FAVOURITE Premier League moment for Spurs | Ultimates",
        "thumbnail": "https://i.ytimg.com/vi/BXDp8iMF7J0/hqdefault.jpg",
        "length": "6:59",
        "lengthSeconds": 419,
        "viewCount": "96K",
        "relativeUploadTime": "1 year ago",
        "channelId": "UCG5qGWdu8nIRZqJ_GgDwQ-w",
        "channelURL": "https://www.youtube.com/@premierleague",
        "channelUsername": "premierleague",
        "channelDisplayName": "Premier League"
      },
      {
        "index": 5,
        "id": "7aMutyZelts",
        "url": "https://www.youtube.com/watch?v=7aMutyZelts",
        "title": "'I'M GETTING EMOTIONAL...' 😢 Heartwarming moment Heung-Min Son surprises Spurs fan | Fan Mail",
        "thumbnail": "https://i.ytimg.com/vi/7aMutyZelts/hqdefault.jpg",
        "length": "6:30",
        "lengthSeconds": 390,
        "viewCount": "400K",
        "relativeUploadTime": "1 year ago",
        "channelId": "UCG5qGWdu8nIRZqJ_GgDwQ-w",
        "channelURL": "https://www.youtube.com/@premierleague",
        "channelUsername": "premierleague",
        "channelDisplayName": "Premier League"
      }
    ]
  }
]

❔ FAQ ❔

What does the RUN_SUMMARY file contain?

The RUN_SUMMARY file is created after each run and stored in the key-value store. It divides each playlist input URL into 5 categories:

• complete - this URL was successfully processed and all videos are complete.
• hasHiddenVideos - this URL was successfully processed but there are some hidden videos. This is usually due to location issues and you can solve this by turning the proxy on and setting an appropraite location. Check the Input section for more details.
• incomplete - Some videos were gotten but processing failed before it was completed.
• unavailable - The playlist is unavailable for some reason. Either it has been deleted or it is invalid
• failed - Processing failed completely and no videos were gotten.

Feedback

We’re always working on improving the performance of our Actors. So if you’ve got any technical feedback for YouTube Playlist scraper or simply found a bug, please create an issue on the Actor’s Issues tab in Apify Console.