Pour discuter de nos produits et nous faire part de vos commentaires, rejoignez le canal Discord officiel Google Ads sur le serveur de la communauté Google Advertising and Measurement.
Restez organisé à l'aide des collections
Enregistrez et classez les contenus selon vos préférences.
Découvrez et récupérez des insights sur les créateurs YouTube grâce à la fonctionnalité Insights sur les créateurs. Cela peut être utile pour les agences et les annonceurs qui souhaitent trouver des créateurs pertinents pour leur audience cible.
L'API comporte quatre fonctions principales :
Découverte de créateurs : trouvez les créateurs les plus populaires pour un ensemble donné de thèmes, de données démographiques, d'audiences ou d'attributs de créateurs.
Insights sur les marques de créateurs : récupérez des insights sur les créateurs associés à une marque spécifique.
Insights sur les créateurs : obtenez des insights sur des chaînes YouTube spécifiques, comme le nombre d'abonnés, le nombre de vues et les données démographiques de l'audience.
Tendances : obtenez des insights sur des tendances spécifiques, en fonction d'audiences ou de thèmes spécifiques.
Critères d'éligibilité
ContentCreatorInsightsService.GenerateCreatorInsights
est un composant privé de l'API Google Ads proposé avec une licence de données non exclusive et sans redevance. Les partenaires connectés peuvent utiliser les bibliothèques clientes Google Ads standards pour explorer les créateurs et les contenus YouTube. Pour être éligibles, les partenaires doivent remplir les conditions suivantes :
Disposer d'un outil de planification ou d'une interface utilisateur qui intégrera l'API.
Utilisez l'API pour explorer les contenus et les créateurs YouTube afin d'identifier des opportunités publicitaires potentielles.
Effectuez une évaluation préliminaire pour vérifier votre éligibilité.
Respectez les exigences concernant l'utilisation des données et acceptez de vous soumettre à des audits de données périodiques.
Signez un contrat de licence de données qui applique légalement les exigences d'utilisation des données.
Pour plus d'informations, contactez votre représentant Google.
Générer des insights sur les créateurs
Pour générer des insights sur les créateurs, envoyez une requête à la méthode ContentCreatorInsightsService.GenerateCreatorInsights. Cette méthode est limitée à cinq requêtes par seconde (QPS) et accepte trois types d'entrées selon que vous souhaitez découvrir des créateurs, obtenir des insights sur les marques de créateurs ou obtenir des insights sur les créateurs. Vous devez indiquer les pays à partir desquels vous souhaitez obtenir des données.
Découverte des créateurs : vous pouvez fournir une liste d'attributs d'audience, tels que l'âge, le genre et les centres d'intérêt. L'API renvoie une liste de créateurs dont les audiences correspondent à ces attributs. Vous pouvez également fournir des attributs de créateur pour filtrer les créateurs dont le contenu correspond spécifiquement aux attributs de créateur que vous avez saisis.
Insights sur les marques de créateurs : indiquez une marque pour rechercher les principaux créateurs. L'API renvoie des insights sur les chaînes correspondantes.
Insights sur les créateurs : fournissez une liste d'ID de chaînes YouTube. L'API renvoie des insights sur ces canaux spécifiques.
La méthode generateCreatorInsights renvoie un objet GenerateCreatorInsightsResponse. Cet objet contient une liste d'objets YouTubeCreatorInsights. Chaque objet YouTubeCreatorInsights contient les informations suivantes sur un créateur :
Nom du créateur
Chaîne YouTube
Métriques totales sur les créateurs
Liste des insights sur les chaînes YouTube
L'objet YouTubeMetrics contient les métriques suivantes :
Nombre d'abonnés
Nombre de vues
Nombre de vidéos
Être un créateur de Shorts actif
L'objet YouTubeChannelInsights contient les informations suivantes sur une chaîne YouTube :
Nom de la chaîne
ID de la chaîne
URL de la chaîne
Description de la chaîne
Métriques de la chaîne
Attributs de l'audience de la chaîne (comme la répartition par âge, par genre et par centres d'intérêt des utilisateurs)
Vidéos les plus regardées
Type de canal
Générer des insights sur les tendances
Pour générer des insights sur les tendances, envoyez une requête à la méthode ContentCreatorInsightsService.GenerateTrendingInsights. Cette méthode est limitée à cinq requêtes par seconde (RPS) et accepte deux types d'entrées selon que vous souhaitez obtenir des tendances d'audience ou des tendances de thèmes.
Vous devez indiquer le pays spécifique à partir duquel vous souhaitez obtenir des tendances.
Tendances de l'audience : vous pouvez fournir une liste d'attributs d'audience, tels que l'âge, le genre et les centres d'intérêt. L'API renvoie une liste d'insights tendances pour ces audiences.
Tendances des thèmes : fournissez une liste de thèmes de contenu. L'API renvoie une liste d'insights sur les tendances pour ces thèmes.
Sauf indication contraire, le contenu de cette page est régi par une licence Creative Commons Attribution 4.0, et les échantillons de code sont régis par une licence Apache 2.0. Pour en savoir plus, consultez les Règles du site Google Developers. Java est une marque déposée d'Oracle et/ou de ses sociétés affiliées.
Dernière mise à jour le 2025/08/27 (UTC).
[null,null,["Dernière mise à jour le 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."]]
