Skip to main content
POST
/
youtube
/
playlist
Import 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}
    ]
}

Documentation Index

Fetch the complete documentation index at: https://docs.gurubase.ai/llms.txt

Use this file to discover all available pages before exploring further.

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.

​
Headers

​
x-api-key
string
required
Your API key for authentication. You can obtain your API key from the Gurubase dashboard.

​
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}
    ]
}