YouTube creator insights

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 four main functions:

  1. Creator Discoverability: Find the top creators for a given set of topics, demographics, audiences, or creator attributes.
  2. Creator Brand Insights: Fetch insights about creators relating to a specific brand.
  3. Creator Insights: Fetch insights about specific YouTube channels, such as their subscriber count, view count, and audience demographics.
  4. Trending Insights: Fetch insights about specific trends, based on specific audiences or topics.

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 three types of input depending on if you want to do creator discoverability, creator brand insights or get creator insights. You must provide the country locations where you want to get data from.

  1. Creator Discoverability: You can provide a list of audience attributes, such as age, gender, and interests. The API returns a list of creators whose audiences match those attributes. You can also provide creator attributes to filter for creators whose content specifically matches your inputted creator attributes.
  2. Creator Brand Insights: Provide a brand to search for top creators. The API returns insights about matching channels.
  3. 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
  • Video count
  • Is Active Shorts Creator

The YouTubeChannelInsights object contains the following information about a YouTube channel:

  • Channel name
  • Channel ID
  • Channel URL
  • Channel description
  • Channel metrics
  • Channel audience attributes (such as age, gender, and user interest breakdown)
  • Top Videos
  • Channel type

To generate trending insights, send a request to the ContentCreatorInsightsService.GenerateTrendingInsights method. This method has a limit of 5 queries per second (QPS) and takes two types of input depending on if you want to get audience trends or topic trends. You must provide the specific country location where you want to get trends from.

  1. Audience Trends: You can provide a list of audience attributes, such as age, gender, and interests. The API returns a list of trending insights for those audiences.
  2. Topic Trends: Provide a list of content topics. The API returns a list of trending insights for those topics.
Previous
Overview