YouTube API Integration — Connect Your Channel Analytics

Frequently asked questions

What is the TubeAnalytics YouTube API Integration?

The YouTube API Integration is the connection layer that links your YouTube channel to TubeAnalytics via Google OAuth 2.0. Once authorized, TubeAnalytics pulls data from the YouTube Analytics API and YouTube Data API v3 — the same authenticated endpoints YouTube Studio uses — to populate your dashboard with video performance, audience, revenue, and metadata. Analytics and metadata access is read-only; comment management additionally uses the youtube.force-ssl scope so you can reply to and moderate comments on your own videos. The integration syncs automatically on a daily cadence. It is the foundation connection required for all TubeAnalytics features and is available on every plan.

Is the YouTube API Integration secure?

Yes, and here is exactly what is granted. TubeAnalytics requests four YouTube scopes over Google OAuth 2.0: youtube.readonly for video and channel metadata, yt-analytics.readonly for performance data, yt-analytics-monetary.readonly for revenue data, and youtube.force-ssl for the comments manager and the transcripts tool. The first three are read-only. youtube.force-ssl is a read/write scope, and it is used for two things: replying to, moderating, spam-flagging, and deleting comments on your own videos from the comments dashboard, and reading the caption tracks behind the transcripts tool — Google gates its captions endpoints behind youtube.force-ssl, so youtube.readonly is not sufficient to fetch them. The transcripts use only reads. Comments are the only place the product writes to YouTube — TubeAnalytics cannot upload or publish videos, edit titles, descriptions, tags or thumbnails, change channel settings, or delete videos. You can review and revoke access at any time from your Google Account's 'Third-party apps with account access' page. TubeAnalytics also encrypts all OAuth tokens at rest and rotates them according to Google's token expiration schedule.

How long does the initial data sync take?

The initial sync typically completes within 24 hours for most channels. During this period, TubeAnalytics imports your video library metadata, analytics history, audience demographics, and revenue data going back as far as your plan allows (90 days Starter, 1 year Professional, 5 years Enterprise). The sync runs in the background — you can close the browser and return later to find your data ready. After the initial import, your data updates once a day.

What happens if my OAuth token expires?

Google OAuth tokens expire after a set period (typically 6–12 months depending on the token type) or if you change your Google account password. When a token expires, TubeAnalytics detects the failed sync and stops syncing that channel until you re-authorize the connection.

Can I connect multiple YouTube channels to one TubeAnalytics account?

Yes. TubeAnalytics supports multiple channel connections under a single account. Starter plan supports 1 channel, Professional supports up to 3 channels, and Enterprise supports up to 5 channels. Each channel undergoes its own OAuth authorization flow and is managed independently from Settings > Channels. Multi-channel views are available on Professional and Enterprise plans, letting you see aggregate metrics across all connected channels in a single dashboard view.

What data does the YouTube API Integration pull?

The integration pulls video-level analytics (views, watch time, CTR, average view duration), audience data (demographics, retention curves, new vs. returning viewers), revenue metrics (CPM, RPM, ad type performance, estimated revenue), traffic source breakdowns (Browse, Search, Suggested, External, Notifications), and video metadata (titles, descriptions, tags, publish dates, thumbnails). The exact dataset available depends on the YouTube Analytics API's data retention and your TubeAnalytics plan tier. All data matches what you see in YouTube Studio since both platforms use the same API endpoints.