YouTube Integration
Connect your YouTube channel to Iverton AI to track video performance, monitor channel growth, and access detailed analytics for your video content strategy.
Overview
The YouTube integration uses OAuth 2.0 via Google to securely connect your channel. Once connected, you can:
- View channel and video analytics
- Track subscriber growth and engagement
- Monitor video performance over time
- Access real-time statistics
- Integrate video data with marketing reports
Prerequisites
Before connecting, ensure you have:
- A Google account linked to the YouTube channel
- Owner or Manager access to the channel
- The channel must be in good standing (not suspended)
If your YouTube channel is a Brand Account, make sure you're signed into the correct Google account that manages that channel.
Connecting YouTube
Step-by-Step Connection
- Go to Integrations in the main sidebar
- Find YouTube in the Social Media category
- Click Connect
- A Google login popup will appear
- Sign in with the Google account linked to your YouTube channel
- Review the permissions Iverton AI is requesting
- Click Allow to grant access
- Select which channel to connect (if you manage multiple)
Permissions Requested
Iverton AI requests these YouTube/Google permissions:
| Permission | Scope | What It Allows |
|---|---|---|
| View YouTube account | youtube.readonly | Read channel info and video data |
| View YouTube analytics | youtube.analytics.readonly | Access detailed performance metrics |
| Manage YouTube videos | youtube.force-ssl | Secure API access |
Iverton AI only requests read-only access to your YouTube data. We cannot upload, modify, or delete your videos.
Channel Selection
If your Google account manages multiple YouTube channels:
- After authorization, you'll see a list of available channels
- Select the channel you want to connect
- Click Confirm to complete the setup
Available Data
Channel Analytics
Once connected, Iverton AI syncs the following channel data:
Overview Metrics
| Metric | Description |
|---|---|
| Subscribers | Total subscriber count |
| Total views | Lifetime video views |
| Total videos | Number of public videos |
| Watch time | Total hours watched |
Growth Metrics
| Metric | Description |
|---|---|
| New subscribers | Subscribers gained in period |
| Lost subscribers | Subscribers lost in period |
| Net growth | New minus lost subscribers |
| Views trend | Views over time |
Video Analytics
For each video, Iverton AI tracks:
Performance Metrics
| Metric | Description |
|---|---|
| Views | Total video views |
| Watch time | Hours watched |
| Average view duration | How long viewers watch |
| Average percentage viewed | % of video watched on average |
Engagement Metrics
| Metric | Description |
|---|---|
| Likes | Number of likes |
| Dislikes | Number of dislikes (if available) |
| Comments | Number of comments |
| Shares | Number of shares |
Traffic Sources
| Source | Description |
|---|---|
| YouTube search | Views from search |
| Suggested videos | Views from recommendations |
| External | Views from outside YouTube |
| Direct | Views from direct links |
| Browse features | Views from home page |
Audience Data
Understand who's watching your content:
| Data | Description |
|---|---|
| Geography | Top countries and regions |
| Demographics | Age and gender breakdown |
| Device type | Desktop, mobile, tablet, TV |
| Playback location | YouTube watch page, embedded, etc. |
Features
Dashboard Widgets
Add YouTube data to your dashboard:
Available Widgets
- Channel overview card
- Subscriber growth chart
- Top performing videos
- Recent video performance
- Views trend line
To add a widget:
- Go to Dashboard → Customize
- Click Add Widget
- Select a YouTube widget
- Configure date range and display options
Automated Reports
Include YouTube analytics in client reports:
- Go to Reports → Create Report
- Add the YouTube section
- Select metrics to include:
- Channel growth summary
- Top videos by views/engagement
- Traffic source breakdown
- Audience insights
- Schedule automated delivery
Video Performance Tracking
Monitor video performance over time:
- Go to Analytics → YouTube
- View the video list sorted by performance
- Click a video for detailed metrics
- Compare performance across videos
Data Syncing
Sync Schedule
| Data Type | Sync Frequency |
|---|---|
| Channel stats | Every hour |
| Video metrics | Every 4 hours |
| Audience data | Daily |
| Real-time views | On demand |
YouTube's API has a delay of 1-2 days for some detailed metrics. Real-time data shows estimates that may differ from final numbers.
Manual Sync
To force an immediate data sync:
- Go to Integrations → YouTube
- Click Sync Now
- Wait for the sync to complete
Token Management
Token Lifecycle
YouTube tokens are managed through Google OAuth:
- Initial Connection: You authorize via Google
- Access Token: Short-lived token (1 hour)
- Refresh Token: Used to get new access tokens
- Automatic Refresh: Iverton AI refreshes tokens automatically
Token Expiration
Tokens may need manual refresh if:
- You revoked access in Google account settings
- You changed your Google password
- Extended inactivity (90+ days without sync)
Re-Authorization
If you see a "Token expired" warning:
- Go to Integrations → YouTube
- Click Reconnect
- Complete the Google authorization flow
- Select your channel again
Troubleshooting
Common Issues
"Channel not appearing in selection"
- Verify you're signed into the correct Google account
- Check that you have Manager or Owner role on the channel
- For Brand Accounts, switch to the correct account in Google
"Analytics data not available"
- New channels may take 48 hours to show analytics
- Verify the channel has public videos with views
- Some metrics require a minimum data threshold
"API quota exceeded"
- YouTube has strict API quotas (10,000 units/day)
- Wait until the next day for quota reset
- Reduce sync frequency if this happens often
"Token refresh failed"
- Check if access was revoked in Google account
- Re-authorize the connection
- Verify the channel still exists and is active
"Subscriber count not updating"
- YouTube may delay subscriber counts by up to 48 hours
- Counts are rounded on the public API
- Check YouTube Studio for exact numbers
YouTube API Limitations
| Limitation | Details |
|---|---|
| API quota | 10,000 units per day |
| Data delay | 1-2 days for detailed analytics |
| Subscriber rounding | Rounded to nearest 10/100/1000 |
| Historical data | Limited to last 18 months |
| Real-time accuracy | Estimates may differ from final |
Disconnecting
To remove the YouTube integration:
- Go to Integrations → YouTube
- Click Disconnect
- Confirm the disconnection
To fully revoke access:
- Go to Google Account Permissions
- Find "Iverton AI" in the list
- Click Remove Access
API Endpoints Reference
For developers integrating with the YouTube API:
GET /api/oauth/youtube - Initiate YouTube OAuth
GET /api/oauth/youtube/callback - OAuth callback handler
GET /api/social-accounts - List connected accounts
DELETE /api/social-accounts/youtube/:id - Disconnect account
POST /api/oauth/youtube/refresh/:id - Refresh access token
GET /api/oauth/status/youtube/:id - Check connection status
Environment Variables
For self-hosted deployments:
# Google OAuth (used for YouTube)
GOOGLE_CLIENT_ID=your-client-id
GOOGLE_CLIENT_SECRET=your-client-secret
# YouTube-specific (if separate from main Google OAuth)
YOUTUBE_CLIENT_ID=your-youtube-client-id
YOUTUBE_CLIENT_SECRET=your-youtube-client-secret
YOUTUBE_REDIRECT_URI=https://your-domain/api/oauth/youtube/callback
Next: SEO Tools