Оптимизируйте свои подборки
Сохраняйте и классифицируйте контент в соответствии со своими настройками.
Находите и получайте информацию об авторах YouTube с помощью функции «Информация о создателях». Это может быть полезно агентствам и рекламодателям, которые хотят найти авторов, релевантных их целевой аудитории.
API имеет четыре основные функции:
Обнаруживаемость создателей: найдите лучших создателей по заданному набору тем, демографических данных, аудиторий или характеристик создателей.
Статистика по брендам авторов: получайте информацию о создателях, связанных с определенным брендом.
Аналитика для авторов: получайте аналитику о конкретных каналах YouTube, например, количество подписчиков, количество просмотров и демографические данные аудитории.
Аналитика тенденций: получайте информацию о конкретных тенденциях на основе определенных аудиторий или тем.
Требования к претендентам
ContentCreatorInsightsService.GenerateCreatorInsights — это закрытый компонент API Google Рекламы, предоставляемый по неисключительной лицензии на данные без уплаты роялти. Подписавшие партнеры могут использовать стандартные клиентские библиотеки Google Рекламы для поиска авторов и контента YouTube. Для участия партнеры должны соответствовать следующим условиям:
Иметь инструмент планирования или пользовательский интерфейс, который будет интегрировать API.
Используйте API для изучения контента и авторов YouTube на предмет потенциальных возможностей размещения рекламы.
Пройдите предварительную оценку, чтобы убедиться в вашем праве на участие.
Соблюдайте требования к использованию данных и будьте готовы проходить периодические проверки данных.
Подпишите соглашение о лицензировании данных, которое юридически закрепляет требования к использованию данных.
Для получения более подробной информации обратитесь к представителю Google.
Генерация идей создателей
Чтобы получить данные об авторах, отправьте запрос методу ContentCreatorInsightsService.GenerateCreatorInsights . Этот метод имеет ограничение в 5 запросов в секунду (QPS) и принимает три типа входных данных в зависимости от того, хотите ли вы получить данные об обнаружении авторов, о бренде автора или об авторах. Необходимо указать страны, из которых вы хотите получить данные.
Возможность обнаружения авторов: вы можете указать список атрибутов аудитории, таких как возраст, пол и интересы. API возвращает список авторов, чья аудитория соответствует этим атрибутам. Вы также можете указать атрибуты авторов, чтобы отфильтровать авторов, чей контент точно соответствует указанным вами атрибутам.
Аналитика бренда автора: укажите бренд для поиска лучших авторов. API возвращает аналитику о подходящих каналах.
Информация для авторов: список идентификаторов каналов YouTube. API возвращает информацию об этих каналах.
Метод generateCreatorInsights возвращает объект GenerateCreatorInsightsResponse . Этот объект содержит список объектов YouTubeCreatorInsights . Каждый объект YouTubeCreatorInsights содержит следующую информацию об авторе:
Имя создателя
канал на YouTube
Общие метрики создателей
Список аналитических данных YouTube-канала
Объект YouTubeMetrics содержит следующие метрики:
Количество подписчиков
Количество просмотров
Количество видео
Является активным создателем коротких видео
Объект YouTubeChannelInsights содержит следующую информацию о канале YouTube:
Название канала
Идентификатор канала
URL-адрес канала
Описание канала
Метрики канала
Атрибуты аудитории канала (такие как возраст, пол и распределение интересов пользователей)
Лучшие видео
Тип канала
Генерируйте информацию о тенденциях
Чтобы получить аналитические данные о тенденциях, отправьте запрос к методу ContentCreatorInsightsService.GenerateTrendingInsights . Этот метод имеет ограничение в 5 запросов в секунду (QPS) и принимает два типа входных данных в зависимости от того, хотите ли вы получить данные об аудиторных или тематических тенденциях. Необходимо указать конкретную страну, из которой вы хотите получить данные о тенденциях.
Тенденции аудитории: вы можете предоставить список атрибутов аудитории, таких как возраст, пол и интересы. API возвращает список тенденций для этих аудиторий.
Тенденции тем: Предоставьте список тем контента. API возвращает список актуальных тенденций по этим темам.
[[["Прост для понимания","easyToUnderstand","thumb-up"],["Помог мне решить мою проблему","solvedMyProblem","thumb-up"],["Другое","otherUp","thumb-up"]],[["Отсутствует нужная мне информация","missingTheInformationINeed","thumb-down"],["Слишком сложен/слишком много шагов","tooComplicatedTooManySteps","thumb-down"],["Устарел","outOfDate","thumb-down"],["Проблема с переводом текста","translationIssue","thumb-down"],["Проблемы образцов/кода","samplesCodeIssue","thumb-down"],["Другое","otherDown","thumb-down"]],["Последнее обновление: 2025-09-03 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."]]
