Skip to main content

​
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

​
Jobs

​
Rate Limits & Production Notes

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:

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