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

# YouTube Connection

> Bring playlists, channel content, and engagement data directly into your YouWare projects. Automate updates, showcase videos, and personalize experiences with live YouTube data.

<Frame>
  <img src="https://mintcdn.com/youware-18c86901/WGsWq6AKYA8w9i4T/images/YouTube.png?fit=max&auto=format&n=WGsWq6AKYA8w9i4T&q=85&s=f8e29fe62ed3d94f15d928caef1930b6" alt="YouTube connection overview showing channel insights and video cards" width="1440" height="810" data-path="images/YouTube.png" />
</Frame>

<Info>
  **Ship video-first experiences without manual embeds.** Once the YouTube connection is enabled, YouWare can pull live channel and video data—no personal API keys or manual syncing required.
</Info>

## Quick Summary

* **Purpose:** Auto-fetch public YouTube channel + video metadata to power research sites, landing pages, and dashboards
* **Pulls:** Titles, descriptions, thumbnails, view counts, publish dates, Shorts, livestream replays, and channel stats
* **Updates:** Data refreshes every time you regenerate the page or request a sync in Connections → YouTube
* **Best for:** Channel research, creator partnerships, media kits, launch hubs, course directories, investor reports

***

## What is the YouTube Connection?

The YouTube connection lets YouWare analyze any channel you mention in your prompt—e.g. *“Build a research site for the MrBeast YouTube channel”*. The AI fetches real channel data (subscriber counts, playlists, top videos, latest uploads) and designs pages that embed playable videos with jump links back to YouTube.

<CardGroup cols={3}>
  <Card title="Live Video Galleries" icon="grid">
    Auto-generate carousels and grids with real thumbnails, durations, and view counts
  </Card>

  <Card title="Channel Profiles" icon="users">
    Summarize creator bios, publishing cadence, top-performing content, and sponsorship highlights
  </Card>

  <Card title="Analytics Dashboards" icon="chart-line">
    Visualize trends for watch time, subscriber growth, engagement ratios, and upload frequency
  </Card>
</CardGroup>

***

## How It Works

<Steps>
  <Step title="Enable the connection">
    In your workspace, open **Connections → YouTube** and toggle it on. No Google Cloud setup or API keys required.
  </Step>

  <Step title="Describe the channel or topic">
    In your prompt, reference the creator, channel ID, video, or keywords you need. Example:\
    *“Create a competitive analysis page for MrBeast’s YouTube channel showcasing top videos, upload cadence, and audience stats.”*
  </Step>

  <Step title="Preview the generated sections">
    YouWare builds hero sections, galleries, analytics widgets, and CTAs populated with live channel data and video links.
  </Step>

  <Step title="Regenerate to refresh">
    Whenever you regenerate or request a manual sync, YouWare fetches the latest stats and updates the layouts accordingly.
  </Step>
</Steps>

***

## Prompt Example

```text theme={null}
"Build a research microsite for the MrBeast YouTube channel.
Include subscriber milestones, a grid of the latest uploads with direct links,
and a table comparing performance of his most-watched videos."
```

***

## Best Practices

* **Be specific in prompts:** Mention channel names, playlists, or target audiences (“compare tech review channels”)
* **Mix text + video:** Ask for executive summaries, sponsor callouts, or insight panels alongside embeds
* **Combine with Backend:** Save curated playlists, survey results, or partner leads directly into YouWare Backend
* **Leverage Shorts + Livestreams:** Call out trending Shorts or upcoming live events for richer engagement
* **Use Credit Care:** Iterate on layouts without fear—undo attempts that miss the mark and retry instantly

***

## Real-World Use Cases

<Tabs>
  <Tab title="Creator Hub">
    <Card title="Personal brand HQ" icon="star">
      Showcase featured videos, embed upcoming tour dates, and plug memberships. YouWare keeps thumbnails, view counts, and CTAs fresh.
    </Card>
  </Tab>

  <Tab title="Product Launch">
    <Card title="Video-first landing page" icon="rocket">
      Pair official trailers with product specs, influencer reactions, and direct CTAs to purchase or subscribe.
    </Card>
  </Tab>

  <Tab title="Education">
    <Card title="Course library" icon="graduation-cap">
      Organize lesson playlists, surface recommended modules, and sync descriptions or transcripts for SEO.
    </Card>
  </Tab>

  <Tab title="Media Network">
    <Card title="Editorial hub" icon="newspaper">
      Build verticals for shows, creators, or genres; drive traffic back to YouTube or monetize sponsorship inventory on your site.
    </Card>
  </Tab>
</Tabs>

***

## Frequently Asked Questions

<AccordionGroup>
  <Accordion title="Do I need a YouTube API key?">
    No. Once the YouTube connection is enabled in your YouWare workspace, data fetching is handled automatically—no Google Cloud project or keys required.
  </Accordion>

  <Accordion title="Can I limit results to specific videos or playlists?">
    Yes. Mention the exact channel, playlist, video IDs, or keywords in your prompt. YouWare only surfaces the sources you describe.
  </Accordion>

  <Accordion title="Does this work with Shorts and livestreams?">
    Absolutely. Shorts and live replay metadata are treated like standard videos—YouWare can create story strips, highlight sections, or event countdowns.
  </Accordion>

  <Accordion title="How often is the data refreshed?">
    Every time you regenerate the page or request a manual sync. You can also set automatic schedules inside Connections → YouTube.
  </Accordion>

  <Accordion title="Will embedding lots of videos hurt performance?">
    YouWare lazy-loads embeds and uses optimized thumbnails until interaction. You can also choose text-only cards that open modals or link directly to YouTube.
  </Accordion>

  <Accordion title="Can I mix YouTube data with other sources?">
    Yes. Blend YouTube insights with YouWare Backend, Notion, or Supabase connections to enrich pages with articles, products, or community feedback.
  </Accordion>

  <Accordion title="Is quota a concern?">
    YouWare respects YouTube’s public data limits. For channel research use cases, default quotas are typically sufficient; high-volume enterprise needs can request expanded access through support.
  </Accordion>
</AccordionGroup>

***

<Tip>
  **Need help crafting prompts?** Try:\
  `“Create a competitive report comparing Marques Brownlee and MrBeast YouTube channels, including top videos, collaboration highlights, and sponsor-ready talking points.”`
</Tip>