> ## Documentation Index
> Fetch the complete documentation index at: https://ago.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# YouTube Playlist

> Import video content from YouTube playlists into AGO

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.

| Feature            | Details                                   |
| ------------------ | ----------------------------------------- |
| **Authentication** | Google API Key (YouTube Data API v3)      |
| **Content type**   | Video metadata (title, description, link) |
| **Hierarchy**      | Flat (one document per video)             |
| **Multi-language** | No                                        |
| **Attachments**    | No                                        |

## 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](https://console.cloud.google.com/)
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:

```
https://www.youtube.com/playlist?list=PLxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx
```

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

| Setting                | Required | Description                                                          |
| ---------------------- | -------- | -------------------------------------------------------------------- |
| API Key                | Yes      | Your Google API key with YouTube Data API v3 access                  |
| Playlist ID            | Yes      | The YouTube playlist ID to import from                               |
| Include private videos | No       | When enabled, imports private and unlisted videos too (default: off) |

## 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

<AccordionGroup>
  <Accordion title="No videos imported">
    * 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)
  </Accordion>

  <Accordion title="API key error">
    * 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

    ***
  </Accordion>
</AccordionGroup>

## Related

* [Knowledge Connectors](./knowledge-connectors) — All available connectors
* [Knowledge Source Management](../features/knowledge-source-management) — Managing sources