{# Vars for auth docs %}

Channel Reports

This page lists reports that channel owners can retrieve with the YouTube Reporting API. Each report's id, as returned by the API's reportTypes.list method, is provided in the report description.

Video reports

Video reports provide statistics for all user activity related to a channel's videos. For example, these reports contain the number of times that your videos were viewed.

User activity

This report provides user activity statistics related to a channel and its videos. The id for this report is channel_basic_a2.

version a2
Status: current

The id for this version of this report is channel_basic_a2. It has the following differences from version a1:

Contents
Dimensions: date, channel_id, video_id, live_or_on_demand, subscribed_status, country_code
Metrics: views, comments, likes, dislikes, videos_added_to_playlists, videos_removed_from_playlists, shares, watch_time_minutes, average_view_duration_seconds, average_view_duration_percentage, annotation_click_through_rate, annotation_close_rate, annotation_impressions, annotation_clickable_impressions, annotation_closable_impressions, annotation_clicks, annotation_closes, card_click_rate, card_teaser_click_rate, card_impressions, card_teaser_impressions, card_clicks, card_teaser_clicks, subscribers_gained, subscribers_lost, red_views, red_watch_time_minutes

User activity by province

This report provides user activity statistics for U.S. states and the District of Columbia. The id for this report is channel_province_a2.

version a2
Status: current

The id for this version of this report is channel_province_a2. It has the following differences from version a1:

Contents
Dimensions: date, channel_id, video_id, live_or_on_demand, subscribed_status, country_code, province_code
Metrics: views, watch_time_minutes, average_view_duration_seconds, average_view_duration_percentage, annotation_click_through_rate, annotation_close_rate, annotation_impressions, annotation_clickable_impressions, annotation_closable_impressions, annotation_clicks, annotation_closes, card_click_rate, card_teaser_click_rate, card_impressions, card_teaser_impressions, card_clicks, card_teaser_clicks, red_views, red_watch_time_minutes

Playback locations

This report provides statistics related to the type of page or application where video playbacks occurred. The id for this report is channel_playback_location_a2.

Traffic sources

This report aggregates viewing statistics based on the manner in which viewers reached the channel's video content. For example, it identifies the number of views that stemmed from a Google search or from a link to a related video. The id for this report is channel_traffic_source_a2.

Device type and operating system

This report aggregates video viewing statistics based on viewers' operating systems and device types. For example, it identifies the number of views that occurred on Android tablets or on Windows desktop devices. The id for this report is channel_device_os_a2.

Viewer demographics

This report aggregates viewing statistics based on viewers' age group and gender. The id for this report is channel_demographics_a1.

Contents
Dimensions: date, channel_id, video_id, live_or_on_demand, subscribed_status, country_code, age_group, gender
Metrics: views_percentage

Content sharing by platform

This report provides statistics showing how frequently the channel's videos were shared on different social platforms. The id for this report is channel_sharing_service_a1.

Contents
Dimensions: date, channel_id, video_id, live_or_on_demand, subscribed_status, country_code, sharing_service
Metrics: shares

Annotations

This report provides statistics for annotations that display during a channel's videos. The report data measures the performance of individual annotations for each video. The user activity report, by contrast, aggregates statistics for all of a video's annotations. The id for this report is channel_annotations_a1.

Contents
Dimensions: date, channel_id, video_id, live_or_on_demand, subscribed_status, country_code, annotation_type, annotation_id
Metrics: annotation_click_through_rate, annotation_close_rate, annotation_impressions, annotation_clickable_impressions, annotation_closable_impressions, annotation_clicks, annotation_closes

Cards

This report provides impressions and click-through statistics for cards that display during a channel's videos. The report data measures the performance of individual cards. The user activity report, by contrast, aggregates statistics for all of a video's cards. The id for this report is channel_cards_a1.

Contents
Dimensions: date, channel_id, video_id, live_or_on_demand, subscribed_status, country_code, card_type, card_id
Metrics: card_click_rate, card_teaser_click_rate, card_impressions, card_teaser_impressions, card_clicks, card_teaser_clicks

End screens

This report provides impression and click-through statistics for end screens that display after a video stops playing. The report contains statistics for a channel's videos. The id for this report is channel_end_screens_a1.

Contents
Dimensions: date, channel_id, video_id, live_or_on_demand, subscribed_status, country_code, end_screen_element_type, end_screen_element_id
Metrics: end_screen_element_clicks, end_screen_element_impressions, end_screen_element_click_rate

Subtitles

This report provides statistics about the closed caption language that is used for the longest time during video views. Views in which captions are mostly turned off are excluded. The id for this report is channel_subtitles_a2.

Combined

This report provides fine-grained video statistics by combining dimensions used in the playback location, traffic source, and device/OS reports. The id for this report is channel_combined_a2.

version a2
Status: current

The id for this version of this report is channel_combined_a2. It has the following differences from version a1:

Contents
Dimensions: date, channel_id, video_id, live_or_on_demand, subscribed_status, country_code, playback_location_type, traffic_source_type, device_type, operating_system
Metrics: views, watch_time_minutes, average_view_duration_seconds, average_view_duration_percentage, red_views, red_watch_time_minutes

Playlist reports

Playlist reports provide statistics that are specifically related to video views that occur in the context of a playlist.

User activity

This report provides statistics related to users' interactions with a channel's playlists. The id for this report is playlist_basic_a1.

Contents
Dimensions: date, channel_id, playlist_id, video_id, live_or_on_demand, subscribed_status, country_code
Metrics: views, watch_time_minutes, average_view_duration_seconds, playlist_starts, playlist_saves_added, playlist_saves_removed

User activity by province

This report provides user activity statistics related to users' interactions with a channel's playlists for U.S. states and the District of Columbia. This effectively means that the report is filtered to only include data if the country_code dimension's value is US. The id for this report is playlist_province_a1.

Contents
Dimensions: date, channel_id, playlist_id, video_id, live_or_on_demand, subscribed_status, country_code, province_code
Metrics: views, watch_time_minutes, average_view_duration_seconds, playlist_starts, playlist_saves_added, playlist_saves_removed

Playback locations

This report provides statistics related to the type of page or application where playlist playbacks occurred. The id for this report is playlist_playback_location_a1.

Contents
Dimensions: date, channel_id, playlist_id, video_id, live_or_on_demand, subscribed_status, country_code, playback_location_type, playback_location_detail
Metrics: views, watch_time_minutes, average_view_duration_seconds, playlist_starts, playlist_saves_added, playlist_saves_removed

Traffic sources

This report aggregates viewing statistics based on the manner in which viewers reached a channel's playlist videos. For example, it identifies the number of views that stemmed from a Google search or from a link to a related video. The id for this report is playlist_traffic_source_a1.

Contents
Dimensions: date, channel_id, playlist_id, video_id, live_or_on_demand, subscribed_status, country_code, traffic_source_type, traffic_source_detail
Metrics: views, watch_time_minutes, average_view_duration_seconds, playlist_starts, playlist_saves_added, playlist_saves_removed

Device type and operating system

This report aggregates playlist viewing statistics based on viewers' operating systems and device types. For example, it identifies the number of views that occurred on Android tablets or on Windows desktop devices. The id for this report is playlist_device_os_a1.

Contents
Dimensions: date, channel_id, playlist_id, video_id, live_or_on_demand, subscribed_status, country_code, device_type, operating_system
Metrics: views, watch_time_minutes, average_view_duration_seconds, playlist_starts, playlist_saves_added, playlist_saves_removed

Combined

This report provides fine-grained playlist statistics by combining dimensions used in the playback location, traffic source, and device/OS reports. The id for this report is playlist_combined_a1.

Contents
Dimensions: date, channel_id, playlist_id, video_id, live_or_on_demand, subscribed_status, country_code, playback_location_type, traffic_source_type, device_type, operating_system
Metrics: views, watch_time_minutes, average_view_duration_seconds, playlist_starts, playlist_saves_added, playlist_saves_removed