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
.
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
.
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
.
Status: current
The
id
for this version of this report is
channel_playback_location_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
,
playback_location_detail
|
Metrics:
|
views
,
watch_time_minutes
,
average_view_duration_seconds
,
average_view_duration_percentage
,
red_views
,
red_watch_time_minutes
|
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
.
Status: current
The
id
for this version of this report is
channel_traffic_source_a2
. It has the following differences from version
a1
:
Contents
|
Dimensions:
|
date
,
channel_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
,
average_view_duration_percentage
,
red_views
,
red_watch_time_minutes
|
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
.
Status: current
The
id
for this version of this report is
channel_device_os_a2
. It has the following differences from version
a1
:
Contents
|
Dimensions:
|
date
,
channel_id
,
video_id
,
live_or_on_demand
,
subscribed_status
,
country_code
,
device_type
,
operating_system
|
Metrics:
|
views
,
watch_time_minutes
,
average_view_duration_seconds
,
average_view_duration_percentage
,
red_views
,
red_watch_time_minutes
|
Viewer demographics
This report aggregates viewing statistics based on viewers' age group and gender.
The
id
for this report is
channel_demographics_a1
.
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
.
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
.
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
.
Status: current
The
id
for this version of this report is
channel_subtitles_a2
. It has the following differences from version
a1
:
Contents
|
Dimensions:
|
date
,
channel_id
,
video_id
,
live_or_on_demand
,
subscribed_status
,
country_code
,
subtitle_language
,
subtitle_language_autotranslated
|
Metrics:
|
views
,
watch_time_minutes
,
average_view_duration_seconds
,
average_view_duration_percentage
,
red_views
,
red_watch_time_minutes
|
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
.
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
|