Stay organized with collectionsSave and categorize content based on your preferences.
The YouTube Analytics API allows you to retrieve YouTube Analytics data for a YouTube channel or content owner. The API supports real-time queries and generates a report based on the API request parameters.
The API supports two types of functions:
Report retrieval– The API'sreports.querymethod retrieves YouTube Analytics reports.
YouTube Analytics group management– A YouTube Analytics group is a custom collection of up to 500 channels, videos, playlists, or assets. The API supports several methods to create, retrieve, and update YouTube Analytics groups. Channel and content owners can then use thereports.querymethod to retrieve aggregated data for all of the items in a group, which can aid performance analysis.
This page provides a brief overview of the API resources and methods that enable these functions.
Authorization
All YouTube Analytics API requests must be authorized. TheAuthorization guideexplains how to use the OAuth 2.0 protocol to retrieve authorization tokens.
YouTube Analytics API requests use the following authorization scopes:
View YouTube Analytics monetary reports for your YouTube content. This scope provides access to user activity metrics and to estimated revenue and ad performance metrics.
https://www.googleapis.com/auth/youtube
Manage your YouTube account. In the YouTube Analytics API, channel owners use this scope to manage YouTube Analytics groups and group items.
https://www.googleapis.com/auth/youtubepartner
View and manage YouTube assets and associated content on YouTube. In the YouTube Analytics API, content owners use this scope to manage YouTube Analytics groups and group items.
Report retrieval
The API'sreports.querymethod lets you retrieve many different YouTube Analytics reports. Each request uses query parameters to specify a channel ID or content owner, a start date, an end date, and at least one metric. You can also provide additional query parameters, such as dimensions, filters, and sorting instructions.
Retrieves a YouTube Analytics report. Each API request uses query parameters to specify a channel ID or content owner, a start date, an end date, and at least one metric. You can also provide additional query parameters, such as dimensions, filters, or sorting instructions.
Metricsare individual measurements of user activity, such as video views or ratings (likes and dislikes).
Dimensionsare common criteria that are used to aggregate data, such as the date on which the user activity occurred or the country where the users were located. In a report, each row of data has a unique combination of dimension values.
Filtersare dimension values that specify the data that will be retrieved.
For example, you could retrieve data for a specific country, a specific video, or a group of videos.
Agroupresource represents a YouTube Analytics group, which is a custom collection of up to 500 channels, videos, playlists, or assets.
All of the items in a group must represent the same type of resource. For example, you cannot create a group that contains 100 videos and 100 playlists.
An Analytics group can only contain resources that you have uploaded or claimed or that are linked to a channel that you administer. As a result, channel owners can create groups of videos and playlists. Content owners can create groups of videos, playlists, channels, or assets.
Returns a list of groups that match the API request parameters. For example, you can retrieve all groups that the authenticated user owns, or you can retrieve one or more groups by their unique IDs.
Modifies the metadata for a group. Currently, the only property that can be updated is the group's title. (Use thegroupItems.insertandgroupItems.deleteto add and remove group items.)
[[["Easy to understand","easyToUnderstand","thumb-up"],["Solved my problem","solvedMyProblem","thumb-up"],["Other","otherUp","thumb-up"]],[["Missing the information I need","missingTheInformationINeed","thumb-down"],["Too complicated / too many steps","tooComplicatedTooManySteps","thumb-down"],["Out of date","outOfDate","thumb-down"],["Samples / code issue","samplesCodeIssue","thumb-down"],["Other","otherDown","thumb-down"]],["Last updated 2025-08-28 UTC."],[[["\u003cp\u003eThe YouTube Analytics API allows retrieval of YouTube Analytics data for channels or content owners, supporting real-time queries to generate reports.\u003c/p\u003e\n"],["\u003cp\u003eThe API offers report retrieval via the \u003ccode\u003ereports.query\u003c/code\u003e method, allowing specification of metrics, dimensions, filters, and sorting instructions, all defined by request parameters.\u003c/p\u003e\n"],["\u003cp\u003eYouTube Analytics groups are customizable collections of up to 500 channels, videos, playlists, or assets, which help in aggregating data for performance analysis and are manageable through the API.\u003c/p\u003e\n"],["\u003cp\u003eAuthorization for API requests requires OAuth 2.0 and uses specific scopes, such as \u003ccode\u003eyt-analytics.readonly\u003c/code\u003e for viewing user activity metrics and \u003ccode\u003eyt-analytics-monetary.readonly\u003c/code\u003e for viewing financial reports.\u003c/p\u003e\n"],["\u003cp\u003eThe API provides methods to manage YouTube Analytics groups including creating, listing, updating, and deleting groups and their items, with channels, videos, playlists, and assets being the acceptable components.\u003c/p\u003e\n"]]],["The YouTube Analytics API allows retrieval of YouTube Analytics data via the `reports.query` method, specifying parameters like channel/owner ID, date range, and metrics. It also manages custom groups of up to 500 channels, videos, playlists, or assets. Group management includes creating, listing, updating, and deleting groups and items using `groups` and `groupItems` methods. Authorization uses OAuth 2.0 with specific scopes for viewing and managing reports, revenue data, and account or content.\n"],null,[]]
