Zadbaj o dobrą organizację dzięki kolekcji
Zapisuj i kategoryzuj treści zgodnie ze swoimi preferencjami.
Odkrywaj informacje o twórcach YouTube i pobieraj je za pomocą funkcji informacji o twórcach. Może to być przydatne dla agencji i reklamodawców, którzy chcą znaleźć twórców odpowiednich dla swoich odbiorców docelowych.
Interfejs API ma 4 główne funkcje:
Wyszukiwanie twórców: znajdź najpopularniejszych twórców w określonych kategoriach tematycznych, demograficznych, grupach odbiorców lub na podstawie atrybutów twórców.
Statystyki dotyczące marki twórcy: pobieranie statystyk dotyczących twórców związanych z określoną marką.
Statystyki twórców: pobieraj statystyki dotyczące konkretnych kanałów w YouTube, takie jak liczba subskrybentów, liczba wyświetleń i dane demograficzne odbiorców.
Trendy: uzyskuj informacje o konkretnych trendach na podstawie określonych grup odbiorców lub tematów.
Wymagania
ContentCreatorInsightsService.GenerateCreatorInsights
jest prywatnym komponentem interfejsu Google Ads API oferowanym na podstawie niewyłącznej, bezpłatnej
licencji na dane. Podpisani partnerzy mogą korzystać ze standardowych bibliotek klienta Google Ads, aby wyszukiwać twórców i treści w YouTube. Aby kwalifikować się do programu, partnerzy muszą spełniać te warunki:
mieć narzędzie do planowania lub interfejs użytkownika, który będzie integrować interfejs API;
Używaj interfejsu API do odkrywania treści i twórców w YouTube pod kątem potencjalnych możliwości reklamowych.
Aby sprawdzić, czy spełniasz wymagania, przeprowadź wstępną ocenę.
Przestrzegaj wymagań dotyczących wykorzystania danych i zgódź się na okresowe audyty danych.
Podpisz umowę licencyjną na dane, która prawnie egzekwuje wymagania dotyczące używania danych.
Aby uzyskać więcej informacji, skontaktuj się z przedstawicielem Google.
Generowanie statystyk twórców
Aby wygenerować statystyki twórcy, wyślij żądanie do metody
ContentCreatorInsightsService.GenerateCreatorInsights. Ta metoda ma limit 5 zapytań na sekundę i przyjmuje 3 rodzaje danych wejściowych w zależności od tego, czy chcesz zwiększyć widoczność twórcy, uzyskać statystyki dotyczące marki twórcy czy uzyskać statystyki dotyczące twórcy. Musisz podać kraje, z których chcesz pobierać dane.
Wyszukiwanie twórców: możesz podać listę atrybutów odbiorców, takich jak wiek, płeć i zainteresowania. Interfejs API zwraca listę twórców, których odbiorcy pasują do tych atrybutów. Możesz też podać atrybuty twórcy, aby filtrować twórców, których treści są zgodne z podanymi atrybutami.
Creator Brand Insights: podaj nazwę marki, aby wyszukać najlepszych twórców. Interfejs API zwraca statystyki dotyczące pasujących kanałów.
Statystyki twórców: podaj listę identyfikatorów kanałów w YouTube. Interfejs API zwraca statystyki dotyczące tych konkretnych kanałów.
Metoda generateCreatorInsights zwraca obiekt GenerateCreatorInsightsResponse. Ten obiekt zawiera listę obiektów YouTubeCreatorInsights. Każdy obiekt YouTubeCreatorInsights zawiera te informacje o twórcy:
Nazwa twórcy
Kanał w YouTube
Łączne dane twórcy
Lista statystyk kanału w YouTube
Obiekt YouTubeMetrics zawiera te dane:
Liczba subskrybentów
Liczba wyświetleń
Liczba filmów
jest aktywnym twórcą filmów Short;
Obiekt YouTubeChannelInsights zawiera te informacje o kanale w YouTube:
Nazwa kanału
Identyfikator kanału
Adres URL kanału
Opis kanału
Dane kanału
Atrybuty odbiorców kanału (np. podział według wieku, płci i zainteresowań użytkowników)
Najpopularniejsze filmy wideo
Typ kanału
Generowanie statystyk dotyczących trendów
Aby wygenerować statystyki dotyczące trendów, wyślij żądanie do metody
ContentCreatorInsightsService.GenerateTrendingInsights. Ta metoda ma limit 5 zapytań na sekundę i przyjmuje 2 rodzaje danych wejściowych w zależności od tego, czy chcesz uzyskać trendy dotyczące odbiorców, czy trendy dotyczące tematów.
Musisz podać konkretny kraj, z którego chcesz uzyskać trendy.
Trendy dotyczące odbiorców: możesz podać listę atrybutów odbiorców, takich jak wiek, płeć i zainteresowania. Interfejs API zwraca listę popularnych statystyk dotyczących tych odbiorców.
Trendy dotyczące tematów: podaj listę tematów treści. Interfejs API zwraca listę popularnych statystyk dotyczących tych tematów.
[[["Łatwo zrozumieć","easyToUnderstand","thumb-up"],["Rozwiązało to mój problem","solvedMyProblem","thumb-up"],["Inne","otherUp","thumb-up"]],[["Brak potrzebnych mi informacji","missingTheInformationINeed","thumb-down"],["Zbyt skomplikowane / zbyt wiele czynności do wykonania","tooComplicatedTooManySteps","thumb-down"],["Nieaktualne treści","outOfDate","thumb-down"],["Problem z tłumaczeniem","translationIssue","thumb-down"],["Problem z przykładami/kodem","samplesCodeIssue","thumb-down"],["Inne","otherDown","thumb-down"]],["Ostatnia aktualizacja: 2025-09-05 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."]]
