Multi-Region Video Discovery with YouTube Data API

The YouTube Data API lets you fetch trending videos from specific countries using the regionCode parameter. In this article, I'll show how to build a multi-region fetching system, handle API quotas intelligently, and normalize the results. This approach powers DailyWatch , which aggregates trending content from 8 countries. Understanding the API The key endpoint is videos.list with the chart=mostPopular parameter: GET https://www.googleapis.com/youtube/v3/videos ?part=snippet,statistics,contentDetails &chart=mostPopular &regionCode=US &maxResults=50 &key=YOUR_API_KEY This costs 1 quota unit and returns up to 50 videos. The Multi-Region Fetcher class RegionalVideoFetcher { private const API_BASE = 'https://www.googleapis.com/youtube/v3/videos' ; private const PARTS = 'snippet,statistics,contentDetails' ; private int $quotaUsed = 0 ; public function __construct ( private readonly string $apiKey , private readonly int $dailyQuotaLimit = 10000 , ) {} /** * Fetch trending videos from multip