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


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.coupler.io/sources/category/marketing/youtube.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.