YouTube Analytics

This page contains the setup guide and reference information for the YouTube Analytics source connector.

Prerequisites

YouTube does not start to generate a report until you create a reporting job for that report. Airbyte creates a reporting job for your report or uses the current reporting job if it already exists. The report will be available within 48 hours of creating the reporting job and will be for the day that the job was scheduled. For example, if you schedule a job on September 1, 2015, then the report for September 1, 2015, will be ready on September 3, 2015. The report for September 2, 2015, will be posted on September 4, 2015, and so forth. Youtube also generates historical data reports covering the 30-day period prior to when you created the job. Airbyte syncs all available historical data too.

Setup guide

Step 1: Set up YouTube Analytics

• Go to the YouTube Reporting API dashboard in the project for your service user. Enable the API for your account.
• Use your Google account and authorize over Google's OAuth 2.0 on connection setup. Please make sure to grant the following authorization scope: https://www.googleapis.com/auth/yt-analytics.readonly.

Step 2: Set up the YouTube Analytics connector in Airbyte

For Airbyte Cloud:

1. Log into your Airbyte Cloud account.
2. In the left navigation bar, click Sources. In the top-right corner, click +new source.
3. On the Set up the source page, enter the name for the YouTube Analytics connector and select YouTube Analytics from the Source type dropdown.
4. Select Authenticate your account.
5. Log in and Authorize to the Youtube account and click Set up source.

For Airbyte OSS:

1. In the left navigation bar, click Sources. In the top-right corner, click +new source.
2. On the Set up the source page, enter the name for the YouTube Analytics connector and select YouTube Analytics from the Source type dropdown.
3. Enter your client_id
4. Enter your client_secret
5. Enter your refresh_token
6. Click Set up source.

Content Owner ID (Optional)

The Content Owner ID field is for YouTube partners who participate in the YouTube Partner Program and manage multiple channels through a content owner account. This includes Multi-Channel Networks (MCNs) and media companies that manage content across multiple YouTube channels.

• If you are a regular YouTube channel owner, leave this field empty. The connector will retrieve data for the channel associated with your OAuth credentials.
• If you are a YouTube partner with a content owner account, enter your content owner ID to retrieve data for channels managed under that account.
• To find your content owner ID, you can check the URL when logged into the YouTube Studio (look for the o= parameter), use the YouTube Content ID API, or contact your YouTube partner manager.

Supported sync modes

The YouTube Analytics source connector supports the following sync modes:

Feature	Supported?
Full Refresh Sync	Yes
Incremental Sync	Yes
SSL connection	Yes
Channel Reports	Yes
Content Owner Reports	Coming soon
YouTube Data API	Coming soon

Supported Streams

• channel_annotations_a1
• channel_basic_a3
• channel_cards_a1
• channel_combined_a3
• channel_demographics_a1
• channel_device_os_a3
• channel_end_screens_a1
• channel_playback_location_a3
• channel_province_a3
• channel_sharing_service_a1
• channel_subtitles_a3
• channel_traffic_source_a3
• playlist_basic_a2
• playlist_combined_a2
• playlist_device_os_a2
• playlist_playback_location_a2
• playlist_province_a2
• playlist_traffic_source_a2

Performance considerations

The YouTube Reporting API has the following quota limits:

• Free requests per day: 20,000
• Free requests per 100 seconds: 100
• Free requests per minute: 60

The connector retrieves bulk report data from YouTube's reporting jobs, which minimizes API quota usage compared to making individual queries for each metric.

Changelog

<details> <summary>Expand to review</summary>

Version	Date	Pull Request	Subject
1.2.3	2026-02-24	73149	Update dependencies
1.2.2	2026-02-03	72635	Update dependencies
1.2.1	2026-01-20	72048	Update dependencies
1.2.0	2026-01-14	71377	Promoting release candidate 1.2.0-rc.2 to a main version.
1.2.0-rc.2	2026-01-09	71244	Fix incorrect report_id key and remove additional error message
1.2.0-rc.1	2026-01-07	71169	Add optional content_owner_id config for multi-channel support and improve error handling
1.1.2	2025-12-18	70715	Update dependencies
1.1.1	2025-12-02	64964	Update dependencies
1.1.0	2025-11-17	69352	Promoting release candidate 1.1.0-rc.1 to a main version.
1.1.0-rc.1	2025-11-02	42838	Migrate to Manifest-only
1.0.0	2025-10-30	66558	Update deprecated channel and playlist BULK reports
0.2.0	2025-02-07	53196	Update check connection and empty responses
0.1.7	2025-02-26	54696	Update requests-mock dependency version
0.1.6	2024-06-17	39529	Pin CDK version to 0.38.0
0.1.5	2024-05-21	38546	[autopull] base image + poetry + up_to_date
0.1.4	2023-05-22	26420	Migrate to advancedAuth
0.1.3	2022-09-30	17454	Added custom backoff logic
0.1.2	2022-09-29	17399	Fixed 403 error while check connection
0.1.1	2022-08-18	15744	Fix channel_basic_a2 schema fields data type
0.1.0	2021-11-01	7407	Initial Release

</details>