This page shows sample YouTube Analytics API requests. Each example briefly describes the report being retrieved and then shows the corresponding `dimensions`, `metrics`, `filters`, and `sort` parameter values. (The [channel reports](https://developers.google.com/youtube/analytics/channel_reports) and [content owner reports](https://developers.google.com/youtube/analytics/content_owner_reports) documents identify the reports that the API supports.)

Each example links to and populates the Google APIs Explorer with the values shown. The examples also use default start and end dates (`YYYY-MM-DD`) of `2023-09-01` and `2024-03-31`.

After linking to the APIs Explorer, you must still specify the channel or content owner for which you are retrieving reports. The APIs Explorer will populate the `ids` parameter value with either `channel==MINE` or `contentOwner==CONTENT_OWNER_ID`, depending on the query that you have clicked. For channel reports, you could change `MINE` to the authenticated user's channel ID. For content owner reports, you need to replace `CONTENT_OWNER_ID` with your content owner ID.

You also have to be authenticated as the specified channel or content owner so that the APIs Explorer can authorize your API requests using OAuth 2.0.

1. [Sorting requests by multiple dimensions/metrics](https://developers.google.com/youtube/analytics/sample-requests#Multisort)
2. [Channel reports](https://developers.google.com/youtube/analytics/sample-requests#Channel_Reports)
3. [Content owner reports](https://developers.google.com/youtube/analytics/sample-requests#Content_Owner_Reports)

## Sorting requests by multiple dimensions/metrics

The API supports the ability to sort response data using multiple dimensions or metrics. For example, the request below retrieves daily traffic source data for a particular channel's videos. Each row in the result set identifies the number of views and the estimated watch time that originated from a particular type of traffic source (e.g. `EXT_URL`) on a particular day.

    https://developers.google.com/apis-explorer/#p/youtubeAnalytics/v2/youtubeAnalytics.reports.query?metrics=views%252CestimatedMinutesWatched&dimensions=day%252CinsightTrafficSourceType&sort=day%252C-views&startDate=2023-09-01&endDate=2024-03-31&&ids=channel%253D%253DMINE

In the response, results are sorted chronologically. Within the set of results for each day, results are sorted in descending order by view count. So, the first row in the result set contains data for the traffic source that generated the most views on the first day in the requested date range. The second row contains data for the traffic source that generated the next highest number of views on the first day.

## Channel reports

Basic stats

### Video reports

#### Total view counts, estimated watch time, and more for a channel

This query retrieves aggregated metrics for the channel's content. The report returns a single row of data that contains totals for each requested metric during the specified date range.

    https://developers.google.com/apis-explorer/#p/youtubeAnalytics/v2/youtubeAnalytics.reports.query?metrics=views%252Ccomments%252Clikes%252Cdislikes%252CestimatedMinutesWatched%252CaverageViewDuration&startDate=2023-09-01&endDate=2024-03-31&&ids=channel%253D%253DMINE

#### Country-specific view counts (and more) for a channel

This query retrieves metrics for a specific country for a channel's videos. The report returns a single row of data that contains totals for each requested metric during the specified date range.

    https://developers.google.com/apis-explorer/#p/youtubeAnalytics/v2/youtubeAnalytics.reports.query?metrics=views%252Ccomments%252Clikes%252Cdislikes%252CestimatedMinutesWatched&filters=country%253D%253DUS&startDate=2023-09-01&endDate=2024-03-31&&ids=channel%253D%253DMINE

#### Top 10 -- Most watched videos for a channel

This query retrieves a channel's 10 most watched videos, as measured by estimated minutes watched during the specified date range. Results are sorted by estimated minutes watched in descending order.

**Note:** This report requires you to specify a value for the `sort` request parameter and to set the `maxResults` parameter to an integer value of `10` or less.

    https://developers.google.com/apis-explorer/#p/youtubeAnalytics/v2/youtubeAnalytics.reports.query?metrics=estimatedMinutesWatched%252Cviews%252Clikes%252CsubscribersGained&dimensions=video&maxResults=10&sort=-estimatedMinutesWatched&startDate=2023-09-01&endDate=2024-03-31&&ids=channel%253D%253DMINE

#### Top 10 -- Annotation click-through rates for a channel's most viewed videos

This request retrieves view counts, annotation click-through rates, annotation close rates, and annotation impressions for the channel's 10 most viewed videos. Results are sorted by view count in descending order, which means that the most viewed video will be listed first.

**Note:** This report requires you to specify a value for the `sort` request parameter and to set the `maxResults` parameter to an integer value of `10` or less.

    https://developers.google.com/apis-explorer/#p/youtubeAnalytics/v2/youtubeAnalytics.reports.query?metrics=views%252Clikes%252CannotationClickThroughRate%252CannotationCloseRate%252CannotationImpressions&dimensions=video&maxResults=10&sort=-views&startDate=2023-09-01&endDate=2024-03-31&&ids=channel%253D%253DMINE

### Playlist reports

#### Total playlist views for a channel

This request retrieves total playlist starts, estimated minutes watched, views (an
[aggregated video metric](https://developers.google.com/youtube/analytics/channel_reports#aggregated-video-metrics)),
playlist views (an [in-playlist](https://developers.google.com/youtube/analytics/channel_reports#in-playlist-metrics) metric),
and views per playlist start for playlists in the authenticated user's channel.

    https://developers.google.com/apis-explorer/#p/youtubeAnalytics/v2/youtubeAnalytics.reports.query?metrics=views%252CestimatedMinutesWatched%252CplaylistStarts%252CplaylistViews%252CviewsPerPlaylistStart&filters&startDate=2023-09-01&endDate=2024-03-31&&ids=channel%253D%253DMINE

#### Statistics for a specific playlist

This request retrieves total playlist starts, estimated minutes watched, views (an
[aggregated video metric](https://developers.google.com/youtube/analytics/channel_reports#aggregated-video-metrics)),
playlist views (an [in-playlist](https://developers.google.com/youtube/analytics/channel_reports#in-playlist-metrics) metric),
and views per playlist start for a specific playlist. Note that to run this query in the APIs
Explorer, you must replace the string `PLAYLIST_ID` in the `filters`
parameter value with the playlist ID for a playlist in the authenticated user's channel.

    https://developers.google.com/apis-explorer/#p/youtubeAnalytics/v2/youtubeAnalytics.reports.query?metrics=views%252CestimatedMinutesWatched%252CplaylistStarts%252CplaylistViews%252CviewsPerPlaylistStart&filters=playlist%253D%253DPLAYLIST_ID&startDate=2023-09-01&endDate=2024-03-31&&ids=channel%253D%253DMINE

To retrieve aggregate statistics for multiple playlists, you can also replace the string `PLAYLIST_ID` with a comma-separated list of up to 500 playlists IDs for playlists in the authenticated user's channel.

#### Top 10 -- Most watched playlists for a channel

This query retrieves a channel's 10 most watched playlists, as measured by playlist views
during the specified date range. It also retrieves several other playlist metrics,
such as the number of times that viewers initiated playback of each playlist and the average
amount of time that a viewer watched videos in the playlist after it was started. Results are
sorted by playlist views in descending order.

**Note:** Since this report uses the `https://developers.google.com/youtube/analytics/dimensions#playlist` dimension, you must specify a value for the `sort` request parameter and also set the `maxResults` parameter to an integer value of `10` or less.

    https://developers.google.com/apis-explorer/#p/youtubeAnalytics/v2/youtubeAnalytics.reports.query?metrics=views%252CestimatedMinutesWatched%252CplaylistStarts%252CaverageTimeInPlaylist&dimensions=playlist&filtersmaxResults=10&sort=-estimatedMinutesWatched&startDate=2023-09-01&endDate=2024-03-31&&ids=channel%253D%253DMINE

Time-based

### Video reports

#### Daily watch time metrics for a channel's videos

This query retrieves daily view counts, watch time metrics, and new subscriber counts for a channel's videos. The report returns one row of data for each day in the requested date range. Rows are sorted in chronological order.

    https://developers.google.com/apis-explorer/#p/youtubeAnalytics/v2/youtubeAnalytics.reports.query?metrics=views%252CestimatedMinutesWatched%252CaverageViewDuration%252CaverageViewPercentage%252CsubscribersGained&dimensions=day&sort=day&startDate=2023-09-01&endDate=2024-03-31&&ids=channel%253D%253DMINE

#### Daily annotation metrics for a channel's videos

This request retrieves daily view counts, annotation click-through rates, annotation close rates, and annotation impressions for the channel's content. Results are sorted in chronological order.

    https://developers.google.com/apis-explorer/#p/youtubeAnalytics/v2/youtubeAnalytics.reports.query?metrics=views%252CannotationClickThroughRate%252CannotationCloseRate%252CannotationImpressions&dimensions=day&sort=day&startDate=2023-09-01&endDate=2024-03-31&&ids=channel%253D%253DMINE

### Playlist reports

#### Daily playlist views for a channel

This request retrieves daily view counts (an
[aggregated video metric](https://developers.google.com/youtube/analytics/channel_reports#aggregated-video-metrics)),
playlist views (an [in-playlist](https://developers.google.com/youtube/analytics/channel_reports#in-playlist-metrics) metric),
playlist starts, estimated minutes watched, and views per playlist start for the authenticated
user's channel. Results are sorted in chronological order.

    https://developers.google.com/apis-explorer/#p/youtubeAnalytics/v2/youtubeAnalytics.reports.query?metrics=views%252CestimatedMinutesWatched%252CplaylistStarts%252CplaylistViews%252CviewsPerPlaylistStart&dimensions=day&sort=day&startDate=2023-09-01&endDate=2024-03-31&&ids=channel%253D%253DMINE

Geographic

### Video reports

#### Country-specific watch time metrics for a channel's videos

This query retrieves country-specific view counts, watch time metrics, and subscription figures for a channel's videos. The report returns one row of data for each country where the channel's videos were watched. Rows are sorted in descending order of number of minutes watched.

    https://developers.google.com/apis-explorer/#p/youtubeAnalytics/v2/youtubeAnalytics.reports.query?metrics=views%252CestimatedMinutesWatched%252CaverageViewDuration%252CaverageViewPercentage%252CsubscribersGained&dimensions=country&sort=-estimatedMinutesWatched&startDate=2023-09-01&endDate=2024-03-31&&ids=channel%253D%253DMINE

#### Country-specific annotation metrics for a channel's videos

This request retrieves country-specific view counts, annotation click-through rates, annotation close rates, and annotation impressions for the channel's videos. Results are sorted by annotation click-through rate in descending order, which means that the country with the highest annotation click-through rate will be listed first.

    https://developers.google.com/apis-explorer/#p/youtubeAnalytics/v2/youtubeAnalytics.reports.query?metrics=views%252CannotationClickThroughRate%252CannotationCloseRate%252CannotationImpressions&dimensions=country&sort=-annotationClickThroughRate&startDate=2023-09-01&endDate=2024-03-31&&ids=channel%253D%253DMINE

#### Province-specific metrics for U.S. states and Washington D.C.

This request retrieves a province-by-province breakdown of view counts, estimated minutes watched, and average view duration for the channel's videos. The data covers U.S. states and Washington D.C. Results are sorted alphabetically by provinces' ISO 3166-2 codes.

    https://developers.google.com/apis-explorer/#p/youtubeAnalytics/v2/youtubeAnalytics.reports.query?metrics=views%252CestimatedMinutesWatched%252CaverageViewDuration&dimensions=province&filters=country==US&sort=province&startDate=2023-09-01&endDate=2024-03-31&&ids=channel%253D%253DMINE

#### Top 10 -- Most viewed videos in a specific country

This query retrieves the channel's 10 most viewed videos, as measured by number of views during the specified date range, in a specified country. Results are sorted by view count in descending order.

**Note:** This report requires you to specify a value for the `sort` request parameter and to set the `maxResults` parameter to an integer value of `10` or less.

    https://developers.google.com/apis-explorer/#p/youtubeAnalytics/v2/youtubeAnalytics.reports.query?metrics=views%252CestimatedMinutesWatched%252Clikes%252CsubscribersGained&dimensions=video&maxResults=10&filters=country%253D%253DUS&sort=-views&startDate=2023-09-01&endDate=2024-03-31&&ids=channel%253D%253DMINE

#### Top 10 U.S. cities by total views

This query retrieves a list of the 10 U.S. cities that accounted for the most views of the channel's content during the specified date range. The query could be modified to request data for another [country](https://developers.google.com/youtube/analytics/v1/dimsmets/dims#country) by choosing another valid value for that filter. Similarly, the query could be modified to retrieve data for a subcontinent, such as Western Europe or Southeastern Asia, by using the [subContinent](https://developers.google.com/youtube/analytics/v1/dimsmets/dims#subContinent) filter and one of its valid values. Other filters are supported, too. Results are sorted by view count in descending order.

        https://developers.google.com/apis-explorer/#p/youtubeAnalytics/v2/youtubeAnalytics.reports.query?metrics=views&dimensions=city&maxResults=10&filters=country%253D%253DUS&sort=-views&startDate=2023-09-01&endDate=2024-03-31&&ids=channel%253D%253DMINE

#### Top 10 U.S. cities by total views for each content type

This query retrieves a list of the 10 U.S. cities that accounted for the most views of the channel's content during the specified date range for each supported [creatorContentType](https://developers.google.com/youtube/analytics/v1/dimsmets/dims#creatorContentType). Results are sorted by view count in descending order.

        https://developers.google.com/apis-explorer/#p/youtubeAnalytics/v2/youtubeAnalytics.reports.query?metrics=views&dimensions=city%252CcreatorContentType&maxResults=10&filters=country%253D%253DUS&sort=-views&startDate=2023-09-01&endDate=2024-03-31&&ids=channel%253D%253DMINE

#### Top 10 U.S. cities by total watch time

This query retrieves a list of the top 10 days during the specified date range when any U.S. city accounted for the greatest total daily watch time of the channel's content. The query results identify the total watch time, the date on which the watch time occurred, and the city where the content was estimated to have been viewed. Results are sorted in descending order of total watch time.

        https://developers.google.com/apis-explorer/#p/youtubeAnalytics/v2/youtubeAnalytics.reports.query?metrics=estimatedWatchTime&dimensions=city%252Cday&maxResults=10&filters=country%253D%253DUS&sort=-estimatedWatchTime&startDate=2023-09-01&endDate=2024-03-31&&ids=channel%253D%253DMINE

#### Top 10 -- Most viewed videos in Europe

This query retrieves the channel's 10 most viewed videos in Europe, as measured by number of views during the specified date range. The query could be modified to request data for another [continent](https://developers.google.com/youtube/analytics/v1/dimsmets/dims#continent) by choosing another valid value for that filter. Similarly, the query could be modified to retrieve data for a subcontinent, such as Western Europe or Southeastern Asia, by using the [subContinent](https://developers.google.com/youtube/analytics/v1/dimsmets/dims#subContinent) filter and one of its valid values. Results are sorted by view count in descending order.

**Note:** This report requires you to specify a value for the `sort` request parameter and to set the `maxResults` parameter to an integer value of `10` or less.

    https://developers.google.com/apis-explorer/#p/youtubeAnalytics/v2/youtubeAnalytics.reports.query?metrics=views%252CestimatedMinutesWatched%252Clikes%252CsubscribersGained&dimensions=video&maxResults=10&filters=continent%253D%253D150&sort=-views&startDate=2023-09-01&endDate=2024-03-31&&ids=channel%253D%253DMINE

### Playlist reports

#### Country-specific watch time metrics for a channel's playlists

This query retrieves country-specific view counts (an
[aggregated video metric](https://developers.google.com/youtube/analytics/channel_reports#aggregated-video-metrics)),
playlist views (an [in-playlist](https://developers.google.com/youtube/analytics/channel_reports#in-playlist-metrics) metric),
and watch time metrics for a channel's playlists. The report returns one row of data for each
country where the channel's playlists were watched. Rows are sorted in descending order of number of minutes watched.

    https://developers.google.com/apis-explorer/#p/youtubeAnalytics/v2/youtubeAnalytics.reports.query?metrics=views%252CestimatedMinutesWatched%252CaverageTimeInPlaylist%252CplaylistStarts%252CplaylistViews&dimensions=country&sort=-estimatedMinutesWatched&startDate=2023-09-01&endDate=2024-03-31&&ids=channel%253D%253DMINE

#### Top 10 -- Most started playlists in the United States

This query retrieves the 10 playlists that viewers in the United States started watching most frequently during the specified date range. Results are sorted by number of playlist starts in descending order.

**Note:** Since this report uses the `https://developers.google.com/youtube/analytics/dimensions#playlist` dimension, you must specify a value for the `sort` request parameter and also set the `maxResults` parameter to an integer value of `10` or less.

    https://developers.google.com/apis-explorer/#p/youtubeAnalytics/v2/youtubeAnalytics.reports.query?metrics=playlistStarts%252Cviews%252CestimatedMinutesWatched%252CaverageViewDuration&dimensions=playlist&filters=country%253D%253DUS&maxResults=10&sort=-playlistStarts&startDate=2023-09-01&endDate=2024-03-31&&ids=channel%253D%253DMINE

Playback location

### Video reports

#### Viewcounts and watch time from different playback locations

This query retrieves the number of views and estimated watch time for a particular channel's videos. Results are aggregated based on the type of page or application where video playbacks occurred, and results are sorted in descending order by view count.

    https://developers.google.com/apis-explorer/#p/youtubeAnalytics/v2/youtubeAnalytics.reports.query?metrics=estimatedMinutesWatched%252Cviews&dimensions=insightPlaybackLocationType&sort=-views&startDate=2023-09-01&endDate=2024-03-31&&ids=channel%253D%253DMINE

#### Daily view counts and watch time from different playback locations

This query retrieves daily view counts and estimated watch time in the United States for a particular channel's videos. Results are grouped by day for each type of page or application where video playbacks occurred. Results are sorted in chronological order.

    https://developers.google.com/apis-explorer/#p/youtubeAnalytics/v2/youtubeAnalytics.reports.query?metrics=estimatedMinutesWatched%252Cviews&dimensions=day%252CinsightPlaybackLocationType&filters=country%253D%253DUS&sort=day&startDate=2023-09-01&endDate=2024-03-31&&ids=channel%253D%253DMINE

#### Top 10 -- Third-party sites that generate the most views for an embedded video

This query retrieves view counts and estimated watch time for a particular video or group of videos. Results are grouped by the third-party site where the video was embedded. Results are sorted in descending order by view count. Note that to run this query in the APIs Explorer, you must replace the string `VIDEO_ID` in the `filters` parameter value with a comma-separated list of one or more video IDs for your uploaded videos.

    https://developers.google.com/apis-explorer/#p/youtubeAnalytics/v2/youtubeAnalytics.reports.query?metrics=views%252CestimatedMinutesWatched&dimensions=insightPlaybackLocationDetail&filters=video%253D%253DVIDEO_ID%253BinsightPlaybackLocationType%253D%253DEMBEDDED&maxResults=10&sort=-views&startDate=2023-09-01&endDate=2024-03-31&&ids=channel%253D%253DMINE

### Playlist reports

#### Playlist view counts and watch time from different playback locations

This query retrieves the number of view counts (an
[aggregated video metric](https://developers.google.com/youtube/analytics/channel_reports#aggregated-video-metrics)),
playlist views (an [in-playlist](https://developers.google.com/youtube/analytics/channel_reports#in-playlist-metrics) metric),
estimated watch time, and playlist starts for a particular channel's playlists. Results are
aggregated based on the type of page or application where video playbacks occurred, and
results are sorted in descending order by playlist starts.

    https://developers.google.com/apis-explorer/#p/youtubeAnalytics/v2/youtubeAnalytics.reports.query?metrics=views%252CestimatedMinutesWatched%252CplaylistStarts%252CplaylistViews&dimensions=insightPlaybackLocationType&sort=-views&startDate=2023-09-01&endDate=2024-03-31&&ids=channel%253D%253DMINE

#### Daily playlist view counts and watch time from different playback locations

This query retrieves daily playlist starts, view counts (an
[aggregated video metric](https://developers.google.com/youtube/analytics/channel_reports#aggregated-video-metrics)),
playlist views (an [in-playlist](https://developers.google.com/youtube/analytics/channel_reports#in-playlist-metrics) metric),
and estimated watch time in the United States for a particular channel's playlists. Results
are grouped by day for each type of page or application where playlist views occurred. Results
are sorted in chronological order.

    https://developers.google.com/apis-explorer/#p/youtubeAnalytics/v2/youtubeAnalytics.reports.query?metrics=views%252CestimatedMinutesWatched%252playlistStarts%252CCplaylistViews&dimensions=day%252CinsightPlaybackLocationType&filters=country%253D%253DUS&sort=day&startDate=2023-09-01&endDate=2024-03-31&&ids=channel%253D%253DMINE

Playback details

### Video reports

#### Likes and dislikes by content type

This query retrieves the number of likes and dislikes for each type of content on a channel.

    https://developers.google.com/apis-explorer/#p/youtubeAnalytics/v2/youtubeAnalytics.reports.query?metrics=likes%dislikes&dimensions=creatorContentType&startDate=2023-09-01&endDate=2024-03-31&&ids=contentOwner%253D%253DCONTENT_OWNER_ID

Traffic source

### Video reports

#### Viewcounts and watch time from different traffic sources in a country

This request retrieves the number of views and estimated watch time for the channel's videos in a specified country. The metrics are aggregated by traffic source, which describes the manner in which users reached the video.

    https://developers.google.com/apis-explorer/#p/youtubeAnalytics/v2/youtubeAnalytics.reports.query?metrics=views%252CestimatedMinutesWatched&dimensions=insightTrafficSourceType&filters=country%253D%253DUS&startDate=2023-09-01&endDate=2024-03-31&&ids=channel%253D%253DMINE

#### Daily view counts and watch time from different traffic sources

This request retrieves daily view counts and daily estimated watch time for the channel's videos. The metrics are aggregated on a daily basis by traffic source and sorted in chronological order.

    https://developers.google.com/apis-explorer/#p/youtubeAnalytics/v2/youtubeAnalytics.reports.query?metrics=views%252CestimatedMinutesWatched&dimensions=day%252CinsightTrafficSourceType&sort=day&startDate=2023-09-01&endDate=2024-03-31&&ids=channel%253D%253DMINE

#### Top 10 -- YouTube search terms that generate the most traffic for a video

This query retrieves the 10 search terms that generated the most views from YouTube search results for one or more specific videos. Results are sorted by view count in descending order. Note that to run this query in the APIs Explorer, you must replace the string `VIDEO_ID` in the `filters` parameter value with a comma-separated list of up to 500 video IDs.

For example, you could run the query for a single video or replace `VIDEO_ID` to identify the search terms that generate the most traffic for that video. You could also list all of the videos in a particular playlist to determine which search terms generate the most traffic for any of the videos in that playlist.

    https://developers.google.com/apis-explorer/#p/youtubeAnalytics/v2/youtubeAnalytics.reports.query?metrics=views&dimensions=insightTrafficSourceDetail&filters=video%253D%253DVIDEO_ID%253BinsightTrafficSourceType%253D%253DYT_SEARCH&maxResults=10&sort=-views&startDate=2023-09-01&endDate=2024-03-31&&ids=channel%253D%253DMINE

#### Top 10 -- External websites that generate the most traffic for a video

This query retrieves the 10 external websites that generated the most views for a specific video or group of videos. Results are sorted by estimated watch time in descending order. Note that to run this query in the APIs Explorer, you must replace the string `VIDEO_ID` in the `filters` parameter value with a comma-separated list of up to 500 video IDs for your uploaded videos.

    https://developers.google.com/apis-explorer/#p/youtubeAnalytics/v2/youtubeAnalytics.reports.query?metrics=estimatedMinutesWatched%252Cviews&dimensions=insightTrafficSourceDetail&filters=video%253D%253DVIDEO_ID%253BinsightTrafficSourceType%253D%253DEXT_URL&maxResults=25&sort=-estimatedMinutesWatched&startDate=2023-09-01&endDate=2024-03-31&&ids=channel%253D%253DMINE

### Playlist reports

#### Playlist view counts and watch time from different traffic sources in a country

This request retrieves the number of views (an
[aggregated video metric](https://developers.google.com/youtube/analytics/channel_reports#aggregated-video-metrics)),
playlist views (an [in-playlist](https://developers.google.com/youtube/analytics/channel_reports#in-playlist-metrics) metric),
playlist starts, and estimated watch time for playlist views in a specified country. The
metrics are aggregated by traffic source, which describes the manner in which users reached the playlist.

    https://developers.google.com/apis-explorer/#p/youtubeAnalytics/v2/youtubeAnalytics.reports.query?metrics=views%252CestimatedMinutesWatched%252CplaylistStarts%252CplaylistViews&dimensions=insightTrafficSourceType&filters=country%253D%253DUS&startDate=2023-09-01&endDate=2024-03-31&&ids=channel%253D%253DMINE

#### Daily playlist view counts and watch time from different traffic sources

This request retrieves a channel's daily playlist views (an
[in-playlist](https://developers.google.com/youtube/analytics/channel_reports#in-playlist-metrics) metric),
playlist starts, and estimated watch time. It also retrieves total views (an
[aggregated video metric](https://developers.google.com/youtube/analytics/channel_reports#aggregated-video-metrics)).
The metrics are aggregated on a daily basis by traffic source and sorted in chronological order.

    https://developers.google.com/apis-explorer/#p/youtubeAnalytics/v2/youtubeAnalytics.reports.query?metrics=views%252CestimatedMinutesWatched%252CplaylistStarts%252CplaylistViews&dimensions=day%252CinsightTrafficSourceType&sort=day&startDate=2023-09-01&endDate=2024-03-31&&ids=channel%253D%253DMINE

Device/OS

### Video reports

#### Daily device type metrics for the Android operating system

This query retrieves daily view counts and estimated watch time on Android devices for a particular channel's videos. Results are grouped by day for each type of device where video playbacks occurred. Results are sorted in chronological order.

    https://developers.google.com/apis-explorer/#p/youtubeAnalytics/v2/youtubeAnalytics.reports.query?metrics=estimatedMinutesWatched%252Cviews&dimensions=day%252CdeviceType&filters=operatingSystem%253D%253DANDROID&sort=day&startDate=2023-09-01&endDate=2024-03-31&&ids=channel%253D%253DMINE

#### Daily operating system metrics for mobile devices

This query retrieves daily view counts and estimated watch time on mobile devices for a particular channel's videos. Results are grouped by day for each operating system on which video playbacks occurred. Results are sorted in chronological order.

    https://developers.google.com/apis-explorer/#p/youtubeAnalytics/v2/youtubeAnalytics.reports.query?metrics=estimatedMinutesWatched%252Cviews&dimensions=day%252CoperatingSystem&filters=deviceType%253D%253DMOBILE&sort=day&startDate=2023-09-01&endDate=2024-03-31&&ids=channel%253D%253DMINE

#### Daily operating system and device type metrics

This query retrieves daily view counts and estimated watch time for a channel. Statistics are grouped by operating system and device type. Results are sorted in chronological order.

    https://developers.google.com/apis-explorer/#p/youtubeAnalytics/v2/youtubeAnalytics.reports.query?metrics=estimatedMinutesWatched%252Cviews&dimensions=day%252CoperatingSystem%252CdeviceType&sort=day&startDate=2023-09-01&endDate=2024-03-31&&ids=channel%253D%253DMINE

### Playlist reports

#### Daily device type metrics for playlist views on the Android operating system

This query retrieves daily views (an
[aggregated video metric](https://developers.google.com/youtube/analytics/channel_reports#aggregated-video-metrics)),
playlist views (an [in-playlist](https://developers.google.com/youtube/analytics/channel_reports#in-playlist-metrics) metric),
and estimated watch time on Android devices for a particular channel's playlists. Results are
grouped by day for each type of device where playlist views occurred. Results are sorted in chronological order.

    https://developers.google.com/apis-explorer/#p/youtubeAnalytics/v2/youtubeAnalytics.reports.query?metrics=views%252CestimatedMinutesWatched%252CplaylistViews&dimensions=day%252CdeviceType&filters=operatingSystem%253D%253DANDROID&sort=day&startDate=2023-09-01&endDate=2024-03-31&&ids=channel%253D%253DMINE

#### Daily operating system metrics for playlist views on mobile devices

This query retrieves daily views (an
[aggregated video metric](https://developers.google.com/youtube/analytics/channel_reports#aggregated-video-metrics)),
playlist views (an [in-playlist](https://developers.google.com/youtube/analytics/channel_reports#in-playlist-metrics) metric),
and estimated watch time on mobile devices for a particular channel's playlists. Results are
grouped by day for each operating system on which playlist views occurred. Results are sorted in chronological order.

    https://developers.google.com/apis-explorer/#p/youtubeAnalytics/v2/youtubeAnalytics.reports.query?metrics=views%252CestimatedMinutesWatched%252CplaylistViews&dimensions=day%252CoperatingSystem&filters=deviceType%253D%253DMOBILE&sort=day&startDate=2023-09-01&endDate=2024-03-31&&ids=channel%253D%253DMINE

Demographic

### Video reports

#### Viewer demographics in California (age group and gender)

This report retrieves statistics about the age group and gender of viewers in California who watched the channel's videos. Results are sorted by gender and then by age group. This query could be modified to retrieve the same statistics for all viewers worldwide or all viewers in a country, continent, subcontinent, or another U.S. state by adjusting the `filters` parameter value.

    https://developers.google.com/apis-explorer/#p/youtubeAnalytics/v2/youtubeAnalytics.reports.query?metrics=viewerPercentage&dimensions=ageGroup%252Cgender&filters=province%253D%253DUS-CA&sort=gender%252CageGroup&startDate=2023-09-01&endDate=2024-03-31&&ids=channel%253D%253DMINE

### Playlist reports

#### Playlist viewer demographics in California (age group and gender)

This report retrieves statistics about the age group and gender of viewers in California who
watched the channel's playlists. Results are sorted by gender and then by age group. This
query could be modified to retrieve the same statistics for all viewers worldwide or all
viewers in a country, continent, subcontinent, or another U.S. state by adjusting the `filters` parameter value.

    https://developers.google.com/apis-explorer/#p/youtubeAnalytics/v2/youtubeAnalytics.reports.query?metrics=viewerPercentage&dimensions=ageGroup%252Cgender&filters=province%253D%253DUS-CA&sort=gender%252CageGroup&startDate=2023-09-01&endDate=2024-03-31&&ids=channel%253D%253DMINE

Social

#### Sharing metrics, aggregated by service where videos were shared

This request retrieves the number of times that users used the `Share` button to share a channel's videos. Results are aggregated by sharing service (Google+, Twitter, etc.) and sorted in descending order of number of shares.

    https://developers.google.com/apis-explorer/#p/youtubeAnalytics/v2/youtubeAnalytics.reports.query?metrics=shares&dimensions=sharingService&sort=-shares&startDate=2023-09-01&endDate=2024-03-31&&ids=channel%253D%253DMINE

Audience retention

#### Audience retention metrics for a video

This report measures a video's ability to retain its audience. The report can only be retrieved for a single video at a time. Note that to run this query in the APIs Explorer, you must replace the string `VIDEO_ID` in the `filters` parameter value with the video ID for one of your uploaded videos. Note that audience retention reports do not support the ability to specify multiple values for the `video` filter.

In this example, the report uses the `https://developers.google.com/youtube/analytics/dimensions#audienceType` filter to restrict the response so that it only contains data for organic views, which are the result of a direct user action, such as a search for a video or a click on a suggested video. As such, the report does not include data for views from TrueView in-stream or TrueView in-display ads. You can remove the filter to retrieve the video's audience retention data from all audience types.

Note that data for the `audienceType` filter is available as of September 25, 2013. The API will not return data for queries that use the filter to try to retrieve data from earlier dates. Queries that do not use the filter work for any date after July 1, 2008.

    https://developers.google.com/apis-explorer/#p/youtubeAnalytics/v2/youtubeAnalytics.reports.query?metrics=audienceWatchRatio%252CrelativeRetentionPerformance&dimensions=elapsedVideoTimeRatio&filters=video%253D%253DVIDEO_ID%253BaudienceType%253D%253DORGANIC&startDate=2023-09-01&endDate=2024-03-31&&ids=channel%253D%253DMINE

Revenue/Ads

#### Channel revenue and ad performance metrics

This request retrieves a channel's revenue and ad performance metrics. The report returns a single row of data that contains totals for each requested metric during the specified date range.

    https://developers.google.com/apis-explorer/#p/youtubeAnalytics/v2/youtubeAnalytics.reports.query?metrics=views%252CestimatedRevenue%252CestimatedAdRevenue%252CestimatedRedPartnerRevenue%252CgrossRevenue%252CadImpressions%252Ccpm%252CplaybackBasedCpm%252CmonetizedPlaybacks&startDate=2023-09-01&endDate=2024-03-31&&ids=channel%253D%253DMINE

#### Daily revenue and ad performance metrics

This request retrieves a channel's daily revenue and ad performance metrics.

    https://developers.google.com/apis-explorer/#p/youtubeAnalytics/v2/youtubeAnalytics.reports.query?metrics=views%252CestimatedRevenue%252CestimatedAdRevenue%252CestimatedRedPartnerRevenue%252CgrossRevenue%252CadImpressions%252Ccpm%252CplaybackBasedCpm%252CmonetizedPlaybacks&dimensions=day&startDate=2023-09-01&endDate=2024-03-31&&ids=channel%253D%253DMINE

#### Country-specific revenue and ad performance metrics

This request retrieves a channel's country-specific revenue and ad performance metrics. Results are sorted in descending order by revenue amount, which means that the first country listed will be the one where the partner had the greatest net revenue.

    https://developers.google.com/apis-explorer/#p/youtubeAnalytics/v2/youtubeAnalytics.reports.query?metrics=views%252CestimatedRevenue%252CestimatedAdRevenue%252CestimatedRedPartnerRevenue%252CgrossRevenue%252CadImpressions%252Ccpm%252CplaybackBasedCpm%252CmonetizedPlaybacks&dimensions=country&sort=-estimatedRevenue&startDate=2023-09-01&endDate=2024-03-31&&ids=channel%253D%253DMINE

#### Top 10 -- Videos with the highest revenue

This request retrieves revenue and ad performance metrics for the channel's 10 videos with the greatest revenue. Results are sorted in descending order by revenue amount, which means that the first video will be the one that had the highest estimated revenue.

    https://developers.google.com/apis-explorer/#p/youtubeAnalytics/v2/youtubeAnalytics.reports.query?metrics=views%252CestimatedRevenue%252CestimatedAdRevenue%252CestimatedRedPartnerRevenue%252CgrossRevenue%252CadImpressions%252Ccpm%252CplaybackBasedCpm%252CmonetizedPlaybacks&dimensions=video&maxResults=10&sort=-estimatedRevenue&startDate=2023-09-01&endDate=2024-03-31&&ids=channel%253D%253DMINE

#### Ad performance metrics for different ad types

This request retrieves ad performance metrics for the content owner's claimed content. Results are grouped by ad type, which enables you to compare revenue and CPM values across different ad types.

    https://developers.google.com/apis-explorer/#p/youtubeAnalytics/v2/youtubeAnalytics.reports.query?metrics=grossRevenue%252CadImpressions%252Ccpm&dimensions=adType&filters=claimedStatus%253D%253Dclaimed&sort=-adType&startDate=2023-09-01&endDate=2024-03-31&&ids=channel%253D%253DMINE

## Content owner reports

Basic stats

### Video reports

#### Total view counts, estimated watch time, and more for all claimed content

This query retrieves aggregated metrics for the content owner's claimed content. The report returns a single row of data that contains totals for each requested metric during the specified date range.

    https://developers.google.com/apis-explorer/#p/youtubeAnalytics/v2/youtubeAnalytics.reports.query?metrics=views%252Ccomments%252Clikes%252Cdislikes%252CestimatedMinutesWatched%252CaverageViewDuration&filters=claimedStatus%253D%253Dclaimed&startDate=2023-09-01&endDate=2024-03-31&&ids=contentOwner%253D%253DCONTENT_OWNER_ID

#### Country-specific view counts (and more) for all self-uploaded videos

This query retrieves metrics for a specific country for videos that the content owner uploaded. The report returns a single row of data that contains totals for each requested metric during the specified date range.

    https://developers.google.com/apis-explorer/#p/youtubeAnalytics/v2/youtubeAnalytics.reports.query?metrics=views%252Ccomments%252Clikes%252Cdislikes%252Cshares&filters=uploaderType%253D%253Dself%253Bcountry%253D%253DFR&startDate=2023-09-01&endDate=2024-03-31&&ids=contentOwner%253D%253DCONTENT_OWNER_ID

#### Total view counts (and more) for all claimed third-party content

This query retrieves aggregated metrics for videos that the content owner claimed but did not upload. The report returns a single row of data that contains totals for each requested metric during the specified date range.

    https://developers.google.com/apis-explorer/#p/youtubeAnalytics/v2/youtubeAnalytics.reports.query?metrics=views%252Ccomments%252Clikes%252Cdislikes%252Cshares&filters=uploaderType%253D%253DthirdParty%253BclaimedStatus%253D%253Dclaimed&startDate=2023-09-01&endDate=2024-03-31&&ids=contentOwner%253D%253DCONTENT_OWNER_ID

#### Total view counts (and more) for all self-uploaded content

This query retrieves aggregated metrics for videos that the content owner uploaded. The report returns a single row of data that contains totals for each requested metric during the specified date range.

    https://developers.google.com/apis-explorer/#p/youtubeAnalytics/v2/youtubeAnalytics.reports.query?metrics=views%252Ccomments%252Clikes%252Cdislikes%252CestimatedMinutesWatched&filters=uploaderType%253D%253Dself&startDate=2023-09-01&endDate=2024-03-31&&ids=contentOwner%253D%253DCONTENT_OWNER_ID

#### Total view counts (and more) for all claimed, self-uploaded content

This query retrieves aggregated metrics for videos that the content owner uploaded and also claimed. The report returns a single row of data that contains totals for each requested metric during the specified date range.

    https://developers.google.com/apis-explorer/#p/youtubeAnalytics/v2/youtubeAnalytics.reports.query?metrics=views%252Ccomments%252Clikes%252Cdislikes%252CestimatedMinutesWatched&filters=uploaderType%253D%253Dself%253BclaimedStatus%253D%253Dclaimed&startDate=2023-09-01&endDate=2024-03-31&&ids=contentOwner%253D%253DCONTENT_OWNER_ID

#### Top 10 -- Most viewed videos for a content owner

This query retrieves the 10 most viewed videos, as measured by number of views during the specified date range, that the content owner uploaded. Results are sorted by view count in descending order.

    https://developers.google.com/apis-explorer/#p/youtubeAnalytics/v2/youtubeAnalytics.reports.query?metrics=views%252CestimatedMinutesWatched%252CestimatedRevenue%252CestimatedAdRevenue%252CmonetizedPlaybacks%252CadImpressions&dimensions=video&filters=uploaderType%253D%253Dself&maxResults=10&sort=-views&startDate=2023-09-01&endDate=2024-03-31&&ids=contentOwner%253D%253DCONTENT_OWNER_ID

#### Top 10 -- Most watched videos for a content owner

This query retrieves the 10 most watched videos, as measured by estimated minutes watched during the specified date range, that the content owner uploaded. Results are sorted by estimated minutes watched in descending order.

    https://developers.google.com/apis-explorer/#p/youtubeAnalytics/v2/youtubeAnalytics.reports.query?metrics=estimatedMinutesWatched%252CaverageViewDuration%252CaverageViewPercentage%252Cviews%252CsubscribersGained&dimensions=video&filters=uploaderType%253D%253Dself&maxResults=10&sort=-estimatedMinutesWatched&startDate=2023-09-01&endDate=2024-03-31&&ids=contentOwner%253D%253DCONTENT_OWNER_ID

#### Top 10 -- Most viewed videos for a content owner's channel

This query retrieves the 10 most viewed videos for a specific channel or group of channels that the content owner manages. Results are sorted by view count in descending order. Note that to run this query in the APIs Explorer, you must replace the string `CHANNEL_ID` in the `filters` parameter value with a comma-separated list of up to 500 channel IDs for your channels.

    https://developers.google.com/apis-explorer/#p/youtubeAnalytics/v2/youtubeAnalytics.reports.query?metrics=views&dimensions=video&filters=channel%253D%253DCHANNEL_ID&maxResults=10&sort=-views&startDate=2023-09-01&endDate=2024-03-31&&ids=contentOwner%253D%253DCONTENT_OWNER_ID

#### Top 10 -- Annotation click-through rates for a channel's most viewed videos

This request retrieves view counts, annotation click-through rates, annotation close rates, and annotation impressions for the 10 most viewed videos in a specified channel or group of channels. Results are sorted by view count in descending order, which means that the most viewed video will be listed first. Note that to run this query in the APIs Explorer, you must replace the string `CHANNEL_ID` in the `filters` parameter value with a comma-separated list of up to 500 channel IDs for your channels.

    https://developers.google.com/apis-explorer/#p/youtubeAnalytics/v2/youtubeAnalytics.reports.query?metrics=views%252Clikes%252CannotationClickThroughRate%252CannotationCloseRate%252CannotationImpressions&dimensions=video&filters=channel%253D%253DCHANNEL_ID&maxResults=10&sort=-views&startDate=2023-09-01&endDate=2024-03-31&&ids=contentOwner%253D%253DCONTENT_OWNER_ID

### Playlist reports

#### Playlist views for a content owner's channels

This request retrieves total playlist starts, playlist estimated minutes watched, playlist
views, and views per playlist start for playlists in the content owner's channels. The
`playlistViews` metric counts only video views that occurred in the context of a
playlist. Since all of the requested metrics are in-playlist metrics, the request does not
also need to include the [playlist](https://developers.google.com/youtube/analytics/v1/dimsmets/dims#playlist) or [group](https://developers.google.com/youtube/analytics/v1/dimsmets/dims#group) filter.

    https://developers.google.com/apis-explorer/#p/youtubeAnalytics/v2/youtubeAnalytics.reports.query?metrics=playlistStarts%252CplaylistEstimatedMinutesWatched%252CplaylistViews%252CviewsPerPlaylistStart&startDate=2023-09-01&endDate=2024-03-31&&ids=contentOwner%253D%253DCONTENT_OWNER_ID

#### Statistics for a specific playlist

This request retrieves total playlist starts, estimated minutes watched, views (an
[aggregated video metric](https://developers.google.com/youtube/analytics/content_owner_reports#aggregated-video-metrics)),
playlist views (an [in-playlist](https://developers.google.com/youtube/analytics/content_owner_reports#in-playlist-metrics) metric),
and views per playlist start for a specific playlist. Note that to run this query in the APIs
Explorer, you must replace the string `PLAYLIST_ID` in the `filters`
parameter value with the playlist ID for a playlist in one of the content owner's channels.

    https://developers.google.com/apis-explorer/#p/youtubeAnalytics/v2/youtubeAnalytics.reports.query?metrics=views%252CestimatedMinutesWatched%252CplaylistStarts%252CplaylistViews%252CviewsPerPlaylistStart&filters=playlist%253D%253DPLAYLIST_ID&startDate=2023-09-01&endDate=2024-03-31&&ids=contentOwner%253D%253DCONTENT_OWNER_ID

To retrieve aggregate statistics for multiple playlists, you can also replace the string `PLAYLIST_ID` with a comma-separated list of up to 500 playlists IDs for playlists in the content owner's channels.
Time-based

### Video reports

#### Daily watch time metrics for self-uploaded content

This query retrieves daily watch time metrics, as well as view counts, monetized playback counts, and impression counts for videos that the content owner uploaded. The report returns one row of data for each day in the requested date range, and rows are sorted in chronological order.

    https://developers.google.com/apis-explorer/#p/youtubeAnalytics/v2/youtubeAnalytics.reports.query?metrics=estimatedMinutesWatched%252CaverageViewPercentage%252Cviews%252CmonetizedPlaybacks%252CadImpressions&dimensions=day&filters=uploaderType%253D%253Dself&sort=day&startDate=2023-09-01&endDate=2024-03-31&&ids=contentOwner%253D%253DCONTENT_OWNER_ID

#### Annotation metrics for claimed content

This request retrieves daily view counts, annotation click-through rates, annotation close rates, and annotation impressions for the content owner's claimed content. Results are sorted in chronological order.

    https://developers.google.com/apis-explorer/#p/youtubeAnalytics/v2/youtubeAnalytics.reports.query?metrics=views%252CannotationClickThroughRate%252CannotationCloseRate%252CannotationImpressions&dimensions=day&filters=claimedStatus%253D%253Dclaimed&sort=day&startDate=2023-09-01&endDate=2024-03-31&&ids=contentOwner%253D%253DCONTENT_OWNER_ID

### Playlist reports

#### Daily playlist views for a content owner

This request retrieves metrics for daily user interactions with videos in the content owner's
playlists. The metrics retrieved in the report are [playlistViews](https://developers.google.com/youtube/analytics/v1/dimsmets/mets#playlistViews), [playlistStarts](https://developers.google.com/youtube/analytics/v1/dimsmets/mets#playlistStarts),
[playlistEstimatedMinutesWatched](https://developers.google.com/youtube/analytics/v1/dimsmets/mets#playlistEstimatedMinutesWatched), and [viewsPerPlaylistStart](https://developers.google.com/youtube/analytics/v1/dimsmets/mets#viewsPerPlaylistStart). All of these metrics
are [in-playlist](https://developers.google.com/youtube/analytics/channel_reports#in-playlist-metrics) metrics.
Since all of the requested metrics are in-playlist metrics, the request does not need to
also include the [playlist](https://developers.google.com/youtube/analytics/v1/dimsmets/dims#playlist) or [group](https://developers.google.com/youtube/analytics/v1/dimsmets/dims#group) filter.

    https://developers.google.com/apis-explorer/#p/youtubeAnalytics/v2/youtubeAnalytics.reports.query?metrics=playlistViews%252CplaylistEstimatedMinutesWatched%252CplaylistStarts%252CviewsPerPlaylistStart&dimensions=day&sort=day&startDate=2023-09-01&endDate=2024-03-31&&ids=contentOwner%253D%253DCONTENT_OWNER_ID

Geographic

### Video reports

#### Country-specific watch time metrics for self-uploaded content

This query retrieves view counts, watch time metrics, and estimated ad revenue for each country. The metrics are for videos that the content owner uploaded. The report returns one row of data for each country where the videos were watched, and rows are sorted in descending order of number of minutes watched.

    https://developers.google.com/apis-explorer/#p/youtubeAnalytics/v2/youtubeAnalytics.reports.query?metrics=views%252CestimatedMinutesWatched%252CaverageViewDuration%252CaverageViewPercentage%252CestimatedRevenue%252CestimatedAdRevenue%252CgrossRevenue&dimensions=country&filters=uploaderType%253D%253Dself&sort=-estimatedMinutesWatched&startDate=2023-09-01&endDate=2024-03-31&&ids=contentOwner%253D%253DCONTENT_OWNER_ID

#### Country-specific annotation metrics for self-uploaded content

This request retrieves country-specific view counts, annotation click-through rates, annotation close rates, and annotation impressions for the content owner's uploaded videos. Results are sorted by annotation click-through rate in descending order, which means that the country with the highest annotation click-through rate will be listed first.

    https://developers.google.com/apis-explorer/#p/youtubeAnalytics/v2/youtubeAnalytics.reports.query?metrics=views%252CannotationClickThroughRate%252CannotationCloseRate%252CannotationImpressions&dimensions=country&filters=uploaderType%253D%253Dself&sort=-annotationClickThroughRate&startDate=2023-09-01&endDate=2024-03-31&&ids=contentOwner%253D%253DCONTENT_OWNER_ID

#### Province-specific metrics for U.S. states and Washington D.C.

This request retrieves a province-by-province breakdown of view counts, estimated minutes watched, and average view duration for the content owner's claimed videos. The data covers U.S. states and Washington D.C. Results are sorted alphabetically by provinces' ISO 3166-2 codes.

    https://developers.google.com/apis-explorer/#p/youtubeAnalytics/v2/youtubeAnalytics.reports.query?metrics=views%252CestimatedMinutesWatched%252CaverageViewDuration&dimensions=province&filters=claimedStatus%253D%253Dclaimed%253Bcountry%253D%253DUS&sort=province&startDate=2023-09-01&endDate=2024-03-31&&ids=contentOwner%253D%253DCONTENT_OWNER_ID

#### Top 10 U.S. cities by total views

This query retrieves a list of the 10 U.S. cities that accounted for the most views of the content owner's claimed videos during the specified date range. The query could be modified to request data for another [country](https://developers.google.com/youtube/analytics/v1/dimsmets/dims#country) by choosing another valid value for that filter. Similarly, the query could be modified to retrieve data for a subcontinent, such as Western Europe or Southeastern Asia, by using the [subContinent](https://developers.google.com/youtube/analytics/v1/dimsmets/dims#subContinent) filter and one of its valid values. Other filters are supported, too. Results are sorted by view count in descending order.

        https://developers.google.com/apis-explorer/#p/youtubeAnalytics/v2/youtubeAnalytics.reports.query?metrics=views&dimensions=city&maxResults=10&filters=claimedStatus%253D%253Dclaimed%253Bcountry%253D%253DUS&sort=-views&startDate=2023-09-01&endDate=2024-03-31&&ids=channel%253D%253DMINE

#### Top 10 U.S. cities by total views for each content type

This query retrieves a list of the 10 U.S. cities that accounted for the most views of the content owner's claimed content during the specified date range for each supported [creatorContentType](https://developers.google.com/youtube/analytics/v1/dimsmets/dims#creatorContentType). Results are sorted by view count in descending order.

        https://developers.google.com/apis-explorer/#p/youtubeAnalytics/v2/youtubeAnalytics.reports.query?metrics=views&dimensions=city%252CcreatorContentType&maxResults=10&filters=claimedStatus%253D%253Dclaimed%253Bcountry%253D%253DUS&sort=-views&startDate=2023-09-01&endDate=2024-03-31&&ids=channel%253D%253DMINE

#### Top 10 U.S. cities by total watch time

This query retrieves a list of the top 10 days during the specified date range when any U.S. city accounted for the greatest total daily watch time of the content owner's claimed content. The query results identify the total watch time, the date on which the watch time occurred, and the city where the content was estimated to have been viewed. Results are sorted in descending order of total watch time.

        https://developers.google.com/apis-explorer/#p/youtubeAnalytics/v2/youtubeAnalytics.reports.query?metrics=estimatedWatchTime&dimensions=city%252Cday&maxResults=10&filters=claimedStatus%253D%253Dclaimed%253Bcountry%253D%253DUS&sort=-estimatedWatchTime&startDate=2023-09-01&endDate=2024-03-31&&ids=channel%253D%253DMINE

#### Top 10 -- Most watched videos in Europe

This query retrieves the 10 most watched videos in Europe, among videos claimed by the content owner, as measured by number of views during the specified date range. The query could be modified to request data for another [continent](https://developers.google.com/youtube/analytics/v1/dimsmets/dims#continent) by choosing another valid value for that filter. Similarly, the query could be modified to retrieve data for a subcontinent, such as Western Europe or Southeastern Asia, by using the [subContinent](https://developers.google.com/youtube/analytics/v1/dimsmets/dims#subContinent) filter and one of its valid values. Results are sorted by view count in descending order.

    https://developers.google.com/apis-explorer/#p/youtubeAnalytics/v2/youtubeAnalytics.reports.query?metrics=views%252CestimatedMinutesWatched%252Clikes%252CsubscribersGained&dimensions=video&maxResults=10&filters=claimedStatus%253D%253Dclaimed%253Bcontinent%253D%253D150&sort=-estimatedMinutesWatched&startDate=2023-09-01&endDate=2024-03-31&&ids=channel%253D%253DMINE

### Playlist reports

#### Country-specific watch time metrics for a content owner's playlists

This query retrieves country-specific playlist view counts and playlist watch time metrics
for all playlists in the content owner's channels. The report returns one row of data for each
country where the playlists were watched. Rows are sorted in descending order of number of
minutes watched.

    https://developers.google.com/apis-explorer/#p/youtubeAnalytics/v2/youtubeAnalytics.reports.query?metrics=playlistViews%252CplaylistEstimatedMinutesWatched%252CaverageTimeInPlaylist%252CplaylistStarts&dimensions=country&&sort=-playlistEstimatedMinutesWatched&startDate=2023-09-01&endDate=2024-03-31&&ids=contentOwner%253D%253DCONTENT_OWNER_ID

#### Top 10 -- Most started playlists in the United States

This query retrieves the 10 playlists from the content owner's channels that viewers in the
United States started watching most frequently during the specified date range. Results are
sorted by number of playlist starts in descending order.

**Note:** Since this report uses the
`https://developers.google.com/youtube/analytics/dimensions#playlist` dimension, you must
specify a value for the `sort` request parameter and also set th
`maxResults` parameter to an integer value of `10` or less.

    https://developers.google.com/apis-explorer/#p/youtubeAnalytics/v2/youtubeAnalytics.reports.query?metrics=playlistStarts%252CplaylistViews%252CplaylistEstimatedMinutesWatched%252CplaylistAverageViewDuration&dimensions=playlist&filters=country%253D%253DUS&maxResults=10&sort=-playlistStarts&startDate=2023-09-01&endDate=2024-03-31&&ids=contentOwner%253D%253DCONTENT_OWNER_ID

Playback details

### Video reports

#### Likes and dislikes by content type

This query retrieves the number of likes and dislikes for each type of content on a particular channel or group of channels. Note that to run this query in the APIs Explorer, you must replace the string `CHANNEL_ID` in the `filters` parameter value with a comma-separated list of up to 500 channel IDs for your channels.

    https://developers.google.com/apis-explorer/#p/youtubeAnalytics/v2/youtubeAnalytics.reports.query?metrics=likes%dislikes&dimensions=creatorContentType&filters=channel%253D%253DCHANNEL_ID&startDate=2023-09-01&endDate=2024-03-31&&ids=contentOwner%253D%253DCONTENT_OWNER_ID

Playback location

### Video reports

#### Viewcounts and watch time from different playback locations

This query retrieves the number of views and estimated watch time for videos uploaded to a particular channel or group of channels. Results are aggregated based on the type of page or application where video playbacks occurred, and results are sorted in descending order by view count. Note that to run this query in the APIs Explorer, you must replace the string `CHANNEL_ID` in the `filters` parameter value with a comma-separated list of up to 500 channel IDs for your channels.

    https://developers.google.com/apis-explorer/#p/youtubeAnalytics/v2/youtubeAnalytics.reports.query?metrics=estimatedMinutesWatched%252Cviews&dimensions=insightPlaybackLocationType&filters=channel%253D%253DCHANNEL_ID&sort=-views&startDate=2023-09-01&endDate=2024-03-31&&ids=contentOwner%253D%253DCONTENT_OWNER_ID

#### Daily view counts and watch time from different playback locations

This query retrieves daily view counts and estimated watch time in the United States for videos uploaded to a particular channel or group of channels. Results are grouped by day for each type of page or application where video playbacks occurred. Results are sorted in reverse chronological order. Note that to run this query in the APIs Explorer, you must replace the string `CHANNEL_ID` in the `filters` parameter value with a comma-separated list of up to 500 channel IDs for your channels.

    https://developers.google.com/apis-explorer/#p/youtubeAnalytics/v2/youtubeAnalytics.reports.query?metrics=estimatedMinutesWatched%252Cviews&dimensions=day%252CinsightPlaybackLocationType&filters=country==US%253Bchannel%253D%253DCHANNEL_ID&sort=-day&startDate=2023-09-01&endDate=2024-03-31&&ids=contentOwner%253D%253DCONTENT_OWNER_ID

#### Top 10 -- Third-party sites that generate the most views for an embedded video

This query retrieves view counts and estimated watch time for a particular video or group of videos. Results are grouped by the third-party site where the video was embedded. Results are sorted in descending order by view count. Note that to run this query in the APIs Explorer, you must replace the string `VIDEO_ID` in the `filters` parameter value with a comma-separated list of up to 500 video IDs for your uploaded videos.

    https://developers.google.com/apis-explorer/#p/youtubeAnalytics/v2/youtubeAnalytics.reports.query?metrics=views%252CestimatedMinutesWatched&dimensions=insightPlaybackLocationDetail&filters=video%253D%253DVIDEO_ID%253BinsightPlaybackLocationType%253D%253DEMBEDDED&maxResults=10&sort=-views&startDate=2023-09-01&endDate=2024-03-31&&ids=contentOwner%253D%253DCONTENT_OWNER_ID

### Playlist reports

#### Playlist view counts and watch time from different playback locations

This query retrieves the number of playlist views, playlist estimated watch time, and
playlist starts for all playlists in a content owner's channels. Results are aggregated based
on the type of page or application where video playbacks occurred, and results are sorted in
descending order by playlist starts.

    https://developers.google.com/apis-explorer/#p/youtubeAnalytics/v2/youtubeAnalytics.reports.query?metrics=playlistViews%252CplaylistEstimatedMinutesWatched%252CplaylistStarts&dimensions=insightPlaybackLocationType&sort=-playlistStarts&startDate=2023-09-01&endDate=2024-03-31&&ids=contentOwner%253D%253DCONTENT_OWNER_ID

#### Playlist view counts and watch time from different playback locations

This query retrieves daily playlist starts, playlist view counts, and playlist estimated watch
time in the United States for all playlists in a content owner's channels. Results are returned
for each type of page or application where playlist views occurred.

```
dimensions=day,insightPlaybackLocationType
metrics=playlistStarts,playlistViews,playlistEstimatedMinutesWatched
filters=country==US
```
Traffic source

### Video reports

#### Viewcounts and watch time from different traffic sources

This request retrieves the number of views and estimated watch time for the content owner's videos. The metrics are aggregated by traffic source, which describes the manner in which users reached the video.

    https://developers.google.com/apis-explorer/#p/youtubeAnalytics/v2/youtubeAnalytics.reports.query?metrics=views%252CestimatedMinutesWatched&dimensions=insightTrafficSourceType&filters=uploaderType%253D%253Dself&startDate=2023-09-01&endDate=2024-03-31&&ids=contentOwner%253D%253DCONTENT_OWNER_ID

#### Daily view counts and watch time from different traffic sources

This request retrieves daily view counts and daily estimated watch time for the content owner's videos. The metrics are aggregated on a daily basis by traffic source and sorted in reverse chronological order.

    https://developers.google.com/apis-explorer/#p/youtubeAnalytics/v2/youtubeAnalytics.reports.query?metrics=views%252CestimatedMinutesWatched&dimensions=day%252CinsightTrafficSourceType&filters=uploaderType%253D%253Dself&sort=-day&startDate=2023-09-01&endDate=2024-03-31&&ids=contentOwner%253D%253DCONTENT_OWNER_ID

**Note:** The next two sample reports are only supported for specific traffic sources. `VIDEO_REMIXES`, `NOTIFICATION`, `END_SCREEN`, `CAMPAIGN_CARD`, `VIDEO_REMIXES`, and `NO_LINK_EMBEDDED` traffic sources are some of the unsupported ones.

#### Top 10 -- YouTube search terms that generate the most traffic for a video

This query retrieves the 10 search terms that generated the most views from YouTube search results for a specific video or group of videos. Results are sorted by view count in descending order. Note that to run this query in the APIs Explorer, you must replace the string `VIDEO_ID` in the `filters` parameter value with a comma-separated list of up to 500 video IDs for your uploaded videos.

    https://developers.google.com/apis-explorer/#p/youtubeAnalytics/v2/youtubeAnalytics.reports.query?metrics=views&dimensions=insightTrafficSourceDetail&filters=video%253D%253DVIDEO_ID%253BinsightTrafficSourceType%253D%253DYT_SEARCH&maxResults=10&sort=-views&startDate=2023-09-01&endDate=2024-03-31&&ids=contentOwner%253D%253DCONTENT_OWNER_ID

#### Top 10 -- External websites that generate the most traffic for a video

This query retrieves the 10 external websites that generated the most views from Google search results for a specific video or group of videos. Results are sorted by estimated watch time in descending order. Note that to run this query in the APIs Explorer, you must replace the string `VIDEO_ID` in the `filters` parameter value with a comma-separated list of up to 500 video IDs for your uploaded videos.

    https://developers.google.com/apis-explorer/#p/youtubeAnalytics/v2/youtubeAnalytics.reports.query?metrics=estimatedMinutesWatched%252Cviews&dimensions=insightTrafficSourceDetail&filters=video%253D%253DVIDEO_ID%253BinsightTrafficSourceType%253D%253DEXT_URL&maxResults=25&sort=-estimatedMinutesWatched&startDate=2023-09-01&endDate=2024-03-31&&ids=contentOwner%253D%253DCONTENT_OWNER_ID

### Playlist reports

#### Playlist view counts and watch time from different traffic sources in a country

This request retrieves the number of playlist views, playlist starts, and playlist estimated watch
time for playlist views in a specified country. The metrics are aggregated by traffic source,
which describes the manner in which users reached the playlist.

    https://developers.google.com/apis-explorer/#p/youtubeAnalytics/v2/youtubeAnalytics.reports.query?metrics=playlistViews%252CplaylistStarts%252CplaylistEstimatedMinutesWatched&dimensions=insightTrafficSourceType&filters=country%253D%253DUS&startDate=2023-09-01&endDate=2024-03-31&&ids=contentOwner%253D%253DCONTENT_OWNER_ID

#### Playlist view counts and watch time from different traffic sources

This request retrieves playlist views, playlist starts, and playlist estimated watch time
for playlists in one or more of a content owner's channels. The metrics are aggregated by
traffic source. Note that to run this query in the APIs Explorer, you must replace the string
`CHANNEL_ID` in the `filters` parameter value with a comma-separated
list of up to 500 channel IDs for your channels.

    https://developers.google.com/apis-explorer/#p/youtubeAnalytics/v2/youtubeAnalytics.reports.query?metrics=playlistViews%252CplaylistStarts%252CplaylistEstimatedMinutesWatched&dimensions=insightTrafficSourceType&filters=channel%253D%253DCHANNEL_ID&startDate=2023-09-01&endDate=2024-03-31&&ids=contentOwner%253D%253DCONTENT_OWNER_ID

Device/OS

### Video reports

#### Daily device type metrics for claimed videos

This query retrieves daily view counts and estimated watch time by device type for videos claimed by a particular content owner. Results are grouped by day for each type of device where video playbacks occurred. Results are sorted in chronological order.

    https://developers.google.com/apis-explorer/#p/youtubeAnalytics/v2/youtubeAnalytics.reports.query?metrics=estimatedMinutesWatched%252Cviews&dimensions=day%252CdeviceType&filters=claimedStatus%253D%253Dclaimed&sort=day&startDate=2023-09-01&endDate=2024-03-31&&ids=contentOwner%253D%253DCONTENT_OWNER_ID

#### Daily operating system metrics for claimed videos viewed on mobile devices

This query retrieves daily view counts and estimated watch time by operating system for views of videos claimed by a specified content owner that took place on mobile devices. Results are grouped by day for each operating system where video playbacks occurred. Results are sorted in chronological order.

    https://developers.google.com/apis-explorer/#p/youtubeAnalytics/v2/youtubeAnalytics.reports.query?metrics=estimatedMinutesWatched%252Cviews&dimensions=day%252CoperatingSystem&filters=claimedStatus%253D%253Dclaimed%253BdeviceType%253D%253DMOBILE&sort=day&startDate=2023-09-01&endDate=2024-03-31&&ids=contentOwner%253D%253DCONTENT_OWNER_ID

#### Daily operating system and device type metrics

This query retrieves daily view counts and estimated watch time for videos claimed by a particular content owner. Statistics are grouped by operating system and device type. Results are sorted in chronological order.

    https://developers.google.com/apis-explorer/#p/youtubeAnalytics/v2/youtubeAnalytics.reports.query?metrics=estimatedMinutesWatched%252Cviews&dimensions=day%252CoperatingSystem%252CdeviceType&filters=claimedStatus%253D%253Dclaimed&sort=day&startDate=2023-09-01&endDate=2024-03-31&&ids=contentOwner%253D%253DCONTENT_OWNER_ID

### Playlist reports

#### Device type metrics for playlist views on the Android operating system

This query retrieves playlist view counts and playlist estimated watch time on Android devices
for playlists in one or more of a content owner's channels. Results are returned for
each type of device where playlist views occurred. Note that to run this query in the APIs
Explorer, you must replace the string `CHANNEL_ID` in the `filters`
parameter value with a comma-separated list of up to 500 channel IDs for your channels.

    https://developers.google.com/apis-explorer/#p/youtubeAnalytics/v2/youtubeAnalytics.reports.query?metrics=playlistEstimatedMinutesWatched%252CplaylistViews&dimensions=deviceType&filters=channel%253D%253DCHANNEL_ID%253BoperatingSystem%253D%253DANDROID&startDate=2023-09-01&endDate=2024-03-31&&ids=contentOwner%253D%253DCONTENT_OWNER_ID

#### Operating system metrics for playlist views on mobile devices

This query retrieves playlist view counts and playlist estimated watch time on mobile devices
for playlists in any of a content owner's channels. Results are returned for each
operating system on which playlist views occurred.

    https://developers.google.com/apis-explorer/#p/youtubeAnalytics/v2/youtubeAnalytics.reports.query?metrics=playlistEstimatedMinutesWatched%252CplaylistViews&dimensions=operatingSystem&filters=deviceType%253D%253DMOBILE&startDate=2023-09-01&endDate=2024-03-31&&ids=contentOwner%253D%253DCONTENT_OWNER_ID

Demographic

### Video reports

#### Viewer demographics in California (age group and gender)

This report retrieves statistics about the age group and gender of viewers in California who watched the content owner's claimed content. Results are sorted by gender and then by age group. This query could be modified to retrieve the same statistics for all viewers worldwide or all viewers in a country, continent, subcontinent, or another U.S. state by adjusting the `filters` parameter value.

    https://developers.google.com/apis-explorer/#p/youtubeAnalytics/v2/youtubeAnalytics.reports.query?metrics=viewerPercentage&dimensions=ageGroup%252Cgender&filters=claimedStatus%253D%253Dclaimed%253Bprovince%253D%253DUS-CA&sort=gender%252CageGroup&startDate=2023-09-01&endDate=2024-03-31&&ids=contentOwner%253D%253DCONTENT_OWNER_ID

Social

#### Sharing metrics, aggregated by service where videos were shared

This request retrieves the number of times that users used the `Share` button to share videos that the content owner uploaded. Results are aggregated by sharing service (Google+, Twitter, etc.) and sorted in descending order of number of shares.

    https://developers.google.com/apis-explorer/#p/youtubeAnalytics/v2/youtubeAnalytics.reports.query?metrics=shares&dimensions=sharingService&filters=uploaderType%253D%253Dself&sort=-shares&startDate=2023-09-01&endDate=2024-03-31&&ids=contentOwner%253D%253DCONTENT_OWNER_ID

Audience retention

#### Audience retention metrics for a video

This report measures a video's ability to retain its audience. The report can only be retrieved for a single video at a time. Note that to run this query in the APIs Explorer, you must replace the string `VIDEO_ID` in the `filters` parameter value with the video ID for one of your uploaded videos. Note that audience retention reports do not support the ability to specify multiple values for the `video` filter.

In this example, the report uses the `https://developers.google.com/youtube/analytics/dimensions#audienceType` filter to restrict the response so that it only contains data for organic views, which are the result of a direct user action, such as a search for a video or a click on a suggested video. As such, the report does not include data for views from TrueView in-stream or TrueView in-display ads. You can remove the filter to retrieve the video's audience retention data from all audience types.

Note that data for the `audienceType` filter is available as of September 25, 2013. The API will not return data for queries that use the filter to try to retrieve data from earlier dates. Queries that do not use the filter work for any date after July 1, 2008.

    https://developers.google.com/apis-explorer/#p/youtubeAnalytics/v2/youtubeAnalytics.reports.query?metrics=audienceWatchRatio%252CrelativeRetentionPerformance&dimensions=elapsedVideoTimeRatio&filters=video%253D%253DVIDEO_ID%253BaudienceType%253D%253DORGANIC&startDate=2023-09-01&endDate=2024-03-31&&ids=contentOwner%253D%253DCONTENT_OWNER_ID

Revenue/Ads

#### Revenue and ad performance metrics for claimed content

This request retrieves revenue and ad performance metrics for the content owner's claimed content. The report returns a single row of data that contains totals for each requested metric during the specified date range.

    https://developers.google.com/apis-explorer/#p/youtubeAnalytics/v2/youtubeAnalytics.reports.query?metrics=views%252CestimatedRevenue%252CestimatedAdRevenue%252CestimatedRedPartnerRevenue%252CgrossRevenue%252CadImpressions%252Ccpm%252CplaybackBasedCpm%252CmonetizedPlaybacks&filters=claimedStatus%253D%253Dclaimed&startDate=2023-09-01&endDate=2024-03-31&&ids=contentOwner%253D%253DCONTENT_OWNER_ID

#### Daily revenue and ad performance metrics

This request retrieves daily revenue and ad performance metrics for the content owner's claimed content.

    https://developers.google.com/apis-explorer/#p/youtubeAnalytics/v2/youtubeAnalytics.reports.query?metrics=views%252CestimatedRevenue%252CestimatedAdRevenue%252CestimatedRedPartnerRevenue%252CgrossRevenue%252CadImpressions%252Ccpm%252CplaybackBasedCpm%252CmonetizedPlaybacks&dimensions=day&filters=claimedStatus%253D%253Dclaimed&startDate=2023-09-01&endDate=2024-03-31&&ids=contentOwner%253D%253DCONTENT_OWNER_ID

#### Country-specific revenue and ad performance metrics

This request retrieves country-specific revenue and ad performance metrics for the content owner's claimed content. Results are sorted in descending order by revenue amount, which means that the first country listed will be the one where the partner had the greatest estimated revenue.

    https://developers.google.com/apis-explorer/#p/youtubeAnalytics/v2/youtubeAnalytics.reports.query?metrics=views%252CestimatedRevenue%252CestimatedAdRevenue%252CestimatedRedPartnerRevenue%252CgrossRevenue%252CadImpressions%252Ccpm%252CplaybackBasedCpm%252CmonetizedPlaybacks&dimensions=country&filters=claimedStatus%253D%253Dclaimed&sort=-estimatedRevenue&startDate=2023-09-01&endDate=2024-03-31&&ids=contentOwner%253D%253DCONTENT_OWNER_ID

#### Top 10 -- Videos with the highest revenue

This request retrieves revenue and ad performance metrics for the 10 videos that where claimed by the content owner claimed and that had the highest revenue. Results are sorted in descending order by revenue amount, which means that the first video will be the one that had the highest estimated revenue.

    https://developers.google.com/apis-explorer/#p/youtubeAnalytics/v2/youtubeAnalytics.reports.query?metrics=views%252CestimatedRevenue%252CestimatedAdRevenue%252CestimatedRedPartnerRevenue%252CgrossRevenue%252CadImpressions%252Ccpm%252CplaybackBasedCpm%252CmonetizedPlaybacks&dimensions=video&filters=claimedStatus%253D%253Dclaimed&maxResults=10&sort=-estimatedRevenue&startDate=2023-09-01&endDate=2024-03-31&&ids=contentOwner%253D%253DCONTENT_OWNER_ID

#### Ad performance metrics for different ad types

This request retrieves ad performance metrics for the content owner's claimed content. Results are grouped by ad type, which enables you to compare revenue and CPM values across different ad types.

    https://developers.google.com/apis-explorer/#p/youtubeAnalytics/v2/youtubeAnalytics.reports.query?metrics=grossRevenue%252CadImpressions%252Ccpm&dimensions=adType&filters=claimedStatus%253D%253Dclaimed&sort=-adType&startDate=2023-09-01&endDate=2024-03-31&&ids=contentOwner%253D%253DCONTENT_OWNER_ID