{"id":550,"date":"2025-10-26T22:56:04","date_gmt":"2025-10-26T22:56:04","guid":{"rendered":"https:\/\/ykim.synology.me\/wordpress\/?p=550"},"modified":"2025-10-26T23:00:15","modified_gmt":"2025-10-26T23:00:15","slug":"youtube-reporting-job-list-and-the-output-of-each-job","status":"publish","type":"post","link":"https:\/\/ykim.synology.me\/wordpress\/youtube-reporting-job-list-and-the-output-of-each-job-550\/","title":{"rendered":"YouTube reporting job list and the output of each job"},"content":{"rendered":"\n

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.<\/p>\n\n\n\n

Important Note:<\/strong> This is a list of available report types<\/em> you can create jobs for. It’s not a list of jobs you currently<\/em> 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).<\/p>\n\n\n\n

\n\n\n\n

Channel Reports<\/h2>\n\n\n\n

These reports provide data specifically about your channel’s performance.<\/p>\n\n\n\n

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

    2. User Activity by Province (channel_province_a2<\/code>)<\/h3>\n\n\n\n
      \n
    • Description:<\/strong> Basic user activity metrics (like channel_basic_a2<\/code>), broken down by the viewer’s geographical province or state (e.g., California, Texas in the US).<\/li>\n\n\n\n
    • Example CSV Output:<\/strong>
      date,channel_id,video_id,country_code,province_code,views,estimated_minutes_watched <\/code>
      2025-10-23,UCxxxxxxxxx,vid123abc,US,US-CA,1500,3000 2025-10-23,UCxxxxxxxxx,vid123abc,US,US-TX,850,1600 <\/code>
      2025-10-23,UCxxxxxxxxx,vid123abc,CA,CA-ON,400,750 2025-10-23,UCxxxxxxxxx,vid456def,US,US-CA,900,1800<\/code><\/li>\n<\/ul>\n\n\n\n

      3. Playback Location (channel_playback_location_a2<\/code>)<\/h3>\n\n\n\n
        \n
      • Description:<\/strong> Statistics about where videos were played (YouTube watch page, embedded player, mobile devices), including views and watch time.<\/li>\n\n\n\n
      • Example CSV Output:<\/strong>
        date,channel_id,video_id,playback_location_type,views,estimated_minutes_watched <\/code>
        2025-10-23,UCxxxxxxxxx,vid123abc,EMBEDDED,1250,2300 <\/code>
        2025-10-23,UCxxxxxxxxx,vid123abc,YT_WATCH,3500,6500 2<\/code>
        025-10-23,UCxxxxxxxxx,vid456def,YT_WATCH,2800,4000<\/code><\/li>\n<\/ul>\n\n\n\n

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

          5. Device Type and Operating System (channel_device_os_a2<\/code>)<\/h3>\n\n\n\n
            \n
          • Description:<\/strong> Statistics about the types of devices (desktop, mobile, tablet, TV) and operating systems (Windows, macOS, Android, iOS) viewers used.<\/li>\n\n\n\n
          • Example CSV Output:<\/strong>
            date,channel_id,video_id,device_type,operating_system,views,estimated_minutes_watched <\/code>
            2025-10-23,UCxxxxxxxxx,vid123abc,MOBILE,ANDROID,2500,4800 <\/code>
            2025-10-23,UCxxxxxxxxx,vid123abc,DESKTOP,WINDOWS,1500,3000 <\/code>
            2025-10-23,UCxxxxxxxxx,vid123abc,TABLET,IOS,500,950 <\/code>
            2025-10-23,UCxxxxxxxxx,vid456def,MOBILE,ANDROID,1600,3000<\/code><\/li>\n<\/ul>\n\n\n\n

            6. Viewer Demographics (channel_demographics_a1<\/code>)<\/h3>\n\n\n\n
              \n
            • Description:<\/strong> Aggregated statistics about the age group and gender of your viewers.<\/li>\n\n\n\n
            • Example CSV Output:<\/strong>
              date,channel_id,video_id,age_group,gender,views <\/code>
              2025-10-23,UCxxxxxxxxx,vid123abc,age18-24,male,501 <\/code>
              2025-10-23,UCxxxxxxxxx,vid123abc,age25-34,male,620 <\/code>
              2025-10-23,UCxxxxxxxxx,vid123abc,age18-24,female,450 <\/code>
              2025-10-23,UCxxxxxxxxx,vid456def,age25-34,male,400<\/code><\/li>\n<\/ul>\n\n\n\n

              7. Sharing Service (channel_sharing_service_a1<\/code>)<\/h3>\n\n\n\n
                \n
              • Description:<\/strong> Statistics measuring how often videos are shared via the ‘Share’ button, broken down by the service used (e.g., Facebook, Twitter).<\/li>\n\n\n\n
              • Example CSV Output:<\/strong>
                date,channel_id,video_id,sharing_service,shares <\/code>
                2025-10-23,UCxxxxxxxxx,vid123abc,FACEBOOK,25 <\/code>
                2025-10-23,UCxxxxxxxxx,vid123abc,TWITTER,12 <\/code>
                2025-10-23,UCxxxxxxxxx,vid123abc,WHATS_APP,8 <\/code>
                2025-10-23,UCxxxxxxxxx,vid456def,FACEBOOK,15<\/code><\/li>\n<\/ul>\n\n\n\n

                (Note: There are other specialized channel reports like channel_annotations_a1<\/code>, channel_cards_a1<\/code>, channel_end_screens_a1<\/code>, channel_combined_a2<\/code>, etc., which provide metrics specific to those features.)<\/em><\/p>\n\n\n\n

                \n\n\n\n

                Content Owner Reports<\/h2>\n\n\n\n

                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.<\/p>\n\n\n\n

                1. Basic User Activity for Content Owner (content_owner_basic_a3<\/code>)<\/h3>\n\n\n\n
                  \n
                • Description:<\/strong> Similar to channel_basic_a2<\/code>, but aggregates data across all channels managed by the content owner.<\/li>\n\n\n\n
                • Example CSV Output:<\/strong> (Same columns as channel_basic_a2<\/code>, but channel_id<\/code> will vary)
                  date,channel_id,video_id,claimed_status,uploader_type,country_code,views,likes,comments,subscribers_gained,... <\/code>
                  2025-10-23,UCchannel_A,vid123,claimed,self,US,1500,50,5,10,... <\/code>
                  2025-10-23,UCchannel_B,vid456,claimed,third_party,GB,800,20,2,3,...<\/code><\/li>\n<\/ul>\n\n\n\n

                  2. Ad Performance (content_owner_ad_performance_a1<\/code>)<\/h3>\n\n\n\n
                    \n
                  • Description:<\/strong> Reports on ad performance metrics, like estimated revenue, impressions, and CPM, often broken down by ad type.<\/li>\n\n\n\n
                  • Example CSV Output:<\/strong>
                    date,channel_id,video_id,country_code,ad_type,estimated_partner_revenue,ad_impressions,estimated_cpm <\/code>
                    2025-10-23,UCchannel_A,vid123,US,auction,15.50,18000,1.20 <\/code>
                    2025-10-23,UCchannel_A,vid123,US,reserved,10.20,5000,2.50 <\/code>
                    2025-10-23,UCchannel_B,vid456,GB,auction,5.75,9000,0.85<\/code><\/li>\n<\/ul>\n\n\n\n

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

                    \n\n\n\n

                    To get the exact list available to you<\/em> and their specific IDs, you would use the reportTypes.list<\/code> method of the API, as shown in the previous Python script example for creating a job.<\/p>\n

                    <\/div>
                    <\/div>","protected":false},"excerpt":{"rendered":"

                    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…<\/p>\n","protected":false},"author":1,"featured_media":0,"comment_status":"open","ping_status":"open","sticky":false,"template":"","format":"standard","meta":{"_bbp_topic_count":0,"_bbp_reply_count":0,"_bbp_total_topic_count":0,"_bbp_total_reply_count":0,"_bbp_voice_count":0,"_bbp_anonymous_reply_count":0,"_bbp_topic_count_hidden":0,"_bbp_reply_count_hidden":0,"_bbp_forum_subforum_count":0,"_kadence_starter_templates_imported_post":false,"_kad_post_transparent":"","_kad_post_title":"","_kad_post_layout":"","_kad_post_sidebar_id":"","_kad_post_content_style":"","_kad_post_vertical_padding":"","_kad_post_feature":"","_kad_post_feature_position":"","_kad_post_header":false,"_kad_post_footer":false,"_kad_post_classname":"","yasr_overall_rating":0,"yasr_post_is_review":"","yasr_auto_insert_disabled":"","yasr_review_type":"","fifu_image_url":"","fifu_image_alt":"","iawp_total_views":0,"footnotes":""},"categories":[55],"tags":[],"class_list":["post-550","post","type-post","status-publish","format-standard","hentry","category-application-slug"],"yasr_visitor_votes":{"stars_attributes":{"read_only":false,"span_bottom":false},"number_of_votes":0,"sum_votes":0},"jetpack_featured_media_url":"","_links":{"self":[{"href":"https:\/\/ykim.synology.me\/wordpress\/wp-json\/wp\/v2\/posts\/550","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/ykim.synology.me\/wordpress\/wp-json\/wp\/v2\/posts"}],"about":[{"href":"https:\/\/ykim.synology.me\/wordpress\/wp-json\/wp\/v2\/types\/post"}],"author":[{"embeddable":true,"href":"https:\/\/ykim.synology.me\/wordpress\/wp-json\/wp\/v2\/users\/1"}],"replies":[{"embeddable":true,"href":"https:\/\/ykim.synology.me\/wordpress\/wp-json\/wp\/v2\/comments?post=550"}],"version-history":[{"count":3,"href":"https:\/\/ykim.synology.me\/wordpress\/wp-json\/wp\/v2\/posts\/550\/revisions"}],"predecessor-version":[{"id":555,"href":"https:\/\/ykim.synology.me\/wordpress\/wp-json\/wp\/v2\/posts\/550\/revisions\/555"}],"wp:attachment":[{"href":"https:\/\/ykim.synology.me\/wordpress\/wp-json\/wp\/v2\/media?parent=550"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/ykim.synology.me\/wordpress\/wp-json\/wp\/v2\/categories?post=550"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/ykim.synology.me\/wordpress\/wp-json\/wp\/v2\/tags?post=550"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}