Примеры запросов API

На этой странице показаны примеры запросов API YouTube Analytics. В каждом примере кратко описывается извлекаемый отчет, а затем показаны соответствующие dimensions , metrics , filters и значения параметров sort . (В документах отчетов о каналах и отчетах владельцев контента указаны отчеты, которые поддерживает API.)

Каждый пример ссылается на Google API Explorer и заполняет его показанными значениями. В примерах также используются даты начала и окончания по умолчанию ( YYYY-MM-DD ) 2023-09-01 и 2024-03-31

После подключения к API Explorer вам все равно необходимо указать владельца канала или контента, для которого вы получаете отчеты. Обозреватель API заполнит значение параметра ids либо channel==MINE , либо contentOwner==CONTENT_OWNER_ID в зависимости от запроса, который вы нажали. Для отчетов о каналах вы можете изменить MINE на идентификатор канала аутентифицированного пользователя. В отчетах о владельцах контента вам необходимо заменить CONTENT_OWNER_ID на свой идентификатор владельца контента.

Вам также необходимо пройти аутентификацию как указанный владелец канала или контента, чтобы API Explorer мог авторизовать ваши запросы API с помощью OAuth 2.0 .

1. Сортировка запросов по нескольким параметрам/метрикам
2. Отчеты канала
3. Отчеты владельца контента

Сортировка запросов по нескольким параметрам/метрикам

API поддерживает возможность сортировки данных ответов с использованием нескольких параметров или показателей. Например, приведенный ниже запрос получает данные об источниках ежедневного трафика для видео определенного канала. Каждая строка в наборе результатов определяет количество просмотров и примерное время просмотра, полученное из определенного типа источника трафика (например, EXT_URL ) в определенный день.

dimensions=day,insightTrafficSourceType
metrics=views,estimatedWatchTime
sort=day,-views

В ответе результаты сортируются в хронологическом порядке. В наборе результатов за каждый день результаты сортируются в порядке убывания количества просмотров. Итак, первая строка в наборе результатов содержит данные для источника трафика, который сгенерировал наибольшее количество просмотров в первый день запрошенного диапазона дат. Вторая строка содержит данные для источника трафика, который сгенерировал следующее по величине количество просмотров в первый день.

Отчеты канала

Основная статистика

Видеоотчеты

Общее количество просмотров, расчетное время просмотра и т. д. для канала.

Этот запрос получает агрегированные показатели контента канала. Отчет возвращает одну строку данных, содержащую итоговые значения для каждого запрошенного показателя за указанный диапазон дат.

metrics=views,comments,likes,dislikes,estimatedMinutesWatched,averageViewDuration

Количество просмотров канала (и не только) в зависимости от страны

Этот запрос получает показатели для конкретной страны для видео канала. Отчет возвращает одну строку данных, содержащую итоговые значения для каждого запрошенного показателя за указанный диапазон дат.

metrics=views,comments,likes,dislikes,estimatedMinutesWatched
filters=country==US

Топ-10 — самые просматриваемые видео на канале.

Этот запрос извлекает 10 самых просматриваемых видео на канале по оценкам минут, просмотренных в течение указанного диапазона дат. Результаты отсортированы по примерному количеству просмотренных минут в порядке убывания.

Примечание. Для этого отчета необходимо указать значение параметра запроса sort и установить для параметра maxResults целое значение 10 или меньше.

dimensions=video
metrics=estimatedMinutesWatched,views,likes,subscribersGained
maxResults=10
sort=-estimatedMinutesWatched

Топ-10 – рейтинг кликов по аннотациям для самых просматриваемых видео на канале.

Этот запрос позволяет получить количество просмотров, рейтинг кликов по аннотациям, коэффициент закрытия аннотаций и количество показов аннотаций для 10 наиболее просматриваемых видео канала. Результаты сортируются по количеству просмотров в порядке убывания, что означает, что наиболее просматриваемое видео будет указано первым.

Примечание. Для этого отчета необходимо указать значение параметра запроса sort и установить для параметра maxResults целое значение 10 или меньше.

dimensions=video
metrics=views,likes,annotationClickThroughRate,annotationCloseRate,annotationImpressions
maxResults=10
sort=-views

Отчеты о плейлистах

Общее количество просмотров плейлиста для канала

Этот запрос получает общее количество запусков плейлиста, расчетное количество просмотренных минут, просмотры ( агрегированный показатель видео ), просмотры плейлиста (показатель в плейлисте ) и количество просмотров на начало плейлиста для плейлистов на канале проверенного пользователя.

metrics=views,estimatedMinutesWatched,playlistStarts,playlistViews,viewsPerPlaylistStart

Статистика по конкретному плейлисту

Этот запрос получает общее количество запусков плейлиста, примерное количество просмотренных минут, просмотры ( агрегированный показатель видео ), просмотры плейлиста (показатель в плейлисте ) и количество просмотров на начало плейлиста для определенного плейлиста. Обратите внимание: чтобы выполнить этот запрос в API Explorer, необходимо заменить строку PLAYLIST_ID в значении параметра filters на идентификатор списка воспроизведения для списка воспроизведения в канале аутентифицированного пользователя.

metrics=views,estimatedMinutesWatched,playlistStarts,playlistViews,viewsPerPlaylistStart
filters=playlist==PLAYLIST_ID

Чтобы получить совокупную статистику для нескольких списков воспроизведения, вы также можете заменить строку PLAYLIST_ID списком, разделенным запятыми, содержащим до 500 идентификаторов списков воспроизведения для списков воспроизведения на канале аутентифицированного пользователя.

Топ-10 — самые просматриваемые плейлисты канала.

Этот запрос извлекает 10 наиболее просматриваемых плейлистов канала по количеству просмотров плейлистов в течение указанного диапазона дат. Он также получает несколько других показателей плейлиста, таких как количество раз, когда зрители инициировали воспроизведение каждого плейлиста, и среднее время, в течение которого зритель смотрел видео в плейлисте после его запуска. Результаты сортируются по просмотрам плейлистов в порядке убывания.

Примечание. Поскольку в этом отчете используется измерение playlist , необходимо указать значение параметра запроса sort , а также установить для параметра maxResults целое значение 10 или меньше.

dimensions=playlist
metrics=playlistViews,playlistEstimatedMinutesWatched,playlistStarts,averageTimeInPlaylist,playlistSaves
maxResults=10
sort=-playlistViews

На основе времени

Видеоотчеты

Ежедневные показатели времени просмотра видео канала

Этот запрос получает количество ежедневных просмотров, показатели времени просмотра и количество новых подписчиков видео канала. Отчет возвращает одну строку данных для каждого дня в запрошенном диапазоне дат. Строки сортируются в хронологическом порядке.

dimensions=day
metrics=views,estimatedMinutesWatched,averageViewDuration,averageViewPercentage,subscribersGained
sort=day

Ежедневные показатели аннотаций для видео канала

Этот запрос получает количество ежедневных просмотров, рейтинг кликов аннотаций, коэффициент закрытия аннотаций и количество показов аннотаций для контента канала. Результаты отсортированы в хронологическом порядке.

dimensions=day
metrics=views,likes,annotationClickThroughRate,annotationCloseRate,annotationImpressions
sort=day

Отчеты о плейлистах

Ежедневные просмотры плейлиста для канала

Этот запрос получает количество просмотров за день ( агрегированный показатель видео ), просмотры плейлиста (показатель в плейлисте ), начало плейлиста, примерное количество просмотренных минут и количество просмотров на начало плейлиста для канала проверенного пользователя. Результаты отсортированы в хронологическом порядке.

dimensions=day
metrics=views,estimatedMinutesWatched,playlistStarts,playlistViews,viewsPerPlaylistStart
sort=day

Географический

Видеоотчеты

Показатели времени просмотра видео на канале для конкретной страны

Этот запрос получает количество просмотров в конкретной стране, показатели времени просмотра и данные о подписке на видео канала. Отчет возвращает одну строку данных для каждой страны, где просматривались видео канала. Строки отсортированы по убыванию количества минут просмотра.

dimensions=country
metrics=views,estimatedMinutesWatched,averageViewDuration,averageViewPercentage,subscribersGained
sort=-estimatedMinutesWatched

Показатели аннотаций для видео на канале для конкретной страны

Этот запрос позволяет получить количество просмотров в конкретной стране, рейтинг кликов аннотаций, коэффициент закрытия аннотаций и количество показов аннотаций для видео канала. Результаты сортируются по рейтингу кликов аннотаций в порядке убывания. Это означает, что первой будет указана страна с самым высоким рейтингом кликов аннотаций.

dimensions=country
metrics=views,likes,annotationClickThroughRate,annotationCloseRate,annotationImpressions
sort=-annotationClickThroughRate

Показатели по конкретным провинциям для штатов США и Вашингтона, округ Колумбия

Этот запрос получает разбивку по провинциям по количеству просмотров, примерному количеству просмотренных минут и средней продолжительности просмотра видео канала. Данные охватывают штаты США и Вашингтон, округ Колумбия. Результаты отсортированы в алфавитном порядке по кодам провинций ISO 3166-2.

dimensions=province
metrics=views,estimatedMinutesWatched,averageViewDuration
filters=claimedStatus==claimed;country==US
sort=province

Топ-10 — самые просматриваемые видео в конкретной стране.

Этот запрос извлекает 10 наиболее просматриваемых видео канала по количеству просмотров в течение указанного диапазона дат в указанной стране. Результаты отсортированы по количеству просмотров в порядке убывания.

Примечание. Для этого отчета необходимо указать значение параметра запроса sort и установить для параметра maxResults целое значение 10 или меньше.

dimensions=video
metrics=views,estimatedMinutesWatched,likes,subscribersGained
filters=country==US
maxResults=10
sort=-views

Топ-10 городов США по общему количеству просмотров

Этот запрос возвращает список из 10 городов США, на которые приходится наибольшее количество просмотров контента канала в течение указанного диапазона дат. Запрос можно изменить для запроса данных по другой стране , выбрав другое допустимое значение для этого фильтра. Аналогично, запрос можно изменить для получения данных по субконтиненту, например Западной Европе или Юго-Восточной Азии, с помощью фильтра «Субконтинент» и одного из его допустимых значений. Другие фильтры также поддерживаются. Результаты отсортированы по количеству просмотров в порядке убывания.

    dimensions=city
metrics=views
filters=country==US
maxResults=10
sort=-views

Топ-10 городов США по общему количеству просмотров для каждого типа контента

Этот запрос возвращает список из 10 городов США, на которые приходится наибольшее количество просмотров контента канала в течение указанного диапазона дат для каждого поддерживаемого типа CreatorContentType . Результаты отсортированы по количеству просмотров в порядке убывания.

    dimensions=city,creatorContentType
metrics=views
filters=country==US
maxResults=10
sort=-views

Топ-10 городов США по общему времени просмотра

Этот запрос возвращает список из 10 лучших дней в течение указанного диапазона дат, когда на какой-либо город США приходилось наибольшее общее время ежедневного просмотра контента канала. Результаты запроса определяют общее время просмотра, дату, когда это время произошло, и город, в котором, по оценкам, контент был просмотрен. Результаты отсортированы в порядке убывания общего времени просмотра.

    dimensions=city,day
metrics=estimatedWatchTime
filters=country==US
maxResults=10
sort=-estimatedWatchTime

Топ-10 — самые просматриваемые видео в Европе

Этот запрос извлекает 10 самых просматриваемых видео канала в Европе по количеству просмотров в течение указанного диапазона дат. Запрос можно изменить для запроса данных для другого континента , выбрав другое допустимое значение для этого фильтра. Аналогично, запрос можно изменить для получения данных по субконтиненту, например Западной Европе или Юго-Восточной Азии, с помощью фильтра «Субконтинент» и одного из его допустимых значений. Результаты отсортированы по количеству просмотров в порядке убывания.

Примечание. Для этого отчета необходимо указать значение параметра запроса sort и установить для параметра maxResults целое значение 10 или меньше.

dimensions=video
metrics=views,estimatedMinutesWatched,likes,subscribersGained
filters=continent==150
maxResults=10
sort=-views

Отчеты о плейлистах

Показатели времени просмотра плейлистов канала для конкретной страны

Этот запрос извлекает количество просмотров для конкретной страны ( агрегированный показатель видео ), просмотров плейлистов (показатель в плейлисте ) и показатели времени просмотра для плейлистов канала. Отчет возвращает одну строку данных для каждой страны, где просматривались плейлисты канала. Строки отсортированы по убыванию количества минут просмотра.

dimensions=country
metrics=views,estimatedMinutesWatched,playlistStarts,averageTimeInPlaylist
sort=-estimatedMinutesWatched

Топ-10 – Самые запускаемые плейлисты в США

Этот запрос извлекает 10 плейлистов, которые зрители в США начали смотреть чаще всего в течение указанного диапазона дат. Результаты отсортированы по количеству запусков плейлиста в порядке убывания.

Примечание. Поскольку в этом отчете используется измерение playlist , необходимо указать значение параметра запроса sort , а также установить для параметра maxResults целое значение 10 или меньше.

dimensions=playlist
metrics=playlistStarts,views,estimatedMinutesWatched,averageViewDuration
filters=isCurated==1;country==US
maxResults=10
sort=-playlistStarts

Место воспроизведения

Видеоотчеты

Количество просмотров и время просмотра из разных мест воспроизведения

Этот запрос получает количество просмотров и примерное время просмотра видео определенного канала. Результаты агрегируются в зависимости от типа страницы или приложения, где происходило воспроизведение видео, и сортируются в порядке убывания количества просмотров.

dimensions=insightPlaybackLocationType
metrics=estimatedMinutesWatched,views
sort=-views

Количество просмотров за день и время просмотра из разных мест воспроизведения

Этот запрос позволяет получить количество просмотров за день и примерное время просмотра в США для видео определенного канала. Результаты сгруппированы по дням для каждого типа страниц или приложений, где происходило воспроизведение видео. Результаты отсортированы в хронологическом порядке.

    dimensions=day,insightPlaybackLocationType
metrics=estimatedMinutesWatched,views
filters=country==US
sort=day

Топ-10 – сторонние сайты, которые генерируют наибольшее количество просмотров встроенного видео.

Этот запрос получает количество просмотров и примерное время просмотра определенного видео или группы видео. Результаты сгруппированы по стороннему сайту, на который было встроено видео. Результаты отсортированы в порядке убывания количества просмотров. Обратите внимание, что для запуска этого запроса в API Explorer необходимо заменить строку VIDEO_ID в значении параметра filters разделенным запятыми списком из одного или нескольких идентификаторов видео для загруженных вами видео.

dimensions=insightPlaybackLocationDetail
metrics=views,estimatedMinutesWatched
filters=video==VIDEO_ID;insightPlaybackLocationType==EMBEDDED
maxResults=10
sort=-views

Отчеты о плейлистах

Количество просмотров плейлиста и время просмотра из разных мест воспроизведения

Этот запрос получает количество просмотров ( агрегированный показатель видео ), просмотров плейлиста (показатель в плейлисте ), расчетное время просмотра и количество запусков плейлиста для плейлистов определенного канала. Результаты агрегируются в зависимости от типа страницы или приложения, где происходило воспроизведение видео, а результаты сортируются в порядке убывания по началам списка воспроизведения.

dimensions=insightPlaybackLocationType
metrics=views,estimatedMinutesWatched,playlistStarts,playlistViews
sort=-playlistStarts

Количество просмотров плейлиста за день и время просмотра из разных мест воспроизведения

Этот запрос извлекает ежедневные запуски плейлиста, количество просмотров ( агрегированный показатель видео ), просмотры плейлиста (показатель в плейлисте ) и примерное время просмотра в США для плейлистов определенного канала. Результаты сгруппированы по дням для каждого типа страниц или приложений, где происходили просмотры плейлистов. Результаты отсортированы в хронологическом порядке.

dimensions=day,insightPlaybackLocationType
metrics=views,estimatedMinutesWatched,playlistStarts,playlistViews
filters=country==US
sort=day

Детали воспроизведения

Видеоотчеты

Что нравится и что не нравится по типу контента

Этот запрос извлекает количество лайков и антипатий для каждого типа контента на канале.

dimensions=creatorContentType
metrics=likes,dislikes

Источник трафика

Видеоотчеты

Количество просмотров и время просмотра из разных источников трафика в стране

Этот запрос получает количество просмотров и примерное время просмотра видео канала в указанной стране. Метрики агрегируются по источникам трафика, который описывает способ, которым пользователи получили доступ к видео.

dimensions=insightTrafficSourceType
metrics=views,estimatedMinutesWatched
filters=country==US

Ежедневное количество просмотров и время просмотра из разных источников трафика

Этот запрос получает количество ежедневных просмотров и примерное время просмотра видео канала за день. Метрики агрегируются ежедневно по источникам трафика и сортируются в хронологическом порядке.

dimensions=day,insightTrafficSourceType
metrics=views,estimatedMinutesWatched
sort=day

Топ-10 – поисковые запросы YouTube, которые генерируют больше всего трафика для видео.

Этот запрос извлекает 10 поисковых запросов, которые вызвали наибольшее количество просмотров в результатах поиска YouTube для одного или нескольких конкретных видео. Результаты отсортированы по количеству просмотров в порядке убывания. Обратите внимание: чтобы выполнить этот запрос в API Explorer, необходимо заменить строку VIDEO_ID в значении параметра filters списком, разделенным запятыми, длиной до 500 идентификаторов видео.

Например, вы можете запустить запрос для одного видео или заменить VIDEO_ID , чтобы определить условия поиска, которые генерируют наибольший трафик для этого видео. Вы также можете перечислить все видео в определенном плейлисте, чтобы определить, какие поисковые запросы генерируют наибольший трафик для любого из видео в этом плейлисте.

dimensions=insightTrafficSourceDetail
metrics=views
filters=video==VIDEO_ID;insightTrafficSourceType==YT_SEARCH
maxResults=10
sort=-views

Топ-10 — внешние веб-сайты, которые генерируют больше всего трафика для видео

Этот запрос извлекает 10 внешних веб-сайтов, которые сгенерировали наибольшее количество просмотров определенного видео или группы видео. Результаты отсортированы по предполагаемому времени просмотра в порядке убывания. Обратите внимание: чтобы выполнить этот запрос в API Explorer, необходимо заменить строку VIDEO_ID в значении параметра filters разделенным запятыми списком, содержащим до 500 идентификаторов видео для загруженных вами видео.

dimensions=insightTrafficSourceDetail
metrics=estimatedMinutesWatched,views
filters=video==VIDEO_ID;insightTrafficSourceType==EXT_URL
maxResults=25
sort=-estimatedMinutesWatched

Отчеты о плейлистах

Количество просмотров плейлистов и время просмотра из разных источников трафика в стране

Этот запрос получает количество просмотров ( агрегированный показатель видео ), просмотров плейлиста (показатель в плейлисте ), начала плейлиста и расчетное время просмотра для просмотров плейлиста в указанной стране. Метрики агрегируются по источникам трафика, который описывает способ, которым пользователи попали в плейлист.

dimensions=insightTrafficSourceType
metrics=views,estimatedMinutesWatchedplaylistStarts,playlistViews
filters=country==US

Количество просмотров плейлиста за день и время просмотра из разных источников трафика

Этот запрос получает данные о ежедневных просмотрах плейлиста на канале (показатель в плейлисте ), начале плейлиста и примерном времени просмотра. Он также получает общее количество просмотров ( агрегированный показатель видео ). Метрики агрегируются ежедневно по источникам трафика и сортируются в хронологическом порядке.

dimensions=day,insightTrafficSourceType
metrics=views,estimatedMinutesWatched,playlistStarts,playlistViews
sort=day

Устройство/ОС

Видеоотчеты

Ежедневные показатели типов устройств для операционной системы Android

Этот запрос получает количество ежедневных просмотров и примерное время просмотра на устройствах Android для видео определенного канала. Результаты сгруппированы по дням для каждого типа устройств, на которых происходило воспроизведение видео. Результаты отсортированы в хронологическом порядке.

dimensions=day,deviceType
metrics=estimatedMinutesWatched,views
filters=operatingSystem==ANDROID
sort=day

Ежедневные показатели операционной системы для мобильных устройств

Этот запрос получает количество ежедневных просмотров и примерное время просмотра на мобильных устройствах видео определенного канала. Результаты сгруппированы по дням для каждой операционной системы, в которой происходило воспроизведение видео. Результаты отсортированы в хронологическом порядке.

dimensions=day,operatingSystem
metrics=estimatedMinutesWatched,views
filters=deviceType==MOBILE
sort=day

Ежедневные показатели операционной системы и типа устройства

Этот запрос получает количество ежедневных просмотров и примерное время просмотра канала. Статистика сгруппирована по операционной системе и типу устройства. Результаты отсортированы в хронологическом порядке.

dimensions=day,operatingSystem,deviceType
metrics=estimatedMinutesWatched,views
sort=day

Отчеты о плейлистах

Ежедневные показатели типов устройств для просмотров плейлистов в операционной системе Android

Этот запрос извлекает ежедневные просмотры ( агрегированный показатель видео ), просмотры плейлистов (показатель в плейлисте ) и примерное время просмотра на устройствах Android для плейлистов определенного канала. Результаты сгруппированы по дням для каждого типа устройств, на которых были просмотры плейлистов. Результаты отсортированы в хронологическом порядке.

dimensions=day,deviceType
metrics=views,estimatedMinutesWatched,playlistViews
filters=operatingSystem==ANDROID
sort=day

Ежедневные показатели операционной системы по просмотрам плейлистов на мобильных устройствах

Этот запрос извлекает ежедневные просмотры ( агрегированный показатель видео ), просмотры плейлистов (показатели в плейлистах ) и расчетное время просмотра на мобильных устройствах плейлистов определенного канала. Результаты сгруппированы по дням для каждой операционной системы, в которой происходили просмотры плейлистов. Результаты отсортированы в хронологическом порядке.

dimensions=day,operatingSystem
metrics=views,estimatedMinutesWatched
filters=deviceType==MOBILE
sort=day

Демографический

Видеоотчеты

Демографические данные зрителей в Калифорнии (возрастная группа и пол)

В этом отчете собраны статистические данные о возрастной группе и поле зрителей в Калифорнии, которые смотрели видео канала. Результаты сортируются по полу, а затем по возрастной группе. Этот запрос можно изменить для получения одной и той же статистики для всех зрителей по всему миру или для всех зрителей в стране, континенте, субконтиненте или другом штате США, изменив значение параметра filters .

dimensions=ageGroup,gender
metrics=viewerPercentage
filters=province==US-CA
sort=gender,ageGroup

Отчеты о плейлистах

Демографические данные о зрителях плейлистов в Калифорнии (возрастная группа и пол)

В этом отчете собраны статистические данные о возрастной группе и поле зрителей в Калифорнии, которые смотрели плейлисты канала. Результаты сортируются по полу, а затем по возрастной группе. Этот запрос можно изменить для получения одной и той же статистики для всех зрителей по всему миру или для всех зрителей в стране, континенте, субконтиненте или другом штате США, изменив значение параметра filters .

dimensions=ageGroup,gender
metrics=viewerPercentage
filters=province==US-CA
sort=gender,ageGroup

Социальный

Показатели общего доступа, агрегированные по сервисам, где были опубликованы видео.

Этот запрос получает количество раз, когда пользователи использовали кнопку Share чтобы поделиться видео канала. Результаты агрегируются по сервисам обмена (Google+, Twitter и т. д.) и сортируются по убыванию количества акций.

dimensions=sharingService
metrics=shares
sort=-shares

Удержание аудитории

Показатели удержания аудитории для видео

В этом отчете измеряется способность видео удерживать аудиторию. Отчет можно получить только для одного видео одновременно. Обратите внимание: чтобы выполнить этот запрос в API Explorer, вам необходимо заменить строку VIDEO_ID в значении параметра filters на идентификатор видео для одного из загруженных вами видео. Обратите внимание, что отчеты об удержании аудитории не поддерживают возможность указания нескольких значений для video .

В этом примере отчет использует фильтр audienceType , чтобы ограничить ответ, чтобы он содержал только данные для обычных просмотров, которые являются результатом прямого действия пользователя, такого как поиск видео или щелчок по предложенному видео. Таким образом, в отчет не включены данные о просмотрах объявлений TrueView In-Stream или TrueView In-Display. Вы можете удалить фильтр, чтобы получить данные об удержании аудитории видео для всех типов аудитории.

Обратите внимание, что данные для фильтра audienceType доступны по состоянию на 25 сентября 2013 г. API не будет возвращать данные для запросов, использующих фильтр для получения данных за более ранние даты. Запросы, не использующие фильтр, работают для любой даты после 1 июля 2008 г.

dimensions=elapsedVideoTimeRatio
metrics=audienceWatchRatio,relativeRetentionPerformance
filters=video==VIDEO_ID;audienceType==ORGANIC

Доход/Реклама

Доход канала и показатели эффективности рекламы

Этот запрос получает данные о доходе канала и эффективности рекламы. Отчет возвращает одну строку данных, содержащую итоговые значения для каждого запрошенного показателя за указанный диапазон дат.

metrics=views,estimatedRevenue,estimatedAdRevenue,estimatedRedPartnerRevenue,grossRevenue,adImpressions,cpm,playbackBasedCpm,monetizedPlaybacks

Ежедневные показатели дохода и эффективности рекламы

Этот запрос получает ежедневный доход канала и показатели эффективности рекламы.

dimensions=day
metrics=views,estimatedRevenue,estimatedAdRevenue,estimatedRedPartnerRevenue,grossRevenue,adImpressions,cpm,playbackBasedCpm,monetizedPlaybacks

Показатели дохода и эффективности рекламы для конкретной страны

Этот запрос получает данные о доходе канала в конкретной стране и показатели эффективности рекламы. Результаты отсортированы в порядке убывания суммы дохода. Это означает, что первой в списке будет страна, в которой партнер получил наибольший чистый доход.

dimensions=country
metrics=views,estimatedRevenue,estimatedAdRevenue,estimatedRedPartnerRevenue,grossRevenue,adImpressions,cpm,playbackBasedCpm,monetizedPlaybacks
sort=-estimatedRevenue

Топ-10 – видео с наибольшим доходом

Этот запрос получает показатели дохода и эффективности рекламы для 10 видео канала с наибольшим доходом. Результаты отсортированы в порядке убывания суммы дохода. Это означает, что первым видео будет то, которое принесло наибольший расчетный доход.

dimensions=video
metrics=views,estimatedRevenue,estimatedAdRevenue,estimatedRedPartnerRevenue,grossRevenue,adImpressions,cpm,playbackBasedCpm,monetizedPlaybacks
maxResults=10
sort=-estimatedRevenue

Показатели эффективности рекламы для разных типов объявлений

Этот запрос получает показатели эффективности рекламы для контента, на который заявлены права владельца. Результаты сгруппированы по типам объявлений, что позволяет сравнивать доходы и значения цены за тысячу показов для разных типов объявлений.

dimensions=adType
metrics=grossRevenue,adImpressions,cpm
filters=claimedStatus==claimed
sort=-adType

Отчеты владельца контента

Основная статистика

Видеоотчеты

Общее количество просмотров, расчетное время просмотра и другие данные для всего контента, на который заявлены права.

Этот запрос получает агрегированные показатели для контента, на который заявлены права владельца контента. Отчет возвращает одну строку данных, содержащую итоговые значения для каждого запрошенного показателя за указанный диапазон дат.

metrics=views,comments,likes,dislikes,estimatedMinutesWatched,averageViewDuration
filters=claimedStatus==claimed

Количество просмотров (и не только) для всех самостоятельно загружаемых видео в зависимости от страны.

Этот запрос получает показатели для конкретной страны для видео, загруженных владельцем контента. Отчет возвращает одну строку данных, содержащую итоговые значения для каждого запрошенного показателя за указанный диапазон дат.

metrics=views,comments,likes,dislikes,shares
filters=uploaderType==self;country==FR

Общее количество просмотров (и не только) для всего стороннего контента, на который заявлены права.

Этот запрос получает агрегированные показатели для видео, на которые владелец контента заявил права, но не загрузил их. Отчет возвращает одну строку данных, содержащую итоговые значения для каждого запрошенного показателя за указанный диапазон дат.

metrics=views,comments,likes,dislikes,shares
filters=uploaderType==thirdParty;claimedStatus==claimed

Общее количество просмотров (и не только) для всего контента, загруженного самостоятельно.

Этот запрос получает агрегированные показатели для видео, загруженных владельцем контента. Отчет возвращает одну строку данных, содержащую итоговые значения для каждого запрошенного показателя за указанный диапазон дат.

metrics=views,comments,likes,dislikes,estimatedMinutesWatched
filters=uploaderType==self

Общее количество просмотров (и не только) для всего заявленного самостоятельно загруженного контента.

Этот запрос получает агрегированные показатели для видео, которые владелец контента загрузил и на которые также заявили права. Отчет возвращает одну строку данных, содержащую итоговые значения для каждого запрошенного показателя за указанный диапазон дат.

metrics=views,comments,likes,dislikes,estimatedMinutesWatched
filters=uploaderType==self;claimedStatus==claimed

Топ-10 – самые просматриваемые видео для владельца контента

Этот запрос извлекает 10 наиболее просматриваемых видео, измеренных по количеству просмотров в течение указанного диапазона дат, которые загрузил владелец контента. Результаты отсортированы по количеству просмотров в порядке убывания.

dimensions=video
metrics=views,estimatedMinutesWatched,estimatedRevenue,estimatedAdRevenue,monetizedPlaybacks,adImpressions
filters=uploaderType==self
maxResults=10
sort=-views

Топ-10 — самые просматриваемые видео для владельцев контента

Этот запрос извлекает 10 наиболее просматриваемых видео, измеренных по приблизительному количеству минут просмотра в течение указанного диапазона дат, которые загрузил владелец контента. Результаты отсортированы по примерному количеству просмотренных минут в порядке убывания.

dimensions=video
metrics=estimatedMinutesWatched,averageViewDuration,averageViewPercentage,views,subscribersGained
filters=uploaderType==self
maxResults=10
sort=-estimatedMinutesWatched

Топ-10 – самые просматриваемые видео на канале владельца контента.

Этот запрос извлекает 10 наиболее просматриваемых видео для определенного канала или группы каналов, которыми управляет владелец контента. Результаты отсортированы по количеству просмотров в порядке убывания. Обратите внимание: чтобы выполнить этот запрос в API Explorer, необходимо заменить строку CHANNEL_ID в значении параметра filters разделенным запятыми списком, содержащим до 500 идентификаторов каналов для ваших каналов.

dimensions=video
metrics=views
filters=channel==CHANNEL_ID
maxResults=10
sort=-views

Топ-10 – рейтинг кликов аннотаций для самых просматриваемых видео на канале.

Этот запрос получает количество просмотров, рейтинг кликов по аннотациям, коэффициент закрытия аннотаций и количество показов аннотаций для 10 наиболее просматриваемых видео на указанном канале или группе каналов. Результаты сортируются по количеству просмотров в порядке убывания, что означает, что наиболее просматриваемое видео будет указано первым. Обратите внимание: чтобы выполнить этот запрос в API Explorer, необходимо заменить строку CHANNEL_ID в значении параметра filters разделенным запятыми списком, содержащим до 500 идентификаторов каналов для ваших каналов.

dimensions=video
metrics=views,likes,annotationClickThroughRate,annotationCloseRate,annotationImpressions
filters=channel==CHANNEL_ID
maxResults=10
sort=-views

Отчеты о плейлистах

Просмотры плейлистов для каналов владельца контента

Этот запрос получает общее количество запусков плейлиста, приблизительное количество просмотров плейлиста, количество просмотров плейлиста и количество просмотров на начало плейлиста для плейлистов на каналах владельца контента. Метрика playlistViews учитывает только просмотры видео, произошедшие в контексте плейлиста. Поскольку все запрошенные метрики являются метриками списка воспроизведения, запрос также не требует включения фильтра списка воспроизведения или группы .

metrics=playlistViews,playlistStarts,playlistEstimatedMinutesWatched,viewsPerPlaylistStart

Статистика по конкретному плейлисту

Этот запрос получает общее количество запусков плейлиста, расчетное количество просмотренных минут, просмотры ( агрегированный показатель видео ), просмотры плейлиста (показатель в плейлисте ) и количество просмотров на начало плейлиста для определенного плейлиста. Обратите внимание: чтобы выполнить этот запрос в API Explorer, необходимо заменить строку PLAYLIST_ID в значении параметра filters на идентификатор плейлиста для плейлиста в одном из каналов владельца контента.

metrics=views,estimatedMinutesWatched,playlistStarts,playlistViews,viewsPerPlaylistStart
filters=playlist==PLAYLIST_ID

Чтобы получить совокупную статистику для нескольких списков воспроизведения, вы также можете заменить строку PLAYLIST_ID списком, разделенным запятыми, содержащим до 500 идентификаторов списков воспроизведения для списков воспроизведения на каналах владельца контента.

На основе времени

Видеоотчеты

Ежедневные показатели времени просмотра самостоятельно загружаемого контента

Этот запрос получает ежедневные показатели времени просмотра, а также количество просмотров, количество монетизированных воспроизведений и количество показов видео, загруженных владельцем контента. Отчет возвращает одну строку данных для каждого дня в запрошенном диапазоне дат, строки сортируются в хронологическом порядке.

dimensions=day
metrics=estimatedMinutesWatched,averageViewPercentage,views,monetizedPlaybacks,adImpressions
filters=uploaderType==self
sort=day

Показатели аннотаций для заявленного контента

Этот запрос получает количество ежедневных просмотров, рейтинг кликов по аннотациям, коэффициент закрытия аннотаций и количество показов аннотаций для контента, на который заявлены права владельца контента. Результаты отсортированы в хронологическом порядке.

dimensions=day
metrics=views,likes,annotationClickThroughRate,annotationCloseRate,annotationImpressions
filters=claimedStatus==claimed
sort=day

Отчеты о плейлистах

Ежедневные просмотры плейлистов для владельца контента

Этот запрос получает показатели ежедневного взаимодействия пользователей с видео в плейлистах владельца контента. Метрики, полученные в отчете, — это playlistViews , playlistStars , playlistEstimatedMinutesWatched иviewPerPlaylistStart . Все эти показатели являются показателями плейлиста . Поскольку все запрошенные метрики являются метриками списка воспроизведения, запрос не обязательно должен включать фильтр списка воспроизведения или групповой фильтр.

dimensions=day
metrics=playlistViews,playlistStarts,playlistEstimatedMinutesWatched,viewsPerPlaylistStart
sort=day

Географический

Видеоотчеты

Показатели времени просмотра для самостоятельно загружаемого контента в зависимости от страны

Этот запрос получает количество просмотров, показатели времени просмотра и расчетный доход от рекламы для каждой страны. Показатели относятся к видео, загруженным владельцем контента. Отчет возвращает одну строку данных для каждой страны, где были просмотрены видео, а строки отсортированы по убыванию количества минут просмотра.

dimensions=country
metrics=views,estimatedMinutesWatched,averageViewDuration,averageViewPercentage,estimatedRevenue,estimatedAdRevenue,grossRevenue
filters=uploaderType==self
sort=-estimatedMinutesWatched

Показатели аннотаций для самостоятельно загружаемого контента для конкретной страны

Этот запрос получает количество просмотров для конкретной страны, рейтинг кликов аннотаций, коэффициент закрытия аннотаций и количество показов аннотаций для загруженных владельцем контента видео. Результаты отсортированы по рейтингу кликов аннотаций в порядке убывания. Это означает, что первой будет указана страна с самым высоким рейтингом кликов аннотаций.

dimensions=country
metrics=views,likes,annotationClickThroughRate,annotationCloseRate,annotationImpressions
filters=uploaderType==self
sort=-annotationClickThroughRate

Показатели по конкретным провинциям для штатов США и Вашингтона, округ Колумбия

Этот запрос получает разбивку по провинциям по количеству просмотров, примерному количеству просмотренных минут и средней продолжительности просмотра видео, на которые заявлены права владельца контента. Данные охватывают штаты США и Вашингтон. Результаты отсортированы в алфавитном порядке по кодам провинций ISO 3166-2.

dimensions=province
metrics=views,estimatedMinutesWatched,averageViewDuration
filters=claimedStatus==claimed;country==US
sort=province

Топ-10 городов США по общему количеству просмотров

Этот запрос возвращает список из 10 городов США, на которые приходится наибольшее количество просмотров видео, на которые заявлены права владельца контента, в течение указанного диапазона дат. Запрос можно изменить для запроса данных по другой стране , выбрав другое допустимое значение для этого фильтра. Аналогично, запрос можно изменить для получения данных по субконтиненту, например Западной Европе или Юго-Восточной Азии, используя фильтр «Субконтинент» и одно из его допустимых значений. Другие фильтры также поддерживаются. Результаты отсортированы по количеству просмотров в порядке убывания.

    dimensions=city
metrics=views
filters=claimedStatus==claimed;country==US
maxResults=10
sort=-views

Топ-10 городов США по общему количеству просмотров для каждого типа контента

Этот запрос возвращает список из 10 городов США, на которые приходится наибольшее количество просмотров заявленного владельцем контента контента в течение указанного диапазона дат для каждого поддерживаемого типа CreatorContentType . Результаты отсортированы по количеству просмотров в порядке убывания.

    dimensions=city,creatorContentType
metrics=views
filters=claimedStatus==claimed;country==US
maxResults=10
sort=-views

Топ-10 городов США по общему времени просмотра

Этот запрос возвращает список из 10 самых популярных дней в течение указанного диапазона дат, когда в каком-либо городе США наблюдалось наибольшее общее ежедневное время просмотра заявленного владельцем контента контента. Результаты запроса определяют общее время просмотра, дату, когда это время произошло, и город, в котором, по оценкам, контент был просмотрен. Результаты отсортированы в порядке убывания общего времени просмотра.

    dimensions=city,day
metrics=estimatedWatchTime
filters=claimedStatus==claimed;country==US
maxResults=10
sort=-estimatedWatchTime

Топ-10 – Самые просматриваемые видео в Европе

Этот запрос извлекает 10 самых просматриваемых видео в Европе среди видео, на которые заявлены права владельца контента, по количеству просмотров в течение указанного диапазона дат. Запрос можно изменить для запроса данных для другого континента , выбрав другое допустимое значение для этого фильтра. Аналогично, запрос можно изменить для получения данных по субконтиненту, например Западной Европе или Юго-Восточной Азии, с помощью фильтра «Субконтинент» и одного из его допустимых значений. Результаты отсортированы по количеству просмотров в порядке убывания.

dimensions=video
metrics=views,estimatedMinutesWatched,likes,subscribersGained
filters=claimedStatus==claimed;filters=continent==150
maxResults=10
sort=-estimatedMinutesWatched

Отчеты о плейлистах

Показатели времени просмотра для плейлистов владельца контента для конкретной страны

Этот запрос позволяет получить количество просмотров плейлистов для конкретной страны и показатели времени просмотра плейлистов для всех плейлистов на каналах владельца контента. Отчет возвращает одну строку данных для каждой страны, в которой просматривались плейлисты. Строки отсортированы по убыванию количества минут просмотра.

dimensions=country
metrics=playlistViews,playlistEstimatedMinutesWatched,playlistStarts,averageTimeInPlaylist
sort=-playlistEstimatedMinutesWatched

Топ-10 – Самые запускаемые плейлисты в США

Этот запрос извлекает 10 плейлистов из каналов владельца контента, которые зрители в США начали смотреть чаще всего в течение указанного диапазона дат. Результаты отсортированы по количеству запусков плейлиста в порядке убывания.

Примечание. Поскольку в этом отчете используется измерение playlist , необходимо указать значение параметра запроса sort , а также установить для параметра maxResults целое значение 10 или меньше.

dimensions=playlist
metrics=playlistStarts,playlistViews,playlistEstimatedMinutesWatched,playlistAverageViewDuration
filters=country==US
maxResults=10
sort=-playlistStarts

Детали воспроизведения

Видеоотчеты

Что нравится и что не нравится по типу контента

Этот запрос извлекает количество лайков и антипатий для каждого типа контента на определенном канале или группе каналов. Обратите внимание: чтобы выполнить этот запрос в API Explorer, необходимо заменить строку CHANNEL_ID в значении параметра filters разделенным запятыми списком, содержащим до 500 идентификаторов каналов для ваших каналов.

dimensions=creatorContentType
metrics=likes,dislikes
filters=channel==CHANNEL_ID

Место воспроизведения

Видеоотчеты

Количество просмотров и время просмотра из разных мест воспроизведения

Этот запрос получает количество просмотров и примерное время просмотра видео, загруженных на определенный канал или группу каналов. Результаты агрегируются в зависимости от типа страницы или приложения, где происходило воспроизведение видео, и сортируются в порядке убывания количества просмотров. Обратите внимание: чтобы выполнить этот запрос в API Explorer, необходимо заменить строку CHANNEL_ID в значении параметра filters разделенным запятыми списком, содержащим до 500 идентификаторов каналов для ваших каналов.

dimensions=insightPlaybackLocationType
metrics=estimatedMinutesWatched,views
filters=channel==CHANNEL_ID
sort=-views

Количество просмотров за день и время просмотра из разных мест воспроизведения

Этот запрос позволяет получить количество ежедневных просмотров и примерное время просмотра в США видео, загруженных на определенный канал или группу каналов. Результаты сгруппированы по дням для каждого типа страниц или приложений, где происходило воспроизведение видео. Результаты отсортированы в обратном хронологическом порядке. Обратите внимание: чтобы выполнить этот запрос в API Explorer, необходимо заменить строку CHANNEL_ID в значении параметра filters разделенным запятыми списком, содержащим до 500 идентификаторов каналов для ваших каналов.

dimensions=day,insightPlaybackLocationType
metrics=estimatedMinutesWatched,views
filters=country==US;channel==CHANNEL_ID
sort=-day

Топ-10 – сторонние сайты, которые генерируют наибольшее количество просмотров встроенного видео.

Этот запрос получает количество просмотров и примерное время просмотра определенного видео или группы видео. Результаты сгруппированы по стороннему сайту, на который было встроено видео. Результаты отсортированы в порядке убывания количества просмотров. Обратите внимание, что для запуска этого запроса в APIS Explorer необходимо заменить строку VIDEO_ID в значении параметра filters со списком, разделенным за запятушкой, из 500 видео идентификаторов для загруженных видео.

dimensions=insightPlaybackLocationDetail
metrics=views,estimatedMinutesWatched
filters=video==VIDEO_ID;insightPlaybackLocationType==EMBEDDED
maxResults=10
sort=-views

Отчеты плейлиста

Подсчет просмотра плейлиста и время наблюдения за разными местами воспроизведения

Этот запрос получает количество просмотров плейлиста, плейлиста оценил время наблюдения, и список воспроизведения начинается для всех плейлистов в каналах владельца контента. Результаты агрегируются на основе типа страницы или приложения, где произошли воспроизведения видео, а результаты отсортированы в порядке убывания по началам плейлиста.

dimensions=insightPlaybackLocationType
metrics=playlistViews,playlistEstimatedMinutesWatched,playlistStarts
sort=-playlistStarts

Подсчет просмотра плейлиста и время наблюдения за разными местами воспроизведения

Этот запрос запускает Daily Playlist Spartslist, количество видов плейлиста, и плейлист оценил время наблюдения в Соединенных Штатах для всех плейлистов в каналах владельца контента. Результаты возвращаются для каждого типа страницы или приложения, где произошли представления плейлиста.

dimensions=day,insightPlaybackLocationType
metrics=playlistStarts,playlistViews,playlistEstimatedMinutesWatched
filters=country==US

Источник трафика

Видео отчеты

ViewCounts и время наблюдения из разных источников трафика

Этот запрос получает количество просмотров и предполагаемое время наблюдения за видео владельца контента. Метрики агрегируются источником трафика, который описывает способ, с помощью которого пользователи достигли видео.

dimensions=insightTrafficSourceType
metrics=views,estimatedMinutesWatched
filters=uploaderType==self

Daily View Counts и время наблюдения из разных источников трафика

Этот запрос получает ежедневное количество просмотров и ежедневное время для просмотра видео -видео. Метрики ежедневно агрегируются по источнику трафика и сортируются в обратном хронологическом порядке.

dimensions=day,insightTrafficSourceType
metrics=views,estimatedMinutesWatched
filters=uploaderType==self
sort=-day

ПРИМЕЧАНИЕ. Следующие два отчета примера поддерживаются только для конкретных источников трафика. VIDEO_REMIXES , NOTIFICATION , END_SCREEN , CAMPAIGN_CARD , VIDEO_REMIXES и NO_LINK_EMBEDDED Источники трафика являются одними из неподдерживаемых.

Топ -10 - термины поиска на YouTube, которые генерируют наибольшее трафик для видео

Этот запрос получает 10 поисковых терминов, которые сгенерировали наибольшее количество просмотров из результатов поиска YouTube для конкретного видео или группы видео. Результаты отсортируются по подсчету в порядке убывания. Обратите внимание, что для запуска этого запроса в APIS Explorer необходимо заменить строку VIDEO_ID в значении параметра filters со списком, разделенным за запятушкой, из 500 видео идентификаторов для загруженных видео.

dimensions=insightTrafficSourceDetail
metrics=views
filters=video==VIDEO_ID;insightTrafficSourceType==YT_SEARCH
maxResults=10
sort=-views

Топ -10 - внешние веб -сайты, которые генерируют большинство трафика для видео

Этот запрос получает 10 внешних веб -сайтов, которые сгенерировали наибольшее количество просмотров из результатов поиска Google для конкретного видео или группы видео. Результаты отсортируются по расчетному времени наблюдения в порядке убывания. Обратите внимание, что для запуска этого запроса в APIS Explorer необходимо заменить строку VIDEO_ID в значении параметра filters со списком, разделенным за запятушкой, из 500 видео идентификаторов для загруженных видео.

dimensions=insightTrafficSourceDetail
metrics=estimatedMinutesWatched,views
filters=video==VIDEO_ID;insightTrafficSourceType==EXT_URL
maxResults=25
sort=-estimatedMinutesWatched

Отчеты плейлиста

Подсчет просмотра плейлиста и время наблюдения из разных источников трафика в стране

Этот запрос получает количество просмотров плейлиста, запускается плейлист, и плейлист оценил время наблюдения за просмоткой плейлиста в указанной стране. Метрики агрегируются источником трафика, который описывает способ, которым пользователи достигли списка воспроизведения.

dimensions=insightTrafficSourceType
metrics=playlistViews,playlistStarts,playlistEstimatedMinutesWatched
filters=country==US

Подсчет просмотра плейлиста и время наблюдения из разных источников трафика

Этот запрос получает просмотры плейлиста, запускается плейлист, и плейлист оценил время наблюдения за плейлистами в одном или нескольких каналах владельца контента. Метрики агрегируются источником трафика. Обратите внимание, что чтобы запустить этот запрос в APIS Explorer, вы должны заменить строку CHANNEL_ID в значении параметра filters со списком, разделенным за запятушкой, из 500 идентификаторов канала для ваших каналов.

dimensions=day,insightTrafficSourceType
metrics=playlistViews,playlistStarts,playlistEstimatedMinutesWatched
filters=channel==CHANNEL_ID

Устройство/ОС

Видео отчеты

Ежедневные метрики типа устройства для заявленных видеороликов

Этот запрос получает ежедневное количество просмотра и предполагаемое время наблюдения по типу устройства для видео, заявленных конкретным владельцем контента. Результаты сгруппированы днем ​​для каждого типа устройства, где произошли воспроизведения видео. Результаты отсортированы в хронологическом порядке.

dimensions=day,deviceType
metrics=estimatedMinutesWatched,views
filters=claimedStatus==claimed
sort=day

Ежедневные метрики операционной системы для заявленных видеороликов, просмотренных на мобильных устройствах

Этот запрос получает подсчет ежедневного просмотра и предполагаемое время наблюдения за операционной системой для просмотров видео, заявленных указанным владельцем контента, который имел место на мобильных устройствах. Результаты сгруппированы днем ​​для каждой операционной системы, где произошли воспроизведения видео. Результаты отсортированы в хронологическом порядке.

dimensions=day,operatingSystem
metrics=estimatedMinutesWatched,views
filters=claimedStatus==claimed;deviceType==MOBILE
sort=day

Ежедневная операционная система и метрики типа устройства

Этот запрос извлекает подсчет ежедневного просмотра и предполагаемое время наблюдения для видео, заявленных конкретным владельцем контента. Статистика сгруппирована с помощью операционной системы и типа устройства. Результаты отсортированы в хронологическом порядке.

dimensions=day,operatingSystem,deviceType
metrics=estimatedMinutesWatched,views
sort=day

Отчеты плейлиста

Метрики типа устройства для просмотров плейлиста в операционной системе Android

Этот запрос извлекает подсчет плейлиста и плейлист оценил время наблюдения на устройствах Android для плейлистов в одном или нескольких каналах владельца контента. Результаты возвращаются для каждого типа устройства, где произошли представления плейлиста. Обратите внимание, что чтобы запустить этот запрос в APIS Explorer, вы должны заменить строку CHANNEL_ID в значении параметра filters со списком, разделенным за запятушкой, из 500 идентификаторов канала для ваших каналов.

dimensions=deviceType
metrics=playlistViews,playlistEstimatedMinutesWatched
filters=channel==CHANNEL_ID;operatingSystem==ANDROID

Метрики операционной системы для просмотров плейлиста на мобильных устройствах

Этот запрос получает количество плейлиста плейлиста и плейлист оценил время наблюдения на мобильных устройствах для плейлистов в любом из каналов владельца контента. Результаты возвращаются для каждой операционной системы, в которой произошли представления плейлиста.

dimensions=operatingSystem
metrics=views,estimatedMinutesWatched
filters=deviceType==MOBILE

Демографический

Видео отчеты

Демография зрителя в Калифорнии (возрастная группа и пол)

Этот отчет дает статистику о возрастной группе и поле зрителей в Калифорнии, которые наблюдали за заявленным контентом владельца контента. Результаты сортируются по полу, а затем по возрастной группе. Этот запрос может быть изменен, чтобы получить одну и ту же статистику для всех зрителей по всему миру или всем зрителям в стране, континенте, субконтиненте или другое состояние США путем настройки значения параметра filters .

dimensions=ageGroup,gender
metrics=viewerPercentage
filters=claimedStatus==claimed;province==US-CA
sort=gender,ageGroup

Социальный

Обмен показателями, агрегированные по обслуживанию, где были переданы видео

Этот запрос получает количество раз, когда пользователи использовали кнопку Share , чтобы обмениваться видео, которые загрузил владелец контента. Результаты агрегируются путем обмена услугами (Google+, Twitter и т. Д.) И отсортируются в порядке убывания количества акций.

dimensions=sharingService
metrics=shares
filters=uploaderType==self
sort=-shares

Удержание аудитории

Метрики удержания аудитории для видео

Этот отчет измеряет способность видео сохранять свою аудиторию. Отчет может быть получен только для одного видео за раз. Обратите внимание, что для запуска этого запроса в APIS Explorer вы должны заменить строку VIDEO_ID в значении параметра filters на видео идентификатор для одного из ваших загруженных видео. Обратите внимание, что отчеты о хранении аудитории не поддерживают возможность указать несколько значений для video .

В этом примере в отчете используется фильтр audienceType для ограничения ответа, чтобы он содержит только данные для органических представлений, которые являются результатом прямого действия пользователя, таких как поиск видео или нажмите на предлагаемое видео. Таким образом, отчет не включает данные для представлений от TrueView In-Stream или TrueView в дисков. Вы можете удалить фильтр, чтобы получить данные о хранении аудитории видео от всех типов аудитории.

Обратите внимание, что данные для фильтра audienceType доступны по состоянию на 25 сентября 2013 года. API не будет возвращать данные для запросов, которые используют фильтр, чтобы попытаться извлечь данные из более ранних дат. Запросы, которые не используют работу фильтра на любую дату после 1 июля 2008 года.

dimensions=elapsedVideoTimeRatio
metrics=audienceWatchRatio,relativeRetentionPerformance
filters=video==VIDEO_ID;audienceType==ORGANIC

Доход/реклама

Метрики доходов и производительности рекламы для заявленного контента

Этот запрос получает показатели доходов и рекламных показателей для заявленного контента владельца контента. Отчет возвращает одну строку данных, которая содержит итоги для каждой запрашиваемой метрики во время указанного диапазона дат.

metrics=views,estimatedRevenue,estimatedAdRevenue,estimatedRedPartnerRevenue,grossRevenue,adImpressions,cpm,playbackBasedCpm,monetizedPlaybacks
filters=claimedStatus==claimed

Ежедневные доходы и показатели эффективности рекламы

Этот запрос получает ежедневные показатели доходов и производительности рекламы для заявленного контента владельца контента.

dimensions=day
metrics=views,estimatedRevenue,estimatedAdRevenue,estimatedRedPartnerRevenue,grossRevenue,adImpressions,cpm,playbackBasedCpm,monetizedPlaybacks
filters=claimedStatus==claimed

Страновые доходы и показатели эффективности рекламы

Этот запрос получает показатели доходов и производительности рекламы для конкретного страны для заявленного контента владельца контента. Результаты сортируются в порядке убывания по сумме дохода, что означает, что первая перечисленная страна будет той, где партнер получил наибольший оценочный доход.

dimensions=country
metrics=views,estimatedRevenue,estimatedAdRevenue,estimatedRedPartnerRevenue,grossRevenue,adImpressions,cpm,playbackBasedCpm,monetizedPlaybacks
filters=claimedStatus==claimed
sort=-estimatedRevenue

Топ -10 - видео с самым высоким доходом

Этот запрос получает показатели доходов и производительности рекламы для 10 видеороликов, в которых утверждается владелец контента, и это имел самый высокий доход. Результаты сортируются в порядке убывания по сумме дохода, что означает, что первое видео будет тем, которое получит самый высокий оценочный доход.

dimensions=video
metrics=views,estimatedRevenue,estimatedAdRevenue,estimatedRedPartnerRevenue,grossRevenue,adImpressions,cpm,playbackBasedCpm,monetizedPlaybacks
filters=claimedStatus==claimed
maxResults=10
sort=-estimatedRevenue

Метрики производительности рекламы для разных типов рекламы

Этот запрос получает показатели производительности рекламы для заявленного контента владельца контента. Результаты сгруппированы по типу AD, что позволяет сравнить доходы и значения CPM по разным типам AD.

dimensions=adType
metrics=grossRevenue,adImpressions,cpm
filters=claimedStatus==claimed
sort=-adType

,

На этой странице показаны образцы запросов API API YouTube. В каждом примере кратко описывается полученный отчет, а затем показывает соответствующие dimensions , metrics , filters и sort значений параметров. ( Отчеты о каналах и документах владельца контента сообщают о документах, определяющих отчеты, которые поддерживает API.)

Каждый пример ссылается на и заполняет проводник Google APIS с указанными значениями. Примеры также используют даты начала и окончания по умолчанию ( YYYY-MM-DD ) 2023-09-01 и 2024-03-31 .

После ссылки на APIS Explorer, вы все равно должны указать владелец канала или контента, для которого вы получаете отчеты. APIS Explorer заполнит значение параметра ids с помощью channel==MINE или contentOwner==CONTENT_OWNER_ID , в зависимости от запроса, который вы нажали. Для отчетов о каналах вы можете изменить MINE на канал аутентифицированного пользователя. Для отчетов владельца контента вам необходимо заменить CONTENT_OWNER_ID на идентификатор владельца контента.

Вы также должны быть аутентифицированы как указанный канал или владелец контента, чтобы APIS Explorer мог разрешить ваши запросы API с помощью OAuth 2.0 .

1. Запросы на сортировку по нескольким измерениям/метрикам
2. Отчеты о каналах
3. Владелец контента отчеты

Запросы на сортировку по нескольким измерениям/метрикам

API поддерживает возможность сортировать данные ответа с использованием нескольких измерений или метрик. Например, приведенный ниже запрос получает ежедневные данные источника трафика для видео определенного канала. Каждая строка в наборе результатов идентифицирует количество просмотров и предполагаемое время наблюдения, которое происходило из конкретного типа источника трафика (например, EXT_URL ) в определенный день.

dimensions=day,insightTrafficSourceType
metrics=views,estimatedWatchTime
sort=day,-views

В ответе результаты отсортированы хронологически. В рамках набора результатов для каждого дня результаты отсортируются в порядке убывания по количеству взглядов. Таким образом, первая строка в наборе результатов содержит данные для источника трафика, который генерировал большинство представлений в первый день в запрошенном диапазоне дат. Второй ряд содержит данные для источника трафика, который генерировал следующее самое большое количество просмотров в первый день.

Отчеты о каналах

Основная статистика

Видео отчеты

Общее количество обзора, расчетное время наблюдения и больше для канала

Этот запрос получает агрегированные метрики для содержания канала. Отчет возвращает одну строку данных, которая содержит итоги для каждой запрашиваемой метрики во время указанного диапазона дат.

metrics=views,comments,likes,dislikes,estimatedMinutesWatched,averageViewDuration

Специфичное количество видов (и многое другое) для канала

Этот запрос извлекает метрики для конкретной страны для видео канала. Отчет возвращает одну строку данных, которая содержит итоги для каждой запрашиваемой метрики во время указанного диапазона дат.

metrics=views,comments,likes,dislikes,estimatedMinutesWatched
filters=country==US

Топ 10 - большинство смотрели видео на канал

Этот запрос получает 10 самых просмотренных видео канала, измеренные по оценкам, просмотренным в указанном диапазоне дат. Результаты отсортируются по расчетным минутам, наблюдаемым в порядке убывания.

Примечание. Этот отчет требует, чтобы вы указали значение для параметра запроса sort и установить параметр maxResults на целочисленное значение 10 или менее.

dimensions=video
metrics=estimatedMinutesWatched,views,likes,subscribersGained
maxResults=10
sort=-estimatedMinutesWatched

Топ-10-Анотация по проведению кликов для самых просмотренных видео

Этот запрос извлекает подсчет просмотра, анонтные показатели кликов, ставки по закрытию аннотации и впечатления от аннотации для 10 наиболее просмотренных видео канала. Результаты отсортируются по подсчету просмотра в порядке убывания, что означает, что наиболее просмотренное видео будет перечислено первым.

Примечание. Этот отчет требует, чтобы вы указали значение для параметра запроса sort и установить параметр maxResults на целочисленное значение 10 или менее.

dimensions=video
metrics=views,likes,annotationClickThroughRate,annotationCloseRate,annotationImpressions
maxResults=10
sort=-views

Отчеты плейлиста

Общий просмотр плейлиста для канала

Этот запрос получает Total Playlist Sparts, Searted Minate Scileded, Views ( агрегированная видеометра ), просмотры плейлиста (метрика в игре ) и просмотры за список воспроизведения для списков воспроизведения в канале аутентифицированного пользователя.

metrics=views,estimatedMinutesWatched,playlistStarts,playlistViews,viewsPerPlaylistStart

Статистика для конкретного плейлиста

Этот запрос получает Total Playlist Sparts, Searted Minate Scileded, Views ( агрегированная видеометра ), просмотры плейлиста (метрика в игре ) и просмотры за список воспроизведения для конкретного списка воспроизведения. Обратите внимание, что для запуска этого запроса в APIS Explorer вы должны заменить строку PLAYLIST_ID в значении параметра filters на идентификатор плейлиста для плейлиста в канале аутентифицированного пользователя.

metrics=views,estimatedMinutesWatched,playlistStarts,playlistViews,viewsPerPlaylistStart
filters=playlist==PLAYLIST_ID

Чтобы получить совокупную статистику для нескольких списков воспроизведения, вы также можете заменить строку PLAYLIST_ID в списке, разделенных запятыми, из 500 идентификаторов воспроизведения для списков воспроизведения в канале аутентифицированного пользователя.

Топ 10 - большинство смотрели плейлисты для канала

Этот запрос извлекает 10 самых наблюдаемых плейлистов канала, измеренные с помощью просмотров плейлистов в указанном диапазоне дат. Он также получает несколько других метрик плейлиста, таких как количество раз, когда зрители инициировали воспроизведение каждого плейлиста и среднее количество времени, которое зритель смотрел видео в списке воспроизведения после его начала. Результаты отсортированы по просмотрам плейлиста в порядке убывания.

Примечание. Поскольку в этом отчете используется измерение playlist , вы должны указать значение для параметра запроса sort , а также установить параметр maxResults на целочисленное значение 10 или менее.

dimensions=playlist
metrics=playlistViews,playlistEstimatedMinutesWatched,playlistStarts,averageTimeInPlaylist,playlistSaves
maxResults=10
sort=-playlistViews

Основанное на времени

Видео отчеты

Действительно просмотреть метрики времени для видео канала

Этот запрос получает ежедневные подсчеты обзора, метрики времени, и количество новых подписчиков для видео канала. Отчет возвращает одну строку данных для каждого дня в запрошенном диапазоне дат. Ряды отсортированы в хронологическом порядке.

dimensions=day
metrics=views,estimatedMinutesWatched,averageViewDuration,averageViewPercentage,subscribersGained
sort=day

Дневные метрики аннотации для видео канала

Этот запрос получает ежедневные подсчеты просмотра, анонтные показатели кликов, показатели закрытия аннотации и впечатления от аннотации для содержания канала. Результаты отсортированы в хронологическом порядке.

dimensions=day
metrics=views,likes,annotationClickThroughRate,annotationCloseRate,annotationImpressions
sort=day

Отчеты плейлиста

Ежедневные просмотры плейлиста для канала

Этот запрос получает подсчет ежедневного представления ( агрегированная видео-метрика ), просмотры плейлиста (метрика в игровом списке ), запуска плейлиста, расчетные просмотры и просмотры на запуск плейлиста для канала аутентифицированного пользователя. Результаты отсортированы в хронологическом порядке.

dimensions=day
metrics=views,estimatedMinutesWatched,playlistStarts,playlistViews,viewsPerPlaylistStart
sort=day

Географический

Видео отчеты

Страновые метрики времени для видео для видео

Этот запрос извлекает специфические для страны подсчет представлений, метрики времени и подписки на видео канала. Отчет возвращает одну строку данных для каждой страны, где были просмотрены видео канала. Ряды сортируются в порядке убывания за количество минут.

dimensions=country
metrics=views,estimatedMinutesWatched,averageViewDuration,averageViewPercentage,subscribersGained
sort=-estimatedMinutesWatched

Страновые показатели аннотации для видео канала

Этот запрос получает подсчеты видов, конкретные для конкретной страны, показатели кликов, анонтные показатели близких и аннотационные впечатления для видео канала. Результаты отсортируются по скорости клики в порядке убывания, что означает, что страна с самой высокой коэффициентом клика, проведена с самой высокой аннотацией.

dimensions=country
metrics=views,likes,annotationClickThroughRate,annotationCloseRate,annotationImpressions
sort=-annotationClickThroughRate

Провинция специфические показатели для штатов США и Вашингтона, округ Колумбия

Этот запрос извлекает провинцию по прозрачному расщеплению количества обзора, просмотренные минуты и среднюю продолжительность просмотра для видео канала. Данные, охватывающие штаты США, и результаты Вашингтона, округ Колумбия, сортируются в алфавитном порядке по кодам ISO 3166-2.

dimensions=province
metrics=views,estimatedMinutesWatched,averageViewDuration
filters=claimedStatus==claimed;country==US
sort=province

Топ -10 - большинство просматриваемых видео в определенной стране

Этот запрос получает 10 наиболее просмотренных видео канала, измеренные по количеству просмотров в указанном диапазоне дат в указанной стране. Результаты отсортируются по подсчету в порядке убывания.

Примечание. Этот отчет требует, чтобы вы указали значение для параметра запроса sort и установить параметр maxResults на целочисленное значение 10 или менее.

dimensions=video
metrics=views,estimatedMinutesWatched,likes,subscribersGained
filters=country==US
maxResults=10
sort=-views

10 лучших городов США по общим видам

Этот запрос извлекает список из 10 городов США, которые приходилось на наибольшее представление о содержании канала в указанном диапазоне дат. Запрос может быть изменен для запроса данных для другой страны , выбрав еще одно допустимое значение для этого фильтра. Аналогичным образом, запрос может быть изменен для извлечения данных для субконтинента, такого как Западная Европа или Юго -Восточная Азия, с помощью фильтра субконтинента и одного из его допустимых значений. Другие фильтры также поддерживаются. Результаты отсортируются по подсчету в порядке убывания.

    dimensions=city
metrics=views
filters=country==US
maxResults=10
sort=-views

10 лучших городов США по общим видам для каждого типа контента

Этот запрос получает список из 10 городов США, которые учитывали наибольшее количество представлений о содержании канала в указанном диапазоне дат для каждого поддерживаемого CreatorContentType . Результаты отсортируются по подсчету в порядке убывания.

    dimensions=city,creatorContentType
metrics=views
filters=country==US
maxResults=10
sort=-views

10 лучших городов США по общему времени.

Этот запрос получает список из 10 лучших дней в течение указанного диапазона дат, когда любой город США приходился на наибольшее время ежедневного времени для наблюдения за содержанием канала. Результаты запроса определяют общее время наблюдения, дату, когда произошло время наблюдения, и город, где, по оценкам, был просмотр контента. Результаты отсортированы в порядке убывания полного времени наблюдения.

    dimensions=city,day
metrics=estimatedWatchTime
filters=country==US
maxResults=10
sort=-estimatedWatchTime

Топ -10 - большинство просматриваемых видео в Европе

Этот запрос извлекает 10 самых просмотренных видео канала в Европе, измеряемые по количеству просмотров в указанном диапазоне дат. Запрос может быть изменен для запроса данных для другого континента , выбрав другое допустимое значение для этого фильтра. Аналогичным образом, запрос может быть изменен для извлечения данных для субконтинента, такого как Западная Европа или Юго -Восточная Азия, с помощью фильтра субконтинента и одного из его допустимых значений. Результаты отсортируются по подсчету в порядке убывания.

Примечание. Этот отчет требует, чтобы вы указали значение для параметра запроса sort и установить параметр maxResults на целочисленное значение 10 или менее.

dimensions=video
metrics=views,estimatedMinutesWatched,likes,subscribersGained
filters=continent==150
maxResults=10
sort=-views

Отчеты плейлиста

Страновые метрики времени для наблюдения за плейлистами канала

Этот запрос извлекает подсчеты видов, специфичные для страны ( агрегированная видео-метрика ), просмотры плейлиста (метрика в игровом списке ) и просмотреть метрики времени для плейлистов канала. Отчет возвращает одну ряд данных для каждой страны, где наблюдались списки плейлистов канала. Ряды сортируются в порядке убывания за количество минут.

dimensions=country
metrics=views,estimatedMinutesWatched,playlistStarts,averageTimeInPlaylist
sort=-estimatedMinutesWatched

Топ -10 - большинство начали плейлисты в Соединенных Штатах

Этот запрос извлекает 10 плейлистов, которые зрители в Соединенных Штатах начали чаще всего наблюдать за указанным диапазоном дат. Результаты отсортированы по количеству плейлиста, начинающихся в порядке убывания.

Примечание. Поскольку в этом отчете используется измерение playlist , вы должны указать значение для параметра запроса sort , а также установить параметр maxResults на целочисленное значение 10 или менее.

dimensions=playlist
metrics=playlistStarts,views,estimatedMinutesWatched,averageViewDuration
filters=isCurated==1;country==US
maxResults=10
sort=-playlistStarts

Место воспроизведения

Видео отчеты

ViewCounts и время наблюдения из разных мест воспроизведения

Этот запрос получает количество просмотров и предполагаемое время наблюдения для видео определенного канала. Результаты агрегируются в зависимости от типа страницы или приложения, где произошли воспроизведения видео, а результаты отсортированы в порядке убывания по обзору.

dimensions=insightPlaybackLocationType
metrics=estimatedMinutesWatched,views
sort=-views

Daily View Counts and Watch Time из разных мест воспроизведения

Этот запрос извлекает подсчет ежедневного обзора и предполагаемое время наблюдения в Соединенных Штатах для видео определенного канала. Результаты сгруппированы днем ​​для каждого типа страницы или приложения, где произошли воспроизведения видео. Результаты отсортированы в хронологическом порядке.

    dimensions=day,insightPlaybackLocationType
metrics=estimatedMinutesWatched,views
filters=country==US
sort=day

Топ-10-сторонние сайты, которые генерируют наибольшее количество просмотров для встроенного видео

Этот запрос извлекает количество видов и предполагаемое время просмотра для конкретного видео или группы видео. Результаты сгруппированы на стороннем сайте, где было встроено видео. Результаты отсортированы в порядке убывания по количеству взглядов. Обратите внимание, что чтобы запустить этот запрос в APIS Explorer, вы должны заменить строку VIDEO_ID в значении параметра filters со списком одного или нескольких идентификаторов видео для загруженных видео.

dimensions=insightPlaybackLocationDetail
metrics=views,estimatedMinutesWatched
filters=video==VIDEO_ID;insightPlaybackLocationType==EMBEDDED
maxResults=10
sort=-views

Отчеты плейлиста

Подсчет просмотра плейлиста и время наблюдения за разными местами воспроизведения

Этот запрос извлекает количество численных видов ( агрегированная видеометра ), просмотры плейлиста (показатель в игровом списке ), предполагаемое время наблюдения и список воспроизведения начинается для плейлистов определенного канала. Результаты агрегируются на основе типа страницы или приложения, где произошли воспроизведения видео, а результаты отсортированы в порядке убывания по началам плейлиста.

dimensions=insightPlaybackLocationType
metrics=views,estimatedMinutesWatched,playlistStarts,playlistViews
sort=-playlistStarts

Ежедневно

Этот запрос получает Daily Playlist Spess, Counts Counts ( агрегированный видео-метрика ), просмотры плейлиста (показатель в игровом списке ) и предполагаемое время наблюдения в Соединенных Штатах для плейлистов определенного канала. Результаты сгруппированы днем ​​для каждого типа страницы или приложения, где произошли представления плейлиста. Результаты отсортированы в хронологическом порядке.

dimensions=day,insightPlaybackLocationType
metrics=views,estimatedMinutesWatched,playlistStarts,playlistViews
filters=country==US
sort=day

Детали воспроизведения

Видео отчеты

Лайки и антипатия по типу контента

Этот запрос получает количество лайков и антипатий для каждого типа контента на канале.

dimensions=creatorContentType
metrics=likes,dislikes

Источник трафика

Видео отчеты

ViewCounts и время наблюдения из разных источников движения в стране

Этот запрос получает количество просмотров и предполагаемое время наблюдения за видео канала в указанной стране. Метрики агрегируются источником трафика, который описывает способ, с помощью которого пользователи достигли видео.

dimensions=insightTrafficSourceType
metrics=views,estimatedMinutesWatched
filters=country==US

Daily View Counts и время наблюдения из разных источников трафика

Этот запрос получает ежедневное количество просмотра и ежедневное время для просмотра видео канала. Метрики ежедневно агрегируются по источнику трафика и отсортируются в хронологическом порядке.

dimensions=day,insightTrafficSourceType
metrics=views,estimatedMinutesWatched
sort=day

Топ -10 - термины поиска на YouTube, которые генерируют наибольшее трафик для видео

Этот запрос получает 10 поисковых терминов, которые сгенерировали наибольшее количество просмотров из результатов поиска YouTube для одного или нескольких конкретных видео. Результаты отсортируются по подсчету в порядке убывания. Обратите внимание, что для запуска этого запроса в APIS Explorer необходимо заменить строку VIDEO_ID в значении параметра filters со списком, разделенным за запятушкой, составляющим до 500 идентификаторов видео.

Например, вы можете запустить запрос для одного видео или заменить VIDEO_ID чтобы определить термины поиска, которые генерируют наибольшую трафик для этого видео. Вы также можете перечислить все видео в конкретном списке воспроизведения, чтобы определить, какие условия поиска генерируют наибольшую трафик для любого из видео в этом списке воспроизведения.

dimensions=insightTrafficSourceDetail
metrics=views
filters=video==VIDEO_ID;insightTrafficSourceType==YT_SEARCH
maxResults=10
sort=-views

Топ -10 - внешние веб -сайты, которые генерируют большинство трафика для видео

Этот запрос получает 10 внешних веб -сайтов, которые генерировали наибольшее количество просмотров для конкретного видео или группы видео. Результаты отсортируются по расчетному времени наблюдения в порядке убывания. Обратите внимание, что для запуска этого запроса в APIS Explorer необходимо заменить строку VIDEO_ID в значении параметра filters со списком, разделенным за запятушкой, из 500 видео идентификаторов для загруженных видео.

dimensions=insightTrafficSourceDetail
metrics=estimatedMinutesWatched,views
filters=video==VIDEO_ID;insightTrafficSourceType==EXT_URL
maxResults=25
sort=-estimatedMinutesWatched

Отчеты плейлиста

Подсчет просмотра плейлиста и время наблюдения из разных источников трафика в стране

Этот запрос получает количество просмотров ( агрегированная видео-метрика ), просмотры плейлиста (метрика в игровом списке ), запускается плейлист и предполагаемое время наблюдения за просмотров плейлиста в указанной стране. Метрики агрегируются источником трафика, который описывает способ, которым пользователи достигли списка воспроизведения.

dimensions=insightTrafficSourceType
metrics=views,estimatedMinutesWatchedplaylistStarts,playlistViews
filters=country==US

Ежедневный подсчет плейлиста и время наблюдения из разных источников трафика

Этот запрос получает ежедневные просмотры плейлиста канала (метрика в игре ), запускается плейлист и предполагаемое время наблюдения. Он также получает общие представления ( агрегированная видеометра ). Метрики ежедневно агрегируются по источнику трафика и отсортируются в хронологическом порядке.

dimensions=day,insightTrafficSourceType
metrics=views,estimatedMinutesWatched,playlistStarts,playlistViews
sort=day

Устройство/ОС

Видео отчеты

Ежедневные метрики типа устройства для операционной системы Android

Этот запрос извлекает подсчет ежедневного просмотра и предполагаемое время наблюдения на устройствах Android для видео определенного канала. Результаты сгруппированы днем ​​для каждого типа устройства, где произошли воспроизведения видео. Результаты отсортированы в хронологическом порядке.

dimensions=day,deviceType
metrics=estimatedMinutesWatched,views
filters=operatingSystem==ANDROID
sort=day

Ежедневные метрики операционной системы для мобильных устройств

Этот запрос извлекает подсчет ежедневного просмотра и предполагаемое время наблюдения на мобильных устройствах для видео определенного канала. Результаты сгруппированы днем ​​для каждой операционной системы, в которой произошли воспроизведения видео. Результаты отсортированы в хронологическом порядке.

dimensions=day,operatingSystem
metrics=estimatedMinutesWatched,views
filters=deviceType==MOBILE
sort=day

Ежедневная операционная система и метрики типа устройства

Этот запрос извлекает подсчет ежедневного обзора и предполагаемое время наблюдения за каналом. Статистика сгруппирована с помощью операционной системы и типа устройства. Результаты отсортированы в хронологическом порядке.

dimensions=day,operatingSystem,deviceType
metrics=estimatedMinutesWatched,views
sort=day

Отчеты плейлиста

Ежедневные метрики типа устройства для просмотров плейлиста в операционной системе Android

Этот запрос получает ежедневные просмотры ( агрегированная видеометра ), просмотры плейлиста (метрика в игре ) и предполагаемое время наблюдения на устройствах Android для игровых списков определенного канала. Результаты сгруппированы днем ​​для каждого типа устройства, где произошли представления плейлиста. Результаты отсортированы в хронологическом порядке.

dimensions=day,deviceType
metrics=views,estimatedMinutesWatched,playlistViews
filters=operatingSystem==ANDROID
sort=day

Ежедневные метрики операционной системы для просмотров плейлиста на мобильных устройствах

Этот запрос получает ежедневные просмотры ( агрегированная видеометра ), просмотры плейлиста (метрика в игре ) и предполагаемое время наблюдения на мобильных устройствах для плейлистов определенного канала. Результаты сгруппированы днем ​​для каждой операционной системы, в которой происходили просмотры плейлиста. Результаты отсортированы в хронологическом порядке.

dimensions=day,operatingSystem
metrics=views,estimatedMinutesWatched
filters=deviceType==MOBILE
sort=day

Демографический

Видео отчеты

Демография зрителя в Калифорнии (возрастная группа и пол)

Этот отчет дает статистику о возрастной группе и поре зрителей в Калифорнии, которые смотрели видео канала. Результаты сортируются по полу, а затем по возрастной группе. Этот запрос может быть изменен, чтобы получить одну и ту же статистику для всех зрителей по всему миру или всем зрителям в стране, континенте, субконтиненте или другое состояние США путем настройки значения параметра filters .

dimensions=ageGroup,gender
metrics=viewerPercentage
filters=province==US-CA
sort=gender,ageGroup

Отчеты плейлиста

Демография зрителя плейлиста в Калифорнии (возрастная группа и пол)

Этот отчет дает статистику о возрастной группе и полу зрителей в Калифорнии, которые смотрели плейлисты канала. Результаты сортируются по полу, а затем по возрастной группе. Этот запрос может быть изменен, чтобы получить одну и ту же статистику для всех зрителей по всему миру или всем зрителям в стране, континенте, субконтиненте или другое состояние США путем настройки значения параметра filters .

dimensions=ageGroup,gender
metrics=viewerPercentage
filters=province==US-CA
sort=gender,ageGroup

Социальный

Обмен показателями, агрегированные по обслуживанию, где были переданы видео

Этот запрос получает количество раз, когда пользователи использовали кнопку Share чтобы поделиться видео канала. Результаты агрегируются путем обмена услугами (Google+, Twitter и т. Д.) И отсортируются в порядке убывания количества акций.

dimensions=sharingService
metrics=shares
sort=-shares

Удержание аудитории

Метрики удержания аудитории для видео

Этот отчет измеряет способность видео сохранять свою аудиторию. Отчет может быть получен только для одного видео за раз. Обратите внимание, что для запуска этого запроса в APIS Explorer вы должны заменить строку VIDEO_ID в значении параметра filters на видео идентификатор для одного из ваших загруженных видео. Обратите внимание, что отчеты о хранении аудитории не поддерживают возможность указать несколько значений для video .

В этом примере в отчете используется фильтр audienceType для ограничения ответа, чтобы он содержит только данные для органических представлений, которые являются результатом прямого действия пользователя, таких как поиск видео или нажмите на предлагаемое видео. Таким образом, отчет не включает данные для представлений от TrueView In-Stream или TrueView в дисков. Вы можете удалить фильтр, чтобы получить данные о хранении аудитории видео от всех типов аудитории.

Обратите внимание, что данные для фильтра audienceType доступны по состоянию на 25 сентября 2013 года. API не будет возвращать данные для запросов, которые используют фильтр, чтобы попытаться извлечь данные из более ранних дат. Запросы, которые не используют работу фильтра на любую дату после 1 июля 2008 года.

dimensions=elapsedVideoTimeRatio
metrics=audienceWatchRatio,relativeRetentionPerformance
filters=video==VIDEO_ID;audienceType==ORGANIC

Доход/реклама

Метрики доходов от канала и производительность рекламы

Этот запрос получает показатели доходов канала и производительности рекламы. Отчет возвращает одну строку данных, которая содержит итоги для каждой запрашиваемой метрики во время указанного диапазона дат.

metrics=views,estimatedRevenue,estimatedAdRevenue,estimatedRedPartnerRevenue,grossRevenue,adImpressions,cpm,playbackBasedCpm,monetizedPlaybacks

Ежедневные доходы и показатели эффективности рекламы

Этот запрос получает метрики ежедневного дохода и производительности рекламы.

dimensions=day
metrics=views,estimatedRevenue,estimatedAdRevenue,estimatedRedPartnerRevenue,grossRevenue,adImpressions,cpm,playbackBasedCpm,monetizedPlaybacks

Страновые доходы и показатели эффективности рекламы

Этот запрос получает показатели доходов и показателей рекламы. Результаты сортируются в порядке убывания по сумме дохода, что означает, что первая перечисленная страна будет той, где партнер получил наибольший чистый доход.

dimensions=country
metrics=views,estimatedRevenue,estimatedAdRevenue,estimatedRedPartnerRevenue,grossRevenue,adImpressions,cpm,playbackBasedCpm,monetizedPlaybacks
sort=-estimatedRevenue

Топ -10 - видео с самым высоким доходом

Этот запрос получает показатели дохода и производительности рекламы для 10 видео канала с наибольшим доходом. Результаты сортируются в порядке убывания по сумме дохода, что означает, что первое видео будет тем, которое получит самый высокий оценочный доход.

dimensions=video
metrics=views,estimatedRevenue,estimatedAdRevenue,estimatedRedPartnerRevenue,grossRevenue,adImpressions,cpm,playbackBasedCpm,monetizedPlaybacks
maxResults=10
sort=-estimatedRevenue

Метрики производительности рекламы для разных типов рекламы

Этот запрос получает показатели производительности рекламы для заявленного контента владельца контента. Результаты сгруппированы по типу AD, что позволяет сравнить доходы и значения CPM по разным типам AD.

dimensions=adType
metrics=grossRevenue,adImpressions,cpm
filters=claimedStatus==claimed
sort=-adType

Владелец контента отчеты

Основная статистика

Видео отчеты

Общее количество взглядов, предполагаемое время наблюдения и больше для всего заявленного контента

Этот запрос получает агрегированные метрики для заявленного контента контента. Отчет возвращает одну строку данных, которая содержит итоги для каждой запрашиваемой метрики во время указанного диапазона дат.

metrics=views,comments,likes,dislikes,estimatedMinutesWatched,averageViewDuration
filters=claimedStatus==claimed

Страновое количество видов (и многое другое) для всех самозагруженных видеороликов

Этот запрос получает метрики для конкретной страны для видео, которые загрузил владелец контента. Отчет возвращает одну строку данных, которая содержит итоги для каждой запрашиваемой метрики во время указанного диапазона дат.

metrics=views,comments,likes,dislikes,shares
filters=uploaderType==self;country==FR

Общее количество взглядов (и больше) для всех заявленных сторонних контентов

Этот запрос получает агрегированные метрики для видео, которые заявил владелец контента, но не загружал. Отчет возвращает одну строку данных, которая содержит итоги для каждой запрашиваемой метрики во время указанного диапазона дат.

metrics=views,comments,likes,dislikes,shares
filters=uploaderType==thirdParty;claimedStatus==claimed

Общее количество видов (и больше) для всех самоозарядных контента

Этот запрос получает агрегированные метрики для видео, которые загрузил владелец контента. Отчет возвращает одну строку данных, которая содержит итоги для каждой запрашиваемой метрики во время указанного диапазона дат.

metrics=views,comments,likes,dislikes,estimatedMinutesWatched
filters=uploaderType==self

Общее количество взглядов (и больше) для всех заявленных, самозагруженных контента

Этот запрос извлекает агрегированные метрики для видео, которые загрузил владелец контента, а также заявил. Отчет возвращает одну строку данных, которая содержит итоги для каждой запрашиваемой метрики во время указанного диапазона дат.

metrics=views,comments,likes,dislikes,estimatedMinutesWatched
filters=uploaderType==self;claimedStatus==claimed

Топ 10 - большинство просматриваемых видео для владельца контента

Этот запрос получает 10 наиболее просмотренных видео, измеренных по количеству просмотров в указанном диапазоне дат, которые загрузил владелец контента. Результаты отсортируются по подсчету в порядке убывания.

dimensions=video
metrics=views,estimatedMinutesWatched,estimatedRevenue,estimatedAdRevenue,monetizedPlaybacks,adImpressions
filters=uploaderType==self
maxResults=10
sort=-views

Топ 10 - большинство смотрели видео для владельца контента

Этот запрос извлекает 10 самых просмотренных видео, измеренных по оценкам, просмотренным в указанном диапазоне дат, который загружал владелец контента. Результаты отсортируются по расчетным минутам, наблюдаемым в порядке убывания.

dimensions=video
metrics=estimatedMinutesWatched,averageViewDuration,averageViewPercentage,views,subscribersGained
filters=uploaderType==self
maxResults=10
sort=-estimatedMinutesWatched

Топ 10 - большинство просматриваемых видео для канала владельца контента

Этот запрос получает 10 самых просмотренных видео для определенного канала или группы каналов, которыми управляет владелец контента. Результаты отсортируются по подсчету в порядке убывания. Note that to run this query in the APIs Explorer, you must replace the string CHANNEL_ID in the filters parameter value with a comma-separated list of up to 500 channel IDs for your channels.

dimensions=video
metrics=views
filters=channel==CHANNEL_ID
maxResults=10
sort=-views

Top 10 – Annotation click-through rates for a channel's most viewed videos

This request retrieves view counts, annotation click-through rates, annotation close rates, and annotation impressions for the 10 most viewed videos in a specified channel or group of channels. Results are sorted by view count in descending order, which means that the most viewed video will be listed first. Note that to run this query in the APIs Explorer, you must replace the string CHANNEL_ID in the filters parameter value with a comma-separated list of up to 500 channel IDs for your channels.

dimensions=video
metrics=views,likes,annotationClickThroughRate,annotationCloseRate,annotationImpressions
filters=channel==CHANNEL_ID
maxResults=10
sort=-views

Playlist reports

Playlist views for a content owner's channels

This request retrieves total playlist starts, playlist estimated minutes watched, playlist views, and views per playlist start for playlists in the content owner's channels. The playlistViews metric counts only video views that occurred in the context of a playlist. Since all of the requested metrics are in-playlist metrics, the request does not also need to include the playlist or group filter.

metrics=playlistViews,playlistStarts,playlistEstimatedMinutesWatched,viewsPerPlaylistStart

Statistics for a specific playlist

This request retrieves total playlist starts, estimated minutes watched, views (an aggregated video metric ), playlist views (an in-playlist metric), and views per playlist start for a specific playlist. Note that to run this query in the APIs Explorer, you must replace the string PLAYLIST_ID in the filters parameter value with the playlist ID for a playlist in one of the content owner's channels.

metrics=views,estimatedMinutesWatched,playlistStarts,playlistViews,viewsPerPlaylistStart
filters=playlist==PLAYLIST_ID

To retrieve aggregate statistics for multiple playlists, you can also replace the string PLAYLIST_ID with a comma-separated list of up to 500 playlists IDs for playlists in the content owner's channels.

Time-based

Video reports

Daily watch time metrics for self-uploaded content

This query retrieves daily watch time metrics, as well as view counts, monetized playback counts, and impression counts for videos that the content owner uploaded. The report returns one row of data for each day in the requested date range, and rows are sorted in chronological order.

dimensions=day
metrics=estimatedMinutesWatched,averageViewPercentage,views,monetizedPlaybacks,adImpressions
filters=uploaderType==self
sort=day

Annotation metrics for claimed content

This request retrieves daily view counts, annotation click-through rates, annotation close rates, and annotation impressions for the content owner's claimed content. Results are sorted in chronological order.

dimensions=day
metrics=views,likes,annotationClickThroughRate,annotationCloseRate,annotationImpressions
filters=claimedStatus==claimed
sort=day

Playlist reports

Daily playlist views for a content owner

This request retrieves metrics for daily user interactions with videos in the content owner's playlists. The metrics retrieved in the report are playlistViews , playlistStarts , playlistEstimatedMinutesWatched , and viewsPerPlaylistStart . All of these metrics are in-playlist metrics. Since all of the requested metrics are in-playlist metrics, the request does not need to also include the playlist or group filter.

dimensions=day
metrics=playlistViews,playlistStarts,playlistEstimatedMinutesWatched,viewsPerPlaylistStart
sort=day

Географический

Video reports

Country-specific watch time metrics for self-uploaded content

This query retrieves view counts, watch time metrics, and estimated ad revenue for each country. The metrics are for videos that the content owner uploaded. The report returns one row of data for each country where the videos were watched, and rows are sorted in descending order of number of minutes watched.

dimensions=country
metrics=views,estimatedMinutesWatched,averageViewDuration,averageViewPercentage,estimatedRevenue,estimatedAdRevenue,grossRevenue
filters=uploaderType==self
sort=-estimatedMinutesWatched

Country-specific annotation metrics for self-uploaded content

This request retrieves country-specific view counts, annotation click-through rates, annotation close rates, and annotation impressions for the content owner's uploaded videos. Results are sorted by annotation click-through rate in descending order, which means that the country with the highest annotation click-through rate will be listed first.

dimensions=country
metrics=views,likes,annotationClickThroughRate,annotationCloseRate,annotationImpressions
filters=uploaderType==self
sort=-annotationClickThroughRate

Province-specific metrics for US states and Washington DC

This request retrieves a province-by-province breakdown of view counts, estimated minutes watched, and average view duration for the content owner's claimed videos. The data covers US states and Washington DC Results are sorted alphabetically by provinces' ISO 3166-2 codes .

dimensions=province
metrics=views,estimatedMinutesWatched,averageViewDuration
filters=claimedStatus==claimed;country==US
sort=province

Top 10 US cities by total views

This query retrieves a list of the 10 US cities that accounted for the most views of the content owner's claimed videos during the specified date range. The query could be modified to request data for another country by choosing another valid value for that filter. Similarly, the query could be modified to retrieve data for a subcontinent, such as Western Europe or Southeastern Asia, by using the subContinent filter and one of its valid values. Other filters are supported, too. Results are sorted by view count in descending order.

    dimensions=city
metrics=views
filters=claimedStatus==claimed;country==US
maxResults=10
sort=-views

Top 10 US cities by total views for each content type

This query retrieves a list of the 10 US cities that accounted for the most views of the content owner's claimed content during the specified date range for each supported creatorContentType . Results are sorted by view count in descending order.

    dimensions=city,creatorContentType
metrics=views
filters=claimedStatus==claimed;country==US
maxResults=10
sort=-views

Top 10 US cities by total watch time

This query retrieves a list of the top 10 days during the specified date range when any US city accounted for the greatest total daily watch time of the content owner's claimed content. The query results identify the total watch time, the date on which the watch time occurred, and the city where the content was estimated to have been viewed. Results are sorted in descending order of total watch time.

    dimensions=city,day
metrics=estimatedWatchTime
filters=claimedStatus==claimed;country==US
maxResults=10
sort=-estimatedWatchTime

Top 10 – Most watched videos in Europe

This query retrieves the 10 most watched videos in Europe, among videos claimed by the content owner, as measured by number of views during the specified date range. The query could be modified to request data for another continent by choosing another valid value for that filter. Similarly, the query could be modified to retrieve data for a subcontinent, such as Western Europe or Southeastern Asia, by using the subContinent filter and one of its valid values. Results are sorted by view count in descending order.

dimensions=video
metrics=views,estimatedMinutesWatched,likes,subscribersGained
filters=claimedStatus==claimed;filters=continent==150
maxResults=10
sort=-estimatedMinutesWatched

Playlist reports

Country-specific watch time metrics for a content owner's playlists

This query retrieves country-specific playlist view counts and playlist watch time metrics for all playlists in the content owner's channels. The report returns one row of data for each country where the playlists were watched. Rows are sorted in descending order of number of minutes watched.

dimensions=country
metrics=playlistViews,playlistEstimatedMinutesWatched,playlistStarts,averageTimeInPlaylist
sort=-playlistEstimatedMinutesWatched

Top 10 – Most started playlists in the United States

This query retrieves the 10 playlists from the content owner's channels that viewers in the United States started watching most frequently during the specified date range. Results are sorted by number of playlist starts in descending order.

Note: Since this report uses the playlist dimension, you must specify a value for the sort request parameter and also set th maxResults parameter to an integer value of 10 or less.

dimensions=playlist
metrics=playlistStarts,playlistViews,playlistEstimatedMinutesWatched,playlistAverageViewDuration
filters=country==US
maxResults=10
sort=-playlistStarts

Playback details

Video reports

Likes and dislikes by content type

This query retrieves the number of likes and dislikes for each type of content on a particular channel or group of channels. Note that to run this query in the APIs Explorer, you must replace the string CHANNEL_ID in the filters parameter value with a comma-separated list of up to 500 channel IDs for your channels.

dimensions=creatorContentType
metrics=likes,dislikes
filters=channel==CHANNEL_ID

Playback location

Video reports

Viewcounts and watch time from different playback locations

This query retrieves the number of views and estimated watch time for videos uploaded to a particular channel or group of channels. Results are aggregated based on the type of page or application where video playbacks occurred, and results are sorted in descending order by view count. Note that to run this query in the APIs Explorer, you must replace the string CHANNEL_ID in the filters parameter value with a comma-separated list of up to 500 channel IDs for your channels.

dimensions=insightPlaybackLocationType
metrics=estimatedMinutesWatched,views
filters=channel==CHANNEL_ID
sort=-views

Daily view counts and watch time from different playback locations

This query retrieves daily view counts and estimated watch time in the United States for videos uploaded to a particular channel or group of channels. Results are grouped by day for each type of page or application where video playbacks occurred. Results are sorted in reverse chronological order. Note that to run this query in the APIs Explorer, you must replace the string CHANNEL_ID in the filters parameter value with a comma-separated list of up to 500 channel IDs for your channels.

dimensions=day,insightPlaybackLocationType
metrics=estimatedMinutesWatched,views
filters=country==US;channel==CHANNEL_ID
sort=-day

Top 10 – Third-party sites that generate the most views for an embedded video

This query retrieves view counts and estimated watch time for a particular video or group of videos. Results are grouped by the third-party site where the video was embedded. Results are sorted in descending order by view count. Note that to run this query in the APIs Explorer, you must replace the string VIDEO_ID in the filters parameter value with a comma-separated list of up to 500 video IDs for your uploaded videos.

dimensions=insightPlaybackLocationDetail
metrics=views,estimatedMinutesWatched
filters=video==VIDEO_ID;insightPlaybackLocationType==EMBEDDED
maxResults=10
sort=-views

Playlist reports

Playlist view counts and watch time from different playback locations

This query retrieves the number of playlist views, playlist estimated watch time, and playlist starts for all playlists in a content owner's channels. Results are aggregated based on the type of page or application where video playbacks occurred, and results are sorted in descending order by playlist starts.

dimensions=insightPlaybackLocationType
metrics=playlistViews,playlistEstimatedMinutesWatched,playlistStarts
sort=-playlistStarts

Playlist view counts and watch time from different playback locations

This query retrieves daily playlist starts, playlist view counts, and playlist estimated watch time in the United States for all playlists in a content owner's channels. Results are returned for each type of page or application where playlist views occurred.

dimensions=day,insightPlaybackLocationType
metrics=playlistStarts,playlistViews,playlistEstimatedMinutesWatched
filters=country==US

Traffic source

Video reports

Viewcounts and watch time from different traffic sources

This request retrieves the number of views and estimated watch time for the content owner's videos. The metrics are aggregated by traffic source, which describes the manner in which users reached the video.

dimensions=insightTrafficSourceType
metrics=views,estimatedMinutesWatched
filters=uploaderType==self

Daily view counts and watch time from different traffic sources

This request retrieves daily view counts and daily estimated watch time for the content owner's videos. The metrics are aggregated on a daily basis by traffic source and sorted in reverse chronological order.

dimensions=day,insightTrafficSourceType
metrics=views,estimatedMinutesWatched
filters=uploaderType==self
sort=-day

Note: The next two sample reports are only supported for specific traffic sources. VIDEO_REMIXES , NOTIFICATION , END_SCREEN , CAMPAIGN_CARD , VIDEO_REMIXES , and NO_LINK_EMBEDDED traffic sources are some of the unsupported ones.

Top 10 – YouTube search terms that generate the most traffic for a video

This query retrieves the 10 search terms that generated the most views from YouTube search results for a specific video or group of videos. Results are sorted by view count in descending order. Note that to run this query in the APIs Explorer, you must replace the string VIDEO_ID in the filters parameter value with a comma-separated list of up to 500 video IDs for your uploaded videos.

dimensions=insightTrafficSourceDetail
metrics=views
filters=video==VIDEO_ID;insightTrafficSourceType==YT_SEARCH
maxResults=10
sort=-views

Top 10 – External websites that generate the most traffic for a video

This query retrieves the 10 external websites that generated the most views from Google search results for a specific video or group of videos. Results are sorted by estimated watch time in descending order. Note that to run this query in the APIs Explorer, you must replace the string VIDEO_ID in the filters parameter value with a comma-separated list of up to 500 video IDs for your uploaded videos.

dimensions=insightTrafficSourceDetail
metrics=estimatedMinutesWatched,views
filters=video==VIDEO_ID;insightTrafficSourceType==EXT_URL
maxResults=25
sort=-estimatedMinutesWatched

Playlist reports

Playlist view counts and watch time from different traffic sources in a country

This request retrieves the number of playlist views, playlist starts, and playlist estimated watch time for playlist views in a specified country. The metrics are aggregated by traffic source, which describes the manner in which users reached the playlist.

dimensions=insightTrafficSourceType
metrics=playlistViews,playlistStarts,playlistEstimatedMinutesWatched
filters=country==US

Playlist view counts and watch time from different traffic sources

This request retrieves playlist views, playlist starts, and playlist estimated watch time for playlists in one or more of a content owner's channels. The metrics are aggregated by traffic source. Note that to run this query in the APIs Explorer, you must replace the string CHANNEL_ID in the filters parameter value with a comma-separated list of up to 500 channel IDs for your channels.

dimensions=day,insightTrafficSourceType
metrics=playlistViews,playlistStarts,playlistEstimatedMinutesWatched
filters=channel==CHANNEL_ID

Device/OS

Video reports

Daily device type metrics for claimed videos

This query retrieves daily view counts and estimated watch time by device type for videos claimed by a particular content owner. Results are grouped by day for each type of device where video playbacks occurred. Results are sorted in chronological order.

dimensions=day,deviceType
metrics=estimatedMinutesWatched,views
filters=claimedStatus==claimed
sort=day

Daily operating system metrics for claimed videos viewed on mobile devices

This query retrieves daily view counts and estimated watch time by operating system for views of videos claimed by a specified content owner that took place on mobile devices. Results are grouped by day for each operating system where video playbacks occurred. Results are sorted in chronological order.

dimensions=day,operatingSystem
metrics=estimatedMinutesWatched,views
filters=claimedStatus==claimed;deviceType==MOBILE
sort=day

Daily operating system and device type metrics

This query retrieves daily view counts and estimated watch time for videos claimed by a particular content owner. Statistics are grouped by operating system and device type. Results are sorted in chronological order.

dimensions=day,operatingSystem,deviceType
metrics=estimatedMinutesWatched,views
sort=day

Playlist reports

Device type metrics for playlist views on the Android operating system

This query retrieves playlist view counts and playlist estimated watch time on Android devices for playlists in one or more of a content owner's channels. Results are returned for each type of device where playlist views occurred. Note that to run this query in the APIs Explorer, you must replace the string CHANNEL_ID in the filters parameter value with a comma-separated list of up to 500 channel IDs for your channels.

dimensions=deviceType
metrics=playlistViews,playlistEstimatedMinutesWatched
filters=channel==CHANNEL_ID;operatingSystem==ANDROID

Operating system metrics for playlist views on mobile devices

This query retrieves playlist view counts and playlist estimated watch time on mobile devices for playlists in any of a content owner's channels. Results are returned for each operating system on which playlist views occurred.

dimensions=operatingSystem
metrics=views,estimatedMinutesWatched
filters=deviceType==MOBILE

Демографический

Video reports

Viewer demographics in California (age group and gender)

This report retrieves statistics about the age group and gender of viewers in California who watched the content owner's claimed content. Results are sorted by gender and then by age group. This query could be modified to retrieve the same statistics for all viewers worldwide or all viewers in a country, continent, subcontinent, or another US state by adjusting the filters parameter value.

dimensions=ageGroup,gender
metrics=viewerPercentage
filters=claimedStatus==claimed;province==US-CA
sort=gender,ageGroup

Социальный

Sharing metrics, aggregated by service where videos were shared

This request retrieves the number of times that users used the Share button to share videos that the content owner uploaded. Results are aggregated by sharing service (Google+, Twitter, etc.) and sorted in descending order of number of shares.

dimensions=sharingService
metrics=shares
filters=uploaderType==self
sort=-shares

Audience retention

Audience retention metrics for a video

This report measures a video's ability to retain its audience. The report can only be retrieved for a single video at a time. Note that to run this query in the APIs Explorer, you must replace the string VIDEO_ID in the filters parameter value with the video ID for one of your uploaded videos. Note that audience retention reports do not support the ability to specify multiple values for the video filter.

In this example, the report uses the audienceType filter to restrict the response so that it only contains data for organic views, which are the result of a direct user action, such as a search for a video or a click on a suggested video. As such, the report does not include data for views from TrueView in-stream or TrueView in-display ads. You can remove the filter to retrieve the video's audience retention data from all audience types.

Note that data for the audienceType filter is available as of September 25, 2013. The API will not return data for queries that use the filter to try to retrieve data from earlier dates. Queries that do not use the filter work for any date after July 1, 2008.

dimensions=elapsedVideoTimeRatio
metrics=audienceWatchRatio,relativeRetentionPerformance
filters=video==VIDEO_ID;audienceType==ORGANIC

Revenue/Ads

Revenue and ad performance metrics for claimed content

This request retrieves revenue and ad performance metrics for the content owner's claimed content. The report returns a single row of data that contains totals for each requested metric during the specified date range.

metrics=views,estimatedRevenue,estimatedAdRevenue,estimatedRedPartnerRevenue,grossRevenue,adImpressions,cpm,playbackBasedCpm,monetizedPlaybacks
filters=claimedStatus==claimed

Daily revenue and ad performance metrics

This request retrieves daily revenue and ad performance metrics for the content owner's claimed content.

dimensions=day
metrics=views,estimatedRevenue,estimatedAdRevenue,estimatedRedPartnerRevenue,grossRevenue,adImpressions,cpm,playbackBasedCpm,monetizedPlaybacks
filters=claimedStatus==claimed

Country-specific revenue and ad performance metrics

This request retrieves country-specific revenue and ad performance metrics for the content owner's claimed content. Results are sorted in descending order by revenue amount, which means that the first country listed will be the one where the partner had the greatest estimated revenue.

dimensions=country
metrics=views,estimatedRevenue,estimatedAdRevenue,estimatedRedPartnerRevenue,grossRevenue,adImpressions,cpm,playbackBasedCpm,monetizedPlaybacks
filters=claimedStatus==claimed
sort=-estimatedRevenue

Top 10 – Videos with the highest revenue

This request retrieves revenue and ad performance metrics for the 10 videos that where claimed by the content owner claimed and that had the highest revenue. Results are sorted in descending order by revenue amount, which means that the first video will be the one that had the highest estimated revenue.

dimensions=video
metrics=views,estimatedRevenue,estimatedAdRevenue,estimatedRedPartnerRevenue,grossRevenue,adImpressions,cpm,playbackBasedCpm,monetizedPlaybacks
filters=claimedStatus==claimed
maxResults=10
sort=-estimatedRevenue

Ad performance metrics for different ad types

This request retrieves ad performance metrics for the content owner's claimed content. Results are grouped by ad type, which enables you to compare revenue and CPM values across different ad types.

dimensions=adType
metrics=grossRevenue,adImpressions,cpm
filters=claimedStatus==claimed
sort=-adType

,

This page shows sample YouTube Analytics API requests. Each example briefly describes the report being retrieved and then shows the corresponding dimensions , metrics , filters , and sort parameter values. (The channel reports and content owner reports documents identify the reports that the API supports.)

Each example links to and populates the Google APIs Explorer with the values shown. The examples also use default start and end dates ( YYYY-MM-DD ) of 2023-09-01 and 2024-03-31 .

After linking to the APIs Explorer, you must still specify the channel or content owner for which you are retrieving reports. The APIs Explorer will populate the ids parameter value with either channel==MINE or contentOwner==CONTENT_OWNER_ID , depending on the query that you have clicked. For channel reports, you could change MINE to the authenticated user's channel ID. For content owner reports, you need to replace CONTENT_OWNER_ID with your content owner ID.

You also have to be authenticated as the specified channel or content owner so that the APIs Explorer can authorize your API requests using OAuth 2.0 .

1. Sorting requests by multiple dimensions/metrics
2. Channel reports
3. Content owner reports

Sorting requests by multiple dimensions/metrics

The API supports the ability to sort response data using multiple dimensions or metrics. For example, the request below retrieves daily traffic source data for a particular channel's videos. Each row in the result set identifies the number of views and the estimated watch time that originated from a particular type of traffic source (eg EXT_URL ) on a particular day.

dimensions=day,insightTrafficSourceType
metrics=views,estimatedWatchTime
sort=day,-views

In the response, results are sorted chronologically. Within the set of results for each day, results are sorted in descending order by view count. So, the first row in the result set contains data for the traffic source that generated the most views on the first day in the requested date range. The second row contains data for the traffic source that generated the next highest number of views on the first day.

Channel reports

Basic stats

Video reports

Total view counts, estimated watch time, and more for a channel

This query retrieves aggregated metrics for the channel's content. The report returns a single row of data that contains totals for each requested metric during the specified date range.

metrics=views,comments,likes,dislikes,estimatedMinutesWatched,averageViewDuration

Country-specific view counts (and more) for a channel

This query retrieves metrics for a specific country for a channel's videos. The report returns a single row of data that contains totals for each requested metric during the specified date range.

metrics=views,comments,likes,dislikes,estimatedMinutesWatched
filters=country==US

Top 10 – Most watched videos for a channel

This query retrieves a channel's 10 most watched videos, as measured by estimated minutes watched during the specified date range. Results are sorted by estimated minutes watched in descending order.

Note: This report requires you to specify a value for the sort request parameter and to set the maxResults parameter to an integer value of 10 or less.

dimensions=video
metrics=estimatedMinutesWatched,views,likes,subscribersGained
maxResults=10
sort=-estimatedMinutesWatched

Top 10 – Annotation click-through rates for a channel's most viewed videos

This request retrieves view counts, annotation click-through rates, annotation close rates, and annotation impressions for the channel's 10 most viewed videos. Results are sorted by view count in descending order, which means that the most viewed video will be listed first.

Note: This report requires you to specify a value for the sort request parameter and to set the maxResults parameter to an integer value of 10 or less.

dimensions=video
metrics=views,likes,annotationClickThroughRate,annotationCloseRate,annotationImpressions
maxResults=10
sort=-views

Playlist reports

Total playlist views for a channel

This request retrieves total playlist starts, estimated minutes watched, views (an aggregated video metric ), playlist views (an in-playlist metric), and views per playlist start for playlists in the authenticated user's channel.

metrics=views,estimatedMinutesWatched,playlistStarts,playlistViews,viewsPerPlaylistStart

Statistics for a specific playlist

This request retrieves total playlist starts, estimated minutes watched, views (an aggregated video metric ), playlist views (an in-playlist metric), and views per playlist start for a specific playlist. Note that to run this query in the APIs Explorer, you must replace the string PLAYLIST_ID in the filters parameter value with the playlist ID for a playlist in the authenticated user's channel.

metrics=views,estimatedMinutesWatched,playlistStarts,playlistViews,viewsPerPlaylistStart
filters=playlist==PLAYLIST_ID

To retrieve aggregate statistics for multiple playlists, you can also replace the string PLAYLIST_ID with a comma-separated list of up to 500 playlists IDs for playlists in the authenticated user's channel.

Top 10 – Most watched playlists for a channel

This query retrieves a channel's 10 most watched playlists, as measured by playlist views during the specified date range. It also retrieves several other playlist metrics, such as the number of times that viewers initiated playback of each playlist and the average amount of time that a viewer watched videos in the playlist after it was started. Results are sorted by playlist views in descending order.

Note: Since this report uses the playlist dimension, you must specify a value for the sort request parameter and also set the maxResults parameter to an integer value of 10 or less.

dimensions=playlist
metrics=playlistViews,playlistEstimatedMinutesWatched,playlistStarts,averageTimeInPlaylist,playlistSaves
maxResults=10
sort=-playlistViews

Time-based

Video reports

Daily watch time metrics for a channel's videos

This query retrieves daily view counts, watch time metrics, and new subscriber counts for a channel's videos. The report returns one row of data for each day in the requested date range. Rows are sorted in chronological order.

dimensions=day
metrics=views,estimatedMinutesWatched,averageViewDuration,averageViewPercentage,subscribersGained
sort=day

Daily annotation metrics for a channel's videos

This request retrieves daily view counts, annotation click-through rates, annotation close rates, and annotation impressions for the channel's content. Results are sorted in chronological order.

dimensions=day
metrics=views,likes,annotationClickThroughRate,annotationCloseRate,annotationImpressions
sort=day

Playlist reports

Daily playlist views for a channel

This request retrieves daily view counts (an aggregated video metric ), playlist views (an in-playlist metric), playlist starts, estimated minutes watched, and views per playlist start for the authenticated user's channel. Results are sorted in chronological order.

dimensions=day
metrics=views,estimatedMinutesWatched,playlistStarts,playlistViews,viewsPerPlaylistStart
sort=day

Географический

Video reports

Country-specific watch time metrics for a channel's videos

This query retrieves country-specific view counts, watch time metrics, and subscription figures for a channel's videos. The report returns one row of data for each country where the channel's videos were watched. Rows are sorted in descending order of number of minutes watched.

dimensions=country
metrics=views,estimatedMinutesWatched,averageViewDuration,averageViewPercentage,subscribersGained
sort=-estimatedMinutesWatched

Country-specific annotation metrics for a channel's videos

This request retrieves country-specific view counts, annotation click-through rates, annotation close rates, and annotation impressions for the channel's videos. Results are sorted by annotation click-through rate in descending order, which means that the country with the highest annotation click-through rate will be listed first.

dimensions=country
metrics=views,likes,annotationClickThroughRate,annotationCloseRate,annotationImpressions
sort=-annotationClickThroughRate

Province-specific metrics for US states and Washington DC

This request retrieves a province-by-province breakdown of view counts, estimated minutes watched, and average view duration for the channel's videos. The data covers US states and Washington DC Results are sorted alphabetically by provinces' ISO 3166-2 codes .

dimensions=province
metrics=views,estimatedMinutesWatched,averageViewDuration
filters=claimedStatus==claimed;country==US
sort=province

Top 10 – Most viewed videos in a specific country

This query retrieves the channel's 10 most viewed videos, as measured by number of views during the specified date range, in a specified country. Results are sorted by view count in descending order.

Note: This report requires you to specify a value for the sort request parameter and to set the maxResults parameter to an integer value of 10 or less.

dimensions=video
metrics=views,estimatedMinutesWatched,likes,subscribersGained
filters=country==US
maxResults=10
sort=-views

Top 10 US cities by total views

This query retrieves a list of the 10 US cities that accounted for the most views of the channel's content during the specified date range. The query could be modified to request data for another country by choosing another valid value for that filter. Similarly, the query could be modified to retrieve data for a subcontinent, such as Western Europe or Southeastern Asia, by using the subContinent filter and one of its valid values. Other filters are supported, too. Results are sorted by view count in descending order.

    dimensions=city
metrics=views
filters=country==US
maxResults=10
sort=-views

Top 10 US cities by total views for each content type

This query retrieves a list of the 10 US cities that accounted for the most views of the channel's content during the specified date range for each supported creatorContentType . Results are sorted by view count in descending order.

    dimensions=city,creatorContentType
metrics=views
filters=country==US
maxResults=10
sort=-views

Top 10 US cities by total watch time

This query retrieves a list of the top 10 days during the specified date range when any US city accounted for the greatest total daily watch time of the channel's content. The query results identify the total watch time, the date on which the watch time occurred, and the city where the content was estimated to have been viewed. Results are sorted in descending order of total watch time.

    dimensions=city,day
metrics=estimatedWatchTime
filters=country==US
maxResults=10
sort=-estimatedWatchTime

Top 10 – Most viewed videos in Europe

This query retrieves the channel's 10 most viewed videos in Europe, as measured by number of views during the specified date range. The query could be modified to request data for another continent by choosing another valid value for that filter. Similarly, the query could be modified to retrieve data for a subcontinent, such as Western Europe or Southeastern Asia, by using the subContinent filter and one of its valid values. Results are sorted by view count in descending order.

Note: This report requires you to specify a value for the sort request parameter and to set the maxResults parameter to an integer value of 10 or less.

dimensions=video
metrics=views,estimatedMinutesWatched,likes,subscribersGained
filters=continent==150
maxResults=10
sort=-views

Playlist reports

Country-specific watch time metrics for a channel's playlists

This query retrieves country-specific view counts (an aggregated video metric ), playlist views (an in-playlist metric), and watch time metrics for a channel's playlists. The report returns one row of data for each country where the channel's playlists were watched. Rows are sorted in descending order of number of minutes watched.

dimensions=country
metrics=views,estimatedMinutesWatched,playlistStarts,averageTimeInPlaylist
sort=-estimatedMinutesWatched

Top 10 – Most started playlists in the United States

This query retrieves the 10 playlists that viewers in the United States started watching most frequently during the specified date range. Results are sorted by number of playlist starts in descending order.

Note: Since this report uses the playlist dimension, you must specify a value for the sort request parameter and also set the maxResults parameter to an integer value of 10 or less.

dimensions=playlist
metrics=playlistStarts,views,estimatedMinutesWatched,averageViewDuration
filters=isCurated==1;country==US
maxResults=10
sort=-playlistStarts

Playback location

Video reports

Viewcounts and watch time from different playback locations

This query retrieves the number of views and estimated watch time for a particular channel's videos. Results are aggregated based on the type of page or application where video playbacks occurred, and results are sorted in descending order by view count.

dimensions=insightPlaybackLocationType
metrics=estimatedMinutesWatched,views
sort=-views

Daily view counts and watch time from different playback locations

This query retrieves daily view counts and estimated watch time in the United States for a particular channel's videos. Results are grouped by day for each type of page or application where video playbacks occurred. Results are sorted in chronological order.

    dimensions=day,insightPlaybackLocationType
metrics=estimatedMinutesWatched,views
filters=country==US
sort=day

Top 10 – Third-party sites that generate the most views for an embedded video

This query retrieves view counts and estimated watch time for a particular video or group of videos. Results are grouped by the third-party site where the video was embedded. Results are sorted in descending order by view count. Note that to run this query in the APIs Explorer, you must replace the string VIDEO_ID in the filters parameter value with a comma-separated list of one or more video IDs for your uploaded videos.

dimensions=insightPlaybackLocationDetail
metrics=views,estimatedMinutesWatched
filters=video==VIDEO_ID;insightPlaybackLocationType==EMBEDDED
maxResults=10
sort=-views

Playlist reports

Playlist view counts and watch time from different playback locations

This query retrieves the number of view counts (an aggregated video metric ), playlist views (an in-playlist metric), estimated watch time, and playlist starts for a particular channel's playlists. Results are aggregated based on the type of page or application where video playbacks occurred, and results are sorted in descending order by playlist starts.

dimensions=insightPlaybackLocationType
metrics=views,estimatedMinutesWatched,playlistStarts,playlistViews
sort=-playlistStarts

Daily playlist view counts and watch time from different playback locations

This query retrieves daily playlist starts, view counts (an aggregated video metric ), playlist views (an in-playlist metric), and estimated watch time in the United States for a particular channel's playlists. Results are grouped by day for each type of page or application where playlist views occurred. Results are sorted in chronological order.

dimensions=day,insightPlaybackLocationType
metrics=views,estimatedMinutesWatched,playlistStarts,playlistViews
filters=country==US
sort=day

Playback details

Video reports

Likes and dislikes by content type

This query retrieves the number of likes and dislikes for each type of content on a channel.

dimensions=creatorContentType
metrics=likes,dislikes

Traffic source

Video reports

Viewcounts and watch time from different traffic sources in a country

This request retrieves the number of views and estimated watch time for the channel's videos in a specified country. The metrics are aggregated by traffic source, which describes the manner in which users reached the video.

dimensions=insightTrafficSourceType
metrics=views,estimatedMinutesWatched
filters=country==US

Daily view counts and watch time from different traffic sources

This request retrieves daily view counts and daily estimated watch time for the channel's videos. The metrics are aggregated on a daily basis by traffic source and sorted in chronological order.

dimensions=day,insightTrafficSourceType
metrics=views,estimatedMinutesWatched
sort=day

Top 10 – YouTube search terms that generate the most traffic for a video

This query retrieves the 10 search terms that generated the most views from YouTube search results for one or more specific videos. Results are sorted by view count in descending order. Note that to run this query in the APIs Explorer, you must replace the string VIDEO_ID in the filters parameter value with a comma-separated list of up to 500 video IDs.

For example, you could run the query for a single video or replace VIDEO_ID to identify the search terms that generate the most traffic for that video. You could also list all of the videos in a particular playlist to determine which search terms generate the most traffic for any of the videos in that playlist.

dimensions=insightTrafficSourceDetail
metrics=views
filters=video==VIDEO_ID;insightTrafficSourceType==YT_SEARCH
maxResults=10
sort=-views

Top 10 – External websites that generate the most traffic for a video

This query retrieves the 10 external websites that generated the most views for a specific video or group of videos. Results are sorted by estimated watch time in descending order. Note that to run this query in the APIs Explorer, you must replace the string VIDEO_ID in the filters parameter value with a comma-separated list of up to 500 video IDs for your uploaded videos.

dimensions=insightTrafficSourceDetail
metrics=estimatedMinutesWatched,views
filters=video==VIDEO_ID;insightTrafficSourceType==EXT_URL
maxResults=25
sort=-estimatedMinutesWatched

Playlist reports

Playlist view counts and watch time from different traffic sources in a country

This request retrieves the number of views (an aggregated video metric ), playlist views (an in-playlist metric), playlist starts, and estimated watch time for playlist views in a specified country. The metrics are aggregated by traffic source, which describes the manner in which users reached the playlist.

dimensions=insightTrafficSourceType
metrics=views,estimatedMinutesWatchedplaylistStarts,playlistViews
filters=country==US

Daily playlist view counts and watch time from different traffic sources

This request retrieves a channel's daily playlist views (an in-playlist metric), playlist starts, and estimated watch time. It also retrieves total views (an aggregated video metric ). The metrics are aggregated on a daily basis by traffic source and sorted in chronological order.

dimensions=day,insightTrafficSourceType
metrics=views,estimatedMinutesWatched,playlistStarts,playlistViews
sort=day

Device/OS

Video reports

Daily device type metrics for the Android operating system

This query retrieves daily view counts and estimated watch time on Android devices for a particular channel's videos. Results are grouped by day for each type of device where video playbacks occurred. Results are sorted in chronological order.

dimensions=day,deviceType
metrics=estimatedMinutesWatched,views
filters=operatingSystem==ANDROID
sort=day

Daily operating system metrics for mobile devices

This query retrieves daily view counts and estimated watch time on mobile devices for a particular channel's videos. Results are grouped by day for each operating system on which video playbacks occurred. Results are sorted in chronological order.

dimensions=day,operatingSystem
metrics=estimatedMinutesWatched,views
filters=deviceType==MOBILE
sort=day

Daily operating system and device type metrics

This query retrieves daily view counts and estimated watch time for a channel. Statistics are grouped by operating system and device type. Results are sorted in chronological order.

dimensions=day,operatingSystem,deviceType
metrics=estimatedMinutesWatched,views
sort=day

Playlist reports

Daily device type metrics for playlist views on the Android operating system

This query retrieves daily views (an aggregated video metric ), playlist views (an in-playlist metric), and estimated watch time on Android devices for a particular channel's playlists. Results are grouped by day for each type of device where playlist views occurred. Results are sorted in chronological order.

dimensions=day,deviceType
metrics=views,estimatedMinutesWatched,playlistViews
filters=operatingSystem==ANDROID
sort=day

Daily operating system metrics for playlist views on mobile devices

This query retrieves daily views (an aggregated video metric ), playlist views (an in-playlist metric), and estimated watch time on mobile devices for a particular channel's playlists. Results are grouped by day for each operating system on which playlist views occurred. Results are sorted in chronological order.

dimensions=day,operatingSystem
metrics=views,estimatedMinutesWatched
filters=deviceType==MOBILE
sort=day

Демографический

Video reports

Viewer demographics in California (age group and gender)

This report retrieves statistics about the age group and gender of viewers in California who watched the channel's videos. Results are sorted by gender and then by age group. This query could be modified to retrieve the same statistics for all viewers worldwide or all viewers in a country, continent, subcontinent, or another US state by adjusting the filters parameter value.

dimensions=ageGroup,gender
metrics=viewerPercentage
filters=province==US-CA
sort=gender,ageGroup

Playlist reports

Playlist viewer demographics in California (age group and gender)

This report retrieves statistics about the age group and gender of viewers in California who watched the channel's playlists. Results are sorted by gender and then by age group. This query could be modified to retrieve the same statistics for all viewers worldwide or all viewers in a country, continent, subcontinent, or another US state by adjusting the filters parameter value.

dimensions=ageGroup,gender
metrics=viewerPercentage
filters=province==US-CA
sort=gender,ageGroup

Социальный

Sharing metrics, aggregated by service where videos were shared

This request retrieves the number of times that users used the Share button to share a channel's videos. Results are aggregated by sharing service (Google+, Twitter, etc.) and sorted in descending order of number of shares.

dimensions=sharingService
metrics=shares
sort=-shares

Audience retention

Audience retention metrics for a video

This report measures a video's ability to retain its audience. The report can only be retrieved for a single video at a time. Note that to run this query in the APIs Explorer, you must replace the string VIDEO_ID in the filters parameter value with the video ID for one of your uploaded videos. Note that audience retention reports do not support the ability to specify multiple values for the video filter.

In this example, the report uses the audienceType filter to restrict the response so that it only contains data for organic views, which are the result of a direct user action, such as a search for a video or a click on a suggested video. As such, the report does not include data for views from TrueView in-stream or TrueView in-display ads. You can remove the filter to retrieve the video's audience retention data from all audience types.

Note that data for the audienceType filter is available as of September 25, 2013. The API will not return data for queries that use the filter to try to retrieve data from earlier dates. Queries that do not use the filter work for any date after July 1, 2008.

dimensions=elapsedVideoTimeRatio
metrics=audienceWatchRatio,relativeRetentionPerformance
filters=video==VIDEO_ID;audienceType==ORGANIC

Revenue/Ads

Channel revenue and ad performance metrics

This request retrieves a channel's revenue and ad performance metrics. The report returns a single row of data that contains totals for each requested metric during the specified date range.

metrics=views,estimatedRevenue,estimatedAdRevenue,estimatedRedPartnerRevenue,grossRevenue,adImpressions,cpm,playbackBasedCpm,monetizedPlaybacks

Daily revenue and ad performance metrics

This request retrieves a channel's daily revenue and ad performance metrics.

dimensions=day
metrics=views,estimatedRevenue,estimatedAdRevenue,estimatedRedPartnerRevenue,grossRevenue,adImpressions,cpm,playbackBasedCpm,monetizedPlaybacks

Country-specific revenue and ad performance metrics

This request retrieves a channel's country-specific revenue and ad performance metrics. Results are sorted in descending order by revenue amount, which means that the first country listed will be the one where the partner had the greatest net revenue.

dimensions=country
metrics=views,estimatedRevenue,estimatedAdRevenue,estimatedRedPartnerRevenue,grossRevenue,adImpressions,cpm,playbackBasedCpm,monetizedPlaybacks
sort=-estimatedRevenue

Top 10 – Videos with the highest revenue

This request retrieves revenue and ad performance metrics for the channel's 10 videos with the greatest revenue. Results are sorted in descending order by revenue amount, which means that the first video will be the one that had the highest estimated revenue.

dimensions=video
metrics=views,estimatedRevenue,estimatedAdRevenue,estimatedRedPartnerRevenue,grossRevenue,adImpressions,cpm,playbackBasedCpm,monetizedPlaybacks
maxResults=10
sort=-estimatedRevenue

Ad performance metrics for different ad types

This request retrieves ad performance metrics for the content owner's claimed content. Results are grouped by ad type, which enables you to compare revenue and CPM values across different ad types.

dimensions=adType
metrics=grossRevenue,adImpressions,cpm
filters=claimedStatus==claimed
sort=-adType

Content owner reports

Basic stats

Video reports

Total view counts, estimated watch time, and more for all claimed content

This query retrieves aggregated metrics for the content owner's claimed content. The report returns a single row of data that contains totals for each requested metric during the specified date range.

metrics=views,comments,likes,dislikes,estimatedMinutesWatched,averageViewDuration
filters=claimedStatus==claimed

Country-specific view counts (and more) for all self-uploaded videos

This query retrieves metrics for a specific country for videos that the content owner uploaded. The report returns a single row of data that contains totals for each requested metric during the specified date range.

metrics=views,comments,likes,dislikes,shares
filters=uploaderType==self;country==FR

Total view counts (and more) for all claimed third-party content

This query retrieves aggregated metrics for videos that the content owner claimed but did not upload. The report returns a single row of data that contains totals for each requested metric during the specified date range.

metrics=views,comments,likes,dislikes,shares
filters=uploaderType==thirdParty;claimedStatus==claimed

Total view counts (and more) for all self-uploaded content

This query retrieves aggregated metrics for videos that the content owner uploaded. The report returns a single row of data that contains totals for each requested metric during the specified date range.

metrics=views,comments,likes,dislikes,estimatedMinutesWatched
filters=uploaderType==self

Total view counts (and more) for all claimed, self-uploaded content

This query retrieves aggregated metrics for videos that the content owner uploaded and also claimed. The report returns a single row of data that contains totals for each requested metric during the specified date range.

metrics=views,comments,likes,dislikes,estimatedMinutesWatched
filters=uploaderType==self;claimedStatus==claimed

Top 10 – Most viewed videos for a content owner

This query retrieves the 10 most viewed videos, as measured by number of views during the specified date range, that the content owner uploaded. Results are sorted by view count in descending order.

dimensions=video
metrics=views,estimatedMinutesWatched,estimatedRevenue,estimatedAdRevenue,monetizedPlaybacks,adImpressions
filters=uploaderType==self
maxResults=10
sort=-views

Top 10 – Most watched videos for a content owner

This query retrieves the 10 most watched videos, as measured by estimated minutes watched during the specified date range, that the content owner uploaded. Results are sorted by estimated minutes watched in descending order.

dimensions=video
metrics=estimatedMinutesWatched,averageViewDuration,averageViewPercentage,views,subscribersGained
filters=uploaderType==self
maxResults=10
sort=-estimatedMinutesWatched

Top 10 – Most viewed videos for a content owner's channel

This query retrieves the 10 most viewed videos for a specific channel or group of channels that the content owner manages. Results are sorted by view count in descending order. Note that to run this query in the APIs Explorer, you must replace the string CHANNEL_ID in the filters parameter value with a comma-separated list of up to 500 channel IDs for your channels.

dimensions=video
metrics=views
filters=channel==CHANNEL_ID
maxResults=10
sort=-views

Top 10 – Annotation click-through rates for a channel's most viewed videos

This request retrieves view counts, annotation click-through rates, annotation close rates, and annotation impressions for the 10 most viewed videos in a specified channel or group of channels. Results are sorted by view count in descending order, which means that the most viewed video will be listed first. Note that to run this query in the APIs Explorer, you must replace the string CHANNEL_ID in the filters parameter value with a comma-separated list of up to 500 channel IDs for your channels.

dimensions=video
metrics=views,likes,annotationClickThroughRate,annotationCloseRate,annotationImpressions
filters=channel==CHANNEL_ID
maxResults=10
sort=-views

Playlist reports

Playlist views for a content owner's channels

This request retrieves total playlist starts, playlist estimated minutes watched, playlist views, and views per playlist start for playlists in the content owner's channels. The playlistViews metric counts only video views that occurred in the context of a playlist. Since all of the requested metrics are in-playlist metrics, the request does not also need to include the playlist or group filter.

metrics=playlistViews,playlistStarts,playlistEstimatedMinutesWatched,viewsPerPlaylistStart

Statistics for a specific playlist

This request retrieves total playlist starts, estimated minutes watched, views (an aggregated video metric ), playlist views (an in-playlist metric), and views per playlist start for a specific playlist. Note that to run this query in the APIs Explorer, you must replace the string PLAYLIST_ID in the filters parameter value with the playlist ID for a playlist in one of the content owner's channels.

metrics=views,estimatedMinutesWatched,playlistStarts,playlistViews,viewsPerPlaylistStart
filters=playlist==PLAYLIST_ID

To retrieve aggregate statistics for multiple playlists, you can also replace the string PLAYLIST_ID with a comma-separated list of up to 500 playlists IDs for playlists in the content owner's channels.

Time-based

Video reports

Daily watch time metrics for self-uploaded content

This query retrieves daily watch time metrics, as well as view counts, monetized playback counts, and impression counts for videos that the content owner uploaded. The report returns one row of data for each day in the requested date range, and rows are sorted in chronological order.

dimensions=day
metrics=estimatedMinutesWatched,averageViewPercentage,views,monetizedPlaybacks,adImpressions
filters=uploaderType==self
sort=day

Annotation metrics for claimed content

This request retrieves daily view counts, annotation click-through rates, annotation close rates, and annotation impressions for the content owner's claimed content. Results are sorted in chronological order.

dimensions=day
metrics=views,likes,annotationClickThroughRate,annotationCloseRate,annotationImpressions
filters=claimedStatus==claimed
sort=day

Playlist reports

Daily playlist views for a content owner

This request retrieves metrics for daily user interactions with videos in the content owner's playlists. The metrics retrieved in the report are playlistViews , playlistStarts , playlistEstimatedMinutesWatched , and viewsPerPlaylistStart . All of these metrics are in-playlist metrics. Since all of the requested metrics are in-playlist metrics, the request does not need to also include the playlist or group filter.

dimensions=day
metrics=playlistViews,playlistStarts,playlistEstimatedMinutesWatched,viewsPerPlaylistStart
sort=day

Географический

Video reports

Country-specific watch time metrics for self-uploaded content

This query retrieves view counts, watch time metrics, and estimated ad revenue for each country. The metrics are for videos that the content owner uploaded. The report returns one row of data for each country where the videos were watched, and rows are sorted in descending order of number of minutes watched.

dimensions=country
metrics=views,estimatedMinutesWatched,averageViewDuration,averageViewPercentage,estimatedRevenue,estimatedAdRevenue,grossRevenue
filters=uploaderType==self
sort=-estimatedMinutesWatched

Country-specific annotation metrics for self-uploaded content

This request retrieves country-specific view counts, annotation click-through rates, annotation close rates, and annotation impressions for the content owner's uploaded videos. Results are sorted by annotation click-through rate in descending order, which means that the country with the highest annotation click-through rate will be listed first.

dimensions=country
metrics=views,likes,annotationClickThroughRate,annotationCloseRate,annotationImpressions
filters=uploaderType==self
sort=-annotationClickThroughRate

Province-specific metrics for US states and Washington DC

This request retrieves a province-by-province breakdown of view counts, estimated minutes watched, and average view duration for the content owner's claimed videos. The data covers US states and Washington DC Results are sorted alphabetically by provinces' ISO 3166-2 codes .

dimensions=province
metrics=views,estimatedMinutesWatched,averageViewDuration
filters=claimedStatus==claimed;country==US
sort=province

Top 10 US cities by total views

This query retrieves a list of the 10 US cities that accounted for the most views of the content owner's claimed videos during the specified date range. The query could be modified to request data for another country by choosing another valid value for that filter. Similarly, the query could be modified to retrieve data for a subcontinent, such as Western Europe or Southeastern Asia, by using the subContinent filter and one of its valid values. Other filters are supported, too. Results are sorted by view count in descending order.

    dimensions=city
metrics=views
filters=claimedStatus==claimed;country==US
maxResults=10
sort=-views

Top 10 US cities by total views for each content type

This query retrieves a list of the 10 US cities that accounted for the most views of the content owner's claimed content during the specified date range for each supported creatorContentType . Results are sorted by view count in descending order.

    dimensions=city,creatorContentType
metrics=views
filters=claimedStatus==claimed;country==US
maxResults=10
sort=-views

Top 10 US cities by total watch time

This query retrieves a list of the top 10 days during the specified date range when any US city accounted for the greatest total daily watch time of the content owner's claimed content. The query results identify the total watch time, the date on which the watch time occurred, and the city where the content was estimated to have been viewed. Results are sorted in descending order of total watch time.

    dimensions=city,day
metrics=estimatedWatchTime
filters=claimedStatus==claimed;country==US
maxResults=10
sort=-estimatedWatchTime

Top 10 – Most watched videos in Europe

This query retrieves the 10 most watched videos in Europe, among videos claimed by the content owner, as measured by number of views during the specified date range. The query could be modified to request data for another continent by choosing another valid value for that filter. Similarly, the query could be modified to retrieve data for a subcontinent, such as Western Europe or Southeastern Asia, by using the subContinent filter and one of its valid values. Results are sorted by view count in descending order.

dimensions=video
metrics=views,estimatedMinutesWatched,likes,subscribersGained
filters=claimedStatus==claimed;filters=continent==150
maxResults=10
sort=-estimatedMinutesWatched

Playlist reports

Country-specific watch time metrics for a content owner's playlists

This query retrieves country-specific playlist view counts and playlist watch time metrics for all playlists in the content owner's channels. The report returns one row of data for each country where the playlists were watched. Rows are sorted in descending order of number of minutes watched.

dimensions=country
metrics=playlistViews,playlistEstimatedMinutesWatched,playlistStarts,averageTimeInPlaylist
sort=-playlistEstimatedMinutesWatched

Top 10 – Most started playlists in the United States

This query retrieves the 10 playlists from the content owner's channels that viewers in the United States started watching most frequently during the specified date range. Results are sorted by number of playlist starts in descending order.

Note: Since this report uses the playlist dimension, you must specify a value for the sort request parameter and also set th maxResults parameter to an integer value of 10 or less.

dimensions=playlist
metrics=playlistStarts,playlistViews,playlistEstimatedMinutesWatched,playlistAverageViewDuration
filters=country==US
maxResults=10
sort=-playlistStarts

Playback details

Video reports

Likes and dislikes by content type

This query retrieves the number of likes and dislikes for each type of content on a particular channel or group of channels. Note that to run this query in the APIs Explorer, you must replace the string CHANNEL_ID in the filters parameter value with a comma-separated list of up to 500 channel IDs for your channels.

dimensions=creatorContentType
metrics=likes,dislikes
filters=channel==CHANNEL_ID

Playback location

Video reports

Viewcounts and watch time from different playback locations

This query retrieves the number of views and estimated watch time for videos uploaded to a particular channel or group of channels. Results are aggregated based on the type of page or application where video playbacks occurred, and results are sorted in descending order by view count. Note that to run this query in the APIs Explorer, you must replace the string CHANNEL_ID in the filters parameter value with a comma-separated list of up to 500 channel IDs for your channels.

dimensions=insightPlaybackLocationType
metrics=estimatedMinutesWatched,views
filters=channel==CHANNEL_ID
sort=-views

Daily view counts and watch time from different playback locations

This query retrieves daily view counts and estimated watch time in the United States for videos uploaded to a particular channel or group of channels. Results are grouped by day for each type of page or application where video playbacks occurred. Results are sorted in reverse chronological order. Note that to run this query in the APIs Explorer, you must replace the string CHANNEL_ID in the filters parameter value with a comma-separated list of up to 500 channel IDs for your channels.

dimensions=day,insightPlaybackLocationType
metrics=estimatedMinutesWatched,views
filters=country==US;channel==CHANNEL_ID
sort=-day

Top 10 – Third-party sites that generate the most views for an embedded video

This query retrieves view counts and estimated watch time for a particular video or group of videos. Results are grouped by the third-party site where the video was embedded. Results are sorted in descending order by view count. Note that to run this query in the APIs Explorer, you must replace the string VIDEO_ID in the filters parameter value with a comma-separated list of up to 500 video IDs for your uploaded videos.

dimensions=insightPlaybackLocationDetail
metrics=views,estimatedMinutesWatched
filters=video==VIDEO_ID;insightPlaybackLocationType==EMBEDDED
maxResults=10
sort=-views

Playlist reports

Playlist view counts and watch time from different playback locations

This query retrieves the number of playlist views, playlist estimated watch time, and playlist starts for all playlists in a content owner's channels. Results are aggregated based on the type of page or application where video playbacks occurred, and results are sorted in descending order by playlist starts.

dimensions=insightPlaybackLocationType
metrics=playlistViews,playlistEstimatedMinutesWatched,playlistStarts
sort=-playlistStarts

Playlist view counts and watch time from different playback locations

This query retrieves daily playlist starts, playlist view counts, and playlist estimated watch time in the United States for all playlists in a content owner's channels. Results are returned for each type of page or application where playlist views occurred.

dimensions=day,insightPlaybackLocationType
metrics=playlistStarts,playlistViews,playlistEstimatedMinutesWatched
filters=country==US

Traffic source

Video reports

Viewcounts and watch time from different traffic sources

This request retrieves the number of views and estimated watch time for the content owner's videos. The metrics are aggregated by traffic source, which describes the manner in which users reached the video.

dimensions=insightTrafficSourceType
metrics=views,estimatedMinutesWatched
filters=uploaderType==self

Daily view counts and watch time from different traffic sources

This request retrieves daily view counts and daily estimated watch time for the content owner's videos. The metrics are aggregated on a daily basis by traffic source and sorted in reverse chronological order.

dimensions=day,insightTrafficSourceType
metrics=views,estimatedMinutesWatched
filters=uploaderType==self
sort=-day

Note: The next two sample reports are only supported for specific traffic sources. VIDEO_REMIXES , NOTIFICATION , END_SCREEN , CAMPAIGN_CARD , VIDEO_REMIXES , and NO_LINK_EMBEDDED traffic sources are some of the unsupported ones.

Top 10 – YouTube search terms that generate the most traffic for a video

This query retrieves the 10 search terms that generated the most views from YouTube search results for a specific video or group of videos. Results are sorted by view count in descending order. Note that to run this query in the APIs Explorer, you must replace the string VIDEO_ID in the filters parameter value with a comma-separated list of up to 500 video IDs for your uploaded videos.

dimensions=insightTrafficSourceDetail
metrics=views
filters=video==VIDEO_ID;insightTrafficSourceType==YT_SEARCH
maxResults=10
sort=-views

Top 10 – External websites that generate the most traffic for a video

This query retrieves the 10 external websites that generated the most views from Google search results for a specific video or group of videos. Results are sorted by estimated watch time in descending order. Note that to run this query in the APIs Explorer, you must replace the string VIDEO_ID in the filters parameter value with a comma-separated list of up to 500 video IDs for your uploaded videos.

dimensions=insightTrafficSourceDetail
metrics=estimatedMinutesWatched,views
filters=video==VIDEO_ID;insightTrafficSourceType==EXT_URL
maxResults=25
sort=-estimatedMinutesWatched

Playlist reports

Playlist view counts and watch time from different traffic sources in a country

This request retrieves the number of playlist views, playlist starts, and playlist estimated watch time for playlist views in a specified country. The metrics are aggregated by traffic source, which describes the manner in which users reached the playlist.

dimensions=insightTrafficSourceType
metrics=playlistViews,playlistStarts,playlistEstimatedMinutesWatched
filters=country==US

Playlist view counts and watch time from different traffic sources

This request retrieves playlist views, playlist starts, and playlist estimated watch time for playlists in one or more of a content owner's channels. The metrics are aggregated by traffic source. Note that to run this query in the APIs Explorer, you must replace the string CHANNEL_ID in the filters parameter value with a comma-separated list of up to 500 channel IDs for your channels.

dimensions=day,insightTrafficSourceType
metrics=playlistViews,playlistStarts,playlistEstimatedMinutesWatched
filters=channel==CHANNEL_ID

Device/OS

Video reports

Daily device type metrics for claimed videos

This query retrieves daily view counts and estimated watch time by device type for videos claimed by a particular content owner. Results are grouped by day for each type of device where video playbacks occurred. Results are sorted in chronological order.

dimensions=day,deviceType
metrics=estimatedMinutesWatched,views
filters=claimedStatus==claimed
sort=day

Daily operating system metrics for claimed videos viewed on mobile devices

This query retrieves daily view counts and estimated watch time by operating system for views of videos claimed by a specified content owner that took place on mobile devices. Results are grouped by day for each operating system where video playbacks occurred. Results are sorted in chronological order.

dimensions=day,operatingSystem
metrics=estimatedMinutesWatched,views
filters=claimedStatus==claimed;deviceType==MOBILE
sort=day

Daily operating system and device type metrics

This query retrieves daily view counts and estimated watch time for videos claimed by a particular content owner. Statistics are grouped by operating system and device type. Results are sorted in chronological order.

dimensions=day,operatingSystem,deviceType
metrics=estimatedMinutesWatched,views
sort=day

Playlist reports

Device type metrics for playlist views on the Android operating system

This query retrieves playlist view counts and playlist estimated watch time on Android devices for playlists in one or more of a content owner's channels. Results are returned for each type of device where playlist views occurred. Note that to run this query in the APIs Explorer, you must replace the string CHANNEL_ID in the filters parameter value with a comma-separated list of up to 500 channel IDs for your channels.

dimensions=deviceType
metrics=playlistViews,playlistEstimatedMinutesWatched
filters=channel==CHANNEL_ID;operatingSystem==ANDROID

Operating system metrics for playlist views on mobile devices

This query retrieves playlist view counts and playlist estimated watch time on mobile devices for playlists in any of a content owner's channels. Results are returned for each operating system on which playlist views occurred.

dimensions=operatingSystem
metrics=views,estimatedMinutesWatched
filters=deviceType==MOBILE

Демографический

Video reports

Viewer demographics in California (age group and gender)

This report retrieves statistics about the age group and gender of viewers in California who watched the content owner's claimed content. Results are sorted by gender and then by age group. This query could be modified to retrieve the same statistics for all viewers worldwide or all viewers in a country, continent, subcontinent, or another US state by adjusting the filters parameter value.

dimensions=ageGroup,gender
metrics=viewerPercentage
filters=claimedStatus==claimed;province==US-CA
sort=gender,ageGroup

Социальный

Sharing metrics, aggregated by service where videos were shared

This request retrieves the number of times that users used the Share button to share videos that the content owner uploaded. Results are aggregated by sharing service (Google+, Twitter, etc.) and sorted in descending order of number of shares.

dimensions=sharingService
metrics=shares
filters=uploaderType==self
sort=-shares

Audience retention

Audience retention metrics for a video

This report measures a video's ability to retain its audience. The report can only be retrieved for a single video at a time. Note that to run this query in the APIs Explorer, you must replace the string VIDEO_ID in the filters parameter value with the video ID for one of your uploaded videos. Note that audience retention reports do not support the ability to specify multiple values for the video filter.

In this example, the report uses the audienceType filter to restrict the response so that it only contains data for organic views, which are the result of a direct user action, such as a search for a video or a click on a suggested video. As such, the report does not include data for views from TrueView in-stream or TrueView in-display ads. You can remove the filter to retrieve the video's audience retention data from all audience types.

Note that data for the audienceType filter is available as of September 25, 2013. The API will not return data for queries that use the filter to try to retrieve data from earlier dates. Queries that do not use the filter work for any date after July 1, 2008.

dimensions=elapsedVideoTimeRatio
metrics=audienceWatchRatio,relativeRetentionPerformance
filters=video==VIDEO_ID;audienceType==ORGANIC

Revenue/Ads

Revenue and ad performance metrics for claimed content

This request retrieves revenue and ad performance metrics for the content owner's claimed content. The report returns a single row of data that contains totals for each requested metric during the specified date range.

metrics=views,estimatedRevenue,estimatedAdRevenue,estimatedRedPartnerRevenue,grossRevenue,adImpressions,cpm,playbackBasedCpm,monetizedPlaybacks
filters=claimedStatus==claimed

Daily revenue and ad performance metrics

This request retrieves daily revenue and ad performance metrics for the content owner's claimed content.

dimensions=day
metrics=views,estimatedRevenue,estimatedAdRevenue,estimatedRedPartnerRevenue,grossRevenue,adImpressions,cpm,playbackBasedCpm,monetizedPlaybacks
filters=claimedStatus==claimed

Country-specific revenue and ad performance metrics

This request retrieves country-specific revenue and ad performance metrics for the content owner's claimed content. Results are sorted in descending order by revenue amount, which means that the first country listed will be the one where the partner had the greatest estimated revenue.

dimensions=country
metrics=views,estimatedRevenue,estimatedAdRevenue,estimatedRedPartnerRevenue,grossRevenue,adImpressions,cpm,playbackBasedCpm,monetizedPlaybacks
filters=claimedStatus==claimed
sort=-estimatedRevenue

Top 10 – Videos with the highest revenue

This request retrieves revenue and ad performance metrics for the 10 videos that where claimed by the content owner claimed and that had the highest revenue. Results are sorted in descending order by revenue amount, which means that the first video will be the one that had the highest estimated revenue.

dimensions=video
metrics=views,estimatedRevenue,estimatedAdRevenue,estimatedRedPartnerRevenue,grossRevenue,adImpressions,cpm,playbackBasedCpm,monetizedPlaybacks
filters=claimedStatus==claimed
maxResults=10
sort=-estimatedRevenue

Ad performance metrics for different ad types

This request retrieves ad performance metrics for the content owner's claimed content. Results are grouped by ad type, which enables you to compare revenue and CPM values across different ad types.

dimensions=adType
metrics=grossRevenue,adImpressions,cpm
filters=claimedStatus==claimed
sort=-adType

,

This page shows sample YouTube Analytics API requests. Each example briefly describes the report being retrieved and then shows the corresponding dimensions , metrics , filters , and sort parameter values. (The channel reports and content owner reports documents identify the reports that the API supports.)

Each example links to and populates the Google APIs Explorer with the values shown. The examples also use default start and end dates ( YYYY-MM-DD ) of 2023-09-01 and 2024-03-31 .

After linking to the APIs Explorer, you must still specify the channel or content owner for which you are retrieving reports. The APIs Explorer will populate the ids parameter value with either channel==MINE or contentOwner==CONTENT_OWNER_ID , depending on the query that you have clicked. For channel reports, you could change MINE to the authenticated user's channel ID. For content owner reports, you need to replace CONTENT_OWNER_ID with your content owner ID.

You also have to be authenticated as the specified channel or content owner so that the APIs Explorer can authorize your API requests using OAuth 2.0 .

1. Sorting requests by multiple dimensions/metrics
2. Channel reports
3. Content owner reports

Sorting requests by multiple dimensions/metrics

The API supports the ability to sort response data using multiple dimensions or metrics. For example, the request below retrieves daily traffic source data for a particular channel's videos. Each row in the result set identifies the number of views and the estimated watch time that originated from a particular type of traffic source (eg EXT_URL ) on a particular day.

dimensions=day,insightTrafficSourceType
metrics=views,estimatedWatchTime
sort=day,-views

In the response, results are sorted chronologically. Within the set of results for each day, results are sorted in descending order by view count. So, the first row in the result set contains data for the traffic source that generated the most views on the first day in the requested date range. The second row contains data for the traffic source that generated the next highest number of views on the first day.

Channel reports

Basic stats

Video reports

Total view counts, estimated watch time, and more for a channel

This query retrieves aggregated metrics for the channel's content. The report returns a single row of data that contains totals for each requested metric during the specified date range.

metrics=views,comments,likes,dislikes,estimatedMinutesWatched,averageViewDuration

Country-specific view counts (and more) for a channel

This query retrieves metrics for a specific country for a channel's videos. The report returns a single row of data that contains totals for each requested metric during the specified date range.

metrics=views,comments,likes,dislikes,estimatedMinutesWatched
filters=country==US

Top 10 – Most watched videos for a channel

This query retrieves a channel's 10 most watched videos, as measured by estimated minutes watched during the specified date range. Results are sorted by estimated minutes watched in descending order.

Note: This report requires you to specify a value for the sort request parameter and to set the maxResults parameter to an integer value of 10 or less.

dimensions=video
metrics=estimatedMinutesWatched,views,likes,subscribersGained
maxResults=10
sort=-estimatedMinutesWatched

Top 10 – Annotation click-through rates for a channel's most viewed videos

This request retrieves view counts, annotation click-through rates, annotation close rates, and annotation impressions for the channel's 10 most viewed videos. Results are sorted by view count in descending order, which means that the most viewed video will be listed first.

Note: This report requires you to specify a value for the sort request parameter and to set the maxResults parameter to an integer value of 10 or less.

dimensions=video
metrics=views,likes,annotationClickThroughRate,annotationCloseRate,annotationImpressions
maxResults=10
sort=-views

Playlist reports

Total playlist views for a channel

This request retrieves total playlist starts, estimated minutes watched, views (an aggregated video metric ), playlist views (an in-playlist metric), and views per playlist start for playlists in the authenticated user's channel.

metrics=views,estimatedMinutesWatched,playlistStarts,playlistViews,viewsPerPlaylistStart

Statistics for a specific playlist

This request retrieves total playlist starts, estimated minutes watched, views (an aggregated video metric ), playlist views (an in-playlist metric), and views per playlist start for a specific playlist. Note that to run this query in the APIs Explorer, you must replace the string PLAYLIST_ID in the filters parameter value with the playlist ID for a playlist in the authenticated user's channel.

metrics=views,estimatedMinutesWatched,playlistStarts,playlistViews,viewsPerPlaylistStart
filters=playlist==PLAYLIST_ID

To retrieve aggregate statistics for multiple playlists, you can also replace the string PLAYLIST_ID with a comma-separated list of up to 500 playlists IDs for playlists in the authenticated user's channel.

Top 10 – Most watched playlists for a channel

This query retrieves a channel's 10 most watched playlists, as measured by playlist views during the specified date range. It also retrieves several other playlist metrics, such as the number of times that viewers initiated playback of each playlist and the average amount of time that a viewer watched videos in the playlist after it was started. Results are sorted by playlist views in descending order.

Note: Since this report uses the playlist dimension, you must specify a value for the sort request parameter and also set the maxResults parameter to an integer value of 10 or less.

dimensions=playlist
metrics=playlistViews,playlistEstimatedMinutesWatched,playlistStarts,averageTimeInPlaylist,playlistSaves
maxResults=10
sort=-playlistViews

Time-based

Video reports

Daily watch time metrics for a channel's videos

This query retrieves daily view counts, watch time metrics, and new subscriber counts for a channel's videos. The report returns one row of data for each day in the requested date range. Rows are sorted in chronological order.

dimensions=day
metrics=views,estimatedMinutesWatched,averageViewDuration,averageViewPercentage,subscribersGained
sort=day

Daily annotation metrics for a channel's videos

This request retrieves daily view counts, annotation click-through rates, annotation close rates, and annotation impressions for the channel's content. Results are sorted in chronological order.

dimensions=day
metrics=views,likes,annotationClickThroughRate,annotationCloseRate,annotationImpressions
sort=day

Playlist reports

Daily playlist views for a channel

This request retrieves daily view counts (an aggregated video metric ), playlist views (an in-playlist metric), playlist starts, estimated minutes watched, and views per playlist start for the authenticated user's channel. Results are sorted in chronological order.

dimensions=day
metrics=views,estimatedMinutesWatched,playlistStarts,playlistViews,viewsPerPlaylistStart
sort=day

Географический

Video reports

Country-specific watch time metrics for a channel's videos

This query retrieves country-specific view counts, watch time metrics, and subscription figures for a channel's videos. The report returns one row of data for each country where the channel's videos were watched. Rows are sorted in descending order of number of minutes watched.

dimensions=country
metrics=views,estimatedMinutesWatched,averageViewDuration,averageViewPercentage,subscribersGained
sort=-estimatedMinutesWatched

Country-specific annotation metrics for a channel's videos

This request retrieves country-specific view counts, annotation click-through rates, annotation close rates, and annotation impressions for the channel's videos. Results are sorted by annotation click-through rate in descending order, which means that the country with the highest annotation click-through rate will be listed first.

dimensions=country
metrics=views,likes,annotationClickThroughRate,annotationCloseRate,annotationImpressions
sort=-annotationClickThroughRate

Province-specific metrics for US states and Washington DC

This request retrieves a province-by-province breakdown of view counts, estimated minutes watched, and average view duration for the channel's videos. The data covers US states and Washington DC Results are sorted alphabetically by provinces' ISO 3166-2 codes .

dimensions=province
metrics=views,estimatedMinutesWatched,averageViewDuration
filters=claimedStatus==claimed;country==US
sort=province

Top 10 – Most viewed videos in a specific country

This query retrieves the channel's 10 most viewed videos, as measured by number of views during the specified date range, in a specified country. Results are sorted by view count in descending order.

Note: This report requires you to specify a value for the sort request parameter and to set the maxResults parameter to an integer value of 10 or less.

dimensions=video
metrics=views,estimatedMinutesWatched,likes,subscribersGained
filters=country==US
maxResults=10
sort=-views

Top 10 US cities by total views

This query retrieves a list of the 10 US cities that accounted for the most views of the channel's content during the specified date range. The query could be modified to request data for another country by choosing another valid value for that filter. Similarly, the query could be modified to retrieve data for a subcontinent, such as Western Europe or Southeastern Asia, by using the subContinent filter and one of its valid values. Other filters are supported, too. Results are sorted by view count in descending order.

    dimensions=city
metrics=views
filters=country==US
maxResults=10
sort=-views

Top 10 US cities by total views for each content type

This query retrieves a list of the 10 US cities that accounted for the most views of the channel's content during the specified date range for each supported creatorContentType . Results are sorted by view count in descending order.

    dimensions=city,creatorContentType
metrics=views
filters=country==US
maxResults=10
sort=-views

Top 10 US cities by total watch time

This query retrieves a list of the top 10 days during the specified date range when any US city accounted for the greatest total daily watch time of the channel's content. The query results identify the total watch time, the date on which the watch time occurred, and the city where the content was estimated to have been viewed. Results are sorted in descending order of total watch time.

    dimensions=city,day
metrics=estimatedWatchTime
filters=country==US
maxResults=10
sort=-estimatedWatchTime

Top 10 – Most viewed videos in Europe

This query retrieves the channel's 10 most viewed videos in Europe, as measured by number of views during the specified date range. The query could be modified to request data for another continent by choosing another valid value for that filter. Similarly, the query could be modified to retrieve data for a subcontinent, such as Western Europe or Southeastern Asia, by using the subContinent filter and one of its valid values. Results are sorted by view count in descending order.

Note: This report requires you to specify a value for the sort request parameter and to set the maxResults parameter to an integer value of 10 or less.

dimensions=video
metrics=views,estimatedMinutesWatched,likes,subscribersGained
filters=continent==150
maxResults=10
sort=-views

Playlist reports

Country-specific watch time metrics for a channel's playlists

This query retrieves country-specific view counts (an aggregated video metric ), playlist views (an in-playlist metric), and watch time metrics for a channel's playlists. The report returns one row of data for each country where the channel's playlists were watched. Rows are sorted in descending order of number of minutes watched.

dimensions=country
metrics=views,estimatedMinutesWatched,playlistStarts,averageTimeInPlaylist
sort=-estimatedMinutesWatched

Top 10 – Most started playlists in the United States

This query retrieves the 10 playlists that viewers in the United States started watching most frequently during the specified date range. Results are sorted by number of playlist starts in descending order.

Note: Since this report uses the playlist dimension, you must specify a value for the sort request parameter and also set the maxResults parameter to an integer value of 10 or less.

dimensions=playlist
metrics=playlistStarts,views,estimatedMinutesWatched,averageViewDuration
filters=isCurated==1;country==US
maxResults=10
sort=-playlistStarts

Playback location

Video reports

Viewcounts and watch time from different playback locations

This query retrieves the number of views and estimated watch time for a particular channel's videos. Results are aggregated based on the type of page or application where video playbacks occurred, and results are sorted in descending order by view count.

dimensions=insightPlaybackLocationType
metrics=estimatedMinutesWatched,views
sort=-views

Daily view counts and watch time from different playback locations

This query retrieves daily view counts and estimated watch time in the United States for a particular channel's videos. Results are grouped by day for each type of page or application where video playbacks occurred. Results are sorted in chronological order.

    dimensions=day,insightPlaybackLocationType
metrics=estimatedMinutesWatched,views
filters=country==US
sort=day

Top 10 – Third-party sites that generate the most views for an embedded video

This query retrieves view counts and estimated watch time for a particular video or group of videos. Results are grouped by the third-party site where the video was embedded. Results are sorted in descending order by view count. Note that to run this query in the APIs Explorer, you must replace the string VIDEO_ID in the filters parameter value with a comma-separated list of one or more video IDs for your uploaded videos.

dimensions=insightPlaybackLocationDetail
metrics=views,estimatedMinutesWatched
filters=video==VIDEO_ID;insightPlaybackLocationType==EMBEDDED
maxResults=10
sort=-views

Playlist reports

Playlist view counts and watch time from different playback locations

This query retrieves the number of view counts (an aggregated video metric ), playlist views (an in-playlist metric), estimated watch time, and playlist starts for a particular channel's playlists. Results are aggregated based on the type of page or application where video playbacks occurred, and results are sorted in descending order by playlist starts.

dimensions=insightPlaybackLocationType
metrics=views,estimatedMinutesWatched,playlistStarts,playlistViews
sort=-playlistStarts

Daily playlist view counts and watch time from different playback locations

This query retrieves daily playlist starts, view counts (an aggregated video metric ), playlist views (an in-playlist metric), and estimated watch time in the United States for a particular channel's playlists. Results are grouped by day for each type of page or application where playlist views occurred. Results are sorted in chronological order.

dimensions=day,insightPlaybackLocationType
metrics=views,estimatedMinutesWatched,playlistStarts,playlistViews
filters=country==US
sort=day

Playback details

Video reports

Likes and dislikes by content type

This query retrieves the number of likes and dislikes for each type of content on a channel.

dimensions=creatorContentType
metrics=likes,dislikes

Traffic source

Video reports

Viewcounts and watch time from different traffic sources in a country

This request retrieves the number of views and estimated watch time for the channel's videos in a specified country. The metrics are aggregated by traffic source, which describes the manner in which users reached the video.

dimensions=insightTrafficSourceType
metrics=views,estimatedMinutesWatched
filters=country==US

Daily view counts and watch time from different traffic sources

This request retrieves daily view counts and daily estimated watch time for the channel's videos. The metrics are aggregated on a daily basis by traffic source and sorted in chronological order.

dimensions=day,insightTrafficSourceType
metrics=views,estimatedMinutesWatched
sort=day

Top 10 – YouTube search terms that generate the most traffic for a video

This query retrieves the 10 search terms that generated the most views from YouTube search results for one or more specific videos. Results are sorted by view count in descending order. Note that to run this query in the APIs Explorer, you must replace the string VIDEO_ID in the filters parameter value with a comma-separated list of up to 500 video IDs.

For example, you could run the query for a single video or replace VIDEO_ID to identify the search terms that generate the most traffic for that video. You could also list all of the videos in a particular playlist to determine which search terms generate the most traffic for any of the videos in that playlist.

dimensions=insightTrafficSourceDetail
metrics=views
filters=video==VIDEO_ID;insightTrafficSourceType==YT_SEARCH
maxResults=10
sort=-views

Top 10 – External websites that generate the most traffic for a video

This query retrieves the 10 external websites that generated the most views for a specific video or group of videos. Results are sorted by estimated watch time in descending order. Note that to run this query in the APIs Explorer, you must replace the string VIDEO_ID in the filters parameter value with a comma-separated list of up to 500 video IDs for your uploaded videos.

dimensions=insightTrafficSourceDetail
metrics=estimatedMinutesWatched,views
filters=video==VIDEO_ID;insightTrafficSourceType==EXT_URL
maxResults=25
sort=-estimatedMinutesWatched

Playlist reports

Playlist view counts and watch time from different traffic sources in a country

This request retrieves the number of views (an aggregated video metric ), playlist views (an in-playlist metric), playlist starts, and estimated watch time for playlist views in a specified country. The metrics are aggregated by traffic source, which describes the manner in which users reached the playlist.

dimensions=insightTrafficSourceType
metrics=views,estimatedMinutesWatchedplaylistStarts,playlistViews
filters=country==US

Daily playlist view counts and watch time from different traffic sources

This request retrieves a channel's daily playlist views (an in-playlist metric), playlist starts, and estimated watch time. It also retrieves total views (an aggregated video metric ). The metrics are aggregated on a daily basis by traffic source and sorted in chronological order.

dimensions=day,insightTrafficSourceType
metrics=views,estimatedMinutesWatched,playlistStarts,playlistViews
sort=day

Device/OS

Video reports

Daily device type metrics for the Android operating system

This query retrieves daily view counts and estimated watch time on Android devices for a particular channel's videos. Results are grouped by day for each type of device where video playbacks occurred. Results are sorted in chronological order.

dimensions=day,deviceType
metrics=estimatedMinutesWatched,views
filters=operatingSystem==ANDROID
sort=day

Daily operating system metrics for mobile devices

This query retrieves daily view counts and estimated watch time on mobile devices for a particular channel's videos. Results are grouped by day for each operating system on which video playbacks occurred. Results are sorted in chronological order.

dimensions=day,operatingSystem
metrics=estimatedMinutesWatched,views
filters=deviceType==MOBILE
sort=day

Daily operating system and device type metrics

This query retrieves daily view counts and estimated watch time for a channel. Statistics are grouped by operating system and device type. Results are sorted in chronological order.

dimensions=day,operatingSystem,deviceType
metrics=estimatedMinutesWatched,views
sort=day

Playlist reports

Daily device type metrics for playlist views on the Android operating system

This query retrieves daily views (an aggregated video metric ), playlist views (an in-playlist metric), and estimated watch time on Android devices for a particular channel's playlists. Results are grouped by day for each type of device where playlist views occurred. Results are sorted in chronological order.

dimensions=day,deviceType
metrics=views,estimatedMinutesWatched,playlistViews
filters=operatingSystem==ANDROID
sort=day

Daily operating system metrics for playlist views on mobile devices

This query retrieves daily views (an aggregated video metric ), playlist views (an in-playlist metric), and estimated watch time on mobile devices for a particular channel's playlists. Results are grouped by day for each operating system on which playlist views occurred. Results are sorted in chronological order.

dimensions=day,operatingSystem
metrics=views,estimatedMinutesWatched
filters=deviceType==MOBILE
sort=day

Демографический

Video reports

Viewer demographics in California (age group and gender)

This report retrieves statistics about the age group and gender of viewers in California who watched the channel's videos. Results are sorted by gender and then by age group. This query could be modified to retrieve the same statistics for all viewers worldwide or all viewers in a country, continent, subcontinent, or another US state by adjusting the filters parameter value.

dimensions=ageGroup,gender
metrics=viewerPercentage
filters=province==US-CA
sort=gender,ageGroup

Playlist reports

Playlist viewer demographics in California (age group and gender)

This report retrieves statistics about the age group and gender of viewers in California who watched the channel's playlists. Results are sorted by gender and then by age group. This query could be modified to retrieve the same statistics for all viewers worldwide or all viewers in a country, continent, subcontinent, or another US state by adjusting the filters parameter value.

dimensions=ageGroup,gender
metrics=viewerPercentage
filters=province==US-CA
sort=gender,ageGroup

Социальный

Sharing metrics, aggregated by service where videos were shared

This request retrieves the number of times that users used the Share button to share a channel's videos. Results are aggregated by sharing service (Google+, Twitter, etc.) and sorted in descending order of number of shares.

dimensions=sharingService
metrics=shares
sort=-shares

Audience retention

Audience retention metrics for a video

This report measures a video's ability to retain its audience. The report can only be retrieved for a single video at a time. Note that to run this query in the APIs Explorer, you must replace the string VIDEO_ID in the filters parameter value with the video ID for one of your uploaded videos. Note that audience retention reports do not support the ability to specify multiple values for the video filter.

In this example, the report uses the audienceType filter to restrict the response so that it only contains data for organic views, which are the result of a direct user action, such as a search for a video or a click on a suggested video. As such, the report does not include data for views from TrueView in-stream or TrueView in-display ads. You can remove the filter to retrieve the video's audience retention data from all audience types.

Note that data for the audienceType filter is available as of September 25, 2013. The API will not return data for queries that use the filter to try to retrieve data from earlier dates. Queries that do not use the filter work for any date after July 1, 2008.

dimensions=elapsedVideoTimeRatio
metrics=audienceWatchRatio,relativeRetentionPerformance
filters=video==VIDEO_ID;audienceType==ORGANIC

Revenue/Ads

Channel revenue and ad performance metrics

This request retrieves a channel's revenue and ad performance metrics. The report returns a single row of data that contains totals for each requested metric during the specified date range.

metrics=views,estimatedRevenue,estimatedAdRevenue,estimatedRedPartnerRevenue,grossRevenue,adImpressions,cpm,playbackBasedCpm,monetizedPlaybacks

Daily revenue and ad performance metrics

This request retrieves a channel's daily revenue and ad performance metrics.

dimensions=day
metrics=views,estimatedRevenue,estimatedAdRevenue,estimatedRedPartnerRevenue,grossRevenue,adImpressions,cpm,playbackBasedCpm,monetizedPlaybacks

Country-specific revenue and ad performance metrics

This request retrieves a channel's country-specific revenue and ad performance metrics. Results are sorted in descending order by revenue amount, which means that the first country listed will be the one where the partner had the greatest net revenue.

dimensions=country
metrics=views,estimatedRevenue,estimatedAdRevenue,estimatedRedPartnerRevenue,grossRevenue,adImpressions,cpm,playbackBasedCpm,monetizedPlaybacks
sort=-estimatedRevenue

Top 10 – Videos with the highest revenue

This request retrieves revenue and ad performance metrics for the channel's 10 videos with the greatest revenue. Results are sorted in descending order by revenue amount, which means that the first video will be the one that had the highest estimated revenue.

dimensions=video
metrics=views,estimatedRevenue,estimatedAdRevenue,estimatedRedPartnerRevenue,grossRevenue,adImpressions,cpm,playbackBasedCpm,monetizedPlaybacks
maxResults=10
sort=-estimatedRevenue

Ad performance metrics for different ad types

This request retrieves ad performance metrics for the content owner's claimed content. Results are grouped by ad type, which enables you to compare revenue and CPM values across different ad types.

dimensions=adType
metrics=grossRevenue,adImpressions,cpm
filters=claimedStatus==claimed
sort=-adType

Content owner reports

Basic stats

Video reports

Total view counts, estimated watch time, and more for all claimed content

This query retrieves aggregated metrics for the content owner's claimed content. The report returns a single row of data that contains totals for each requested metric during the specified date range.

metrics=views,comments,likes,dislikes,estimatedMinutesWatched,averageViewDuration
filters=claimedStatus==claimed

Country-specific view counts (and more) for all self-uploaded videos

This query retrieves metrics for a specific country for videos that the content owner uploaded. The report returns a single row of data that contains totals for each requested metric during the specified date range.

metrics=views,comments,likes,dislikes,shares
filters=uploaderType==self;country==FR

Total view counts (and more) for all claimed third-party content

This query retrieves aggregated metrics for videos that the content owner claimed but did not upload. The report returns a single row of data that contains totals for each requested metric during the specified date range.

metrics=views,comments,likes,dislikes,shares
filters=uploaderType==thirdParty;claimedStatus==claimed

Total view counts (and more) for all self-uploaded content

This query retrieves aggregated metrics for videos that the content owner uploaded. The report returns a single row of data that contains totals for each requested metric during the specified date range.

metrics=views,comments,likes,dislikes,estimatedMinutesWatched
filters=uploaderType==self

Total view counts (and more) for all claimed, self-uploaded content

This query retrieves aggregated metrics for videos that the content owner uploaded and also claimed. The report returns a single row of data that contains totals for each requested metric during the specified date range.

metrics=views,comments,likes,dislikes,estimatedMinutesWatched
filters=uploaderType==self;claimedStatus==claimed

Top 10 – Most viewed videos for a content owner

This query retrieves the 10 most viewed videos, as measured by number of views during the specified date range, that the content owner uploaded. Results are sorted by view count in descending order.

dimensions=video
metrics=views,estimatedMinutesWatched,estimatedRevenue,estimatedAdRevenue,monetizedPlaybacks,adImpressions
filters=uploaderType==self
maxResults=10
sort=-views

Top 10 – Most watched videos for a content owner

This query retrieves the 10 most watched videos, as measured by estimated minutes watched during the specified date range, that the content owner uploaded. Results are sorted by estimated minutes watched in descending order.

dimensions=video
metrics=estimatedMinutesWatched,averageViewDuration,averageViewPercentage,views,subscribersGained
filters=uploaderType==self
maxResults=10
sort=-estimatedMinutesWatched

Top 10 – Most viewed videos for a content owner's channel

This query retrieves the 10 most viewed videos for a specific channel or group of channels that the content owner manages. Results are sorted by view count in descending order. Note that to run this query in the APIs Explorer, you must replace the string CHANNEL_ID in the filters parameter value with a comma-separated list of up to 500 channel IDs for your channels.

dimensions=video
metrics=views
filters=channel==CHANNEL_ID
maxResults=10
sort=-views

Top 10 – Annotation click-through rates for a channel's most viewed videos

This request retrieves view counts, annotation click-through rates, annotation close rates, and annotation impressions for the 10 most viewed videos in a specified channel or group of channels. Results are sorted by view count in descending order, which means that the most viewed video will be listed first. Note that to run this query in the APIs Explorer, you must replace the string CHANNEL_ID in the filters parameter value with a comma-separated list of up to 500 channel IDs for your channels.

dimensions=video
metrics=views,likes,annotationClickThroughRate,annotationCloseRate,annotationImpressions
filters=channel==CHANNEL_ID
maxResults=10
sort=-views

Playlist reports

Playlist views for a content owner's channels

This request retrieves total playlist starts, playlist estimated minutes watched, playlist views, and views per playlist start for playlists in the content owner's channels. The playlistViews metric counts only video views that occurred in the context of a playlist. Since all of the requested metrics are in-playlist metrics, the request does not also need to include the playlist or group filter.

metrics=playlistViews,playlistStarts,playlistEstimatedMinutesWatched,viewsPerPlaylistStart

Statistics for a specific playlist

This request retrieves total playlist starts, estimated minutes watched, views (an aggregated video metric ), playlist views (an in-playlist metric), and views per playlist start for a specific playlist. Note that to run this query in the APIs Explorer, you must replace the string PLAYLIST_ID in the filters parameter value with the playlist ID for a playlist in one of the content owner's channels.

metrics=views,estimatedMinutesWatched,playlistStarts,playlistViews,viewsPerPlaylistStart
filters=playlist==PLAYLIST_ID

To retrieve aggregate statistics for multiple playlists, you can also replace the string PLAYLIST_ID with a comma-separated list of up to 500 playlists IDs for playlists in the content owner's channels.

Time-based

Video reports

Daily watch time metrics for self-uploaded content

This query retrieves daily watch time metrics, as well as view counts, monetized playback counts, and impression counts for videos that the content owner uploaded. The report returns one row of data for each day in the requested date range, and rows are sorted in chronological order.

dimensions=day
metrics=estimatedMinutesWatched,averageViewPercentage,views,monetizedPlaybacks,adImpressions
filters=uploaderType==self
sort=day

Annotation metrics for claimed content

This request retrieves daily view counts, annotation click-through rates, annotation close rates, and annotation impressions for the content owner's claimed content. Results are sorted in chronological order.

dimensions=day
metrics=views,likes,annotationClickThroughRate,annotationCloseRate,annotationImpressions
filters=claimedStatus==claimed
sort=day

Playlist reports

Daily playlist views for a content owner

This request retrieves metrics for daily user interactions with videos in the content owner's playlists. The metrics retrieved in the report are playlistViews , playlistStarts , playlistEstimatedMinutesWatched , and viewsPerPlaylistStart . All of these metrics are in-playlist metrics. Since all of the requested metrics are in-playlist metrics, the request does not need to also include the playlist or group filter.

dimensions=day
metrics=playlistViews,playlistStarts,playlistEstimatedMinutesWatched,viewsPerPlaylistStart
sort=day

Географический

Video reports

Country-specific watch time metrics for self-uploaded content

This query retrieves view counts, watch time metrics, and estimated ad revenue for each country. The metrics are for videos that the content owner uploaded. The report returns one row of data for each country where the videos were watched, and rows are sorted in descending order of number of minutes watched.

dimensions=country
metrics=views,estimatedMinutesWatched,averageViewDuration,averageViewPercentage,estimatedRevenue,estimatedAdRevenue,grossRevenue
filters=uploaderType==self
sort=-estimatedMinutesWatched

Country-specific annotation metrics for self-uploaded content

This request retrieves country-specific view counts, annotation click-through rates, annotation close rates, and annotation impressions for the content owner's uploaded videos. Results are sorted by annotation click-through rate in descending order, which means that the country with the highest annotation click-through rate will be listed first.

dimensions=country
metrics=views,likes,annotationClickThroughRate,annotationCloseRate,annotationImpressions
filters=uploaderType==self
sort=-annotationClickThroughRate

Province-specific metrics for US states and Washington DC

This request retrieves a province-by-province breakdown of view counts, estimated minutes watched, and average view duration for the content owner's claimed videos. The data covers US states and Washington DC Results are sorted alphabetically by provinces' ISO 3166-2 codes .

dimensions=province
metrics=views,estimatedMinutesWatched,averageViewDuration
filters=claimedStatus==claimed;country==US
sort=province

Top 10 US cities by total views

This query retrieves a list of the 10 US cities that accounted for the most views of the content owner's claimed videos during the specified date range. The query could be modified to request data for another country by choosing another valid value for that filter. Similarly, the query could be modified to retrieve data for a subcontinent, such as Western Europe or Southeastern Asia, by using the subContinent filter and one of its valid values. Other filters are supported, too. Results are sorted by view count in descending order.

    dimensions=city
metrics=views
filters=claimedStatus==claimed;country==US
maxResults=10
sort=-views

Top 10 US cities by total views for each content type

This query retrieves a list of the 10 US cities that accounted for the most views of the content owner's claimed content during the specified date range for each supported creatorContentType . Results are sorted by view count in descending order.

    dimensions=city,creatorContentType
metrics=views
filters=claimedStatus==claimed;country==US
maxResults=10
sort=-views

Top 10 US cities by total watch time

This query retrieves a list of the top 10 days during the specified date range when any US city accounted for the greatest total daily watch time of the content owner's claimed content. The query results identify the total watch time, the date on which the watch time occurred, and the city where the content was estimated to have been viewed. Results are sorted in descending order of total watch time.

    dimensions=city,day
metrics=estimatedWatchTime
filters=claimedStatus==claimed;country==US
maxResults=10
sort=-estimatedWatchTime

Top 10 – Most watched videos in Europe

This query retrieves the 10 most watched videos in Europe, among videos claimed by the content owner, as measured by number of views during the specified date range. The query could be modified to request data for another continent by choosing another valid value for that filter. Similarly, the query could be modified to retrieve data for a subcontinent, such as Western Europe or Southeastern Asia, by using the subContinent filter and one of its valid values. Results are sorted by view count in descending order.

dimensions=video
metrics=views,estimatedMinutesWatched,likes,subscribersGained
filters=claimedStatus==claimed;filters=continent==150
maxResults=10
sort=-estimatedMinutesWatched

Playlist reports

Country-specific watch time metrics for a content owner's playlists

This query retrieves country-specific playlist view counts and playlist watch time metrics for all playlists in the content owner's channels. The report returns one row of data for each country where the playlists were watched. Rows are sorted in descending order of number of minutes watched.

dimensions=country
metrics=playlistViews,playlistEstimatedMinutesWatched,playlistStarts,averageTimeInPlaylist
sort=-playlistEstimatedMinutesWatched

Top 10 – Most started playlists in the United States

This query retrieves the 10 playlists from the content owner's channels that viewers in the United States started watching most frequently during the specified date range. Results are sorted by number of playlist starts in descending order.

Note: Since this report uses the playlist dimension, you must specify a value for the sort request parameter and also set th maxResults parameter to an integer value of 10 or less.

dimensions=playlist
metrics=playlistStarts,playlistViews,playlistEstimatedMinutesWatched,playlistAverageViewDuration
filters=country==US
maxResults=10
sort=-playlistStarts

Playback details

Video reports

Likes and dislikes by content type

This query retrieves the number of likes and dislikes for each type of content on a particular channel or group of channels. Note that to run this query in the APIs Explorer, you must replace the string CHANNEL_ID in the filters parameter value with a comma-separated list of up to 500 channel IDs for your channels.

dimensions=creatorContentType
metrics=likes,dislikes
filters=channel==CHANNEL_ID

Playback location

Video reports

Viewcounts and watch time from different playback locations

This query retrieves the number of views and estimated watch time for videos uploaded to a particular channel or group of channels. Results are aggregated based on the type of page or application where video playbacks occurred, and results are sorted in descending order by view count. Note that to run this query in the APIs Explorer, you must replace the string CHANNEL_ID in the filters parameter value with a comma-separated list of up to 500 channel IDs for your channels.

dimensions=insightPlaybackLocationType
metrics=estimatedMinutesWatched,views
filters=channel==CHANNEL_ID
sort=-views

Daily view counts and watch time from different playback locations

This query retrieves daily view counts and estimated watch time in the United States for videos uploaded to a particular channel or group of channels. Results are grouped by day for each type of page or application where video playbacks occurred. Results are sorted in reverse chronological order. Note that to run this query in the APIs Explorer, you must replace the string CHANNEL_ID in the filters parameter value with a comma-separated list of up to 500 channel IDs for your channels.

dimensions=day,insightPlaybackLocationType
metrics=estimatedMinutesWatched,views
filters=country==US;channel==CHANNEL_ID
sort=-day

Top 10 – Third-party sites that generate the most views for an embedded video

This query retrieves view counts and estimated watch time for a particular video or group of videos. Results are grouped by the third-party site where the video was embedded. Results are sorted in descending order by view count. Note that to run this query in the APIs Explorer, you must replace the string VIDEO_ID in the filters parameter value with a comma-separated list of up to 500 video IDs for your uploaded videos.

dimensions=insightPlaybackLocationDetail
metrics=views,estimatedMinutesWatched
filters=video==VIDEO_ID;insightPlaybackLocationType==EMBEDDED
maxResults=10
sort=-views

Playlist reports

Playlist view counts and watch time from different playback locations

This query retrieves the number of playlist views, playlist estimated watch time, and playlist starts for all playlists in a content owner's channels. Results are aggregated based on the type of page or application where video playbacks occurred, and results are sorted in descending order by playlist starts.

dimensions=insightPlaybackLocationType
metrics=playlistViews,playlistEstimatedMinutesWatched,playlistStarts
sort=-playlistStarts

Playlist view counts and watch time from different playback locations

This query retrieves daily playlist starts, playlist view counts, and playlist estimated watch time in the United States for all playlists in a content owner's channels. Results are returned for each type of page or application where playlist views occurred.

dimensions=day,insightPlaybackLocationType
metrics=playlistStarts,playlistViews,playlistEstimatedMinutesWatched
filters=country==US

Traffic source

Video reports

Viewcounts and watch time from different traffic sources

This request retrieves the number of views and estimated watch time for the content owner's videos. The metrics are aggregated by traffic source, which describes the manner in which users reached the video.

dimensions=insightTrafficSourceType
metrics=views,estimatedMinutesWatched
filters=uploaderType==self

Daily view counts and watch time from different traffic sources

This request retrieves daily view counts and daily estimated watch time for the content owner's videos. The metrics are aggregated on a daily basis by traffic source and sorted in reverse chronological order.

dimensions=day,insightTrafficSourceType
metrics=views,estimatedMinutesWatched
filters=uploaderType==self
sort=-day

Note: The next two sample reports are only supported for specific traffic sources. VIDEO_REMIXES , NOTIFICATION , END_SCREEN , CAMPAIGN_CARD , VIDEO_REMIXES , and NO_LINK_EMBEDDED traffic sources are some of the unsupported ones.

Top 10 – YouTube search terms that generate the most traffic for a video

This query retrieves the 10 search terms that generated the most views from YouTube search results for a specific video or group of videos. Results are sorted by view count in descending order. Note that to run this query in the APIs Explorer, you must replace the string VIDEO_ID in the filters parameter value with a comma-separated list of up to 500 video IDs for your uploaded videos.

dimensions=insightTrafficSourceDetail
metrics=views
filters=video==VIDEO_ID;insightTrafficSourceType==YT_SEARCH
maxResults=10
sort=-views

Top 10 – External websites that generate the most traffic for a video

This query retrieves the 10 external websites that generated the most views from Google search results for a specific video or group of videos. Results are sorted by estimated watch time in descending order. Note that to run this query in the APIs Explorer, you must replace the string VIDEO_ID in the filters parameter value with a comma-separated list of up to 500 video IDs for your uploaded videos.

dimensions=insightTrafficSourceDetail
metrics=estimatedMinutesWatched,views
filters=video==VIDEO_ID;insightTrafficSourceType==EXT_URL
maxResults=25
sort=-estimatedMinutesWatched

Playlist reports

Playlist view counts and watch time from different traffic sources in a country

This request retrieves the number of playlist views, playlist starts, and playlist estimated watch time for playlist views in a specified country. The metrics are aggregated by traffic source, which describes the manner in which users reached the playlist.

dimensions=insightTrafficSourceType
metrics=playlistViews,playlistStarts,playlistEstimatedMinutesWatched
filters=country==US

Playlist view counts and watch time from different traffic sources

This request retrieves playlist views, playlist starts, and playlist estimated watch time for playlists in one or more of a content owner's channels. The metrics are aggregated by traffic source. Note that to run this query in the APIs Explorer, you must replace the string CHANNEL_ID in the filters parameter value with a comma-separated list of up to 500 channel IDs for your channels.

dimensions=day,insightTrafficSourceType
metrics=playlistViews,playlistStarts,playlistEstimatedMinutesWatched
filters=channel==CHANNEL_ID

Device/OS

Video reports

Daily device type metrics for claimed videos

This query retrieves daily view counts and estimated watch time by device type for videos claimed by a particular content owner. Results are grouped by day for each type of device where video playbacks occurred. Results are sorted in chronological order.

dimensions=day,deviceType
metrics=estimatedMinutesWatched,views
filters=claimedStatus==claimed
sort=day

Daily operating system metrics for claimed videos viewed on mobile devices

This query retrieves daily view counts and estimated watch time by operating system for views of videos claimed by a specified content owner that took place on mobile devices. Results are grouped by day for each operating system where video playbacks occurred. Results are sorted in chronological order.

dimensions=day,operatingSystem
metrics=estimatedMinutesWatched,views
filters=claimedStatus==claimed;deviceType==MOBILE
sort=day

Daily operating system and device type metrics

This query retrieves daily view counts and estimated watch time for videos claimed by a particular content owner. Statistics are grouped by operating system and device type. Results are sorted in chronological order.

dimensions=day,operatingSystem,deviceType
metrics=estimatedMinutesWatched,views
sort=day

Playlist reports

Device type metrics for playlist views on the Android operating system

This query retrieves playlist view counts and playlist estimated watch time on Android devices for playlists in one or more of a content owner's channels. Results are returned for each type of device where playlist views occurred. Note that to run this query in the APIs Explorer, you must replace the string CHANNEL_ID in the filters parameter value with a comma-separated list of up to 500 channel IDs for your channels.

dimensions=deviceType
metrics=playlistViews,playlistEstimatedMinutesWatched
filters=channel==CHANNEL_ID;operatingSystem==ANDROID

Operating system metrics for playlist views on mobile devices

This query retrieves playlist view counts and playlist estimated watch time on mobile devices for playlists in any of a content owner's channels. Results are returned for each operating system on which playlist views occurred.

dimensions=operatingSystem
metrics=views,estimatedMinutesWatched
filters=deviceType==MOBILE

Демографический

Video reports

Viewer demographics in California (age group and gender)

This report retrieves statistics about the age group and gender of viewers in California who watched the content owner's claimed content. Results are sorted by gender and then by age group. This query could be modified to retrieve the same statistics for all viewers worldwide or all viewers in a country, continent, subcontinent, or another US state by adjusting the filters parameter value.

dimensions=ageGroup,gender
metrics=viewerPercentage
filters=claimedStatus==claimed;province==US-CA
sort=gender,ageGroup

Социальный

Sharing metrics, aggregated by service where videos were shared

This request retrieves the number of times that users used the Share button to share videos that the content owner uploaded. Results are aggregated by sharing service (Google+, Twitter, etc.) and sorted in descending order of number of shares.

dimensions=sharingService
metrics=shares
filters=uploaderType==self
sort=-shares

Audience retention

Audience retention metrics for a video

This report measures a video's ability to retain its audience. The report can only be retrieved for a single video at a time. Note that to run this query in the APIs Explorer, you must replace the string VIDEO_ID in the filters parameter value with the video ID for one of your uploaded videos. Note that audience retention reports do not support the ability to specify multiple values for the video filter.

In this example, the report uses the audienceType filter to restrict the response so that it only contains data for organic views, which are the result of a direct user action, such as a search for a video or a click on a suggested video. As such, the report does not include data for views from TrueView in-stream or TrueView in-display ads. You can remove the filter to retrieve the video's audience retention data from all audience types.

Note that data for the audienceType filter is available as of September 25, 2013. The API will not return data for queries that use the filter to try to retrieve data from earlier dates. Queries that do not use the filter work for any date after July 1, 2008.

dimensions=elapsedVideoTimeRatio
metrics=audienceWatchRatio,relativeRetentionPerformance
filters=video==VIDEO_ID;audienceType==ORGANIC

Revenue/Ads

Revenue and ad performance metrics for claimed content

This request retrieves revenue and ad performance metrics for the content owner's claimed content. The report returns a single row of data that contains totals for each requested metric during the specified date range.

metrics=views,estimatedRevenue,estimatedAdRevenue,estimatedRedPartnerRevenue,grossRevenue,adImpressions,cpm,playbackBasedCpm,monetizedPlaybacks
filters=claimedStatus==claimed

Daily revenue and ad performance metrics

This request retrieves daily revenue and ad performance metrics for the content owner's claimed content.

dimensions=day
metrics=views,estimatedRevenue,estimatedAdRevenue,estimatedRedPartnerRevenue,grossRevenue,adImpressions,cpm,playbackBasedCpm,monetizedPlaybacks
filters=claimedStatus==claimed

Country-specific revenue and ad performance metrics

This request retrieves country-specific revenue and ad performance metrics for the content owner's claimed content. Results are sorted in descending order by revenue amount, which means that the first country listed will be the one where the partner had the greatest estimated revenue.

dimensions=country
metrics=views,estimatedRevenue,estimatedAdRevenue,estimatedRedPartnerRevenue,grossRevenue,adImpressions,cpm,playbackBasedCpm,monetizedPlaybacks
filters=claimedStatus==claimed
sort=-estimatedRevenue

Top 10 – Videos with the highest revenue

This request retrieves revenue and ad performance metrics for the 10 videos that where claimed by the content owner claimed and that had the highest revenue. Results are sorted in descending order by revenue amount, which means that the first video will be the one that had the highest estimated revenue.

dimensions=video
metrics=views,estimatedRevenue,estimatedAdRevenue,estimatedRedPartnerRevenue,grossRevenue,adImpressions,cpm,playbackBasedCpm,monetizedPlaybacks
filters=claimedStatus==claimed
maxResults=10
sort=-estimatedRevenue

Ad performance metrics for different ad types

This request retrieves ad performance metrics for the content owner's claimed content. Results are grouped by ad type, which enables you to compare revenue and CPM values across different ad types.

dimensions=adType
metrics=grossRevenue,adImpressions,cpm
filters=claimedStatus==claimed
sort=-adType