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

# YouTube

> Search, transcribe, and analyze YouTube content with Hyper AI

The YouTube integration lets your agents search videos, pull transcripts, scrape comments, extract metadata, and gather contact info from channels — all without you having to manage a YouTube Data API key.

Auth type: Built-in (no external auth required)

<Info>
  For how integrations work overall (permissions, authentication, troubleshooting), see the main guide: [App Integrations](/integrations/overview).
</Info>

## Common capabilities

* **Search** — keyword search across YouTube
* **Video metadata** — title, channel, duration, views, upload date
* **Transcripts** — pull captions for any video that has them
* **Comments** — search and extract comments at scale
* **Channel emails** — find contact emails listed on a channel's about page
* **Trainability check** — see whether a video allows AI training (license-aware workflows)
* **Reader / downloader** — turn a YouTube video into structured text or download the video

## Use in Chat

1. In a chat, open the tool selector and enable YouTube
2. Ask your agent to research a topic

Example prompt:

```text theme={null}
Search YouTube for "AI agents demos" uploaded in the last 30 days with at least 10k views. For the top 10, pull the transcript and summarize the key takeaways into a single doc. Add the channel emails so I can reach out about partnerships.
```

## Use in Agents

In `Agents → Settings`, attach YouTube to a content research, competitive intel, or partnerships agent. Pair with [Reddit](/integrations/reddit), [Twitter](/integrations/twitter), and the Meta Ads Library scraper for full social-listening coverage.

## Use in Flows

Add YouTube nodes to automate weekly research: search → fetch transcripts → summarize → drop into Notion or Sheets.

## Troubleshooting

* **No transcript available**: not every video has captions — the tool will tell you. Some channels disable transcripts entirely
* **Comments empty**: comments may be disabled on the video, or YouTube may rate-limit large requests — try smaller batches
* **Channel emails empty**: only channels that publicly list a contact email on their about page expose one

***

## Available Actions

Hyper agents can run the following actions for this integration. Each action can be individually set to **Enabled**, **Requires Approval**, or **Disabled** in your agent's toolkit settings.

Actions can be set to one of three control states:

| State                 | Behavior                                                       |
| --------------------- | -------------------------------------------------------------- |
| **Enabled**           | Agent runs the action automatically                            |
| **Requires Approval** | Agent pauses and waits for your confirmation before proceeding |
| **Disabled**          | Action is blocked and cannot be used                           |

Configure these in the agent's toolkit settings or in workspace defaults.

| Action          | Description                                                                                                                           |
| --------------- | ------------------------------------------------------------------------------------------------------------------------------------- |
| Channel Emails  | Scrape business contact emails from YouTube channel About pages                                                                       |
| Comments Search | Scrape comments from YouTube videos using Apify's YouTube Comments Scraper                                                            |
| Downloader      | Download YouTube videos using Apify's YouTube Download actor. Returns download information including video metadata and download URLs |
| Reader          | Read YouTube videos and extract required information. You can use the tool to:                                                        |
| Sb Metadata     | Get detailed metadata for a YouTube video using YouTube API                                                                           |
| Sb Search       | Search YouTube videos YouTube API                                                                                                     |
| Sb Trainability | Check if a YouTube video's transcript is available for AI training purposes                                                           |
| Sb Transcript   | Get the transcript/captions for a YouTube video using ScrapingBee YouTube API                                                         |
| Search          | Search for YouTube videos using the YouTube Data API v3. You can use this tool to:                                                    |
| Transcript      | Fetch YouTube video transcript using an isolated sandbox environment                                                                  |