# YouTube

YouTube is a video sharing platform with built-in analytics tools. Coupler.io connects to YouTube Analytics to automatically export your channel and video performance data to Google Sheets, Excel, BigQuery, Looker Studio, or AI destinations like Claude and ChatGPT.

## Why connect YouTube to Coupler.io?

* **Automated reporting** — Pull analytics data on a schedule without manual exports
* **Multiple report types** — Access channel statistics, video performance, traffic sources, subscriber data, and custom reports
* **Flexible breakdowns** — Split data by day or month, and filter by content type, device, geography, and more
* **Integrate with BI tools** — Send data directly to BigQuery, Looker Studio, Power BI, or spreadsheets for dashboards and analysis

## Prerequisites

* A YouTube account with access to the channels you want to report on
* YouTube Partner Program eligibility (for revenue-related metrics)
* Basic YouTube analytics access (available on most channels)

## Quick start

{% hint style="success" %}
Start with **Channel detailed statistics** if you're new to YouTube reporting. It gives you views, watch time, subscribers gained, and other essential metrics without complex setup.
{% endhint %}

## How to connect

{% stepper %}
{% step %}
**Sign in to your Coupler.io account** and create a new data flow. Select **YouTube** as your source.
{% endstep %}

{% step %}
**Click "Connect" or "Sign in with Google"** to authorize Coupler.io to access your YouTube Analytics data. You'll be taken to Google's login page. Sign in with the account that owns or has access to your YouTube channels.
{% endstep %}

{% step %}
**Select your channels** from the dropdown. If you have multiple channels, you can select one or multiple to include in your report.
{% endstep %}

{% step %}
**Choose a report type**:

* **Channel detailed statistics** — Overall channel performance (views, watch time, subscribers, likes, comments)
* **Channel statistics by content and subscriber type** — Performance broken down by content type and subscriber status
* **Channel subscribers** — Subscriber growth with demographic breakdowns (age, gender, country)
* **Video detailed statistics** — Individual video performance metrics
* **Video statistics by content and subscriber type** — Video performance by content and subscriber type
* **Traffic sources** — Where your views come from (search, recommended, external links, etc.)
* **Custom** — Pick specific metrics and dimensions for a tailored report
  {% endstep %}

{% step %}
**Set your report period** using the start and end date fields. You can use specific dates or date macros (e.g., {{today}}, {{30daysago}}) to keep reports current.
{% endstep %}

{% step %}
**If using a preset report type**, you'll see additional options:

* **Split data by period** — Choose Day or Month to break down data into smaller time intervals
* **Additional dimensions** — Further segment your data by video, playlist, traffic source, or audience demographics
  {% endstep %}

{% step %}
**If using Custom report**, select your metrics (views, watch time, likes, subscribers gained, etc.) and dimensions (video, device type, country, age, gender, etc.) to build exactly what you need.
{% endstep %}

{% step %}
**Choose your destination** — Google Sheets, Excel, BigQuery, Looker Studio, or an AI destination like Claude or ChatGPT. Configure column mapping if needed.
{% endstep %}

{% step %}
**Run the data flow** by clicking the "Run" button. Wait for the flow to complete successfully before scheduling. This ensures your settings are correct and data flows as expected.
{% endstep %}
{% endstepper %}

## Available report types

| Report Type                                       | Best For                           | Key Metrics                                                             |
| ------------------------------------------------- | ---------------------------------- | ----------------------------------------------------------------------- |
| Channel detailed statistics                       | Overall channel health             | Views, watch time, subscribers gained/lost, engagement                  |
| Channel statistics by content and subscriber type | Performance by content mix         | Views and watch time broken by live vs. on-demand and subscriber status |
| Channel subscribers                               | Subscriber growth and demographics | New subscribers, lost subscribers, by age, gender, country              |
| Video detailed statistics                         | Individual video performance       | Per-video views, watch time, average duration, engagement               |
| Video statistics by content and subscriber type   | Video performance by type          | Video views and watch time by content type and subscriber status        |
| Traffic sources                                   | Understanding discovery            | Views by search, recommendations, external links, YouTube features      |
| Custom                                            | Specific metrics and dimensions    | Any combination of 40+ metrics and 20+ dimensions                       |