Mantieni tutto organizzato con le raccolte
Salva e classifica i contenuti in base alle tue preferenze.
Scopri e recupera approfondimenti sui creator di YouTube con la funzionalità Approfondimenti sui creator. Questo può essere utile per le agenzie e gli inserzionisti che vogliono trovare
creator pertinenti per il loro pubblico di destinazione.
L'API ha quattro funzioni principali:
Rilevabilità dei creator:trova i migliori creator per un determinato insieme di argomenti,
dati demografici, segmenti di pubblico o attributi dei creator.
Approfondimenti sul brand dei creator:recupera approfondimenti sui creator relativi a un brand specifico.
Approfondimenti per i creator:recupera approfondimenti su canali YouTube specifici, ad esempio
il numero di iscritti, il numero di visualizzazioni e i dati demografici del pubblico.
Approfondimenti sulle tendenze:recupera approfondimenti su tendenze specifiche, in base a
segmenti di pubblico o argomenti specifici.
Requisiti di idoneità
ContentCreatorInsightsService.GenerateCreatorInsights
è un componente privato dell'API Google Ads offerto con una licenza
non esclusiva e senza costi per i dati. I partner registrati possono utilizzare le librerie client Google Ads standard per esplorare i creator e i contenuti di YouTube. Per essere idonei, i partner devono soddisfare le seguenti condizioni:
Disporre di uno strumento di pianificazione o di un'interfaccia utente che integrerà l'API.
Utilizza l'API per esplorare i contenuti e i creator di YouTube per individuare potenziali opportunità pubblicitarie.
Completa una valutazione preliminare per verificare l'idoneità.
Rispettare i requisiti di utilizzo dei dati ed essere disposti a sottoporsi a controlli periodici dei dati.
Firma un contratto di licenza dei dati che imponga legalmente i requisiti di utilizzo dei dati.
Per saperne di più, contatta il tuo rappresentante di Google.
Generare approfondimenti per i creator
Per generare approfondimenti per i creator, invia una richiesta al metodo
ContentCreatorInsightsService.GenerateCreatorInsights. Questo metodo ha un limite di 5 query al secondo (QPS) e accetta tre
tipi di input a seconda che tu voglia eseguire la rilevabilità dei creator, ottenere
approfondimenti sul brand dei creator o approfondimenti sui creator. Devi fornire le località dei paesi
da cui vuoi recuperare i dati.
Rilevabilità dei creator:puoi fornire un elenco di attributi del pubblico,
come età, genere e interessi. L'API restituisce un elenco di creator i cui
pubblici corrispondono a questi attributi. Puoi anche fornire attributi del creator per filtrare i creator i cui contenuti corrispondono specificamente agli attributi del creator inseriti.
Approfondimenti sul brand dei creator:fornisci un brand per cercare i migliori creator. L'API restituisce approfondimenti sui canali corrispondenti.
Approfondimenti per i creator:fornisci un elenco di ID canale YouTube. L'API restituisce
approfondimenti su questi canali specifici.
Il metodo generateCreatorInsights restituisce un oggetto GenerateCreatorInsightsResponse. Questo oggetto contiene un elenco di oggetti YouTubeCreatorInsights. Ogni oggetto
YouTubeCreatorInsights contiene le seguenti informazioni su un
creator:
Nome creator
Canale YouTube
Metriche totali dei creator
Elenco degli approfondimenti sul canale YouTube
L'oggetto YouTubeMetrics contiene le seguenti metriche:
Numero iscritti
Numero di visualizzazioni
Conteggio video
È un creator di Short attivo
L'oggetto YouTubeChannelInsights contiene le seguenti informazioni su un
canale YouTube:
Nome del canale
ID canale
URL del canale
Descrizione del canale
Metriche del canale
Attributi del pubblico del canale (ad esempio, età, genere e suddivisione degli interessi degli utenti)
Video principali
Tipo di canale
Generare insight sulle tendenze
Per generare approfondimenti sulle tendenze, invia una richiesta al metodo
ContentCreatorInsightsService.GenerateTrendingInsights. Questo metodo ha un limite di 5 query al secondo (QPS) e accetta due
tipi di input a seconda che tu voglia ottenere le tendenze del pubblico o degli argomenti.
Devi fornire la posizione del paese specifico da cui vuoi ottenere le tendenze.
Tendenze del pubblico:puoi fornire un elenco di attributi del pubblico,
come età, genere e interessi. L'API restituisce un elenco di approfondimenti
di tendenza per questi segmenti di pubblico.
Tendenze degli argomenti: fornisci un elenco di argomenti dei contenuti. L'API restituisce un elenco di
approfondimenti sulle tendenze per questi argomenti.
[null,null,["Ultimo aggiornamento 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."]]
