YouTube reporting job list and the output of each job

Here’s a list of the common report types available through the YouTube Reporting API, along with a description and a simplified example of the CSV output you’d typically get for each.

Important Note: This is a list of available report types you can create jobs for. It’s not a list of jobs you currently have active. The actual data in your downloaded reports will vary based on your channel’s activity. Reports are generated daily and contain data for a specific 24-hour period (PST).

---

Channel Reports

These reports provide data specifically about your channel’s performance.

1. Basic User Activity (channel_basic_a2)

• Description: Core statistics for your videos, including views, watch time, likes, comments, subscribers gained/lost, etc., aggregated daily per video.
• Example CSV Output:
  date,channel_id,video_id,views,likes,comments,subscribers_gained,subscribers_lost,estimated_minutes_watched,average_view_duration,average_view_percentage,shares
2025-10-23,UCxxxxxxxxx,vid123abc,5021,210,15,22,1,9045,108,30.5,45
2025-10-23,UCxxxxxxxxx,vid456def,3104,150,7,12,0,4502,87,25.1,22
2025-10-23,UCxxxxxxxxx,vid789ghi,1050,35,2,3,0,1100,63,15.0,7

2. User Activity by Province (channel_province_a2)

• Description: Basic user activity metrics (like channel_basic_a2), broken down by the viewer’s geographical province or state (e.g., California, Texas in the US).
• Example CSV Output:
  date,channel_id,video_id,country_code,province_code,views,estimated_minutes_watched
2025-10-23,UCxxxxxxxxx,vid123abc,US,US-CA,1500,3000 2025-10-23,UCxxxxxxxxx,vid123abc,US,US-TX,850,1600
2025-10-23,UCxxxxxxxxx,vid123abc,CA,CA-ON,400,750 2025-10-23,UCxxxxxxxxx,vid456def,US,US-CA,900,1800

3. Playback Location (channel_playback_location_a2)

• Description: Statistics about where videos were played (YouTube watch page, embedded player, mobile devices), including views and watch time.
• Example CSV Output:
  date,channel_id,video_id,playback_location_type,views,estimated_minutes_watched
2025-10-23,UCxxxxxxxxx,vid123abc,EMBEDDED,1250,2300
2025-10-23,UCxxxxxxxxx,vid123abc,YT_WATCH,3500,6500 2
025-10-23,UCxxxxxxxxx,vid456def,YT_WATCH,2800,4000

4. Traffic Source (channel_traffic_source_a2)

• Description: Statistics about how viewers arrived at your videos (e.g., YouTube search, suggested videos, external websites), including views and watch time.
• Example CSV Output:
  date,channel_id,video_id,traffic_source_type,traffic_source_detail,views,estimated_minutes_watched
2025-10-23,UCxxxxxxxxx,vid123abc,SUGGESTED_VIDEO,parentVidIDxyz,1800,3500
2025-10-23,UCxxxxxxxxx,vid123abc,YT_SEARCH,"how to bake bread",1200,2400
2025-10-23,UCxxxxxxxxx,vid123abc,EXT_URL,"google.com",500,900
2025-10-23,UCxxxxxxxxx,vid456def,YT_SEARCH,"easy sourdough",950,1800

5. Device Type and Operating System (channel_device_os_a2)

• Description: Statistics about the types of devices (desktop, mobile, tablet, TV) and operating systems (Windows, macOS, Android, iOS) viewers used.
• Example CSV Output:
  date,channel_id,video_id,device_type,operating_system,views,estimated_minutes_watched
2025-10-23,UCxxxxxxxxx,vid123abc,MOBILE,ANDROID,2500,4800
2025-10-23,UCxxxxxxxxx,vid123abc,DESKTOP,WINDOWS,1500,3000
2025-10-23,UCxxxxxxxxx,vid123abc,TABLET,IOS,500,950
2025-10-23,UCxxxxxxxxx,vid456def,MOBILE,ANDROID,1600,3000

6. Viewer Demographics (channel_demographics_a1)

• Description: Aggregated statistics about the age group and gender of your viewers.
• Example CSV Output:
  date,channel_id,video_id,age_group,gender,views
2025-10-23,UCxxxxxxxxx,vid123abc,age18-24,male,501
2025-10-23,UCxxxxxxxxx,vid123abc,age25-34,male,620
2025-10-23,UCxxxxxxxxx,vid123abc,age18-24,female,450
2025-10-23,UCxxxxxxxxx,vid456def,age25-34,male,400

7. Sharing Service (channel_sharing_service_a1)

• Description: Statistics measuring how often videos are shared via the ‘Share’ button, broken down by the service used (e.g., Facebook, Twitter).
• Example CSV Output:
  date,channel_id,video_id,sharing_service,shares
2025-10-23,UCxxxxxxxxx,vid123abc,FACEBOOK,25
2025-10-23,UCxxxxxxxxx,vid123abc,TWITTER,12
2025-10-23,UCxxxxxxxxx,vid123abc,WHATS_APP,8
2025-10-23,UCxxxxxxxxx,vid456def,FACEBOOK,15

(Note: There are other specialized channel reports like channel_annotations_a1, channel_cards_a1, channel_end_screens_a1, channel_combined_a2, etc., which provide metrics specific to those features.)

---

Content Owner Reports

These reports are available if you manage multiple channels or use YouTube’s Content ID system. They aggregate data across all channels you manage and include revenue/ad performance metrics.

1. Basic User Activity for Content Owner (content_owner_basic_a3)

• Description: Similar to channel_basic_a2, but aggregates data across all channels managed by the content owner.
• Example CSV Output: (Same columns as channel_basic_a2, but channel_id will vary)
  date,channel_id,video_id,claimed_status,uploader_type,country_code,views,likes,comments,subscribers_gained,...
2025-10-23,UCchannel_A,vid123,claimed,self,US,1500,50,5,10,...
2025-10-23,UCchannel_B,vid456,claimed,third_party,GB,800,20,2,3,...

2. Ad Performance (content_owner_ad_performance_a1)

• Description: Reports on ad performance metrics, like estimated revenue, impressions, and CPM, often broken down by ad type.
• Example CSV Output:
  date,channel_id,video_id,country_code,ad_type,estimated_partner_revenue,ad_impressions,estimated_cpm
2025-10-23,UCchannel_A,vid123,US,auction,15.50,18000,1.20
2025-10-23,UCchannel_A,vid123,US,reserved,10.20,5000,2.50
2025-10-23,UCchannel_B,vid456,GB,auction,5.75,9000,0.85

(Note: Many channel report types have content owner equivalents, like content_owner_province_a2, content_owner_playback_location_a2, etc. There are also specific reports for assets, claims, and detailed ad revenue like content_owner_estimated_revenue_a1, content_owner_asset_basic_a2, etc.)

---

To get the exact list available to you and their specific IDs, you would use the reportTypes.list method of the API, as shown in the previous Python script example for creating a job.