Skip to main content

Scenario

YouTube’s Most Popular chart reveals what the platform is amplifying right now — but your brand isn’t on it. This job pulls the top 50 trending videos via videos.list?chart=mostPopular, extracts their categories, tags, and descriptions, then sends the full dataset to Mave with your brand context. Mave identifies content themes that are trending but absent from your channel — gaps your brand could own with timely content. The result is a content gap report with specific video concepts ranked by opportunity size.

Architecture

Code

Example Output

Error Handling

Without regionCode, results default to the US. Set this explicitly for non-US brands. Not all regions return 50 results.
YouTube uses numeric category IDs (e.g., 17 = Sports). The videoCategories endpoint translates these. Some categories are region-specific.
This entire job uses ~2 quota units (1 for videos.list, 1 for videoCategories). It’s the most quota-efficient job in this guide.

YouTube Integration

Mave Agent