YouTube

8 production-ready jobs — competitor ad showdowns, comment persona validation, trending gap analysis, pre-roll testing, influencer analysis, Shorts vs long-form, playlist strategy, and thumbnail focus groups

Overview

YouTube’s Data API v3 exposes the public video intelligence that most marketing teams ignore — search results, comment threads, trending charts, playlist structures, and thumbnail metadata. These eight jobs pull that data through Mavera’s surfaces (Video Analysis, Focus Groups, Personas, Mave Agent, Generate) to rank competitor ads by emotional impact, validate audience personas against real comment sentiment, find content gaps in trending videos, test pre-roll hooks with synthetic panels, and measure Shorts against long-form performance.

YouTube Data API v3 — Base URL: https://www.googleapis.com/youtube/v3/. Auth: API Key (public read) or OAuth 2.0 (private data). Rate limits: 10,000 quota units/day; search.list = 100 units; videos.list = 1 unit; commentThreads.list = 1 unit.

---

Prerequisites

1. Google Cloud project

   Create a project in the Google Cloud Console and enable the YouTube Data API v3.
2. API key

   Generate an API key under APIs & Services → Credentials. Restrict it to the YouTube Data API v3 and your server IP range.
3. Mavera API key

   Get your key from Mavera dashboard.
4. Environment variables

   export YOUTUBE_API_KEY="AIzaSy..."
   export MAVERA_API_KEY="mvra_live_xxxxx"
   

---

Jobs

#	Job	YouTube Data	Mavera Surface	Output
1	Competitor Ad Analysis Showdown	search.list (competitor ads)	Video Analysis	Message clarity, emotional impact, brand attribution ranking
2	Comment Sentiment → Persona Validation	commentThreads.list	Personas + Chat	Audience segment analysis from 200 comments
3	Trending Content Gap Analysis	videos.list?chart=mostPopular	Mave Agent	Missing content themes your brand could own
4	YouTube Pre-Roll Ad Testing	Video Analysis (pre-roll candidates)	Focus Groups	Skip-or-watch verdict on first 5 seconds
5	Influencer Content Analysis	search.list (influencer videos)	Video Analysis	Brand alignment scores per influencer
6	YouTube Shorts vs. Long-Form Performance	videos.list (Shorts + long-form)	Video Analysis	Cross-format scoring comparison
7	Playlist-Based Content Strategy	playlists.list + playlistItems.list	Mave Agent	Content theme and sequencing analysis
8	Video Thumbnail A/B with Focus Groups	videos.list (thumbnails)	Focus Groups	Click-likelihood ratings 1–10 per persona

---

Rate Limits & Production Notes

YouTube Endpoint	Quota Cost	Daily Budget Impact	Strategy
search.list	100 units	1% of daily quota per call	Cache results; avoid repeated searches for same query
videos.list	1 unit	Negligible	Batch up to 50 IDs per call to minimize requests
commentThreads.list	1 unit	Negligible	Paginate with maxResults=100 for efficiency
playlists.list	1 unit	Negligible	Single call covers 25 playlists
playlistItems.list	1 unit	Negligible	50 items per page; paginate for large playlists
videoCategories.list	1 unit	Negligible	Cache category map — it rarely changes

YouTube Data API v3 enforces a 10,000 quota units/day limit. The most expensive operation is search.list at 100 units per call. A single run of Job 1 (Competitor Ad Analysis) with 3 competitors uses 300+ units (3%). Plan your daily job schedule to stay within budget. Monitor usage at the Google Cloud Console quotas page. Request a quota increase via the Audit Form for production workloads.

Production checklist:

Concern	Recommendation
API key security	Restrict your API key to the YouTube Data API v3 and your server’s IP range. Never expose it client-side.
Quota monitoring	Set up Cloud Monitoring alerts at 80% daily quota consumption.
Caching	Cache search.list results for 6–24 hours. Trending data refreshes every 15 minutes but caching hourly is sufficient.
Rate limiting	Add 1-second delays between sequential API calls. YouTube doesn’t publish per-second limits but throttles burst traffic.
Video availability	Public videos can be deleted or made private at any time. Handle 404s gracefully in analysis pipelines.
Regional consistency	Always set regionCode on search.list and videos.list?chart=mostPopular for reproducible results.
Mavera credits	Monitor usage at Dashboard. Video Analysis consumes more credits than Chat.

---

All Integrations

50+ API integrations with full code

YouTube Data API Reference

Official YouTube Data API v3 documentation

Video Analysis

Full reference for POST /api/v1/video-analysis

Focus Groups API

Full reference for POST /api/v1/focus-groups

Mave Agent

Full reference for POST /api/v1/mave/chat

Personas API

Full reference for POST /api/v1/personas