YouTube
Metrics & Dimensions List
Updated: 2026-08-01
Important
Two report families are available, each at two granularities:
youtube__channel_stats_dailyandyoutube__channel_stats_lifetime- your channelyoutube__video_stats_dailyandyoutube__video_stats_lifetime- each video
The daily tables carry day-by-day metrics from the YouTube Analytics API. The lifetime
tables carry the cumulative counters shown on the channel or video itself, plus its
metadata.
The granularity does not change the columns, only the period each row covers.
Choose the Right Time Granularity for Your Data
Channel Table
The ID that YouTube uses to uniquely identify the channel that the video was uploaded to.
Channel title for the channel that the video belongs to.
The channel's description. The property's value has a maximum length of 1000 characters.
The channel's custom URL. The YouTube Help Center explains eligibility requirements for getting a custom URL as well as how to set up the URL.
The date and time that the channel was created. The value is specified.
A map of thumbnail images associated with the channel. For each object in the map, the key is the name of the thumbnail image, and the value is an object that contains other information about the thumbnail. When displaying thumbnails in your application, make sure that your code uses the image URLs exactly as they are returned in API responses. For example, your application should not use the http domain instead of the https domain in a URL returned in an API response. Channel thumbnail URLs are available only in the https domain, which is how the URLs appear in API responses. You might see broken images in your application if it tries to load YouTube images from the http domain. Thumbnail images might be empty for newly created channels and might take up to one day to populate.
The specific date for which the analytics data is reported.
This metric represents different numbers in different types of reports.
The number of times the channel's videos have been viewed past the initial seconds.
The number of times that a video was viewed by YouTube Premium (previously known as YouTube Red) members.
The number of minutes that users watched videos for the specified channel, content owner, video, or playlist.
The number of minutes that YouTube Premium (previously known as YouTube Red) members watched a video.
The average length, in seconds, of video playbacks. As of December 13, 2021, this metric excludes looping clips traffic. In a playlist report, the metric indicates the average length, in seconds, of video playbacks that occurred in the context of a playlist.
The average percentage of a video watched during a video playback. As of December 13, 2021, this metric excludes looping clips traffic.
The number of times that users commented on a video. See the YouTube Help Center for more information.
The ID of the playlist that contains the channel's liked videos. Use the playlistItems.insert and playlistItems.delete methods to add or remove items from that list.
The number of times that users indicated that they disliked a video by giving it a negative rating.
The number of times that users shared a video through the Share button. See the YouTube Help Center for more information.
The number of times that users subscribed to a channel. Channels can gain or lose subscribers in several places, including the video watch page, the channel page, and the guide that appears on the YouTube home page. In channel reports, this metric includes subscribers gained from any of these places. However, in reports that use either the video dimension or the filter parameter to restrict the response to only include data for a particular video, the subscribersGained metric will only include statistics from the specified video's watch page.
The number of times that users unsubscribed from a channel. Data for this metric is reported similarly to the subscribersGained metric. In channel reports, this metric includes subscribers lost through any mechanism through which users can unsubcribe from a channel. However, in reports that use either the video dimension or the filter parameter to restrict the response to only include data for a particular video, this metric only includes users who unsubscribed from the specified video's watch page.
The number of times that videos were added to any YouTube playlists. The videos could have been added to the video owner's playlist or to other channels' playlists. The metric value does include the number of times that videos were added to default playlists like the "Watch Later" playlist. However, it does not count playlists that a video is automatically added to, such as a channel's uploads playlist or a user's watch history. This metric returns an absolute number, meaning that if a user adds a video to a playlist, removes it, and then adds it again, the metric value reflects the video being added to a playlist twice. Data for this metric is not available for dates before October 1, 2014.
The number of times that videos were removed from any YouTube playlists. The videos could have been removed from the video owner's playlist or from other channels' playlists. The metric value includes the number of times that videos were removed from default playlists like the "Watch Later" playlist. This metric returns an absolute number, meaning that if a user adds a video to a playlist, removes it, adds it again, and then removes it again, the metric value reflects the video being removed from a playlist twice. Data for this metric is not available for dates before October 1, 2014.
The total number of annotation impressions.
The number of annotations that appeared and could be clicked.
The number of clicked annotations.
The ratio of annotations that viewers clicked to the total number of clickable annotation impressions. The YouTube Help Center has more information about creating annotations and using link annotations.
The number of annotations that appeared and could be closed.
The number of closed annotations.
The ratio of annotations that viewers closed to the total number of annotation impressions.
The number of times cards were displayed. When the card panel is opened, a card impression is logged for each of the video's cards.
The number of times that cards were clicked.
The click-through-rate for cards, which is calculated as the ratio of card clicks to card impressions.
The number of times that card teasers were displayed. A video view can generate multiple teaser impressions.
The number of clicks on card teasers. Card icon clicks are attributed to the last teaser displayed to the user.
The click-through-rate for card teasers, which is calculated as the ratio of clicks on card teasers to the total number of card teaser impressions.
The number of subscribers that the channel has. This value is rounded down to three significant figures. For more details about how subscriber counts are rounded, see Revision History or YouTube Help Center.
The number of public videos uploaded to the channel. Note that the value reflects the count of the channel's public videos only, even to owners. This behavior is consistent with counts shown on the YouTube website.
The sum of the number of times all the videos in all formats have been viewed for a channel. Starting March 31, 2025, for Shorts on a channel, viewCount will be updated to include the number of times a Short starts to play or replay.
Video Table
The ID that YouTube uses to uniquely identify the channel that the video was uploaded to.
Channel title for the channel that the video belongs to.
The ID of a YouTube video. In the YouTube Data API, this is the value of a video resource's id property. This is a core dimension and is subject to the Deprecation Policy.
The channel's title.
The video's description. The value has a maximum length of 1000 characters.
The date and time that the video was published.
The YouTube video category associated with the video. You must set a value for this property if you call the videos.update method and are updating the snippet part of a video resource.
A list of keyword tags associated with the video. Tags may contain spaces. The property value has a maximum length of 500 characters. Note the following rules regarding the way the character limit is calculated: The property value is a list, and commas between items in the list count toward the limit. If a tag contains a space, the API server handles the tag value as though it were wrapped in quotation marks, and the quotation marks count toward the character limit. So, for the purposes of character limits, the tag Foo-Baz contains seven characters, but the tag Foo Baz contains nine characters.
The length of the video, given as an ISO 8601 duration such as PT15M33S for 15 minutes and 33 seconds. The duration_minutes column holds the same length expressed in minutes.
Duration of the video, in minutes.
Privacy status of the channel. Valid values for this property are: private public unlisted.
A map of thumbnail images associated with the video. For each object in the map, the key is the name of the thumbnail image, and the value is an object that contains other information about the thumbnail.
The specific date for which the analytics data is reported.
This metric represents different numbers in different types of reports.
The number of times the channel's videos have been viewed past the initial seconds.
The number of times that a video was viewed by YouTube Premium (previously known as YouTube Red) members.
The number of minutes that users watched videos for the specified channel, content owner, video, or playlist.
The number of minutes that YouTube Premium (previously known as YouTube Red) members watched a video.
The average length, in seconds, of video playbacks. As of December 13, 2021, this metric excludes looping clips traffic. In a playlist report, the metric indicates the average length, in seconds, of video playbacks that occurred in the context of a playlist.
The average percentage of a video watched during a video playback. As of December 13, 2021, this metric excludes looping clips traffic.
The number of times that users commented on a video. See the YouTube Help Center for more information.
The ID of the playlist that contains the channel's liked videos. Use the playlistItems.insert and playlistItems.delete methods to add or remove items from that list.
The number of times that users indicated that they disliked a video by giving it a negative rating.
The number of times that users shared a video through the Share button. See the YouTube Help Center for more information.
The number of times that users subscribed to a channel. Channels can gain or lose subscribers in several places, including the video watch page, the channel page, and the guide that appears on the YouTube home page. In channel reports, this metric includes subscribers gained from any of these places. However, in reports that use either the video dimension or the filter parameter to restrict the response to only include data for a particular video, the subscribersGained metric will only include statistics from the specified video's watch page.
The number of times that users unsubscribed from a channel. Data for this metric is reported similarly to the subscribersGained metric. In channel reports, this metric includes subscribers lost through any mechanism through which users can unsubcribe from a channel. However, in reports that use either the video dimension or the filter parameter to restrict the response to only include data for a particular video, this metric only includes users who unsubscribed from the specified video's watch page.
The number of times that videos were added to any YouTube playlists. The videos could have been added to the video owner's playlist or to other channels' playlists. The metric value does include the number of times that videos were added to default playlists like the "Watch Later" playlist. However, it does not count playlists that a video is automatically added to, such as a channel's uploads playlist or a user's watch history. This metric returns an absolute number, meaning that if a user adds a video to a playlist, removes it, and then adds it again, the metric value reflects the video being added to a playlist twice. Data for this metric is not available for dates before October 1, 2014.
The number of times that videos were removed from any YouTube playlists. The videos could have been removed from the video owner's playlist or from other channels' playlists. The metric value includes the number of times that videos were removed from default playlists like the "Watch Later" playlist. This metric returns an absolute number, meaning that if a user adds a video to a playlist, removes it, adds it again, and then removes it again, the metric value reflects the video being removed from a playlist twice. Data for this metric is not available for dates before October 1, 2014.
The total number of annotation impressions.
The number of annotations that appeared and could be clicked.
The number of clicked annotations.
The ratio of annotations that viewers clicked to the total number of clickable annotation impressions. The YouTube Help Center has more information about creating annotations and using link annotations.
The number of annotations that appeared and could be closed.
The number of closed annotations.
The ratio of annotations that viewers closed to the total number of annotation impressions.
The number of times cards were displayed. When the card panel is opened, a card impression is logged for each of the video's cards.
The number of times that cards were clicked.
The click-through-rate for cards, which is calculated as the ratio of card clicks to card impressions.
The number of times that card teasers were displayed. A video view can generate multiple teaser impressions.
The number of clicks on card teasers. Card icon clicks are attributed to the last teaser displayed to the user.
The click-through-rate for card teasers, which is calculated as the ratio of clicks on card teasers to the total number of card teaser impressions.
The sum of the number of times all the videos in all formats have been viewed for a channel. Starting March 31, 2025, for Shorts on a channel, viewCount will be updated to include the number of times a Short starts to play or replay.
The number of users who have indicated that they liked the video.
The number of comments for the video.