YouTube Analytics API: Content Owner Reports

  • Content Owner Reports provide YouTube content partners with detailed metrics on channels linked to their content owner accounts, covering user activity, ad performance, and estimated revenue.

  • These reports are accessible through the reports.query method using OAuth 2.0 authorization, and data must be filtered by dimensions like video, channel, or specific combinations of claimedStatus and uploaderType.

  • Video Reports offer a variety of data, including basic user activity, geographic breakdowns by country, province, and city, and time-based activity, all supporting a wide range of metrics like views, likes, and estimatedRevenue.

  • Playlist Reports, while deprecating the isCurated dimension by the end of 2024, offer metrics for both aggregated video activity and in-playlist activity, with the views metric behavior changing based on the presence or absence of isCurated.

  • Several reports require you to specify exactly one of playlist or group if certain view-related metrics are requested, and there are specific reports with their own requirements, like the Top Playlists report that can be sorted by playlistViews, playlistEstimatedMinutesWatched, or playlistStarts with a maxResults limit of 200.