Discover and fetch insights about YouTube creators with the creator insights feature. This can be useful for agencies and advertisers who want to find creators who are relevant to their target audience.
The API has two main functions:
- Creator Discoverability: Find the top creators for a given set of topics, demographics, and audiences.
- Creator Insights: Fetch insights about specific YouTube channels, such as their subscriber count, view count, and audience demographics.
Eligibility requirements
ContentCreatorInsightsService.GenerateCreatorInsights
is a private component of the Google Ads API offered with a non-exclusive, royalty-free
data license. Signed partners can use the standard
Google Ads client libraries to explore YouTube creators and
content. To be eligible, partners must satisfy the following conditions:
- Have a planning tool or user interface that will integrate the API.
- Use the API to explore YouTube content and creators for potential advertising opportunities.
- Complete a pre-screen assessment to ensure eligibility.
- Follow data usage requirements and be willing to undergo periodic data audits.
- Sign a data-licensing agreement that legally enforces data usage requirements.
- Accept the Google Ads API terms of service.
Contact your Google representative for more information.
Generate creator insights
To generate creator insights, send a request to the
ContentCreatorInsightsService.GenerateCreatorInsights
method. This method has a limit of 5 queries per second (QPS) and takes two
types of input depending on if you want to do creator discoverability or get
creator insights.
- Creator Discoverability: Provide a list of audience attributes, such as age, gender, and interests. The API returns a list of creators whose audiences match those attributes.
- Creator Insights: Provide a list of YouTube channel IDs. The API returns insights about those specific channels.
The generateCreatorInsights method returns a GenerateCreatorInsightsResponse
object. This object contains a list of YouTubeCreatorInsights objects. Each
YouTubeCreatorInsights object contains the following information about a
creator:
- Creator name
- YouTube channel
- Total creator metrics
- List of YouTube channel insights
The YouTubeMetrics object contains the following metrics:
- Subscriber count
- View count
The YouTubeChannelInsights object contains the following information about a
YouTube channel:
- Channel name
- Channel ID
- Channel metrics
- Channel audience attributes (such as age and gender breakdown)
- Channel type