POST
/
youtube
/
playlist
/
curl --request POST \
  --url https://api.gurubase.io/api/v1/youtube/playlist/ \
  --header 'Content-Type: application/json' \
  --header 'x-api-key: <api-key>' \
  --data '{
  "url": "<string>"
}'
{
    "playlist_id": {playlist_id},
    "video_count": 3,
    "videos": [
        {url1},
        {url2},
        {url3}
    ]
}

This endpoint allows you to fetch the list of videos from a YouTube playlist. The operation is synchronous and returns the list directly in the response.

To be able to use this feature on self-hosted, you need to specify your YouTube API Key in the settings page. You can create one by following the instructions here. After this, you also need to enable the “Youtube Data API v3” API in your Google Cloud project.

​
Body Parameters

​
url
string
required

The YouTube channel URL to fetch data from. Must be a valid YouTube playlist URL.

The expected URL is of type https://www.youtube.com/watch?v={video_id}&list={playlist_id}

​
Response

​
playlist_id
string

The ID of the playlist

​
video_count
int

The number of videos in the channel

​
videos
list

The urls of the videos

{
    "playlist_id": {playlist_id},
    "video_count": 3,
    "videos": [
        {url1},
        {url2},
        {url3}
    ]
}