YouTube Analytics fields

Every YouTube Analytics field, documented

All 84 metrics and dimensions you can pull into Data Studio and into Claude, ChatGPT or Gemini with the Data Bloo connector, grouped, searchable, and free to use.

Available in

40Metrics

44Dimensions

8Categories

84 fields

All fields84 Metrics40 Dimensions44

Views & watch time

7 fields

FieldDescriptionType

Video viewsviewsTotal views of your videos.~~Metric~~

Engaged viewsengaged_viewsViews that met YouTube engagement thresholds.~~Metric~~

Estimated minutes watchedestimated_minutes_watchedTotal minutes viewers spent watching.~~Metric~~

Average view duration (sec)average_view_durationAverage seconds watched per view.~~Metric~~

Average view duration percentageaverage_view_percentageShare of each video watched on average.~~Metric~~

Audience watch ratioaudience_watch_ratioRetention curve across the video, needs a single video filter.~~Metric~~

Relative retention performancerelative_retention_performanceRetention against similar YouTube videos.~~Metric~~

Engagement

9 fields

FieldDescriptionType

LikeslikesLikes across your videos.~~Metric~~

DislikesdislikesDislikes across your videos.~~Metric~~

CommentscommentsComments left on your videos.~~Metric~~

SharessharesTimes viewers shared your videos.~~Metric~~

Gained subscriberssubscribers_gainedSubscribers added over the period.~~Metric~~

Lost subscriberssubscribers_lostSubscribers lost over the period.~~Metric~~

Videos added to playlistvideos_added_to_playlistsTimes a video was saved to a playlist.~~Metric~~

Videos removed from playlistvideos_removed_from_playlistsTimes a video was removed from a playlist.~~Metric~~

Viewer percentageviewer_percentageShare of views by demographic, pairs with age and gender.~~Metric~~

Channel totals

13 fields

FieldDescriptionType

Channel total page viewschannel_viewsAll-time views on the channel.~~Metric~~

Channel total subscriberschannel_subscribersCurrent subscriber count.~~Metric~~

Channel total video countchannel_videosNumber of videos published.~~Metric~~

Channel IDchannelUnique id of the channel.~~Dimension~~

Channel namechannel_titleDisplay name of the channel.~~Dimension~~

Channel URLchannel_urlLink to the channel page.~~Dimension~~

Channel custom URLchannel_custom_urlThe channel handle or vanity URL.~~Dimension~~

Channel descriptionchannel_descriptionAbout text on the channel.~~Dimension~~

Channel created datechannel_published_atWhen the channel was created.~~Dimension~~

Channel thumbnailchannel_thumbnailChannel avatar rendered as an image.~~Dimension~~

Channel thumbnail URLchannel_thumbnail_urlDirect link to the channel avatar.~~Dimension~~

Channel countrychannel_countryCountry set on the channel.~~Dimension~~

Channel hidden subscriberschannel_hidden_subscribersWhether the subscriber count is hidden.~~Dimension~~

Videos

20 fields

FieldDescriptionType

Video titlevideo_titleTitle of the video.~~Dimension~~

Video IDvideoUnique id of the video.~~Dimension~~

Video URLvideo_urlWatch link for the video.~~Dimension~~

Video thumbnailvideo_thumbnailVideo thumbnail rendered as an image.~~Dimension~~

Video thumbnail URLvideo_thumbnail_urlDirect link to the thumbnail file.~~Dimension~~

Video descriptionvideo_descriptionDescription text on the video.~~Dimension~~

Video tagsvideo_tagsTags applied to the video.~~Dimension~~

Video lengthvideo_lengthDuration of the video.~~Dimension~~

Published datevideo_published_dateThe day the video went live.~~Dimension~~

Published timevideo_published_atExact timestamp the video went live.~~Dimension~~

Video visibility statusvideo_privacy_statusPublic, unlisted or private.~~Dimension~~

Video upload statusvideo_upload_statusWhether processing finished successfully.~~Dimension~~

Video failure reasonvideo_failure_reasonWhy an upload failed, when it did.~~Dimension~~

Video rejection reasonvideo_rejection_reasonWhy YouTube rejected the video, when it did.~~Dimension~~

Video embeddabilityvideo_embeddableWhether the video can be embedded elsewhere.~~Dimension~~

Video public stats viewablevideo_public_stats_viewableWhether view counts are shown publicly.~~Dimension~~

Video made for kidsvideo_made_for_kidsWhether the video is flagged as made for kids.~~Dimension~~

Creator content typecreator_content_typeShort, live stream or standard video.~~Dimension~~

Live broadcast contentlive_broadcast_contentWhether the video is live, upcoming or none.~~Dimension~~

Live or on-demandlive_or_on_demandWhether views came from a live stream or replay.~~Dimension~~

Audience & devices

9 fields

FieldDescriptionType

CountrycountryCountry the viewer watched from.~~Dimension~~

US StateprovinceState within the United States.~~Dimension~~

Age groupage_groupViewer age bracket, pairs with viewer percentage.~~Dimension~~

GendergenderViewer gender, pairs with viewer percentage.~~Dimension~~

Device typedevice_typeMobile, desktop, tablet or TV.~~Dimension~~

Operating systemoperating_systemOperating system of the viewing device.~~Dimension~~

YouTube productyoutube_productWhich YouTube surface the view came from.~~Dimension~~

Traffic source typeinsight_traffic_source_typeHow viewers found the video.~~Dimension~~

Elapsed video time ratioelapsed_video_time_ratioPosition in the video, for retention curves.~~Dimension~~

Revenue & ads

9 fields

FieldDescriptionType

Estimated revenueestimated_revenueEstimated net earnings from the channel.~~Metric~~

Gross revenuegross_revenueEarnings before YouTube takes its share.~~Metric~~

CPMcpmCost per thousand ad impressions.~~Metric~~

Playback based CPMplayback_based_cpmRevenue per thousand monetised playbacks.~~Metric~~

Ad impressionsad_impressionsAds served against your videos.~~Metric~~

Monetized playbacksmonetized_playbacksPlaybacks that showed at least one ad.~~Metric~~

YouTube Premium viewsred_viewsViews from YouTube Premium members.~~Metric~~

Estimated YouTube Premium minutes watchedestimated_red_minutes_watchedMinutes watched by Premium members.~~Metric~~

Ad typead_typeThe ad format that served.~~Dimension~~

Cards & annotations

13 fields

FieldDescriptionType

Card impressionscard_impressionsTimes a card was shown.~~Metric~~

Card clickscard_clicksClicks on cards.~~Metric~~

Card click ratecard_click_rateCard clicks divided by impressions.~~Metric~~

Card teaser impressionscard_teaser_impressionsTimes a card teaser appeared.~~Metric~~

Card teaser clickscard_teaser_clicksClicks on card teasers.~~Metric~~

Card teaser click ratecard_teaser_click_rateTeaser clicks divided by impressions.~~Metric~~

Annotation impressionsannotation_impressionsTimes an annotation was shown.~~Metric~~

Annotation clickable impressionsannotation_clickable_impressionsAnnotation views that could be clicked.~~Metric~~

Annotation clicksannotation_clicksClicks on annotations.~~Metric~~

Annotation click through rateannotation_click_through_rateAnnotation clicks divided by impressions.~~Metric~~

Annotation closable impressionsannotation_closable_impressionsAnnotation views that could be dismissed.~~Metric~~

Annotation closesannotation_closesTimes viewers dismissed an annotation.~~Metric~~

Annotation close rateannotation_close_rateCloses divided by closable impressions.~~Metric~~

Time & dates

4 fields

FieldDescriptionType

DatedateThe day the activity happened.~~Dimension~~

WeekweekThe ISO week of the activity.~~Dimension~~

MonthmonthThe month of the activity.~~Dimension~~

YearyearThe year of the activity.~~Dimension~~

No fields match your search

Try a broader term like "views", "watched", or "revenue".

Missing a field you need?

Tell us which metric or dimension you're after and we'll look at adding it to the connector.

Request a field

Ready to pull these into your report?

Connect YouTube Analytics free and send every field above to Data Studio, Claude, ChatGPT or Gemini.

+ Connect for free