Join us live on
Discord on the Google Advertising and Measurement Community server and on
YouTube on January 29th at 10:00 AM EST! We will discuss the new features added in v23 of the Google Ads API.
YouTubeChannelInsights
Stay organized with collections
Save and categorize content based on your preferences.
YouTube Channel insights, and its metadata (such as channel name and channel ID), returned for a creator insights response.
codeProto definition
| Fields |
channel_attributes[]
|
AudienceInsightsAttributeMetadata
The attributes associated with the content made by a channel.
|
channel_audience_attributes[]
|
AudienceInsightsAttributeMetadata
The types of audiences and demographics linked to the channel's main audience. Audiences and demographics have a breakdown of subscriber share across dimensions of the same value, such as Age Range, Gender, and User Interest.
|
channel_description
|
string
Description of the channel.
|
channel_metrics
|
YouTubeMetrics
The metrics for a YouTube Channel.
|
channel_type
|
string
Metadata string associated with the type of channel.
|
channel_url
|
string
URL for the channel in the form of https://www.youtube.com/channel/{channel_id}.
|
country_location
|
LocationInfo
The country with which the channel is associated.
|
display_name
|
string
The name of the YouTube Channel.
|
handle
|
string
The unique, short, and user-visible identifier for the channel starting with an "@" symbol (such as "@youtubecreators"). See https://support.google.com/youtube/answer/11585688 for more information.
|
language_distributions[]
|
LanguageDistribution
The languages associated with the content made by a channel.
|
publish_date
|
string
The date that the channel was created. Formatted as "yyyy-mm-dd".
|
relevance_score
|
double
The relevance score of the channel to the topic being searched for weighted by views. The value is between 0 and 1, with 1 being the most relevant. Only populated for trends using search_topics.
|
thumbnail_url
|
string
URL for a 240px by 240px thumbnail image of the channel.
|
top_videos[]
|
AudienceInsightsAttributeMetadata
The top 10 videos for the channel.
|
youtube_channel
|
YouTubeChannelInfo
The YouTube Channel ID.
|
Except as otherwise noted, the content of this page is licensed under the Creative Commons Attribution 4.0 License, and code samples are licensed under the Apache 2.0 License. For details, see the Google Developers Site Policies. Java is a registered trademark of Oracle and/or its affiliates.
Last updated 2026-01-22 UTC.
[[["Easy to understand","easyToUnderstand","thumb-up"],["Solved my problem","solvedMyProblem","thumb-up"],["Other","otherUp","thumb-up"]],[["Missing the information I need","missingTheInformationINeed","thumb-down"],["Too complicated / too many steps","tooComplicatedTooManySteps","thumb-down"],["Out of date","outOfDate","thumb-down"],["Samples / code issue","samplesCodeIssue","thumb-down"],["Other","otherDown","thumb-down"]],["Last updated 2026-01-22 UTC."],[],[]]