# How to Automate YouTube Analytics Reports using the API - Tool: API Automations - Difficulty: Intermediate - Fix time: 30–60 minutes - Compatibility: YouTube Analytics API v2, YouTube Data API v3, google-api-python-client 2.x, googleapis npm 144.x - Last updated: May 2026 ## TL;DR Pull YouTube channel performance data using YouTube Analytics API v2 reports.query. The critical recent change: youtube.readonly scope is now REQUIRED in addition to yt-analytics.readonly — integrations that only had the analytics scope will break. Service accounts DO NOT work with YouTube APIs — returns NoLinkedYouTubeAccount. The YouTube Data API has a 10,000 quota unit daily cap per project (not per user) that resets at midnight Pacific Time. Analytics API quota is separate and visible only in Cloud Console. ## Best practices - Request both youtube.readonly and yt-analytics.readonly scopes — youtube.readonly is now required for Analytics API even if you only need analytics data - Never use service accounts for YouTube APIs — they are fundamentally unsupported and will always return NoLinkedYouTubeAccount - Avoid search.list in analytics workflows — it costs 100 quota units per call and depletes your 10,000 unit daily budget in 100 calls - Account for 24–72 hour analytics data delay — use endDate at least 2 days before today for reliable data in automated reports - Batch video metadata lookups: pass up to 50 video IDs in one videos.list call instead of one call per video - Cache channel IDs and report data locally — the channel ID never changes, and historical analytics data doesn't change after processing - Use the 'MINE' identifier in the ids parameter (channel==MINE) rather than hard-coding channel IDs — this makes your code portable across channels - Monitor your project's quota usage in Cloud Console > APIs & Services > Quotas regularly — you want to see warning signs before hitting the daily limit ## Frequently asked questions ### Why do I need youtube.readonly scope for the Analytics API? That seems redundant. It does seem redundant, but it's a real requirement. Google updated the Analytics API to require youtube.readonly in addition to yt-analytics.readonly. If your integration predates this change and only requested yt-analytics.readonly, you'll now get 403 insufficientPermissions errors on reports.query calls. Add youtube.readonly to your scopes and have users re-authorize your app. ### Can I use a service account to automate YouTube analytics pulls on a schedule? No. YouTube APIs fundamentally do not support service accounts — they return NoLinkedYouTubeAccount because a service account has no YouTube channel. You must use OAuth 2.0 with a real user who has authorized your app. For scheduled jobs, store the refresh token securely and use it to get new access tokens automatically without user interaction. ### Why is my analytics data empty or showing zeros for recent dates? YouTube Analytics data has a 24–72 hour processing delay. Data for today or yesterday is typically incomplete or absent. For reliable report data, use endDate set to at least 2–3 days ago. For scheduled weekly reports, a good pattern is: run on Sunday, report on the week ending Thursday (3 days ago). ### The 10,000 daily quota feels very restrictive. How do I get more? Submit the YouTube API Services Audit and Quota Extension Form at console.cloud.google.com. You'll need to describe your application, provide usage patterns, and demonstrate compliance with YouTube API Terms of Service. There is no monetary cost for quota increases — it's a compliance review. The process typically takes 2–4 weeks. In the meantime, optimize your code: avoid search.list (100 units), batch video metadata lookups, and cache results. ### How do I get revenue and CPM data in my analytics reports? Add the yt-analytics-monetary.readonly scope to your OAuth scopes, and your channel must be in the YouTube Partner Program (monetized). Then add revenue metrics to your reports.query: estimatedRevenue, grossRevenue, adImpressions, monetizedPlaybacks, cpm, playbackBasedCpm. Channels not in YPP will get zero values for revenue metrics even with the scope authorized. ### Can RapidDev build a YouTube analytics dashboard for my channel or agency? Yes. If you need a custom analytics dashboard — showing performance trends, comparing videos, tracking campaign ROI, or managing multiple channels — RapidDev can build that. We handle the YouTube OAuth integration, data caching to stay within quota limits, and real-time visualization so you always have the insights you need. ### How do I avoid hitting the search.list quota trap in my analytics workflow? Don't use search.list at all for analytics workflows. It costs 100 quota units per call — calling it 100 times depletes your entire 10,000 daily quota. Instead, use videos.list with specific video IDs (1 unit per call for up to 50 videos), or channels.list with mine=true to get your video list from your channel's contentDetails. If you need to find videos by keyword, do that once and store the IDs rather than searching every time. --- Source: https://www.rapidevelopers.com/api-automations/how-to-automate-youtube-analytics-reports-using-the-api © RapidDev — https://www.rapidevelopers.com/api-automations/how-to-automate-youtube-analytics-reports-using-the-api