Mantenha tudo organizado com as coleções
Salve e categorize o conteúdo com base nas suas preferências.
Descubra e receba insights sobre criadores de conteúdo do YouTube com o recurso de insights do criador. Isso pode ser útil para agências e anunciantes que querem encontrar criadores de conteúdo relevantes para o público-alvo.
A API tem quatro funções principais:
Descoberta de criadores de conteúdo:encontre os principais criadores de conteúdo para um determinado conjunto de temas, dados demográficos, públicos-alvo ou atributos de criadores.
Insights da marca do criador de conteúdo:extrai insights sobre criadores de conteúdo relacionados a uma marca específica.
Insights para criadores de conteúdo:receba insights sobre canais específicos do YouTube, como contagem de inscritos e visualizações e dados demográficos do público.
Insights de tendências:receba insights sobre tendências específicas com base em públicos-alvo ou temas específicos.
Requisitos de qualificação
ContentCreatorInsightsService.GenerateCreatorInsights
é um componente particular da API Google Ads oferecido com uma licença de dados
não exclusiva e sem royalties. Os parceiros que assinaram o contrato podem usar as bibliotecas de cliente do Google Ads padrão para pesquisar criadores de conteúdo e conteúdo do YouTube. Para se qualificar, os parceiros precisam atender às seguintes condições:
Ter uma ferramenta de planejamento ou interface do usuário que integre a API.
Use a API para explorar conteúdo e criadores do YouTube e encontrar possíveis oportunidades de publicidade.
Faça uma avaliação prévia para garantir a qualificação.
Seguir os requisitos de uso de dados e aceitar auditorias periódicas de dados.
Assine um contrato de licenciamento de dados que imponha legalmente os requisitos de uso de dados.
Entre em contato com o representante do Google para mais informações.
Gerar insights do criador de conteúdo
Para gerar insights para criadores de conteúdo, envie uma solicitação ao método
ContentCreatorInsightsService.GenerateCreatorInsights. Esse método tem um limite de cinco consultas por segundo (QPS) e usa três tipos de entrada, dependendo se você quer fazer a descoberta de criadores, insights de marca de criadores ou receber insights de criadores. Você precisa informar os locais dos países de onde quer receber dados.
Descoberta de criadores de conteúdo:você pode fornecer uma lista de atributos do público-alvo, como idade, gênero e interesses. A API retorna uma lista de criadores de conteúdo cujos públicos-alvo correspondem a esses atributos. Você também pode fornecer atributos de criadores para filtrar aqueles cujo conteúdo corresponde especificamente aos atributos inseridos.
Insights da marca do criador de conteúdo:forneça uma marca para pesquisar os principais criadores. A API retorna insights sobre canais correspondentes.
Insights para criadores de conteúdo:forneça uma lista de IDs de canais do YouTube. A API retorna insights sobre esses canais específicos.
O método generateCreatorInsights retorna um objeto GenerateCreatorInsightsResponse. Esse objeto contém uma lista de objetos YouTubeCreatorInsights. Cada objeto YouTubeCreatorInsights contém as seguintes informações sobre um criador de conteúdo:
Nome do criador de conteúdo
Canal do YouTube
Total de métricas do criador de conteúdo
Lista de insights do canal do YouTube
O objeto YouTubeMetrics contém as seguintes métricas:
Contagem de inscritos
o número de visualizações;
Contagem de vídeos
É um criador de Shorts ativo
O objeto YouTubeChannelInsights contém as seguintes informações sobre um canal do YouTube:
Nome do canal
ID do canal
URL do canal
A descrição do canal.
Métricas do canal
Atributos do público do canal (como idade, gênero e detalhamento dos interesses do usuário)
Vídeos mais acessados
Tipo de canal
Gerar insights de tendências
Para gerar insights de tendências, envie uma solicitação ao método
ContentCreatorInsightsService.GenerateTrendingInsights. Esse método tem um limite de cinco consultas por segundo (QPS) e usa dois tipos de entrada, dependendo se você quer receber tendências de público-alvo ou de tema.
Você precisa informar o país específico de onde quer receber as tendências.
Tendências de público-alvo:você pode fornecer uma lista de atributos de público-alvo, como idade, gênero e interesses. A API retorna uma lista de insights de tendências para esses públicos-alvo.
Tendências de temas:forneça uma lista de temas de conteúdo. A API retorna uma lista de insights em alta para esses tópicos.
[null,null,["Última atualização 2025-08-27 UTC."],[[["\u003cp\u003eDiscover top YouTube creators based on topics, demographics, and target audiences using the creator insights feature.\u003c/p\u003e\n"],["\u003cp\u003eAccess creator insights such as subscriber count, view count, and audience demographics for specific YouTube channels.\u003c/p\u003e\n"],["\u003cp\u003eThis feature is currently in beta and requires meeting specific eligibility criteria, including a pre-screen assessment and data usage agreement.\u003c/p\u003e\n"],["\u003cp\u003eUse the \u003ccode\u003eContentCreatorInsightsService.GenerateCreatorInsights\u003c/code\u003e method to request either creator discovery or specific channel insights.\u003c/p\u003e\n"],["\u003cp\u003eThe API provides data like creator name, channel details, metrics (subscriber count, view count), and audience attributes.\u003c/p\u003e\n"]]],[],null,["# YouTube creator insights\n\n| **Note:** This feature is in beta and is only available to developers on an allowlist.\n\nDiscover and fetch insights about YouTube creators with the creator insights\nfeature. This can be useful for agencies and advertisers who want to find\ncreators who are relevant to their target audience.\n\nThe API has four main functions:\n\n1. **Creator Discoverability:** Find the top creators for a given set of topics, demographics, audiences, or creator attributes.\n2. **Creator Brand Insights:** Fetch insights about creators relating to a specific brand.\n3. **Creator Insights:** Fetch insights about specific YouTube channels, such as their subscriber count, view count, and audience demographics.\n4. **Trending Insights:** Fetch insights about specific trends, based on specific audiences or topics.\n\nEligibility requirements\n------------------------\n\n[`ContentCreatorInsightsService.GenerateCreatorInsights`](/google-ads/api/reference/rpc/v21/ContentCreatorInsightsService/GenerateCreatorInsights)\nis a private component of the Google Ads API offered with a non-exclusive, royalty-free\ndata license. Signed partners can use the standard\n[Google Ads client libraries](/google-ads/api/docs/client-libs) to explore YouTube creators and\ncontent. To be eligible, partners must satisfy the following conditions:\n\n- Have a planning tool or user interface that will integrate the API.\n- Use the API to explore YouTube content and creators for potential advertising opportunities.\n- Complete a pre-screen assessment to ensure eligibility.\n- Follow data usage requirements and be willing to undergo periodic data audits.\n- Sign a data-licensing agreement that legally enforces data usage requirements.\n- Accept the Google Ads API [terms of service](../../terms).\n\nContact your Google representative for more information.\n\nGenerate creator insights\n-------------------------\n\nTo generate creator insights, send a request to the\n[`ContentCreatorInsightsService.GenerateCreatorInsights`](/google-ads/api/reference/rpc/v21/ContentCreatorInsightsService/GenerateCreatorInsights)\nmethod. This method has a limit of 5 queries per second (QPS) and takes three\ntypes of input depending on if you want to do creator discoverability, creator\nbrand insights or get creator insights. You must provide the country locations\nwhere you want to get data from.\n\n1. **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.\n2. **Creator Brand Insights:** Provide a brand to search for top creators. The API returns insights about matching channels.\n3. **Creator Insights:** Provide a list of YouTube channel IDs. The API returns insights about those specific channels.\n\nThe `generateCreatorInsights` method returns a `GenerateCreatorInsightsResponse`\nobject. This object contains a list of `YouTubeCreatorInsights` objects. Each\n`YouTubeCreatorInsights` object contains the following information about a\ncreator:\n\n- Creator name\n- YouTube channel\n- Total creator metrics\n- List of YouTube channel insights\n\nThe `YouTubeMetrics` object contains the following metrics:\n\n- Subscriber count\n- View count\n- Video count\n- Is Active Shorts Creator\n\nThe `YouTubeChannelInsights` object contains the following information about a\nYouTube channel:\n\n- Channel name\n- Channel ID\n- Channel URL\n- Channel description\n- Channel metrics\n- Channel audience attributes (such as age, gender, and user interest breakdown)\n- Top Videos\n- Channel type\n\nGenerate trending insights\n--------------------------\n\nTo generate trending insights, send a request to the\n[`ContentCreatorInsightsService.GenerateTrendingInsights`](/google-ads/api/reference/rpc/v21/ContentCreatorInsightsService/GenerateTrendingInsights)\nmethod. This method has a limit of 5 queries per second (QPS) and takes two\ntypes of input depending on if you want to get audience trends or topic trends.\nYou must provide the specific country location where you want to get trends\nfrom.\n\n1. **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.\n2. **Topic Trends:** Provide a list of content topics. The API returns a list of trending insights for those topics."]]
