YouTube Public Data metrics and dimensions

9 metrics107 dimensions

Search fields

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

system_metadata.query_excluded_accounts

Field label	Excluded invalid accounts
Description	A list of unavailable accounts excluded from the query due to the "Exclude invalid accounts" setting
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

Documentation Index