YouTube API Integration — Connect Your Channel Analytics | TubeAnalytics

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. The integration is read-only, uses the most restricted OAuth scopes available, and 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. The integration uses Google OAuth 2.0 with read-only scopes — TubeAnalytics can only view analytics data and video metadata. It cannot publish videos, modify channel settings, delete content, respond to comments, or access non-public account information. The OAuth scopes used are the most restricted available for the YouTube Data API: youtube.readonly for video metadata and yt-analytics.readonly for performance data. 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, daily incremental syncs take just a few minutes to process new data since they only pull updates since the last successful sync.

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 sends you an email notification asking you to re-authorize the connection. Any data that could not be synced during the token expiry period is queued and imported as soon as you re-authorize — no historical data is lost. You can also proactively check your connection status at any time from Settings > Integrations in the TubeAnalytics dashboard.

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 20 channels plus custom configurations. Each channel undergoes its own OAuth authorization flow and is managed independently from the Integrations settings page. 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.