System-Managed Reports

This page lists the system-managed reports that YouTube generates for partners. YouTube automatically generates these reports for any content owners that have access to the corresponding reports in Creator Studio. Note that some Creator Studio reports are not currently available in the API.

Each report's id, as returned by the API's reportTypes.list method, is provided in the report description. All of the system-managed reports that are currently available are monthly reports.

Some reports are customized to include relevant fields for different content types. For example, the Aggregate ad revenue per asset report contains an episode_title field for TV content and an album field for music labels. Use the tabs in the report tables below to view the correct set of fields for your content type.

Aggregate ad revenue per video

This report summarizes monthly, worldwide ad revenue for videos. Each row in the report includes monthly ad revenue totals for the video. The report may contain multiple rows per video if there are revenue adjustments for the video related to backpay, conflict resolution, etc.

The reportType id for this report is content_owner_ad_revenue_summary_a1.

Movies

Contents
Primary Key:	adjustment_type video_id
Additional fields:	video_title video_duration_sec category channel_id uploader channel_display_name owned_views youtube_revenue_split_auction youtube_revenue_split_reserved youtube_revenue_split_partner_sold_youtube_served youtube_revenue_split_partner_sold_partner_served youtube_revenue_split partner_revenue_auction partner_revenue_reserved partner_revenue_partner_sold_youtube_served partner_revenue_partner_sold_partner_served partner_revenue

Music labels

Contents
Primary Key:	adjustment_type video_id
Additional fields:	video_title video_duration_sec category channel_id uploader channel_display_name owned_views youtube_revenue_split_auction youtube_revenue_split_reserved youtube_revenue_split_partner_sold_youtube_served youtube_revenue_split_partner_sold_partner_served youtube_revenue_split partner_revenue_auction partner_revenue_reserved partner_revenue_partner_sold_youtube_served partner_revenue_partner_sold_partner_served partner_revenue

Music publishers

Contents
Primary Key:	adjustment_type video_id
Additional fields:	video_title video_duration_sec category channel_id uploader channel_display_name owned_views youtube_revenue_split_auction youtube_revenue_split_reserved youtube_revenue_split_partner_sold_youtube_served youtube_revenue_split_partner_sold_partner_served youtube_revenue_split partner_revenue_auction partner_revenue_reserved partner_revenue_partner_sold_youtube_served partner_revenue_partner_sold_partner_served partner_revenue

TV

Contents
Primary Key:	adjustment_type video_id
Additional fields:	video_title video_duration_sec category channel_id uploader channel_display_name owned_views youtube_revenue_split_auction youtube_revenue_split_reserved youtube_revenue_split_partner_sold_youtube_served youtube_revenue_split_partner_sold_partner_served youtube_revenue_split partner_revenue_auction partner_revenue_reserved partner_revenue_partner_sold_youtube_served partner_revenue_partner_sold_partner_served partner_revenue

Daily ad revenue per video

This report summarizes daily ad revenue for videos on a country-by-country basis. Each row in the report specifies the amount of revenue earned by a particular video on a particular day in a particular country. In addition, the row might represent normal ad revenue earned that day or an adjustment that represents revenue on a previous day.

Adjusted revenue may also have occurred in a previous month to the month associated with the report data. For example, a report posted in November 2016 may contain revenue adjustments from October 2016 or other earlier months.

The reportType id for this report is content_owner_ad_revenue_raw_a1.

Movies

Contents
Primary Key:	adjustment_type date country_code video_id
Additional fields:	video_title video_duration_sec category channel_id uploader channel_display_name content_type policy owned_views youtube_revenue_split_auction youtube_revenue_split_reserved youtube_revenue_split_partner_sold_youtube_served youtube_revenue_split_partner_sold_partner_served youtube_revenue_split partner_revenue_auction partner_revenue_reserved partner_revenue_partner_sold_youtube_served partner_revenue_partner_sold_partner_served partner_revenue

Music labels

Contents
Primary Key:	adjustment_type date country_code video_id
Additional fields:	video_title video_duration_sec category channel_id uploader channel_display_name content_type policy owned_views youtube_revenue_split_auction youtube_revenue_split_reserved youtube_revenue_split_partner_sold_youtube_served youtube_revenue_split_partner_sold_partner_served youtube_revenue_split partner_revenue_auction partner_revenue_reserved partner_revenue_partner_sold_youtube_served partner_revenue_partner_sold_partner_served partner_revenue

Music publishers

Contents
Primary Key:	adjustment_type date country_code video_id
Additional fields:	video_title video_duration_sec category channel_id uploader channel_display_name content_type policy owned_views youtube_revenue_split_auction youtube_revenue_split_reserved youtube_revenue_split_partner_sold_youtube_served youtube_revenue_split_partner_sold_partner_served youtube_revenue_split partner_revenue_auction partner_revenue_reserved partner_revenue_partner_sold_youtube_served partner_revenue_partner_sold_partner_served partner_revenue

TV

Contents
Primary Key:	adjustment_type date country_code video_id
Additional fields:	video_title video_duration_sec category channel_id uploader channel_display_name content_type policy owned_views youtube_revenue_split_auction youtube_revenue_split_reserved youtube_revenue_split_partner_sold_youtube_served youtube_revenue_split_partner_sold_partner_served youtube_revenue_split partner_revenue_auction partner_revenue_reserved partner_revenue_partner_sold_youtube_served partner_revenue_partner_sold_partner_served partner_revenue

Aggregate ad revenue per asset

This report summarizes monthly, worldwide ad revenue for assets. Each row in the report includes monthly ad revenue totals for the asset. The report may contain multiple rows per asset if there are revenue adjustments for the asset related to backpay, conflict resolution, etc.

The reportType id for this report is content_owner_asset_ad_revenue_summary_a1.

Movies

Contents
Primary Key:	adjustment_type asset_id
Additional fields:	asset_title asset_labels asset_channel_id asset_type custom_id tms eidr upc season episode_title episode_number director studio owned_views youtube_revenue_split_auction youtube_revenue_split_reserved youtube_revenue_split_partner_sold_youtube_served youtube_revenue_split_partner_sold_partner_served youtube_revenue_split partner_revenue_auction partner_revenue_reserved partner_revenue_partner_sold_youtube_served partner_revenue_partner_sold_partner_served partner_revenue

Music labels

Contents
Primary Key:	adjustment_type asset_id
Additional fields:	asset_title asset_labels asset_channel_id asset_type custom_id isrc upc grid artist album label administer_publish_rights owned_views youtube_revenue_split_auction youtube_revenue_split_reserved youtube_revenue_split_partner_sold_youtube_served youtube_revenue_split_partner_sold_partner_served youtube_revenue_split partner_revenue_auction partner_revenue_reserved partner_revenue_partner_sold_youtube_served partner_revenue_partner_sold_partner_served partner_revenue

Music publishers

Contents
Primary Key:	adjustment_type asset_id
Additional fields:	asset_title asset_labels asset_channel_id asset_type custom_id isrc iswc hfa_song_code writers owned_views youtube_revenue_split_auction youtube_revenue_split_reserved youtube_revenue_split_partner_sold_youtube_served youtube_revenue_split_partner_sold_partner_served youtube_revenue_split partner_revenue_auction partner_revenue_reserved partner_revenue_partner_sold_youtube_served partner_revenue_partner_sold_partner_served partner_revenue

TV

Contents
Primary Key:	adjustment_type asset_id
Additional fields:	asset_title asset_labels asset_channel_id asset_type custom_id tms season episode_title episode_number owned_views youtube_revenue_split_auction youtube_revenue_split_reserved youtube_revenue_split_partner_sold_youtube_served youtube_revenue_split_partner_sold_partner_served youtube_revenue_split partner_revenue_auction partner_revenue_reserved partner_revenue_partner_sold_youtube_served partner_revenue_partner_sold_partner_served partner_revenue

Daily ad revenue per asset

This report summarizes daily ad revenue for assets on a country-by-country basis. Each row in the report specifies the amount of revenue earned by a particular asset on a particular day in a particular country. In addition, the row might represent normal ad revenue earned that day or an adjustment that represents revenue on a previous day.

Adjusted revenue may also have occurred in a previous month to the month associated with the report data. For example, a report posted in November 2016 may contain revenue adjustments from October 2016 or other earlier months.

The reportType id for this report is content_owner_asset_ad_revenue_raw_a1.

Movies

Contents
Primary Key:	adjustment_type date country_code asset_id
Additional fields:	asset_title asset_labels asset_channel_id asset_type custom_id tms eidr upc season episode_title episode_number director studio owned_views youtube_revenue_split_auction youtube_revenue_split_reserved youtube_revenue_split_partner_sold_youtube_served youtube_revenue_split_partner_sold_partner_served youtube_revenue_split partner_revenue_auction partner_revenue_reserved partner_revenue_partner_sold_youtube_served partner_revenue_partner_sold_partner_served partner_revenue

Music labels

Contents
Primary Key:	adjustment_type date country_code asset_id
Additional fields:	asset_title asset_labels asset_channel_id asset_type custom_id isrc upc grid artist album label administer_publish_rights owned_views youtube_revenue_split_auction youtube_revenue_split_reserved youtube_revenue_split_partner_sold_youtube_served youtube_revenue_split_partner_sold_partner_served youtube_revenue_split partner_revenue_auction partner_revenue_reserved partner_revenue_partner_sold_youtube_served partner_revenue_partner_sold_partner_served partner_revenue

Music publishers

Contents
Primary Key:	adjustment_type date country_code asset_id
Additional fields:	asset_title asset_labels asset_channel_id asset_type custom_id isrc iswc hfa_song_code writers owned_views youtube_revenue_split_auction youtube_revenue_split_reserved youtube_revenue_split_partner_sold_youtube_served youtube_revenue_split_partner_sold_partner_served youtube_revenue_split partner_revenue_auction partner_revenue_reserved partner_revenue_partner_sold_youtube_served partner_revenue_partner_sold_partner_served partner_revenue

TV

Contents
Primary Key:	adjustment_type date country_code asset_id
Additional fields:	asset_title asset_labels asset_channel_id asset_type custom_id tms season episode_title episode_number owned_views youtube_revenue_split_auction youtube_revenue_split_reserved youtube_revenue_split_partner_sold_youtube_served youtube_revenue_split_partner_sold_partner_served youtube_revenue_split partner_revenue_auction partner_revenue_reserved partner_revenue_partner_sold_youtube_served partner_revenue_partner_sold_partner_served partner_revenue

Claims

This report identifies videos that you have claimed and the assets that they match. Although the report name does contain the word "revenue," the reports do not currently contain revenue amounts.

The reportType id for this report is content_owner_claim_ad_revenue_summary_a1.

Movies

Contents
Primary Key:	video_id channel_id asset_id
Additional fields:	asset_channel_id custom_id tms eidr upc content_type policy claim_type claim_origin multiple_claims

Music labels

Contents
Primary Key:	video_id channel_id asset_id
Additional fields:	asset_channel_id custom_id isrc upc grid content_type policy claim_type claim_origin multiple_claims

Music publishers

Contents
Primary Key:	video_id channel_id asset_id
Additional fields:	asset_channel_id custom_id isrc iswc hfa_song_code content_type policy claim_type claim_origin multiple_claims music_claim_type composition_right_type ownership_percentage

TV

Contents
Primary Key:	video_id channel_id asset_id
Additional fields:	asset_channel_id custom_id tms content_type policy claim_type claim_origin multiple_claims

Reports for YouTube Primetime Channels

The following reports are available only for YouTube Primetime Channels:

Demographic daily events

This report summarizes demographic daily events. The report may contain multiple rows per video.

The reportType id for this report is demographic_daily_events_a1.

Contents
Primary Key:	Date TmsId
Additional fields:	ContentId PublishDateTime Network CallSign SeriesTitle SeasonNumber ProgramTitle EpisodeNumber ContentLength Platform DeviceType ContentType ProgramType AgeGroup Gender MinutesSinceStart ViewersStart ViewersResume ViewersComplete ConcurrentViewers

Demographic daily summary

This report summarizes daily viewing information for Primetime programming for different demographic groups. Each row in the report specifies viewing statistics for a particular program for a particular demographic group. To ensure the anonymity of YouTube viewers, rows are only included if the views metric meets a certain threshold. The data anonymization section of the API overview explains this principle in more detail.

The reportType id for this report is demographic_daily_summary_a1.

Contents
Primary Key:	Date TmsId
Additional fields:	ContentId PublishDateTime Network CallSign SeriesTitle SeasonNumber ProgramTitle EpisodeNumber ContentLength Platform DeviceType ContentType ProgramType AgeGroup Gender TotalWatchTime AverageViewDuration AverageViewPercent Views PeakConcurrentViewers

Geographic daily events

This report summarizes geographic daily events. The report may contain multiple rows per video.

The reportType id for this report is geographic_daily_events_a1.

Contents
Primary Key:	Date TmsId
Additional fields:	ContentId PublishDateTime Network CallSign SeriesTitle SeasonNumber ProgramTitle EpisodeNumber ContentLength Platform DeviceType ContentType ProgramType DmaId MinutesSinceStart ViewersStart ViewersResume ViewersComplete ConcurrentViewers

Geographic daily summary

This report summarizes daily viewing information for Primetime programming in different geographic regions. Each row in the report specifies viewing statistics for a particular program for a particular region. To ensure the anonymity of YouTube viewers, rows are only included if the views metric meets a certain threshold. The data anonymization section of the API overview explains this principle in more detail.

The reportType id for this report is geographic_daily_summary_a1.

Contents
Primary Key:	Date TmsId
Additional fields:	ContentId PublishDateTime Network CallSign SeriesTitle SeasonNumber ProgramTitle EpisodeNumber ContentLength Platform DeviceType ContentType ProgramType DmaId TotalWatchTime AverageViewDuration AverageViewPercentv Views PeakConcurrentViewers