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

# YouTube Data API

> Search, video details, channels and playlists. Where a demo video lives once it is made.

Search, video details, channels and playlists. Where a demo video lives once it is made.

## Connecting

In the dashboard, open **Connectors**, find YouTube Data API and press **Connect**. You will be sent to sign in; the connection is saved once that succeeds.

### What you will need

| Field | What it is |
| - | - |
| Client ID | Your Google OAuth 2.0 Client ID (for user authentication) |
| Client Secret | Your Google OAuth 2.0 Client Secret |

### Getting the credential

1. Go to [Google Cloud Console](https://console.cloud.google.com)
2. Create a new project or select existing one
3. **Enable APIs**: APIs & Services → Library → Search "YouTube Data API v3" → Enable
4. **Create OAuth 2.0 Credentials**:
   * Go to APIs & Services → Credentials
   * Click "Create Credentials" → OAuth 2.0 Client IDs
   * Choose "Web Application"
   * Add redirect URIs
   * Copy Client ID and Client Secret
5. **Optional**: Create API Key for read-only operations

## Notes

* Reading public data works with an API key; anything about YOUR channel, and every write, needs OAuth.
* Quota is per project per day and searches are expensive — a search costs about a hundred times a video lookup.
* **Per user**: 100 requests per 100 seconds
* **Per project**: 10,000 requests per day
* **Concurrent requests**: Recommended max 10

## What your AI teammate can do with it

| Tool | What it does |
| - | - |
| `search_videos` | Search for videos on YouTube |
| `get_video_details` | Get detailed information about specific videos |
| `get_channel_info` | Get information about YouTube channels |
| `get_channel_videos` | Get videos from a specific channel |
| `get_playlists` | Get playlists from a channel or by ID |
| `get_playlist_items` | Get videos from a specific playlist |
| `create_playlist` | Create a new playlist (requires authentication) |
| `add_video_to_playlist` | Add a video to a playlist (requires authentication) |
| `get_video_comments` | Get comments for a video |
| `get_video_categories` | Get available video categories |
| `get_trending_videos` | Get trending videos by region |
| `get_my_channel` | Get authenticated user's channel information |
| `get_subscriptions` | Get channel subscriptions (requires authentication) |
| `subscribe_to_channel` | Subscribe to a channel (requires authentication) |
| `rate_video` | Rate a video (like/dislike) - requires authentication |
| `get_activity` | Get channel activity feed (requires authentication) |

## Useful resources

* [YouTube Data API documentation](https://developers.google.com/youtube/v3/getting-started)


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.