YouTube Public Data fields

  • Updated on Oct 6, 2025
  • Published on Aug 5, 2025
Prev Next

Supermetrics brings all your YouTube Public Data data into Google Sheets, Looker Studio, Power BI, Excel, BigQuery, Snowflake, Redshift, Azure

9 metrics106 dimensions

BRANDING

channels__keywords
Field label Keywords
Description The keywords associated with your channel
Field type dimension
Data type string.text.value
channels__moderate_comments
Field label Moderate comments
Description This setting determines whether user-submitted comments left on the channel page need to be approved by the channel owner to be publicly visible
Field type dimension
Data type bool
channels__banner_image_location
Field label Banner image location
Description This property specifies the location of the banner image that YouTube uses to generate the various banner image sizes for a channel
Field type dimension
Data type string.text.url

CHANNEL

channels__channel_name
Field label Channel name
Description The name of the channel
Field type dimension
Data type string.text.value
channels__channel_id
Field label Channel ID
Description The ID of the channel
Field type dimension
Data type string.text.value
channels__description
Field label Description
Description The description of the channel
Field type dimension
Data type string.text.value
channels__custom_url
Field label Custom URL
Description The custom URL of the channel
Field type dimension
Data type string.text.url
channels__thumbnail_url
Field label Thumbnail URL (default)
Description Link to a default thumbnail image of the video
Field type dimension
Data type string.text.url
channels__thumbnail_url_medium
Field label Thumbnail URL (medium)
Description Link to a higher resolution version of the video's image
Field type dimension
Data type string.text.url
channels__thumbnail_url_high
Field label Thumbnail URL (high)
Description Link to a high resolution version of the video's image
Field type dimension
Data type string.text.url
channels__default_language
Field label Default language
Description The language of the text in the channel's title & description
Field type dimension
Data type string.text.value
channels__localized_title
Field label Localized title
Description The localized title of the channel
Field type dimension
Data type string.text.value
channels__localized_description
Field label Localized description
Description The localized description of the channel
Field type dimension
Data type string.text.value
channels__country
Field label Country
Description The country with which the channel is associated
Field type dimension
Data type string.geo.country.twolettercode
channels__publish_datetime
Field label Publish datetime
Description The date and time that the channel was created
Field type dimension
Data type string.time.datetime
channels__publish_date
Field label Publish date
Description The date that the channel was created
Field type dimension
Data type string.time.date
channel__channel_name
Field label Channel name
Description The name of the YouTube channel
Field type dimension
Data type string.text.value
channel__channel_id
Field label Channel ID
Description The ID of the YouTube channel
Field type dimension
Data type string.text.value
channel__channel_description
Field label Channel description
Description The description of the YouTube channel
Field type dimension
Data type string.text.value
channels__views
Field label Views
Description The number of times the channel has been viewed
Field type metric
Data type int.number.value
channels__subscribers
Field label Subscribers
Description The number of subscribers that the channel has. This value is rounded down to three significant figures
Field type metric
Data type int.number.value
channels__video_count
Field label Video count
Description The number of public videos uploaded to the channel. Note that the value reflects the count of the channel's public videos only, even to owners. This behavior is consistent with counts shown on the YouTube website
Field type metric
Data type int.number.value

CONTENT

channel__videos__details__duration
Field label Duration
Description The length of the video represented in an ISO 8601 format; PT#H#M#S
Field type dimension
Data type string.text.value
channel__videos__details__dimension
Field label Dimension
Description Indicates whether the video is available in 3D or in 2D
Field type dimension
Data type string.text.value
channel__videos__details__definition
Field label Definition
Description Indicates whether the video is available in HD or in standard definition
Field type dimension
Data type string.text.value
channel__videos__details__caption
Field label Caption
Description Indicates whether captions are available for the video
Field type dimension
Data type bool
channel__videos__details__licensed_content
Field label Licensed content
Description Indicates whether the video represents licensed content, which means that the content was uploaded to a channel linked to a YouTube content partner and then claimed by that partner
Field type dimension
Data type bool
channel__videos__details__region_restriction_allowed
Field label Region restriction allowed
Description A list of region codes that identify countries where the video is viewable
Field type dimension
Data type string.text.value
channel__videos__details__region_restriction_blocked
Field label Region restriction blocked
Description A list of region codes that identify countries where the video is blocked
Field type dimension
Data type string.text.value
channel__videos__details__cbfc_rating
Field label CBFC rating
Description The video's Central Board of Film Certification (CBFC - India) rating
Field type dimension
Data type string.text.value
channel__videos__details__yt_rating
Field label YT rating
Description A rating that YouTube uses to identify age-restricted content
Field type dimension
Data type string.text.value
channel__videos__details__projection
Field label Projection
Description Specifies the projection format of the video
Field type dimension
Data type string.text.value
video__duration
Field label Duration
Description The length of the video represented in an ISO 8601 format; PT#H#M#S
Field type dimension
Data type string.text.value
video__dimension
Field label Dimension
Description Indicates whether the video is available in 3D or in 2D
Field type dimension
Data type string.text.value
video__definition
Field label Definition
Description Indicates whether the video is available in HD or in standard definition
Field type dimension
Data type string.text.value
video__caption
Field label Caption
Description Indicates whether captions are available for the video
Field type dimension
Data type bool
video__licensed_content
Field label Licensed content
Description Indicates whether the video represents licensed content, which means that the content was uploaded to a channel linked to a YouTube content partner and then claimed by that partner
Field type dimension
Data type bool
video__region_restriction_allowed
Field label Region restriction allowed
Description A list of region codes that identify countries where the video is viewable
Field type dimension
Data type string.text.value
video__region_restriction_blocked
Field label Region restriction blocked
Description A list of region codes that identify countries where the video is blocked
Field type dimension
Data type string.text.value
video__cbfc_rating
Field label CBFC rating
Description The video's Central Board of Film Certification (CBFC - India) rating
Field type dimension
Data type string.text.value
video__yt_rating
Field label YT rating
Description A rating that YouTube uses to identify age-restricted content
Field type dimension
Data type string.text.value
video__projection
Field label Projection
Description Specifies the projection format of the video
Field type dimension
Data type string.text.value

CONTENT OWNER

channels__content_owner_id
Field label Content owner ID
Description The ID of the content owner linked to the channel
Field type dimension
Data type string.text.value
channels__content_owner_link_datetime
Field label Content owner link datetime
Description The date and time of when the channel was linked to the content owner
Field type dimension
Data type string.time.datetime
channels__content_owner_link_date
Field label Content owner link date
Description The date of when the channel was linked to the content owner
Field type dimension
Data type string.time.date

DATASOURCE

dataSourceName
Field label Data source
Description The name of the source for this data, as listed on supermetrics.com/docs
Field type dimension
Data type string.text.value
Destinations API, Data warehouse
system_metadata.data_source_logins
Field label Data source logins
Description The data source login accounts that were used to authenticate against the data source
Field type dimension
Data type string.text.json
system_metadata.data_source_login_owners
Field label Data source login owners
Description The Supermetrics users that created the data source login connections
Field type dimension
Data type string.text.json

LIVESTREAMING

channel__videos__details__livestreaming_start_datetime
Field label Livestreaming start datetime
Description The date & time that the broadcast actually started
Field type dimension
Data type string.time.datetime
channel__videos__details__livestreaming_start_date
Field label Livestreaming start date
Description The date that the broadcast actually started
Field type dimension
Data type string.time.date
channel__videos__details__livestreaming_end_datetime
Field label Livestreaming end datetime
Description The date & time that the broadcast actually ended
Field type dimension
Data type string.time.datetime
channel__videos__details__livestreaming_end_date
Field label Livestreaming end date
Description The date that the broadcast actually ended
Field type dimension
Data type string.time.date
video__livestreaming_start_datetime
Field label Livestreaming start datetime
Description The date & time that the broadcast actually started
Field type dimension
Data type string.time.datetime
video__livestreaming_start_date
Field label Livestreaming start date
Description The date that the broadcast actually started
Field type dimension
Data type string.time.date
video__livestreaming_end_datetime
Field label Livestreaming end datetime
Description The date & time that the broadcast actually ended
Field type dimension
Data type string.time.datetime
video__livestreaming_end_date
Field label Livestreaming end date
Description The date that the broadcast actually ended
Field type dimension
Data type string.time.date

OTHER

channels__upload_playlist
Field label Upload playlist ID
Description The ID of the playlist that contains the channel's uploaded videos
Field type dimension
Data type string.text.value
channels__topic_categories
Field label Topic categories
Description A list of Wikipedia URLs that describe the channel's content
Field type dimension
Data type string.text.value
channels__hidden_subscribers
Field label Hidden subscribers
Description Indicates whether the channel's subscriber count is publicly visible
Field type dimension
Data type bool
channel__videos__details__topic_categories
Field label Topic categories
Description A list of Wikipedia URLs that provide a high-level description of the video's content
Field type dimension
Data type string.text.value
channel__videos__details__tag_suggestions
Field label Tag suggestions
Description A list of keyword tags that could be added to the video's metadata to increase the likelihood that users will locate your video when searching or browsing on YouTube
Field type dimension
Data type string.text.value
video__topic_categories
Field label Topic categories
Description A list of Wikipedia URLs that provide a high-level description of the video's content
Field type dimension
Data type string.text.value
video__tag_suggestions
Field label Tag suggestions
Description A list of keyword tags that could be added to the video's metadata to increase the likelihood that users will locate your video when searching or browsing on YouTube
Field type dimension
Data type string.text.value

QUERY

system_metadata.query_date_range_start
Field label Start date
Description The start date of the requested query
Field type dimension
Data type string.time.date
system_metadata.query_date_range_end
Field label End date
Description The end date of the requested query
Field type dimension
Data type string.time.date
system_metadata.query_timezone
Field label Timezone
Description The timezone that is supplied to the query
Field type dimension
Data type string.time.timezone
system_metadata.query_filters
Field label Filters
Description All filters used in the query
Field type dimension
Data type string.text.json
system_metadata.query_date_start
Field label Start
Description When the query was started
Field type dimension
Data type string.time.datetime
system_metadata.query_date_end
Field label End
Description When the query completed
Field type dimension
Data type string.time.datetime
system_metadata.query_duration
Field label Duration
Description The duration in seconds of the query
Field type dimension
Data type int.duration.seconds
system_metadata.query_accounts
Field label Accounts
Description A list of accounts of which the data was pulled from
Field type dimension
Data type string.text.json

STATUS

channels__privacy_status
Field label Privacy status
Description The privacy status of the channel
Field type dimension
Data type string.text.value
channels__is_linked
Field label Is linked
Description Indicates whether the channel data identifies a user that is already linked to either a YouTube username or a Google+ account
Field type dimension
Data type bool
channels__made_for_kids
Field label Made for kids
Description This value indicates whether the channel is designated as child-directed, and it contains the current "made for kids" status of the channel
Field type dimension
Data type string.text.value
channel__videos__details__made_for_kids
Field label Made for kids
Description This value indicates whether the video is designated as child-directed, and it contains the current "made for kids" status of the video
Field type dimension
Data type bool
channel__videos__details__self_declared_made_for_kids
Field label Self declared made for kids
Description This value indicates whether the video is designated as child-directed, and it contains the current "made for kids" status of the video
Field type dimension
Data type bool
video__made_for_kids
Field label Made for kids
Description This value indicates whether the video is designated as child-directed, and it contains the current "made for kids" status of the video
Field type dimension
Data type bool
video__self_declared_made_for_kids
Field label Self declared made for kids
Description This value indicates whether the video is designated as child-directed, and it contains the current "made for kids" status of the video
Field type dimension
Data type bool

TIME

today
Field label Today
Description Today's date, e.g. 2017-01-31
Field type dimension
Data type string.time.date
Destinations API, Data warehouse
channels__date
Field label Date
Description A date field for today
Field type dimension
Data type string.time.date
Destinations Google Sheets
channel__date
Field label Date
Description A date field for today
Field type dimension
Data type string.time.date
Destinations Google Sheets

VIDEO

channel__videos__video_id
Field label Video ID
Description The ID of the video
Field type dimension
Data type string.text.value
channel__videos__publish_datetime
Field label Publish datetime
Description The date and time that the video was published
Field type dimension
Data type string.time.datetime
channel__videos__publish_date
Field label Publish date
Description The date that the video was published
Field type dimension
Data type string.time.date
channel__videos__details__video_title
Field label Video title
Description The title of the video
Field type dimension
Data type string.text.value
channel__videos__details__description
Field label Description
Description The description of the video
Field type dimension
Data type string.text.value
channel__videos__details__thumbnail_url
Field label Thumbnail URL (default)
Description Link to a default thumbnail image of the video
Field type dimension
Data type string.text.url
channel__videos__details__thumbnail_url_medium
Field label Thumbnail URL (medium)
Description Link to a higher resolution version of the video's image
Field type dimension
Data type string.text.url
channel__videos__details__thumbnail_url_high
Field label Thumbnail URL (high)
Description Link to a high resolution version of the video's image
Field type dimension
Data type string.text.url
channel__videos__details__tags
Field label Tags
Description A list of keyword tags associated with the video
Field type dimension
Data type string.text.value
channel__videos__details__category_id
Field label Category ID
Description The video category associated with the video
Field type dimension
Data type string.text.value
channel__videos__details__live_broadcast_content
Field label Live broadcast content
Description Indicates if the video is an upcoming or active live broadcast or neither
Field type dimension
Data type string.text.value
channel__videos__details__default_language
Field label Default language
Description The language of the text in the video's resources
Field type dimension
Data type string.text.value
channel__videos__details__localized_title
Field label Localized title
Description The localized title of the video
Field type dimension
Data type string.text.value
channel__videos__details__localized_description
Field label Localized description
Description The localized description of the video
Field type dimension
Data type string.text.value
video__video_title
Field label Video title
Description The title of the video
Field type dimension
Data type string.text.value
video__video_id
Field label Video ID
Description The ID of the video
Field type dimension
Data type string.text.value
video__description
Field label Description
Description The description of the video
Field type dimension
Data type string.text.value
video__thumbnail_url
Field label Thumbnail URL (default)
Description Link to a default thumbnail image of the video
Field type dimension
Data type string.text.url
video__thumbnail_url_medium
Field label Thumbnail URL (medium)
Description Link to a higher resolution version of the video's image
Field type dimension
Data type string.text.url
video__thumbnail_url_high
Field label Thumbnail URL (high)
Description Link to a high resolution version of the video's image
Field type dimension
Data type string.text.url
video__tags
Field label Tags
Description A list of keyword tags associated with the video
Field type dimension
Data type string.text.value
video__category_id
Field label Category ID
Description The video category associated with the video
Field type dimension
Data type string.text.value
video__live_broadcast_content
Field label Live broadcast content
Description Indicates if the video is an upcoming or active live broadcast or neither
Field type dimension
Data type string.text.value
video__default_language
Field label Default language
Description The language of the text in the video's resources
Field type dimension
Data type string.text.value
video__localized_title
Field label Localized title
Description The localized title of the video
Field type dimension
Data type string.text.value
video__localized_description
Field label Localized description
Description The localized description of the video
Field type dimension
Data type string.text.value
video__publish_datetime
Field label Publish datetime
Description The date and time that the video was published
Field type dimension
Data type string.time.datetime
video__publish_date
Field label Publish date
Description The date that the video was published
Field type dimension
Data type string.time.date
channel__videos__details__views
Field label Views
Description The number of times the video has been viewed
Field type metric
Data type int.number.value
channel__videos__details__likes
Field label Likes
Description The number of users who have indicated that they liked the video
Field type metric
Data type int.number.value
channel__videos__details__comments
Field label Comments
Description The number of comments for the video
Field type metric
Data type int.number.value
video__views
Field label Views
Description The number of times the video has been viewed
Field type metric
Data type int.number.value
video__likes
Field label Likes
Description The number of users who have indicated that they liked the video
Field type metric
Data type int.number.value
video__comments
Field label Comments
Description The number of comments for the video
Field type metric
Data type int.number.value