Important: Filters listed in parentheses are optional. For example, for the filtering option claimedStatus(,uploaderType)(,country), the claimedStatus filter is required, and the uploaderType and country filters are both optional.

Activity for time periods (including subscriber counts)

This report provides statistics related to user actions on all of a content owner's channels for specific time intervals. You can filter the report to only return data for a specific video or country. The report includes the subscribersGained and subscribersLost metrics.

User activity for specific time periods (including owned and claimed content)

This report provides statistics related to user actions on all of a content owner's content for specific time intervals. This report supports a different set of filters than the one that includes subscriber counts. It can be used to only retrieve statistics for claimed content, including claimed content uploaded by the content owner, third parties, or both.

User activity in U.S. states for specific time periods

This report provides statistics for a particular U.S. state or the District of Columbia. Note that this report only supports a subset of the metrics available in the country-specific report described above.

Important: Filters listed in parentheses are optional. For example, for the filtering option claimedStatus(,uploaderType)(,country), the claimedStatus filter is required, and the uploaderType and country filters are both optional.

User activity by country (including subscriber counts)

This report provides statistics related to user activity on a country-by-country basis for all of a content owner's channels. You can filter the report to only return data for a specific video or channel. This report includes the subscribersGained and subscribersLost metrics.

User activity by country (including owned and claimed content)

This report provides statistics related to user activity on a country-by-country basis for all of a content owner's channels. The report supports a different set of filters than the one that includes subscriber counts. It can be used to only retrieve statistics for claimed content, including claimed content uploaded by the content owner, third parties, or both.

User activity by province

This report provides user activity statistics for U.S. states and the District of Columbia. For this report, you must set the filters parameter value to country==US.

Important: Filters listed in parentheses are optional. For example, for the filtering option claimedStatus(,uploaderType)(,country), the claimedStatus filter is required, and the uploaderType and country filters are both optional.

Video playback location report

This report provides statistics related to the type of page or application where video playbacks occurred.

Playback location detail(<= 25 results)

Note: This report requires you to set the max-results parameter to a integer value of 25 or less. Unlike most other reports, this report also requires you to specify a value for the sort request parameter.

This report identifies the embedded video players that generated the most views or viewing time for a content owner's content. When retrieving this report, you must set the insightPlaybackLocationType filter to EMBEDDED.

Important: Filters listed in parentheses are optional. For example, for the filtering option claimedStatus(,uploaderType)(,country), the claimedStatus filter is required, and the uploaderType and country filters are both optional.

Traffic source

This report aggregates viewing statistics based on the manner in which viewers reached your video content. For example, it identifies the number of views that stemmed from a Google search or from a link to a related video.

Traffic source detail(<= 25 results)

Note: This report requires you to set the max-results parameter to a integer value of 25 or less. Unlike most other reports, this report also requires you to specify a value for the sort request parameter.

This report aggregates viewing statistics based on the referrers that generated the most views for the content owner's content. Referrers are categorized by traffic source type, and the insightTrafficSourceDetail dimension's definition identifies the traffic sources for which the report is available. For example, if you set the insightTrafficSourceType filter to GOOGLE_SEARCH, the report will list the Google search terms that generated the most views or viewing time for the content owner's content.

Note: This report is only supported for specific traffic sources. For example, the NO_LINK_EMBEDDED traffic source does not have additional details and, therefore, does not support this report. See the insightTrafficSourceType definition for details about which traffic sources support this report.

Important: Filters listed in parentheses are optional. For example, for the filtering option claimedStatus(,uploaderType)(,country), the claimedStatus filter is required, and the uploaderType and country filters are both optional.

Device type

This report aggregates viewing statistics based on the manner in which viewers reached your video content. For example, it identifies the number of views that stemmed from a Google search or from a link to a related video.

Operating system

This report aggregates viewing statistics based on viewers' operating systems. For example, it identifies the number of views that occurred on Android devices or on PlayStations.

Operating system and device type

This report aggregates 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.

Important: Filters listed in parentheses are optional. For example, for the filtering option claimedStatus(,uploaderType)(,country), the claimedStatus filter is required, and the uploaderType and country filters are both optional.

Viewer demographics (age group and gender)

This report aggregates viewing statistics based on viewers' age group and gender.

Important: Filters listed in parentheses are optional. For example, for the filtering option claimedStatus(,uploaderType)(,country), the claimedStatus filter is required, and the uploaderType and country filters are both optional.

Content sharing by platform

This report provides statistics showing how frequently the channel's videos were shared on different social platforms.

Important: Filters listed in parentheses are optional. For example, for the filtering option claimedStatus(,uploaderType)(,country), the claimedStatus filter is required, and the uploaderType and country filters are both optional.

Note: These reports require you to set the max-results parameter to an integer value of 10 or less. Unlike most other reports, these reports also require you to specify a value for the sort request parameter.

Top videos overall, by country, by continent, or by subcontinent (<= 10 results)

This report lists the content owner's top videos based on the specified filtering and sorting criteria.

Top videos overall, by country, by continent, or by subcontinent (<= 10 results)

This report lists the content owner's top videos in a particular U.S. state or the District of Columbia. Note that this report only supports a subset of the metrics available in the country-specific report described above.