Skip to main content
Import content from YouTube playlists as knowledge documents. Each video in the playlist becomes a document with its title, description, and a link to the video.

​
Prerequisites

  1. A Google Cloud project with the YouTube Data API v3 enabled
  2. An API key for your Google Cloud project
  3. The playlist ID you want to import

​
Getting Your Google API Key

  1. Go to the Google Cloud Console
  2. Create or select a project
  3. Navigate to APIs & Services > Library
  4. Search for YouTube Data API v3 and enable it
  5. Go to APIs & Services > Credentials
  6. Click Create Credentials > API key
  7. Copy the generated key

​
Finding Your Playlist ID

The playlist ID is the value of list in a YouTube playlist URL:
The string starting with PL is your playlist ID.

​
Setup Steps

  1. Navigate to Knowledge > Sources > Create
  2. Select YouTube Playlist as the connector type
  3. Enter your Google API Key
  4. Enter the Playlist ID
  5. Optionally enable Include private videos if you want to import unlisted or private videos (disabled by default)
  6. Save and run a manual sync

​
Configuration

​
What Gets Imported

Each video in the playlist creates one knowledge document containing:
  • Title: The video title
  • Content: The video description with a link to the video
  • External link: Direct YouTube watch URL
The connector fetches all videos in the playlist, handling pagination automatically.

​
Troubleshooting

  • Verify the playlist ID is correct and the playlist is not empty
  • Check that the API key has YouTube Data API v3 enabled
  • Ensure the playlist is public (or enable “Include private videos” for private playlists)
  • Verify the key in the Google Cloud Console
  • Check that the YouTube Data API v3 is enabled for your project
  • Ensure the key has no IP or referrer restrictions that block server-side requests