Channels
Columns
Name
Type
Dimension
DefaultMetric
DefaultDimension
Description
Id [KEY]
String
The Id that YouTube uses to uniquely identify the channel.
Title
String
The title of the channel.
Description
String
The description of the channel. The value of the column has a maximum length of 1000 characters.
CustomUrl
String
The channel's custom URL.
PublishedAt
Datetime
The date and time that the channel was created. The value is specified in ISO 8601 (YYYY-MM-DDThh:mm:ss.sZ) format.
ThumbnailsDefaultUrl
String
The URL of the default image thumbnail.
DefaultLanguage
String
This column is confidential to trusted testers.
LiveBroadcastContent
String
An indication of whether a video or channel resource has live broadcast content.
LocalizedTitle
String
This column is confidential to trusted testers. The localized video title.
LocalizedDescription
String
This column is confidential to trusted testers. The localized video description.
Country
String
The country with which the channel is associated.
ViewCount
Long
The number of times the channel has been viewed.
SubscriberCount
Long
The number of subscribers that the channel has. This value is rounded down to three significant figures.
HiddenSubscriberCount
Boolean
Indicates whether the subscriber count of the channel is publicly visible.
VideoCount
Long
The number of videos uploaded to the channel.
RelatedPlaylistsLikes
String
The Id of the playlist that contains the liked videos of the channel.
RelatedPlaylistsUploads
String
The Id of the playlist that contains the uploaded videos of the channel.
PrivacyStatus
String
Privacy status of the channel. Valid values for this column: private, public, unlisted.
IsLinked
Boolean
Indicates whether the channel data identifies a user who is already linked to either a YouTube username or a Google+ account. A user who has one of these links already has a public YouTube identity, which is a prerequisite for several actions, such as uploading videos.
LongUploadsStatus
String
Indicates whether the channel is eligible to upload videos that are more than 15 minutes long. This column is only returned if the channel owner authorized the API request. See the YouTube Help Center for more information about this feature.
MadeForKids
Boolean
This value indicates whether the channel is designated as child-directed, and it contains the current 'made for kids' status of the channel.
Keywords
String
Keywords associated with your channel. The value is a space-separated list of strings.
TrackingAnalyticsAccountId
String
The Id for a Google Analytics account that you want to use to track and measure traffic to your channel.
ModerateComments
Boolean
This setting determines whether user-submitted comments left on the channel page need to be approved by the channel owner to be publicly visible. The default value is false.
SearchTerms
String
The SearchTerms parameter specifies the query term to search for.
Pseudo-Columns
Name
Type
Description
ForUsername
String
The username associated with the channel.
Language
String
Retrieve localized resource metadata for a specific application language that the YouTube website supports.
Language
String
Retrieve localized resource metadata for a specific application language that the YouTube website supports.
ManagedByMe
String
This parameter is intended exclusively for YouTube content partners. Set this parameter's value to true to instruct the API to only return channels managed by the content owner that the onBehalfOfContentOwner parameter specifies. The user must be authenticated as a CMS account linked to the specified content owner and onBehalfOfContentOwner must be provided.
OnBehalfOfContentOwner
String
This parameter is intended exclusively for YouTube content partners. The onBehalfOfContentOwner parameter indicates that the request's authorization credentials identify a YouTube CMS user who is acting on behalf of the content owner specified in the parameter value. This parameter is intended for YouTube content partners that own and manage many different YouTube channels. It allows content owners to authenticate once and get access to all their video and channel data, without having to provide authentication credentials for each individual channel. The CMS account that the user authenticates with must be linked to the specified YouTube content owner.
ChannelId
String
The Id that YouTube uses to uniquely identify a channel.
Region
String
The country associated with the channel.
SafeSearch
String
Indicates whether the search results should include restricted content as well as standard content. Acceptable values: moderate, none, or strict.
Rating
String
Resources are sorted from highest to lowest rating.
Relevance
String
Resources are sorted based on their relevance to the search query. This is the default value for this parameter.
Last updated