Sample API Requests | YouTube Analytics and Reporting APIs

<!doctype html> <html lang="en" dir="ltr"> <head> <meta name="google-signin-client-id" content="721724668570-nbkv1cfusk7kk4eni4pjvepaus73b13t.apps.googleusercontent.com"> <meta name="google-signin-scope" content="profile email https://www.googleapis.com/auth/developerprofiles https://www.googleapis.com/auth/developerprofiles.award"> <meta property="og:site_name" content="Google for Developers"> <meta property="og:type" content="website"><meta name="theme-color" content="#ff0000"><meta charset="utf-8"> <meta content="IE=Edge" http-equiv="X-UA-Compatible"> <meta name="viewport" content="width=device-width, initial-scale=1"> <link rel="manifest" href="/_pwa/developers/manifest.json" crossorigin="use-credentials"> <link rel="preconnect" href="//www.gstatic.com" crossorigin> <link rel="preconnect" href="//fonts.gstatic.com" crossorigin> <link rel="preconnect" href="//fonts.googleapis.com" crossorigin> <link rel="preconnect" href="//apis.google.com" crossorigin> <link rel="preconnect" href="//www.google-analytics.com" crossorigin><link rel="stylesheet" href="//fonts.googleapis.com/css?family=Google+Sans:400,500|Roboto:400,400italic,500,500italic,700,700italic|Roboto+Mono:400,500,700&display=swap"> <link rel="stylesheet" href="//fonts.googleapis.com/css2?family=Material+Icons&family=Material+Symbols+Outlined&display=block"><link rel="stylesheet" href="https://www.gstatic.com/devrel-devsite/prod/v870e399c64f7c43c99a3043db4b3a74327bb93d0914e84a0c3dba90bbfd67625/developers/css/app.css"> <link rel="shortcut icon" href="https://www.gstatic.com/devrel-devsite/prod/v870e399c64f7c43c99a3043db4b3a74327bb93d0914e84a0c3dba90bbfd67625/developers/images/favicon-new.png"> <link rel="apple-touch-icon" href="https://www.gstatic.com/devrel-devsite/prod/v870e399c64f7c43c99a3043db4b3a74327bb93d0914e84a0c3dba90bbfd67625/developers/images/touchicon-180-new.png"><link rel="canonical" href="https://developers.google.com/youtube/analytics/sample-requests"><link rel="search" type="application/opensearchdescription+xml" title="Google for Developers" href="https://developers.google.com/s/opensearch.xml"> <link rel="alternate" hreflang="en" href="https://developers.google.com/youtube/analytics/sample-requests" /><link rel="alternate" hreflang="x-default" href="https://developers.google.com/youtube/analytics/sample-requests" /><link rel="alternate" hreflang="ar" href="https://developers.google.com/youtube/analytics/sample-requests?hl=ar" /><link rel="alternate" hreflang="bn" href="https://developers.google.com/youtube/analytics/sample-requests?hl=bn" /><link rel="alternate" hreflang="zh-Hans" href="https://developers.google.com/youtube/analytics/sample-requests?hl=zh-cn" /><link rel="alternate" hreflang="zh-Hant" href="https://developers.google.com/youtube/analytics/sample-requests?hl=zh-tw" /><link rel="alternate" hreflang="fa" href="https://developers.google.com/youtube/analytics/sample-requests?hl=fa" /><link rel="alternate" hreflang="fr" href="https://developers.google.com/youtube/analytics/sample-requests?hl=fr" /><link rel="alternate" hreflang="de" href="https://developers.google.com/youtube/analytics/sample-requests?hl=de" /><link rel="alternate" hreflang="he" href="https://developers.google.com/youtube/analytics/sample-requests?hl=he" /><link rel="alternate" hreflang="hi" href="https://developers.google.com/youtube/analytics/sample-requests?hl=hi" /><link rel="alternate" hreflang="id" href="https://developers.google.com/youtube/analytics/sample-requests?hl=id" /><link rel="alternate" hreflang="it" href="https://developers.google.com/youtube/analytics/sample-requests?hl=it" /><link rel="alternate" hreflang="ja" href="https://developers.google.com/youtube/analytics/sample-requests?hl=ja" /><link rel="alternate" hreflang="ko" href="https://developers.google.com/youtube/analytics/sample-requests?hl=ko" /><link rel="alternate" hreflang="pl" href="https://developers.google.com/youtube/analytics/sample-requests?hl=pl" /><link rel="alternate" hreflang="pt-BR" href="https://developers.google.com/youtube/analytics/sample-requests?hl=pt-br" /><link rel="alternate" hreflang="ru" href="https://developers.google.com/youtube/analytics/sample-requests?hl=ru" /><link rel="alternate" hreflang="es-419" href="https://developers.google.com/youtube/analytics/sample-requests?hl=es-419" /><link rel="alternate" hreflang="th" href="https://developers.google.com/youtube/analytics/sample-requests?hl=th" /><link rel="alternate" hreflang="tr" href="https://developers.google.com/youtube/analytics/sample-requests?hl=tr" /><link rel="alternate" hreflang="vi" href="https://developers.google.com/youtube/analytics/sample-requests?hl=vi" /><title>Sample API Requests  |  YouTube Analytics and Reporting APIs  |  Google for Developers</title> <meta property="og:title" content="Sample API Requests  |  YouTube Analytics and Reporting APIs  |  Google for Developers"><meta name="description" content="Get samples for channel and owner reports covering basic stats, time-based, geographic, playback details, playback location, traffic source, and more."> <meta property="og:description" content="Get samples for channel and owner reports covering basic stats, time-based, geographic, playback details, playback location, traffic source, and more."><meta property="og:url" content="https://developers.google.com/youtube/analytics/sample-requests"><meta property="og:image" content="https://www.gstatic.com/devrel-devsite/prod/v870e399c64f7c43c99a3043db4b3a74327bb93d0914e84a0c3dba90bbfd67625/developers/images/opengraph/youtube-theme.png"> <meta property="og:image:width" content="1200"> <meta property="og:image:height" content="675"><meta property="og:locale" content="en"><meta name="twitter:card" content="summary_large_image"><script type="application/ld+json"> { "@context": "https://schema.org", "@type": "Article", "headline": "Sample API Requests" } </script><script type="application/ld+json"> { "@context": "https://schema.org", "@type": "BreadcrumbList", "itemListElement": [{ "@type": "ListItem", "position": 1, "name": "YouTube", "item": "https://developers.google.com/youtube" },{ "@type": "ListItem", "position": 2, "name": "Analytics and Reporting APIs", "item": "https://developers.google.com/youtube/analytics" },{ "@type": "ListItem", "position": 3, "name": "Sample API Requests", "item": "https://developers.google.com/youtube/analytics/sample-requests" }] } </script> <link rel="stylesheet" href="/extras.css"></head> <body class="" template="page" theme="youtube-theme" type="article" layout="docs" concierge='closed' display-toc pending> <devsite-progress type="indeterminate" id="app-progress"></devsite-progress> <section class="devsite-wrapper"> <devsite-cookie-notification-bar></devsite-cookie-notification-bar><devsite-header role="banner"> <div class="devsite-header--inner nocontent"> <div class="devsite-top-logo-row-wrapper-wrapper"> <div class="devsite-top-logo-row-wrapper"> <div class="devsite-top-logo-row"> <button type="button" id="devsite-hamburger-menu" class="devsite-header-icon-button button-flat material-icons gc-analytics-event" data-category="Site-Wide Custom Events" data-label="Navigation menu button" visually-hidden aria-label="Open menu"> </button> <div class="devsite-product-name-wrapper"> <a href="https://developers.google.com/youtube"> <div class="devsite-product-logo-container" size="medium" > <picture> <img class="devsite-product-logo" alt="YouTube" src="https://developers.google.com/static/site-assets/logo-youtube.svg" srcset=" /static/site-assets/logo-youtube.svg" sizes="64px" loading="lazy" > </picture> </div> </a> <span class="devsite-product-name"> <ul class="devsite-breadcrumb-list" aria-label="Product breadcrumb"> <li class="devsite-breadcrumb-item "> <a href="https://developers.google.com/youtube" class="devsite-breadcrumb-link gc-analytics-event" data-category="Site-Wide Custom Events" data-label="Upper Header" data-value="1" track-type="globalNav" track-name="breadcrumb" track-metadata-position="1" track-metadata-eventdetail="YouTube" > YouTube </a> </li> <li class="devsite-breadcrumb-item "> <div class="devsite-breadcrumb-guillemet material-icons" aria-hidden="true"></div> <a href="https://developers.google.com/youtube/analytics" class="devsite-breadcrumb-link gc-analytics-event" data-category="Site-Wide Custom Events" data-label="Upper Header" data-value="2" track-type="globalNav" track-name="breadcrumb" track-metadata-position="2" track-metadata-eventdetail="YouTube Analytics and Reporting APIs" > Analytics and Reporting APIs </a> </li> </ul> </span> </div> <div class="devsite-top-logo-row-middle"> <div class="devsite-header-upper-tabs"> </div> <devsite-search enable-signin enable-search enable-suggestions enable-query-completion project-name="YouTube Analytics and Reporting APIs" tenant-name="Google for Developers" project-scope="/youtube/analytics" url-scoped="https://developers.google.com/s/results/youtube/analytics" > <form class="devsite-search-form" action="https://developers.google.com/s/results" method="GET"> <div class="devsite-search-container"> <button type="button" search-open class="devsite-search-button devsite-header-icon-button button-flat material-icons" aria-label="Open search"></button> <div class="devsite-searchbox"> <input aria-activedescendant="" aria-autocomplete="list" aria-label="Search" aria-expanded="false" aria-haspopup="listbox" autocomplete="off" class="devsite-search-field devsite-search-query" name="q" placeholder="Search" role="combobox" type="text" value="" > <div class="devsite-search-image material-icons" aria-hidden="true"> </div> <div class="devsite-search-shortcut-icon-container" aria-hidden="true"> <kbd class="devsite-search-shortcut-icon">/</kbd> </div> </div> </div> </form> <button type="button" search-close class="devsite-search-button devsite-header-icon-button button-flat material-icons" aria-label="Close search"></button> </devsite-search> </div> <devsite-language-selector> <ul role="presentation"> <li role="presentation"> <a role="menuitem" lang="en" >English</a> </li> <li role="presentation"> <a role="menuitem" lang="de" >Deutsch</a> </li> <li role="presentation"> <a role="menuitem" lang="es" >Español</a> </li> <li role="presentation"> <a role="menuitem" lang="es_419" >Español – América Latina</a> </li> <li role="presentation"> <a role="menuitem" lang="fr" >Français</a> </li> <li role="presentation"> <a role="menuitem" lang="id" >Indonesia</a> </li> <li role="presentation"> <a role="menuitem" lang="it" >Italiano</a> </li> <li role="presentation"> <a role="menuitem" lang="pl" >Polski</a> </li> <li role="presentation"> <a role="menuitem" lang="pt_br" >Português – Brasil</a> </li> <li role="presentation"> <a role="menuitem" lang="vi" >Tiếng Việt</a> </li> <li role="presentation"> <a role="menuitem" lang="tr" >Türkçe</a> </li> <li role="presentation"> <a role="menuitem" lang="ru" >Русский</a> </li> <li role="presentation"> <a role="menuitem" lang="he" >עברית</a> </li> <li role="presentation"> <a role="menuitem" lang="ar" >العربيّة</a> </li> <li role="presentation"> <a role="menuitem" lang="fa" >فارسی</a> </li> <li role="presentation"> <a role="menuitem" lang="hi" >हिंदी</a> </li> <li role="presentation"> <a role="menuitem" lang="bn" >বাংলা</a> </li> <li role="presentation"> <a role="menuitem" lang="th" >ภาษาไทย</a> </li> <li role="presentation"> <a role="menuitem" lang="zh_cn" >中文 – 简体</a> </li> <li role="presentation"> <a role="menuitem" lang="zh_tw" >中文 – 繁體</a> </li> <li role="presentation"> <a role="menuitem" lang="ja" >日本語</a> </li> <li role="presentation"> <a role="menuitem" lang="ko" >한국어</a> </li> </ul> </devsite-language-selector> <devsite-user enable-profiles fp-auth id="devsite-user"> <span class="button devsite-top-button" aria-hidden="true" visually-hidden>Sign in</span> </devsite-user> </div> </div> </div> <div class="devsite-collapsible-section "> <div class="devsite-header-background"> <div class="devsite-doc-set-nav-row"> <devsite-tabs class="lower-tabs"> <nav class="devsite-tabs-wrapper" aria-label="Lower tabs"> <tab > <a href="https://developers.google.com/youtube/analytics" track-metadata-eventdetail="https://developers.google.com/youtube/analytics" class="devsite-tabs-content gc-analytics-event " track-type="nav" track-metadata-position="nav - home" track-metadata-module="primary nav" data-category="Site-Wide Custom Events" data-label="Tab: Home" track-name="home" > Home </a> </tab> <tab > <a href="https://developers.google.com/youtube/reporting" track-metadata-eventdetail="https://developers.google.com/youtube/reporting" class="devsite-tabs-content gc-analytics-event " track-type="nav" track-metadata-position="nav - overview" track-metadata-module="primary nav" data-category="Site-Wide Custom Events" data-label="Tab: Overview" track-name="overview" > Overview </a> </tab> <tab > <a href="https://developers.google.com/youtube/reporting/guides/authorization" track-metadata-eventdetail="https://developers.google.com/youtube/reporting/guides/authorization" class="devsite-tabs-content gc-analytics-event " track-type="nav" track-metadata-position="nav - authorization" track-metadata-module="primary nav" data-category="Site-Wide Custom Events" data-label="Tab: Authorization" track-name="authorization" > Authorization </a> </tab> <tab > <a href="https://developers.google.com/youtube/reporting/v1/reports" track-metadata-eventdetail="https://developers.google.com/youtube/reporting/v1/reports" class="devsite-tabs-content gc-analytics-event " track-type="nav" track-metadata-position="nav - bulk reports" track-metadata-module="primary nav" data-category="Site-Wide Custom Events" data-label="Tab: Bulk Reports" track-name="bulk reports" > Bulk Reports </a> </tab> <tab class="devsite-active"> <a href="https://developers.google.com/youtube/analytics/data_model" track-metadata-eventdetail="https://developers.google.com/youtube/analytics/data_model" class="devsite-tabs-content gc-analytics-event " track-type="nav" track-metadata-position="nav - targeted queries" track-metadata-module="primary nav" aria-label="Targeted Queries, selected" data-category="Site-Wide Custom Events" data-label="Tab: Targeted Queries" track-name="targeted queries" > Targeted Queries </a> </tab> <tab > <a href="https://developers.google.com/youtube/reporting/v1/code_samples" track-metadata-eventdetail="https://developers.google.com/youtube/reporting/v1/code_samples" class="devsite-tabs-content gc-analytics-event " track-type="nav" track-metadata-position="nav - resources" track-metadata-module="primary nav" data-category="Site-Wide Custom Events" data-label="Tab: Resources" track-name="resources" > Resources </a> </tab> </nav> </devsite-tabs> </div> </div> </div> </div> </devsite-header> <devsite-book-nav scrollbars > <div class="devsite-book-nav-filter" > <span class="filter-list-icon material-icons" aria-hidden="true"></span> <input type="text" placeholder="Filter" aria-label="Type to filter" role="searchbox"> <span class="filter-clear-button hidden" data-title="Clear filter" aria-label="Clear filter" role="button" tabindex="0"></span> </div> <nav class="devsite-book-nav devsite-nav nocontent" aria-label="Side menu"> <div class="devsite-mobile-header"> <button type="button" id="devsite-close-nav" class="devsite-header-icon-button button-flat material-icons gc-analytics-event" data-category="Site-Wide Custom Events" data-label="Close navigation" aria-label="Close navigation"> </button> <div class="devsite-product-name-wrapper"> <a href="https://developers.google.com/youtube"> <div class="devsite-product-logo-container" size="medium" > <picture> <img class="devsite-product-logo" alt="YouTube" src="https://developers.google.com/static/site-assets/logo-youtube.svg" srcset=" /static/site-assets/logo-youtube.svg" sizes="64px" loading="lazy" > </picture> </div> </a> <span class="devsite-product-name"> <ul class="devsite-breadcrumb-list" aria-label="Upper header breadcrumb"> <li class="devsite-breadcrumb-item "> <a href="https://developers.google.com/youtube" class="devsite-breadcrumb-link gc-analytics-event" data-category="Site-Wide Custom Events" data-label="Upper Header" data-value="1" track-type="globalNav" track-name="breadcrumb" track-metadata-position="1" track-metadata-eventdetail="YouTube" > YouTube </a> </li> <li class="devsite-breadcrumb-item "> <div class="devsite-breadcrumb-guillemet material-icons" aria-hidden="true"></div> <a href="https://developers.google.com/youtube/analytics" class="devsite-breadcrumb-link gc-analytics-event" data-category="Site-Wide Custom Events" data-label="Upper Header" data-value="2" track-type="globalNav" track-name="breadcrumb" track-metadata-position="2" track-metadata-eventdetail="YouTube Analytics and Reporting APIs" > Analytics and Reporting APIs </a> </li> </ul> </span> </div> </div> <div class="devsite-book-nav-wrapper"> <div class="devsite-mobile-nav-top"> <ul class="devsite-nav-list"> <li class="devsite-nav-item"> <a href="/youtube/analytics" class="devsite-nav-title gc-analytics-event " data-category="Site-Wide Custom Events" data-label="Tab: Home" track-name="home" data-category="Site-Wide Custom Events" data-label="Responsive Tab: Home" track-type="navMenu" track-metadata-eventDetail="globalMenu" track-metadata-position="nav"> <span class="devsite-nav-text" tooltip > Home </span> </a> </li> <li class="devsite-nav-item"> <a href="/youtube/reporting" class="devsite-nav-title gc-analytics-event " data-category="Site-Wide Custom Events" data-label="Tab: Overview" track-name="overview" data-category="Site-Wide Custom Events" data-label="Responsive Tab: Overview" track-type="navMenu" track-metadata-eventDetail="globalMenu" track-metadata-position="nav"> <span class="devsite-nav-text" tooltip > Overview </span> </a> </li> <li class="devsite-nav-item"> <a href="/youtube/reporting/guides/authorization" class="devsite-nav-title gc-analytics-event devsite-nav-has-children " data-category="Site-Wide Custom Events" data-label="Tab: Authorization" track-name="authorization" data-category="Site-Wide Custom Events" data-label="Responsive Tab: Authorization" track-type="navMenu" track-metadata-eventDetail="globalMenu" track-metadata-position="nav"> <span class="devsite-nav-text" tooltip > Authorization </span> <span class="devsite-nav-icon material-icons" data-icon="forward" > </span> </a> </li> <li class="devsite-nav-item"> <a href="/youtube/reporting/v1/reports" class="devsite-nav-title gc-analytics-event devsite-nav-has-children " data-category="Site-Wide Custom Events" data-label="Tab: Bulk Reports" track-name="bulk reports" data-category="Site-Wide Custom Events" data-label="Responsive Tab: Bulk Reports" track-type="navMenu" track-metadata-eventDetail="globalMenu" track-metadata-position="nav"> <span class="devsite-nav-text" tooltip > Bulk Reports </span> <span class="devsite-nav-icon material-icons" data-icon="forward" > </span> </a> </li> <li class="devsite-nav-item"> <a href="/youtube/analytics/data_model" class="devsite-nav-title gc-analytics-event devsite-nav-has-children devsite-nav-active" data-category="Site-Wide Custom Events" data-label="Tab: Targeted Queries" track-name="targeted queries" data-category="Site-Wide Custom Events" data-label="Responsive Tab: Targeted Queries" track-type="navMenu" track-metadata-eventDetail="globalMenu" track-metadata-position="nav"> <span class="devsite-nav-text" tooltip > Targeted Queries </span> <span class="devsite-nav-icon material-icons" data-icon="forward" > </span> </a> </li> <li class="devsite-nav-item"> <a href="/youtube/reporting/v1/code_samples" class="devsite-nav-title gc-analytics-event devsite-nav-has-children " data-category="Site-Wide Custom Events" data-label="Tab: Resources" track-name="resources" data-category="Site-Wide Custom Events" data-label="Responsive Tab: Resources" track-type="navMenu" track-metadata-eventDetail="globalMenu" track-metadata-position="nav"> <span class="devsite-nav-text" tooltip > Resources </span> <span class="devsite-nav-icon material-icons" data-icon="forward" > </span> </a> </li> </ul> </div> <div class="devsite-mobile-nav-bottom"> <ul class="devsite-nav-list" menu="_book"> <li class="devsite-nav-item devsite-nav-heading"><div class="devsite-nav-title devsite-nav-title-no-path"> <span class="devsite-nav-text" tooltip>YouTube Analytics API</span> </div></li> <li class="devsite-nav-item devsite-nav-heading"><div class="devsite-nav-title devsite-nav-title-no-path"> <span class="devsite-nav-text" tooltip>Data Model</span> </div></li> <li class="devsite-nav-item"><a href="/youtube/analytics/data_model" class="devsite-nav-title gc-analytics-event" data-category="Site-Wide Custom Events" data-label="Book nav link, pathname: /youtube/analytics/data_model" track-type="bookNav" track-name="click" track-metadata-eventdetail="/youtube/analytics/data_model" ><span class="devsite-nav-text" tooltip>Overview</span></a></li> <li class="devsite-nav-item"><a href="/youtube/analytics/dimensions" class="devsite-nav-title gc-analytics-event" data-category="Site-Wide Custom Events" data-label="Book nav link, pathname: /youtube/analytics/dimensions" track-type="bookNav" track-name="click" track-metadata-eventdetail="/youtube/analytics/dimensions" ><span class="devsite-nav-text" tooltip>Dimensions</span></a></li> <li class="devsite-nav-item"><a href="/youtube/analytics/metrics" class="devsite-nav-title gc-analytics-event" data-category="Site-Wide Custom Events" data-label="Book nav link, pathname: /youtube/analytics/metrics" track-type="bookNav" track-name="click" track-metadata-eventdetail="/youtube/analytics/metrics" ><span class="devsite-nav-text" tooltip>Metrics</span></a></li> <li class="devsite-nav-item"><a href="/youtube/analytics/channel_reports" class="devsite-nav-title gc-analytics-event" data-category="Site-Wide Custom Events" data-label="Book nav link, pathname: /youtube/analytics/channel_reports" track-type="bookNav" track-name="click" track-metadata-eventdetail="/youtube/analytics/channel_reports" ><span class="devsite-nav-text" tooltip>Channel Reports</span></a></li> <li class="devsite-nav-item"><a href="/youtube/analytics/content_owner_reports" class="devsite-nav-title gc-analytics-event" data-category="Site-Wide Custom Events" data-label="Book nav link, pathname: /youtube/analytics/content_owner_reports" track-type="bookNav" track-name="click" track-metadata-eventdetail="/youtube/analytics/content_owner_reports" ><span class="devsite-nav-text" tooltip>Content Owner Reports</span></a></li> <li class="devsite-nav-item devsite-nav-heading"><div class="devsite-nav-title devsite-nav-title-no-path"> <span class="devsite-nav-text" tooltip>Guides</span> </div></li> <li class="devsite-nav-item"><a href="/youtube/analytics/sample-requests" class="devsite-nav-title gc-analytics-event" data-category="Site-Wide Custom Events" data-label="Book nav link, pathname: /youtube/analytics/sample-requests" track-type="bookNav" track-name="click" track-metadata-eventdetail="/youtube/analytics/sample-requests" ><span class="devsite-nav-text" tooltip>Sample requests</span></a></li> <li class="devsite-nav-item devsite-nav-heading"><div class="devsite-nav-title devsite-nav-title-no-path"> <span class="devsite-nav-text" tooltip>API Reference</span> </div></li> <li class="devsite-nav-item"><a href="/youtube/analytics/reference" class="devsite-nav-title gc-analytics-event" data-category="Site-Wide Custom Events" data-label="Book nav link, pathname: /youtube/analytics/reference" track-type="bookNav" track-name="click" track-metadata-eventdetail="/youtube/analytics/reference" ><span class="devsite-nav-text" tooltip>Overview</span></a></li> <li class="devsite-nav-item"><a href="/youtube/analytics/reference/reports/query" class="devsite-nav-title gc-analytics-event" data-category="Site-Wide Custom Events" data-label="Book nav link, pathname: /youtube/analytics/reference/reports/query" track-type="bookNav" track-name="click" track-metadata-eventdetail="/youtube/analytics/reference/reports/query" ><span class="devsite-nav-text" tooltip>reports.query</span></a></li> <li class="devsite-nav-item devsite-nav-expandable"><div class="devsite-expandable-nav"> <a class="devsite-nav-toggle" aria-hidden="true"></a><div class="devsite-nav-title devsite-nav-title-no-path" tabindex="0" role="button"> <span class="devsite-nav-text" tooltip>Groups</span> </div><ul class="devsite-nav-section"><li class="devsite-nav-item"><a href="/youtube/analytics/reference/groups" class="devsite-nav-title gc-analytics-event" data-category="Site-Wide Custom Events" data-label="Book nav link, pathname: /youtube/analytics/reference/groups" track-type="bookNav" track-name="click" track-metadata-eventdetail="/youtube/analytics/reference/groups" ><span class="devsite-nav-text" tooltip>Overview</span></a></li><li class="devsite-nav-item"><a href="/youtube/analytics/reference/groups/list" class="devsite-nav-title gc-analytics-event" data-category="Site-Wide Custom Events" data-label="Book nav link, pathname: /youtube/analytics/reference/groups/list" track-type="bookNav" track-name="click" track-metadata-eventdetail="/youtube/analytics/reference/groups/list" ><span class="devsite-nav-text" tooltip>list</span></a></li><li class="devsite-nav-item"><a href="/youtube/analytics/reference/groups/insert" class="devsite-nav-title gc-analytics-event" data-category="Site-Wide Custom Events" data-label="Book nav link, pathname: /youtube/analytics/reference/groups/insert" track-type="bookNav" track-name="click" track-metadata-eventdetail="/youtube/analytics/reference/groups/insert" ><span class="devsite-nav-text" tooltip>insert</span></a></li><li class="devsite-nav-item"><a href="/youtube/analytics/reference/groups/update" class="devsite-nav-title gc-analytics-event" data-category="Site-Wide Custom Events" data-label="Book nav link, pathname: /youtube/analytics/reference/groups/update" track-type="bookNav" track-name="click" track-metadata-eventdetail="/youtube/analytics/reference/groups/update" ><span class="devsite-nav-text" tooltip>update</span></a></li><li class="devsite-nav-item"><a href="/youtube/analytics/reference/groups/delete" class="devsite-nav-title gc-analytics-event" data-category="Site-Wide Custom Events" data-label="Book nav link, pathname: /youtube/analytics/reference/groups/delete" track-type="bookNav" track-name="click" track-metadata-eventdetail="/youtube/analytics/reference/groups/delete" ><span class="devsite-nav-text" tooltip>delete</span></a></li></ul></div></li> <li class="devsite-nav-item devsite-nav-expandable"><div class="devsite-expandable-nav"> <a class="devsite-nav-toggle" aria-hidden="true"></a><div class="devsite-nav-title devsite-nav-title-no-path" tabindex="0" role="button"> <span class="devsite-nav-text" tooltip>GroupItems</span> </div><ul class="devsite-nav-section"><li class="devsite-nav-item"><a href="/youtube/analytics/reference/groupItems" class="devsite-nav-title gc-analytics-event" data-category="Site-Wide Custom Events" data-label="Book nav link, pathname: /youtube/analytics/reference/groupItems" track-type="bookNav" track-name="click" track-metadata-eventdetail="/youtube/analytics/reference/groupItems" ><span class="devsite-nav-text" tooltip>Overview</span></a></li><li class="devsite-nav-item"><a href="/youtube/analytics/reference/groupItems/list" class="devsite-nav-title gc-analytics-event" data-category="Site-Wide Custom Events" data-label="Book nav link, pathname: /youtube/analytics/reference/groupItems/list" track-type="bookNav" track-name="click" track-metadata-eventdetail="/youtube/analytics/reference/groupItems/list" ><span class="devsite-nav-text" tooltip>list</span></a></li><li class="devsite-nav-item"><a href="/youtube/analytics/reference/groupItems/insert" class="devsite-nav-title gc-analytics-event" data-category="Site-Wide Custom Events" data-label="Book nav link, pathname: /youtube/analytics/reference/groupItems/insert" track-type="bookNav" track-name="click" track-metadata-eventdetail="/youtube/analytics/reference/groupItems/insert" ><span class="devsite-nav-text" tooltip>insert</span></a></li><li class="devsite-nav-item"><a href="/youtube/analytics/reference/groupItems/delete" class="devsite-nav-title gc-analytics-event" data-category="Site-Wide Custom Events" data-label="Book nav link, pathname: /youtube/analytics/reference/groupItems/delete" track-type="bookNav" track-name="click" track-metadata-eventdetail="/youtube/analytics/reference/groupItems/delete" ><span class="devsite-nav-text" tooltip>delete</span></a></li></ul></div></li> <li class="devsite-nav-item devsite-nav-break"></li> <li class="devsite-nav-item"><a href="/youtube/analytics/revision_history" class="devsite-nav-title gc-analytics-event" data-category="Site-Wide Custom Events" data-label="Book nav link, pathname: /youtube/analytics/revision_history" track-type="bookNav" track-name="click" track-metadata-eventdetail="/youtube/analytics/revision_history" ><span class="devsite-nav-text" tooltip>Revision History</span></a></li> </ul> </div> </div> </nav> </devsite-book-nav> <section id="gc-wrapper"> <main role="main" class="devsite-main-content" has-book-nav > <devsite-content> <article class="devsite-article"><style> pre.query a { color: #007000; text-decoration: none; } </style> <div class="devsite-article-meta nocontent" role="navigation"> <ul class="devsite-breadcrumb-list" aria-label="Breadcrumb"> <li class="devsite-breadcrumb-item "> <a href="https://developers.google.com/" class="devsite-breadcrumb-link gc-analytics-event" data-category="Site-Wide Custom Events" data-label="Breadcrumbs" data-value="1" track-type="globalNav" track-name="breadcrumb" track-metadata-position="1" track-metadata-eventdetail="" > Home </a> </li> <li class="devsite-breadcrumb-item "> <div class="devsite-breadcrumb-guillemet material-icons" aria-hidden="true"></div> <a href="https://developers.google.com/products" class="devsite-breadcrumb-link gc-analytics-event" data-category="Site-Wide Custom Events" data-label="Breadcrumbs" data-value="2" track-type="globalNav" track-name="breadcrumb" track-metadata-position="2" track-metadata-eventdetail="" > Products </a> </li> <li class="devsite-breadcrumb-item "> <div class="devsite-breadcrumb-guillemet material-icons" aria-hidden="true"></div> <a href="https://developers.google.com/youtube" class="devsite-breadcrumb-link gc-analytics-event" data-category="Site-Wide Custom Events" data-label="Breadcrumbs" data-value="3" track-type="globalNav" track-name="breadcrumb" track-metadata-position="3" track-metadata-eventdetail="YouTube" > YouTube </a> </li> <li class="devsite-breadcrumb-item "> <div class="devsite-breadcrumb-guillemet material-icons" aria-hidden="true"></div> <a href="https://developers.google.com/youtube/analytics" class="devsite-breadcrumb-link gc-analytics-event" data-category="Site-Wide Custom Events" data-label="Breadcrumbs" data-value="4" track-type="globalNav" track-name="breadcrumb" track-metadata-position="4" track-metadata-eventdetail="YouTube Analytics and Reporting APIs" > Analytics and Reporting APIs </a> </li> <li class="devsite-breadcrumb-item "> <div class="devsite-breadcrumb-guillemet material-icons" aria-hidden="true"></div> <a href="https://developers.google.com/youtube/analytics/data_model" class="devsite-breadcrumb-link gc-analytics-event" data-category="Site-Wide Custom Events" data-label="Breadcrumbs" data-value="5" track-type="globalNav" track-name="breadcrumb" track-metadata-position="5" track-metadata-eventdetail="" > Targeted Queries </a> </li> </ul> <devsite-thumb-rating position="header"> </devsite-thumb-rating> </div> <h1 class="devsite-page-title" tabindex="-1"> Sample API Requests </h1> <devsite-feature-tooltip ack-key="AckCollectionsBookmarkTooltipDismiss" analytics-category="Site-Wide Custom Events" analytics-action-show="Callout Profile displayed" analytics-action-close="Callout Profile dismissed" analytics-label="Create Collection Callout" class="devsite-page-bookmark-tooltip nocontent" dismiss-button="true" id="devsite-collections-dropdown" dismiss-button-text="Dismiss" close-button-text="Got it"> <devsite-bookmark></devsite-bookmark> <span slot="popout-heading"> Stay organized with collections </span> <span slot="popout-contents"> Save and categorize content based on your preferences. </span> </devsite-feature-tooltip> <div class="devsite-page-title-meta"><devsite-view-release-notes></devsite-view-release-notes></div> <devsite-toc class="devsite-nav" depth="2" devsite-toc-embedded > </devsite-toc> <div class="devsite-article-body clearfix "> <p>This page shows sample YouTube Analytics API requests. Each example briefly describes the report being retrieved and then shows the corresponding <code translate="no" dir="ltr">dimensions</code>, <code translate="no" dir="ltr">metrics</code>, <code translate="no" dir="ltr">filters</code>, and <code translate="no" dir="ltr">sort</code> parameter values. (The <a href="/youtube/analytics/channel_reports">channel reports</a> and <a href="/youtube/analytics/content_owner_reports">content owner reports</a> documents identify the reports that the API supports.)</p> <p>Each example links to and populates the Google APIs Explorer with the values shown. The examples also use default start and end dates (<code translate="no" dir="ltr">YYYY-MM-DD</code>) of <code translate="no" dir="ltr">2023-09-01</code> and <code translate="no" dir="ltr">2024-03-31</code>.</p> <p>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 <code translate="no" dir="ltr">ids</code> parameter value with either <code translate="no" dir="ltr">channel==MINE</code> or <code translate="no" dir="ltr">contentOwner==CONTENT_OWNER_ID</code>, depending on the query that you have clicked. For channel reports, you could change <code translate="no" dir="ltr">MINE</code> to the authenticated user's channel ID. For content owner reports, you need to replace <code translate="no" dir="ltr">CONTENT_OWNER_ID</code> with your content owner ID.</p> <p class="note">You also have to be authenticated as the specified channel or content owner so that the APIs Explorer can authorize your API requests using <span class="notranslate">OAuth 2.0</span>.</p> <ol class="toc"> <li><a href="#Multisort">Sorting requests by multiple dimensions/metrics</a></li> <li><a href="#Channel_Reports">Channel reports</a></li> <li><a href="#Content_Owner_Reports">Content owner reports</a></li> </ol> <h2 id="Multisort" data-text="Sorting requests by multiple dimensions/metrics" tabindex="-1">Sorting requests by multiple dimensions/metrics</h2> <p>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 (e.g. <code translate="no" dir="ltr">EXT_URL</code>) on a particular day.</p> <pre class="prettyprint query notranslate" dir="ltr"> <code translate="no" dir="ltr"><a href="https://developers.google.com/apis-explorer/#p/youtubeAnalytics/v2/youtubeAnalytics.reports.query?metrics=views%252CestimatedMinutesWatched&dimensions=day%252CinsightTrafficSourceType&sort=day%252C-views&startDate=2023-09-01&endDate=2024-03-31&&ids=channel%253D%253DMINE">dimensions=day,insightTrafficSourceType metrics=views,estimatedWatchTime sort=day,-views</a></code> </pre> <p>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.</p> <h2 id="Channel_Reports" data-text="Channel reports" tabindex="-1">Channel reports</h2> <section class="kd-tabbed-horz" id="channel-reports"> <article class="selected"> <header id="channel-basic-stats-reports">Basic stats</header> <h3 id="channel-basic-stats-video-reports" data-text="Video reports" tabindex="-1">Video reports</h3> <h4 id="channel_total_viewcounts" data-text="Total view counts, estimated watch time, and more for a channel" tabindex="-1">Total view counts, estimated watch time, and more for a channel</h4> <p>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.</p> <pre class="prettyprint query notranslate" dir="ltr"><code translate="no" dir="ltr"><a href="https://developers.google.com/apis-explorer/#p/youtubeAnalytics/v2/youtubeAnalytics.reports.query?metrics=views%252Ccomments%252Clikes%252Cdislikes%252CestimatedMinutesWatched%252CaverageViewDuration&startDate=2023-09-01&endDate=2024-03-31&&ids=channel%253D%253DMINE">metrics=views,comments,likes,dislikes,estimatedMinutesWatched,averageViewDuration</a></code> </pre> <h4 id="channel_country_viewcounts" data-text="Country-specific view counts (and more) for a channel" tabindex="-1">Country-specific view counts (and more) for a channel</h4> <p>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.</p> <pre class="prettyprint query notranslate" dir="ltr"> <code translate="no" dir="ltr"><a href="https://developers.google.com/apis-explorer/#p/youtubeAnalytics/v2/youtubeAnalytics.reports.query?metrics=views%252Ccomments%252Clikes%252Cdislikes%252CestimatedMinutesWatched&filters=country%253D%253DUS&startDate=2023-09-01&endDate=2024-03-31&&ids=channel%253D%253DMINE">metrics=views,comments,likes,dislikes,estimatedMinutesWatched filters=country==US</a></code> </pre> <h4 id="channel_10_most_watched" data-text="Top 10 – Most watched videos for a channel" tabindex="-1">Top 10 – Most watched videos for a channel</h4> <p>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.</p> <p class="note"><strong>Note:</strong> This report requires you to specify a value for the <code translate="no" dir="ltr">sort</code> request parameter and to set the <code translate="no" dir="ltr">maxResults</code> parameter to an integer value of <code translate="no" dir="ltr">10</code> or less.</p> <pre class="prettyprint query notranslate" dir="ltr"> <code translate="no" dir="ltr"><a href="https://developers.google.com/apis-explorer/#p/youtubeAnalytics/v2/youtubeAnalytics.reports.query?metrics=estimatedMinutesWatched%252Cviews%252Clikes%252CsubscribersGained&dimensions=video&maxResults=10&sort=-estimatedMinutesWatched&startDate=2023-09-01&endDate=2024-03-31&&ids=channel%253D%253DMINE">dimensions=video metrics=estimatedMinutesWatched,views,likes,subscribersGained maxResults=10 sort=-estimatedMinutesWatched</a></code> </pre> <h4 id="channel_top_10_video_annotation_ctr" data-text="Top 10 – Annotation click-through rates for a channel's most viewed videos" tabindex="-1">Top 10 – Annotation click-through rates for a channel's most viewed videos</h4> <p>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.</p> <p class="note"><strong>Note:</strong> This report requires you to specify a value for the <code translate="no" dir="ltr">sort</code> request parameter and to set the <code translate="no" dir="ltr">maxResults</code> parameter to an integer value of <code translate="no" dir="ltr">10</code> or less.</p> <pre class="prettyprint query notranslate" dir="ltr"> <code translate="no" dir="ltr"><a href="https://developers.google.com/apis-explorer/#p/youtubeAnalytics/v2/youtubeAnalytics.reports.query?metrics=views%252Clikes%252CannotationClickThroughRate%252CannotationCloseRate%252CannotationImpressions&dimensions=video&maxResults=10&sort=-views&startDate=2023-09-01&endDate=2024-03-31&&ids=channel%253D%253DMINE">dimensions=video metrics=views,likes,annotationClickThroughRate,annotationCloseRate,annotationImpressions maxResults=10 sort=-views</a></code> </pre> <h3 id="channel-basic-stats-playlist-reports" data-text="Playlist reports" tabindex="-1">Playlist reports</h3> <h4 id="channel_playlist_views" data-text="Total playlist views for a channel" tabindex="-1">Total playlist views for a channel</h4> <p>This request retrieves total playlist starts, estimated minutes watched, views (an <a href="/youtube/analytics/channel_reports#aggregated-video-metrics">aggregated video metric</a>), playlist views (an <a href="/youtube/analytics/channel_reports#in-playlist-metrics">in-playlist</a> metric), and views per playlist start for playlists in the authenticated user's channel.</p> <pre class="prettyprint query notranslate" dir="ltr"> <code translate="no" dir="ltr"><a href="https://developers.google.com/apis-explorer/#p/youtubeAnalytics/v2/youtubeAnalytics.reports.query?metrics=views%252CestimatedMinutesWatched%252CplaylistStarts%252CplaylistViews%252CviewsPerPlaylistStart&filters&startDate=2023-09-01&endDate=2024-03-31&&ids=channel%253D%253DMINE">metrics=views,estimatedMinutesWatched,playlistStarts,playlistViews,viewsPerPlaylistStart</a></code> </pre> <h4 id="channel_specific_playlist_views" data-text="Statistics for a specific playlist" tabindex="-1">Statistics for a specific playlist</h4> <p>This request retrieves total playlist starts, estimated minutes watched, views (an <a href="/youtube/analytics/channel_reports#aggregated-video-metrics">aggregated video metric</a>), playlist views (an <a href="/youtube/analytics/channel_reports#in-playlist-metrics">in-playlist</a> 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 <code translate="no" dir="ltr">PLAYLIST_ID</code> in the <code translate="no" dir="ltr">filters</code> parameter value with the playlist ID for a playlist in the authenticated user's channel.</p> <pre class="prettyprint query notranslate" dir="ltr"> <code translate="no" dir="ltr"><a href="https://developers.google.com/apis-explorer/#p/youtubeAnalytics/v2/youtubeAnalytics.reports.query?metrics=views%252CestimatedMinutesWatched%252CplaylistStarts%252CplaylistViews%252CviewsPerPlaylistStart&filters=playlist%253D%253DPLAYLIST_ID&startDate=2023-09-01&endDate=2024-03-31&&ids=channel%253D%253DMINE">metrics=views,estimatedMinutesWatched,playlistStarts,playlistViews,viewsPerPlaylistStart filters=playlist==PLAYLIST_ID</a></code> </pre> <p>To retrieve aggregate statistics for multiple playlists, you can also replace the string <code translate="no" dir="ltr">PLAYLIST_ID</code> with a comma-separated list of up to 500 playlists IDs for playlists in the authenticated user's channel.</p> <h4 id="channel_10_most_watched_playlists" data-text="Top 10 – Most watched playlists for a channel" tabindex="-1">Top 10 – Most watched playlists for a channel</h4> <p>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.</p> <p class="note"><strong>Note:</strong> Since this report uses the <code translate="no" dir="ltr"><a href="/youtube/analytics/dimensions#playlist">playlist</a></code> dimension, you must specify a value for the <code translate="no" dir="ltr">sort</code> request parameter and also set the <code translate="no" dir="ltr">maxResults</code> parameter to an integer value of <code translate="no" dir="ltr">10</code> or less.</p> <pre class="prettyprint query notranslate" dir="ltr"> <code translate="no" dir="ltr"><a href="https://developers.google.com/apis-explorer/#p/youtubeAnalytics/v2/youtubeAnalytics.reports.query?metrics=views%252CestimatedMinutesWatched%252CplaylistStarts%252CaverageTimeInPlaylist&dimensions=playlist&filters=isCurated%253D%253D1&maxResults=10&sort=-estimatedMinutesWatched&startDate=2023-09-01&endDate=2024-03-31&&ids=channel%253D%253DMINE">dimensions=playlist metrics=playlistViews,playlistEstimatedMinutesWatched,playlistStarts,averageTimeInPlaylist,playlistSaves maxResults=10 sort=-playlistViews</a></code> </pre> </article> <article> <header id="channel-time-based-reports">Time-based</header> <h3 id="channel-time-based-video-reports" data-text="Video reports" tabindex="-1">Video reports</h3> <h4 id="channel_daily_watchtime" data-text="Daily watch time metrics for a channel's videos" tabindex="-1">Daily watch time metrics for a channel's videos</h4> <p>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.</p> <pre class="prettyprint query notranslate" dir="ltr"> <code translate="no" dir="ltr"><a href="https://developers.google.com/apis-explorer/#p/youtubeAnalytics/v2/youtubeAnalytics.reports.query?metrics=views%252CestimatedMinutesWatched%252CaverageViewDuration%252CaverageViewPercentage%252CsubscribersGained&dimensions=day&sort=day&startDate=2023-09-01&endDate=2024-03-31&&ids=channel%253D%253DMINE">dimensions=day metrics=views,estimatedMinutesWatched,averageViewDuration,averageViewPercentage,subscribersGained sort=day</a></code> </pre> <h4 id="channel_annotations" data-text="Daily annotation metrics for a channel's videos" tabindex="-1">Daily annotation metrics for a channel's videos</h4> <p>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.</p> <pre class="prettyprint query notranslate" dir="ltr"> <code translate="no" dir="ltr"><a href="https://developers.google.com/apis-explorer/#p/youtubeAnalytics/v2/youtubeAnalytics.reports.query?metrics=views%252CannotationClickThroughRate%252CannotationCloseRate%252CannotationImpressions&dimensions=day&sort=day&startDate=2023-09-01&endDate=2024-03-31&&ids=channel%253D%253DMINE">dimensions=day metrics=views,likes,annotationClickThroughRate,annotationCloseRate,annotationImpressions sort=day</a></code> </pre> <h3 id="channel-time-based-playlist-reports" data-text="Playlist reports" tabindex="-1">Playlist reports</h3> <h4 id="channel_daily_playlist_views" data-text="Daily playlist views for a channel" tabindex="-1">Daily playlist views for a channel</h4> <p>This request retrieves daily view counts (an <a href="/youtube/analytics/channel_reports#aggregated-video-metrics">aggregated video metric</a>), playlist views (an <a href="/youtube/analytics/channel_reports#in-playlist-metrics">in-playlist</a> metric), playlist starts, estimated minutes watched, and views per playlist start for the authenticated user's channel. Results are sorted in chronological order.</p> <pre class="prettyprint query notranslate" dir="ltr"> <code translate="no" dir="ltr"><a href="https://developers.google.com/apis-explorer/#p/youtubeAnalytics/v2/youtubeAnalytics.reports.query?metrics=views%252CestimatedMinutesWatched%252CplaylistStarts%252CplaylistViews%252CviewsPerPlaylistStart&dimensions=day&sort=day&startDate=2023-09-01&endDate=2024-03-31&&ids=channel%253D%253DMINE">dimensions=day metrics=views,estimatedMinutesWatched,playlistStarts,playlistViews,viewsPerPlaylistStart sort=day</a></code> </pre> </article> <article> <header id="channel-geographic-reports">Geographic</header> <h3 id="channel-geographic-video-reports" data-text="Video reports" tabindex="-1">Video reports</h3> <h4 id="channel_country_watchtime" data-text="Country-specific watch time metrics for a channel's videos" tabindex="-1">Country-specific watch time metrics for a channel's videos</h4> <p>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.</p> <pre class="prettyprint query notranslate" dir="ltr"> <code translate="no" dir="ltr"><a href="https://developers.google.com/apis-explorer/#p/youtubeAnalytics/v2/youtubeAnalytics.reports.query?metrics=views%252CestimatedMinutesWatched%252CaverageViewDuration%252CaverageViewPercentage%252CsubscribersGained&dimensions=country&sort=-estimatedMinutesWatched&startDate=2023-09-01&endDate=2024-03-31&&ids=channel%253D%253DMINE">dimensions=country metrics=views,estimatedMinutesWatched,averageViewDuration,averageViewPercentage,subscribersGained sort=-estimatedMinutesWatched</a></code> </pre> <h4 id="channel_country_annotations" data-text="Country-specific annotation metrics for a channel's videos" tabindex="-1">Country-specific annotation metrics for a channel's videos</h4> <p>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.</p> <pre class="prettyprint query notranslate" dir="ltr"> <code translate="no" dir="ltr"><a href="https://developers.google.com/apis-explorer/#p/youtubeAnalytics/v2/youtubeAnalytics.reports.query?metrics=views%252CannotationClickThroughRate%252CannotationCloseRate%252CannotationImpressions&dimensions=country&sort=-annotationClickThroughRate&startDate=2023-09-01&endDate=2024-03-31&&ids=channel%253D%253DMINE">dimensions=country metrics=views,likes,annotationClickThroughRate,annotationCloseRate,annotationImpressions sort=-annotationClickThroughRate</a></code> </pre> <h4 id="channel_province_statistics" data-text="Province-specific metrics for U.S. states and Washington D.C." tabindex="-1">Province-specific metrics for U.S. states and Washington D.C.</h4> <p>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 U.S. states and Washington D.C. Results are sorted alphabetically by provinces' ISO 3166-2 codes</a>.</p> <pre class="prettyprint query notranslate" dir="ltr"> <code translate="no" dir="ltr"><a href="https://developers.google.com/apis-explorer/#p/youtubeAnalytics/v2/youtubeAnalytics.reports.query?metrics=views%252CestimatedMinutesWatched%252CaverageViewDuration&dimensions=province&filters=country==US&sort=province&startDate=2023-09-01&endDate=2024-03-31&&ids=channel%253D%253DMINE">dimensions=province metrics=views,estimatedMinutesWatched,averageViewDuration filters=claimedStatus==claimed;country==US sort=province</a></code> </pre> <h4 id="channel_10_most_viewed" data-text="Top 10 – Most viewed videos in a specific country" tabindex="-1">Top 10 – Most viewed videos in a specific country</h4> <p>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.</p> <p class="note"><strong>Note:</strong> This report requires you to specify a value for the <code translate="no" dir="ltr">sort</code> request parameter and to set the <code translate="no" dir="ltr">maxResults</code> parameter to an integer value of <code translate="no" dir="ltr">10</code> or less.</p> <pre class="prettyprint query notranslate" dir="ltr"> <code translate="no" dir="ltr"><a href="https://developers.google.com/apis-explorer/#p/youtubeAnalytics/v2/youtubeAnalytics.reports.query?metrics=views%252CestimatedMinutesWatched%252Clikes%252CsubscribersGained&dimensions=video&maxResults=10&filters=country%253D%253DUS&sort=-views&startDate=2023-09-01&endDate=2024-03-31&&ids=channel%253D%253DMINE">dimensions=video metrics=views,estimatedMinutesWatched,likes,subscribersGained filters=country==US maxResults=10 sort=-views</a></code> </pre> <h4 id="channel_top_10_us_cities_by_views" data-text="Top 10 U.S. cities by total views" tabindex="-1">Top 10 U.S. cities by total views</h4> <p>This query retrieves a list of the 10 U.S. 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 <a href="/youtube/analytics/v1/dimsmets/dims#country">country</a> 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 <a href="/youtube/analytics/v1/dimsmets/dims#subContinent">subContinent</a> filter and one of its valid values. Other filters are supported, too. Results are sorted by view count in descending order.</p> <pre class="prettyprint query notranslate" dir="ltr"> <code translate="no" dir="ltr"><a href="https://developers.google.com/apis-explorer/#p/youtubeAnalytics/v2/youtubeAnalytics.reports.query?metrics=views&dimensions=city&maxResults=10&filters=country%253D%253DUS&sort=-views&startDate=2023-09-01&endDate=2024-03-31&&ids=channel%253D%253DMINE">dimensions=city metrics=views filters=country==US maxResults=10 sort=-views</a></code> </pre> <h4 id="channel_top_10_us_cities_by_content_type" data-text="Top 10 U.S. cities by total views for each content type" tabindex="-1">Top 10 U.S. cities by total views for each content type</h4> <p>This query retrieves a list of the 10 U.S. cities that accounted for the most views of the channel's content during the specified date range for each supported <a href="/youtube/analytics/v1/dimsmets/dims#creatorContentType">creatorContentType</a>. Results are sorted by view count in descending order.</p> <pre class="prettyprint query notranslate" dir="ltr"> <code translate="no" dir="ltr"><a href="https://developers.google.com/apis-explorer/#p/youtubeAnalytics/v2/youtubeAnalytics.reports.query?metrics=views&dimensions=city%252CcreatorContentType&maxResults=10&filters=country%253D%253DUS&sort=-views&startDate=2023-09-01&endDate=2024-03-31&&ids=channel%253D%253DMINE">dimensions=city,creatorContentType metrics=views filters=country==US maxResults=10 sort=-views</a></code> </pre> <h4 id="channel_top_10_us_cities_by_day" data-text="Top 10 U.S. cities by total watch time" tabindex="-1">Top 10 U.S. cities by total watch time</h4> <p>This query retrieves a list of the top 10 days during the specified date range when any U.S. 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.</p> <pre class="prettyprint query notranslate" dir="ltr"> <code translate="no" dir="ltr"><a href="https://developers.google.com/apis-explorer/#p/youtubeAnalytics/v2/youtubeAnalytics.reports.query?metrics=estimatedWatchTime&dimensions=city%252Cday&maxResults=10&filters=country%253D%253DUS&sort=-estimatedWatchTime&startDate=2023-09-01&endDate=2024-03-31&&ids=channel%253D%253DMINE">dimensions=city,day metrics=estimatedWatchTime filters=country==US maxResults=10 sort=-estimatedWatchTime</a></code> </pre> <h4 id="channel_10_most_viewed_in_continent" data-text="Top 10 – Most viewed videos in Europe" tabindex="-1">Top 10 – Most viewed videos in Europe</h4> <p>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 <a href="/youtube/analytics/v1/dimsmets/dims#continent">continent</a> 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 <a href="/youtube/analytics/v1/dimsmets/dims#subContinent">subContinent</a> filter and one of its valid values. Results are sorted by view count in descending order.</p> <p class="note"><strong>Note:</strong> This report requires you to specify a value for the <code translate="no" dir="ltr">sort</code> request parameter and to set the <code translate="no" dir="ltr">maxResults</code> parameter to an integer value of <code translate="no" dir="ltr">10</code> or less.</p> <pre class="prettyprint query notranslate" dir="ltr"> <code translate="no" dir="ltr"><a href="https://developers.google.com/apis-explorer/#p/youtubeAnalytics/v2/youtubeAnalytics.reports.query?metrics=views%252CestimatedMinutesWatched%252Clikes%252CsubscribersGained&dimensions=video&maxResults=10&filters=continent%253D%253D150&sort=-views&startDate=2023-09-01&endDate=2024-03-31&&ids=channel%253D%253DMINE">dimensions=video metrics=views,estimatedMinutesWatched,likes,subscribersGained filters=continent==150 maxResults=10 sort=-views</a></code> </pre> <h3 id="channel-geographic-playlist-reports" data-text="Playlist reports" tabindex="-1">Playlist reports</h3> <h4 id="channel_playlist_watchtime_by_country" data-text="Country-specific watch time metrics for a channel's playlists" tabindex="-1">Country-specific watch time metrics for a channel's playlists</h4> <p>This query retrieves country-specific view counts (an <a href="/youtube/analytics/channel_reports#aggregated-video-metrics">aggregated video metric</a>), playlist views (an <a href="/youtube/analytics/channel_reports#in-playlist-metrics">in-playlist</a> 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.</p> <pre class="prettyprint query notranslate" dir="ltr"> <code translate="no" dir="ltr"><a href="https://developers.google.com/apis-explorer/#p/youtubeAnalytics/v2/youtubeAnalytics.reports.query?metrics=views%252CestimatedMinutesWatched%252CaverageTimeInPlaylist%252CplaylistStarts%252CplaylistViews&dimensions=country&sort=-estimatedMinutesWatched&startDate=2023-09-01&endDate=2024-03-31&&ids=channel%253D%253DMINE">dimensions=country metrics=views,estimatedMinutesWatched,playlistStarts,averageTimeInPlaylist sort=-estimatedMinutesWatched</a></code> </pre> <h4 id="channel_10_most_started_playlists" data-text="Top 10 – Most started playlists in the United States" tabindex="-1">Top 10 – Most started playlists in the United States</h4> <p>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.</p> <p class="note"><strong>Note:</strong> Since this report uses the <code translate="no" dir="ltr"><a href="/youtube/analytics/dimensions#playlist">playlist</a></code> dimension, you must specify a value for the <code translate="no" dir="ltr">sort</code> request parameter and also set the <code translate="no" dir="ltr">maxResults</code> parameter to an integer value of <code translate="no" dir="ltr">10</code> or less.</p> <pre class="prettyprint query notranslate" dir="ltr"> <code translate="no" dir="ltr"><a href="https://developers.google.com/apis-explorer/#p/youtubeAnalytics/v2/youtubeAnalytics.reports.query?metrics=playlistStarts%252Cviews%252CestimatedMinutesWatched%252CaverageViewDuration&dimensions=playlist&filters=isCurated%253D%253D1%253Bcountry%253D%253DUS&maxResults=10&sort=-playlistStarts&startDate=2023-09-01&endDate=2024-03-31&&ids=channel%253D%253DMINE">dimensions=playlist metrics=playlistStarts,views,estimatedMinutesWatched,averageViewDuration filters=isCurated==1;country==US maxResults=10 sort=-playlistStarts</a></code> </pre> </article> <article> <header id="channel-playback-location-reports">Playback location</header> <h3 id="channel-playback-location-video-reports" data-text="Video reports" tabindex="-1">Video reports</h3> <h4 id="channel_playback_locations" data-text="Viewcounts and watch time from different playback locations" tabindex="-1">Viewcounts and watch time from different playback locations</h4> <p>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.</p> <pre class="prettyprint query notranslate" dir="ltr"> <code translate="no" dir="ltr"><a href="https://developers.google.com/apis-explorer/#p/youtubeAnalytics/v2/youtubeAnalytics.reports.query?metrics=estimatedMinutesWatched%252Cviews&dimensions=insightPlaybackLocationType&sort=-views&startDate=2023-09-01&endDate=2024-03-31&&ids=channel%253D%253DMINE">dimensions=insightPlaybackLocationType metrics=estimatedMinutesWatched,views sort=-views</a></code> </pre> <h4 id="channel_daily_playback_locations" data-text="Daily view counts and watch time from different playback locations" tabindex="-1">Daily view counts and watch time from different playback locations</h4> <p>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.</p> <pre class="prettyprint query notranslate" dir="ltr"> </code><a href="https://developers.google.com/apis-explorer/#p/youtubeAnalytics/v2/youtubeAnalytics.reports.query?metrics=estimatedMinutesWatched%252Cviews&dimensions=day%252CinsightPlaybackLocationType&filters=country%253D%253DUS&sort=day&startDate=2023-09-01&endDate=2024-03-31&&ids=channel%253D%253DMINE">dimensions=day,insightPlaybackLocationType metrics=estimatedMinutesWatched,views filters=country==US sort=day</a></code> </pre> <h4 id="channel_10_top_third_party" data-text="Top 10 – Third-party sites that generate the most views for an embedded video" tabindex="-1">Top 10 – Third-party sites that generate the most views for an embedded video</h4> <p>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 <code translate="no" dir="ltr">VIDEO_ID</code> in the <code translate="no" dir="ltr">filters</code> parameter value with a comma-separated list of one or more video IDs for your uploaded videos.</p> <pre class="prettyprint query notranslate" dir="ltr"> <code translate="no" dir="ltr"><a href="https://developers.google.com/apis-explorer/#p/youtubeAnalytics/v2/youtubeAnalytics.reports.query?metrics=views%252CestimatedMinutesWatched&dimensions=insightPlaybackLocationDetail&filters=video%253D%253DVIDEO_ID%253BinsightPlaybackLocationType%253D%253DEMBEDDED&maxResults=10&sort=-views&startDate=2023-09-01&endDate=2024-03-31&&ids=channel%253D%253DMINE">dimensions=insightPlaybackLocationDetail metrics=views,estimatedMinutesWatched filters=video==VIDEO_ID;insightPlaybackLocationType==EMBEDDED maxResults=10 sort=-views</a></code> </pre> <h3 id="channel-playback-location-playlist-reports" data-text="Playlist reports" tabindex="-1">Playlist reports</h3> <h4 id="channel_playlist_playback_locations" data-text="Playlist view counts and watch time from different playback locations" tabindex="-1">Playlist view counts and watch time from different playback locations</h4> <p>This query retrieves the number of view counts (an <a href="/youtube/analytics/channel_reports#aggregated-video-metrics">aggregated video metric</a>), playlist views (an <a href="/youtube/analytics/channel_reports#in-playlist-metrics">in-playlist</a> 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.</p> <pre class="prettyprint query notranslate" dir="ltr"> <code translate="no" dir="ltr"><a href="https://developers.google.com/apis-explorer/#p/youtubeAnalytics/v2/youtubeAnalytics.reports.query?metrics=views%252CestimatedMinutesWatched%252CplaylistStarts%252CplaylistViews&dimensions=insightPlaybackLocationType&sort=-views&startDate=2023-09-01&endDate=2024-03-31&&ids=channel%253D%253DMINE">dimensions=insightPlaybackLocationType metrics=views,estimatedMinutesWatched,playlistStarts,playlistViews sort=-playlistStarts</a></code> </pre> <h4 id="channel_daily_playlist_playback_locations" data-text="Daily playlist view counts and watch time from different playback locations" tabindex="-1">Daily playlist view counts and watch time from different playback locations</h4> <p>This query retrieves daily playlist starts, view counts (an <a href="/youtube/analytics/channel_reports#aggregated-video-metrics">aggregated video metric</a>), playlist views (an <a href="/youtube/analytics/channel_reports#in-playlist-metrics">in-playlist</a> 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.</p> <pre class="prettyprint query notranslate" dir="ltr"> <code translate="no" dir="ltr"><a href="https://developers.google.com/apis-explorer/#p/youtubeAnalytics/v2/youtubeAnalytics.reports.query?metrics=views%252CestimatedMinutesWatched%252playlistStarts%252CCplaylistViews&dimensions=day%252CinsightPlaybackLocationType&filters=country%253D%253DUS&sort=day&startDate=2023-09-01&endDate=2024-03-31&&ids=channel%253D%253DMINE">dimensions=day,insightPlaybackLocationType metrics=views,estimatedMinutesWatched,playlistStarts,playlistViews filters=country==US sort=day</a></code> </pre> </article> <article> <header id="channel-playback-details-reports">Playback details</header> <h3 id="channel-playback-details-video-reports" data-text="Video reports" tabindex="-1">Video reports</h3> <h4 id="channel_playback_details_content_type" data-text="Likes and dislikes by content type" tabindex="-1">Likes and dislikes by content type</h4> <p>This query retrieves the number of likes and dislikes for each type of content on a channel.</p> <pre class="prettyprint query notranslate" dir="ltr"> <code translate="no" dir="ltr"><a href="https://developers.google.com/apis-explorer/#p/youtubeAnalytics/v2/youtubeAnalytics.reports.query?metrics=likes%dislikes&dimensions=creatorContentType&startDate=2023-09-01&endDate=2024-03-31&&ids=contentOwner%253D%253DCONTENT_OWNER_ID">dimensions=creatorContentType metrics=likes,dislikes</a></code> </pre> </article> <article> <header id="channel-traffic-source-reports">Traffic source</header> <h3 id="channel-traffic-source-video-reports" data-text="Video reports" tabindex="-1">Video reports</h3> <h4 id="channel_traffic_sources" data-text="Viewcounts and watch time from different traffic sources in a country" tabindex="-1">Viewcounts and watch time from different traffic sources in a country</h4> <p>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.</p> <pre class="prettyprint query notranslate" dir="ltr"> <code translate="no" dir="ltr"><a href="https://developers.google.com/apis-explorer/#p/youtubeAnalytics/v2/youtubeAnalytics.reports.query?metrics=views%252CestimatedMinutesWatched&dimensions=insightTrafficSourceType&filters=country%253D%253DUS&startDate=2023-09-01&endDate=2024-03-31&&ids=channel%253D%253DMINE">dimensions=insightTrafficSourceType metrics=views,estimatedMinutesWatched filters=country==US</a></code> </pre> <h4 id="channel_daily_traffic_sources" data-text="Daily view counts and watch time from different traffic sources" tabindex="-1">Daily view counts and watch time from different traffic sources</h4> <p>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.</p> <pre class="prettyprint query notranslate" dir="ltr"> <code translate="no" dir="ltr"><a href="https://developers.google.com/apis-explorer/#p/youtubeAnalytics/v2/youtubeAnalytics.reports.query?metrics=views%252CestimatedMinutesWatched&dimensions=day%252CinsightTrafficSourceType&sort=day&startDate=2023-09-01&endDate=2024-03-31&&ids=channel%253D%253DMINE">dimensions=day,insightTrafficSourceType metrics=views,estimatedMinutesWatched sort=day</a></code> </pre> <h4 id="channel_10_top_YT_search_terms" data-text="Top 10 – YouTube search terms that generate the most traffic for a video" tabindex="-1">Top 10 – YouTube search terms that generate the most traffic for a video</h4> <p>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 <code translate="no" dir="ltr">VIDEO_ID</code> in the <code translate="no" dir="ltr">filters</code> parameter value with a comma-separated list of up to 500 video IDs.</p> <p>For example, you could run the query for a single video or replace <code translate="no" dir="ltr">VIDEO_ID</code> 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.</p> <pre class="prettyprint query notranslate" dir="ltr"> <code translate="no" dir="ltr"><a href="https://developers.google.com/apis-explorer/#p/youtubeAnalytics/v2/youtubeAnalytics.reports.query?metrics=views&dimensions=insightTrafficSourceDetail&filters=video%253D%253DVIDEO_ID%253BinsightTrafficSourceType%253D%253DYT_SEARCH&maxResults=10&sort=-views&startDate=2023-09-01&endDate=2024-03-31&&ids=channel%253D%253DMINE">dimensions=insightTrafficSourceDetail metrics=views filters=video==VIDEO_ID;insightTrafficSourceType==YT_SEARCH maxResults=10 sort=-views</a></code> </pre> <h4 id="channel_10_top_Google_search_terms" data-text="Top 10 – External websites that generate the most traffic for a video" tabindex="-1">Top 10 – External websites that generate the most traffic for a video</h4> <p>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 <code translate="no" dir="ltr">VIDEO_ID</code> in the <code translate="no" dir="ltr">filters</code> parameter value with a comma-separated list of up to 500 video IDs for your uploaded videos.</p> <pre class="prettyprint query notranslate" dir="ltr"> <code translate="no" dir="ltr"><a href="https://developers.google.com/apis-explorer/#p/youtubeAnalytics/v2/youtubeAnalytics.reports.query?metrics=estimatedMinutesWatched%252Cviews&dimensions=insightTrafficSourceDetail&filters=video%253D%253DVIDEO_ID%253BinsightTrafficSourceType%253D%253DEXT_URL&maxResults=25&sort=-estimatedMinutesWatched&startDate=2023-09-01&endDate=2024-03-31&&ids=channel%253D%253DMINE">dimensions=insightTrafficSourceDetail metrics=estimatedMinutesWatched,views filters=video==VIDEO_ID;insightTrafficSourceType==EXT_URL maxResults=25 sort=-estimatedMinutesWatched</a></code> </pre> <h3 id="channel-traffic-source-playlist-reports" data-text="Playlist reports" tabindex="-1">Playlist reports</h3> <h4 id="channel_playlist_traffic_sources" data-text="Playlist view counts and watch time from different traffic sources in a country" tabindex="-1">Playlist view counts and watch time from different traffic sources in a country</h4> <p>This request retrieves the number of views (an <a href="/youtube/analytics/channel_reports#aggregated-video-metrics">aggregated video metric</a>), playlist views (an <a href="/youtube/analytics/channel_reports#in-playlist-metrics">in-playlist</a> 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.</p> <pre class="prettyprint query notranslate" dir="ltr"> <code translate="no" dir="ltr"><a href="https://developers.google.com/apis-explorer/#p/youtubeAnalytics/v2/youtubeAnalytics.reports.query?metrics=views%252CestimatedMinutesWatched%252CplaylistStarts%252CplaylistViews&dimensions=insightTrafficSourceType&filters=country%253D%253DUS&startDate=2023-09-01&endDate=2024-03-31&&ids=channel%253D%253DMINE">dimensions=insightTrafficSourceType metrics=views,estimatedMinutesWatchedplaylistStarts,playlistViews filters=country==US</a></code> </pre> <h4 id="channel_daily_playlist_traffic_sources" data-text="Daily playlist view counts and watch time from different traffic sources" tabindex="-1">Daily playlist view counts and watch time from different traffic sources</h4> <p>This request retrieves a channel's daily playlist views (an <a href="/youtube/analytics/channel_reports#in-playlist-metrics">in-playlist</a> metric), playlist starts, and estimated watch time. It also retrieves total views (an <a href="/youtube/analytics/channel_reports#aggregated-video-metrics">aggregated video metric</a>). The metrics are aggregated on a daily basis by traffic source and sorted in chronological order.</p> <pre class="prettyprint query notranslate" dir="ltr"> <code translate="no" dir="ltr"><a href="https://developers.google.com/apis-explorer/#p/youtubeAnalytics/v2/youtubeAnalytics.reports.query?metrics=views%252CestimatedMinutesWatched%252CplaylistStarts%252CplaylistViews&dimensions=day%252CinsightTrafficSourceType&sort=day&startDate=2023-09-01&endDate=2024-03-31&&ids=channel%253D%253DMINE">dimensions=day,insightTrafficSourceType metrics=views,estimatedMinutesWatched,playlistStarts,playlistViews sort=day</a></code> </pre> </article> <article> <header id="channel-device-os-reports">Device/OS</header> <h3 id="channel-device-os-video-reports" data-text="Video reports" tabindex="-1">Video reports</h3> <h4 id="channel_daily_device_types" data-text="Daily device type metrics for the Android operating system" tabindex="-1">Daily device type metrics for the Android operating system</h4> <p>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.</p> <pre class="prettyprint query notranslate" dir="ltr"> <code translate="no" dir="ltr"><a href="https://developers.google.com/apis-explorer/#p/youtubeAnalytics/v2/youtubeAnalytics.reports.query?metrics=estimatedMinutesWatched%252Cviews&dimensions=day%252CdeviceType&filters=operatingSystem%253D%253DANDROID&sort=day&startDate=2023-09-01&endDate=2024-03-31&&ids=channel%253D%253DMINE">dimensions=day,deviceType metrics=estimatedMinutesWatched,views filters=operatingSystem==ANDROID sort=day</a></code> </pre> <h4 id="channel_daily_operating_system" data-text="Daily operating system metrics for mobile devices" tabindex="-1">Daily operating system metrics for mobile devices</h4> <p>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.</p> <pre class="prettyprint query notranslate" dir="ltr"> <code translate="no" dir="ltr"><a href="https://developers.google.com/apis-explorer/#p/youtubeAnalytics/v2/youtubeAnalytics.reports.query?metrics=estimatedMinutesWatched%252Cviews&dimensions=day%252CoperatingSystem&filters=deviceType%253D%253DMOBILE&sort=day&startDate=2023-09-01&endDate=2024-03-31&&ids=channel%253D%253DMINE">dimensions=day,operatingSystem metrics=estimatedMinutesWatched,views filters=deviceType==MOBILE sort=day</a></code> </pre> <h4 id="channel_daily_operating_system_device_type" data-text="Daily operating system and device type metrics" tabindex="-1">Daily operating system and device type metrics</h4> <p>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.</p> <pre class="prettyprint query notranslate" dir="ltr"> <code translate="no" dir="ltr"><a href="https://developers.google.com/apis-explorer/#p/youtubeAnalytics/v2/youtubeAnalytics.reports.query?metrics=estimatedMinutesWatched%252Cviews&dimensions=day%252CoperatingSystem%252CdeviceType&sort=day&startDate=2023-09-01&endDate=2024-03-31&&ids=channel%253D%253DMINE">dimensions=day,operatingSystem,deviceType metrics=estimatedMinutesWatched,views sort=day</a></code> </pre> <h3 id="channel-device-os-playlist-reports" data-text="Playlist reports" tabindex="-1">Playlist reports</h3> <h4 id="channel_daily_playlist_device_types" data-text="Daily device type metrics for playlist views on the Android operating system" tabindex="-1">Daily device type metrics for playlist views on the Android operating system</h4> <p>This query retrieves daily views (an <a href="/youtube/analytics/channel_reports#aggregated-video-metrics">aggregated video metric</a>), playlist views (an <a href="/youtube/analytics/channel_reports#in-playlist-metrics">in-playlist</a> 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.</p> <pre class="prettyprint query notranslate" dir="ltr"> <code translate="no" dir="ltr"><a href="https://developers.google.com/apis-explorer/#p/youtubeAnalytics/v2/youtubeAnalytics.reports.query?metrics=views%252CestimatedMinutesWatched%252CplaylistViews&dimensions=day%252CdeviceType&filters=operatingSystem%253D%253DANDROID&sort=day&startDate=2023-09-01&endDate=2024-03-31&&ids=channel%253D%253DMINE">dimensions=day,deviceType metrics=views,estimatedMinutesWatched,playlistViews filters=operatingSystem==ANDROID sort=day</a></code> </pre> <h4 id="channel_daily_playlist_operating_system" data-text="Daily operating system metrics for playlist views on mobile devices" tabindex="-1">Daily operating system metrics for playlist views on mobile devices</h4> <p>This query retrieves daily views (an <a href="/youtube/analytics/channel_reports#aggregated-video-metrics">aggregated video metric</a>), playlist views (an <a href="/youtube/analytics/channel_reports#in-playlist-metrics">in-playlist</a> 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.</p> <pre class="prettyprint query notranslate" dir="ltr"> <code translate="no" dir="ltr"><a href="https://developers.google.com/apis-explorer/#p/youtubeAnalytics/v2/youtubeAnalytics.reports.query?metrics=views%252CestimatedMinutesWatched%252CplaylistViews&dimensions=day%252CoperatingSystem&filters=deviceType%253D%253DMOBILE&sort=day&startDate=2023-09-01&endDate=2024-03-31&&ids=channel%253D%253DMINE">dimensions=day,operatingSystem metrics=views,estimatedMinutesWatched filters=deviceType==MOBILE sort=day</a></code> </pre> </article> <article> <header id="channel-demographic-reports">Demographic</header> <h3 id="channel-demographic-video-reports" data-text="Video reports" tabindex="-1">Video reports</h3> <h4 id="channel_state_demographics" data-text="Viewer demographics in California (age group and gender)" tabindex="-1">Viewer demographics in California (age group and gender)</h4> <p>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 U.S. state by adjusting the <code translate="no" dir="ltr">filters</code> parameter value.</p> <pre class="prettyprint query notranslate" dir="ltr"> <code translate="no" dir="ltr"><a href="https://developers.google.com/apis-explorer/#p/youtubeAnalytics/v2/youtubeAnalytics.reports.query?metrics=viewerPercentage&dimensions=ageGroup%252Cgender&filters=province%253D%253DUS-CA&sort=gender%252CageGroup&startDate=2023-09-01&endDate=2024-03-31&&ids=channel%253D%253DMINE">dimensions=ageGroup,gender metrics=viewerPercentage filters=province==US-CA sort=gender,ageGroup</a></code> </pre> <h3 id="channel-demographic-playlist-reports" data-text="Playlist reports" tabindex="-1">Playlist reports</h3> <h4 id="channel_state_playlist_demographics" data-text="Playlist viewer demographics in California (age group and gender)" tabindex="-1">Playlist viewer demographics in California (age group and gender)</h4> <p>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 U.S. state by adjusting the <code translate="no" dir="ltr">filters</code> parameter value.</p> <pre class="prettyprint query notranslate" dir="ltr"> <code translate="no" dir="ltr"><a href="https://developers.google.com/apis-explorer/#p/youtubeAnalytics/v2/youtubeAnalytics.reports.query?metrics=viewerPercentage&dimensions=ageGroup%252Cgender&filters=province%253D%253DUS-CA&sort=gender%252CageGroup&startDate=2023-09-01&endDate=2024-03-31&&ids=channel%253D%253DMINE">dimensions=ageGroup,gender metrics=viewerPercentage filters=province==US-CA sort=gender,ageGroup</a></code> </pre> </article> <article> <header id="channel-social-reports">Social</header> <h4 id="channel_sharing" data-text="Sharing metrics, aggregated by service where videos were shared" tabindex="-1">Sharing metrics, aggregated by service where videos were shared</h4> <p>This request retrieves the number of times that users used the <code translate="no" dir="ltr">Share</code> 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.</p> <pre class="prettyprint query notranslate" dir="ltr"> <code translate="no" dir="ltr"><a href="https://developers.google.com/apis-explorer/#p/youtubeAnalytics/v2/youtubeAnalytics.reports.query?metrics=shares&dimensions=sharingService&sort=-shares&startDate=2023-09-01&endDate=2024-03-31&&ids=channel%253D%253DMINE">dimensions=sharingService metrics=shares sort=-shares</a></code> </pre> </article> <article> <header id="channel-audience-retention-reports">Audience retention</header> <h4 id="channel_sharing" data-text="Audience retention metrics for a video" tabindex="-1">Audience retention metrics for a video</h4> <p>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 <code translate="no" dir="ltr">VIDEO_ID</code> in the <code translate="no" dir="ltr">filters</code> 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 <code translate="no" dir="ltr">video</code> filter.</p> <p>In this example, the report uses the <code translate="no" dir="ltr"><a href="/youtube/analytics/dimensions#audienceType">audienceType</a></code> 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.</p> <p>Note that data for the <code translate="no" dir="ltr">audienceType</code> 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.</p> <pre class="prettyprint query notranslate" dir="ltr"> <code translate="no" dir="ltr"><a href="https://developers.google.com/apis-explorer/#p/youtubeAnalytics/v2/youtubeAnalytics.reports.query?metrics=audienceWatchRatio%252CrelativeRetentionPerformance&dimensions=elapsedVideoTimeRatio&filters=video%253D%253DVIDEO_ID%253BaudienceType%253D%253DORGANIC&startDate=2023-09-01&endDate=2024-03-31&&ids=channel%253D%253DMINE">dimensions=elapsedVideoTimeRatio metrics=audienceWatchRatio,relativeRetentionPerformance filters=video==VIDEO_ID;audienceType==ORGANIC</a></code> </pre> </article> <article> <header id="channel-revenue-ads-reports">Revenue/Ads</header> <h4 id="channel_revenue" data-text="Channel revenue and ad performance metrics" tabindex="-1">Channel revenue and ad performance metrics</h4> <p>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.</p> <pre class="prettyprint query notranslate" dir="ltr"> <code translate="no" dir="ltr"><a href="https://developers.google.com/apis-explorer/#p/youtubeAnalytics/v2/youtubeAnalytics.reports.query?metrics=views%252CestimatedRevenue%252CestimatedAdRevenue%252CestimatedRedPartnerRevenue%252CgrossRevenue%252CadImpressions%252Ccpm%252CplaybackBasedCpm%252CmonetizedPlaybacks&startDate=2023-09-01&endDate=2024-03-31&&ids=channel%253D%253DMINE">metrics=views,estimatedRevenue,estimatedAdRevenue,estimatedRedPartnerRevenue,grossRevenue,adImpressions,cpm,playbackBasedCpm,monetizedPlaybacks</a></code> </pre> <h4 id="channel_daily_revenue" data-text="Daily revenue and ad performance metrics" tabindex="-1">Daily revenue and ad performance metrics</h4> <p>This request retrieves a channel's daily revenue and ad performance metrics.</p> <pre class="prettyprint query notranslate" dir="ltr"> <code translate="no" dir="ltr"><a href="https://developers.google.com/apis-explorer/#p/youtubeAnalytics/v2/youtubeAnalytics.reports.query?metrics=views%252CestimatedRevenue%252CestimatedAdRevenue%252CestimatedRedPartnerRevenue%252CgrossRevenue%252CadImpressions%252Ccpm%252CplaybackBasedCpm%252CmonetizedPlaybacks&dimensions=day&startDate=2023-09-01&endDate=2024-03-31&&ids=channel%253D%253DMINE">dimensions=day metrics=views,estimatedRevenue,estimatedAdRevenue,estimatedRedPartnerRevenue,grossRevenue,adImpressions,cpm,playbackBasedCpm,monetizedPlaybacks</a></code> </pre> <h4 id="channel_country_revenue" data-text="Country-specific revenue and ad performance metrics" tabindex="-1">Country-specific revenue and ad performance metrics</h4> <p>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.</p> <pre class="prettyprint query notranslate" dir="ltr"> <code translate="no" dir="ltr"><a href="https://developers.google.com/apis-explorer/#p/youtubeAnalytics/v2/youtubeAnalytics.reports.query?metrics=views%252CestimatedRevenue%252CestimatedAdRevenue%252CestimatedRedPartnerRevenue%252CgrossRevenue%252CadImpressions%252Ccpm%252CplaybackBasedCpm%252CmonetizedPlaybacks&dimensions=country&sort=-estimatedRevenue&startDate=2023-09-01&endDate=2024-03-31&&ids=channel%253D%253DMINE">dimensions=country metrics=views,estimatedRevenue,estimatedAdRevenue,estimatedRedPartnerRevenue,grossRevenue,adImpressions,cpm,playbackBasedCpm,monetizedPlaybacks sort=-estimatedRevenue</a></code> </pre> <h4 id="channel_top_10_videos_by_revenue" data-text="Top 10 – Videos with the highest revenue" tabindex="-1">Top 10 – Videos with the highest revenue</h4> <p>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.</p> <pre class="prettyprint query notranslate" dir="ltr"> <code translate="no" dir="ltr"><a href="https://developers.google.com/apis-explorer/#p/youtubeAnalytics/v2/youtubeAnalytics.reports.query?metrics=views%252CestimatedRevenue%252CestimatedAdRevenue%252CestimatedRedPartnerRevenue%252CgrossRevenue%252CadImpressions%252Ccpm%252CplaybackBasedCpm%252CmonetizedPlaybacks&dimensions=video&maxResults=10&sort=-estimatedRevenue&startDate=2023-09-01&endDate=2024-03-31&&ids=channel%253D%253DMINE">dimensions=video metrics=views,estimatedRevenue,estimatedAdRevenue,estimatedRedPartnerRevenue,grossRevenue,adImpressions,cpm,playbackBasedCpm,monetizedPlaybacks maxResults=10 sort=-estimatedRevenue</a></code> </pre> <h4 id="channel_ad_performance" data-text="Ad performance metrics for different ad types" tabindex="-1">Ad performance metrics for different ad types</h4> <p>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.</p> <pre class="prettyprint query notranslate" dir="ltr"> <code translate="no" dir="ltr"><a href="https://developers.google.com/apis-explorer/#p/youtubeAnalytics/v2/youtubeAnalytics.reports.query?metrics=grossRevenue%252CadImpressions%252Ccpm&dimensions=adType&filters=claimedStatus%253D%253Dclaimed&sort=-adType&startDate=2023-09-01&endDate=2024-03-31&&ids=channel%253D%253DMINE">dimensions=adType metrics=grossRevenue,adImpressions,cpm filters=claimedStatus==claimed sort=-adType</a></code> </pre> </article> </section> <h2 id="Content_Owner_Reports" data-text="Content owner reports" tabindex="-1">Content owner reports</h2> <section class="kd-tabbed-horz" id="content-owner-reports"> <article class="selected"> <header id="content-owner-basic-stats-reports">Basic stats</header> <h3 id="content-owner-basic-stats-video-reports" data-text="Video reports" tabindex="-1">Video reports</h3> <h4 id="content_owner_total_claimed_viewcounts" data-text="Total view counts, estimated watch time, and more for all claimed content" tabindex="-1">Total view counts, estimated watch time, and more for all claimed content</h4> <p>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.</p> <pre class="prettyprint query notranslate" dir="ltr"><code translate="no" dir="ltr"><a href="https://developers.google.com/apis-explorer/#p/youtubeAnalytics/v2/youtubeAnalytics.reports.query?metrics=views%252Ccomments%252Clikes%252Cdislikes%252CestimatedMinutesWatched%252CaverageViewDuration&filters=claimedStatus%253D%253Dclaimed&startDate=2023-09-01&endDate=2024-03-31&&ids=contentOwner%253D%253DCONTENT_OWNER_ID">metrics=views,comments,likes,dislikes,estimatedMinutesWatched,averageViewDuration filters=claimedStatus==claimed</a></code> </pre> <h4 id="content_owner_country_viewcounts" data-text="Country-specific view counts (and more) for all self-uploaded videos" tabindex="-1">Country-specific view counts (and more) for all self-uploaded videos</h4> <p>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.</p> <pre class="prettyprint query notranslate" dir="ltr"> <code translate="no" dir="ltr"><a href="https://developers.google.com/apis-explorer/#p/youtubeAnalytics/v2/youtubeAnalytics.reports.query?metrics=views%252Ccomments%252Clikes%252Cdislikes%252Cshares&filters=uploaderType%253D%253Dself%253Bcountry%253D%253DFR&startDate=2023-09-01&endDate=2024-03-31&&ids=contentOwner%253D%253DCONTENT_OWNER_ID">metrics=views,comments,likes,dislikes,shares filters=uploaderType==self;country==FR</a></code> </pre> <h4 id="content_owner_total_claimed_third_party_viewcounts" data-text="Total view counts (and more) for all claimed third-party content" tabindex="-1">Total view counts (and more) for all claimed third-party content</h4> <p>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.</p> <pre class="prettyprint query notranslate" dir="ltr"> <code translate="no" dir="ltr"><a href="https://developers.google.com/apis-explorer/#p/youtubeAnalytics/v2/youtubeAnalytics.reports.query?metrics=views%252Ccomments%252Clikes%252Cdislikes%252Cshares&filters=uploaderType%253D%253DthirdParty%253BclaimedStatus%253D%253Dclaimed&startDate=2023-09-01&endDate=2024-03-31&&ids=contentOwner%253D%253DCONTENT_OWNER_ID">metrics=views,comments,likes,dislikes,shares filters=uploaderType==thirdParty;claimedStatus==claimed</a></code> </pre> <h4 id="content_owner_total_uploaded_viewcounts" data-text="Total view counts (and more) for all self-uploaded content" tabindex="-1">Total view counts (and more) for all self-uploaded content</h4> <p>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.</p> <pre class="prettyprint query notranslate" dir="ltr"> <code translate="no" dir="ltr"><a href="https://developers.google.com/apis-explorer/#p/youtubeAnalytics/v2/youtubeAnalytics.reports.query?metrics=views%252Ccomments%252Clikes%252Cdislikes%252CestimatedMinutesWatched&filters=uploaderType%253D%253Dself&startDate=2023-09-01&endDate=2024-03-31&&ids=contentOwner%253D%253DCONTENT_OWNER_ID">metrics=views,comments,likes,dislikes,estimatedMinutesWatched filters=uploaderType==self</a></code> </pre> <h4 id="content_owner_total_claimed_uploaded_viewcounts" data-text="Total view counts (and more) for all claimed, self-uploaded content" tabindex="-1">Total view counts (and more) for all claimed, self-uploaded content</h4> <p>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.</p> <pre class="prettyprint query notranslate" dir="ltr"> <code translate="no" dir="ltr"><a href="https://developers.google.com/apis-explorer/#p/youtubeAnalytics/v2/youtubeAnalytics.reports.query?metrics=views%252Ccomments%252Clikes%252Cdislikes%252CestimatedMinutesWatched&filters=uploaderType%253D%253Dself%253BclaimedStatus%253D%253Dclaimed&startDate=2023-09-01&endDate=2024-03-31&&ids=contentOwner%253D%253DCONTENT_OWNER_ID">metrics=views,comments,likes,dislikes,estimatedMinutesWatched filters=uploaderType==self;claimedStatus==claimed</a></code> </pre> <h4 id="content_owner_10_most_viewed_videos" data-text="Top 10 – Most viewed videos for a content owner" tabindex="-1">Top 10 – Most viewed videos for a content owner</h4> <p>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.</p> <pre class="prettyprint query notranslate" dir="ltr"> <code translate="no" dir="ltr"><a href="https://developers.google.com/apis-explorer/#p/youtubeAnalytics/v2/youtubeAnalytics.reports.query?metrics=views%252CestimatedMinutesWatched%252CestimatedRevenue%252CestimatedAdRevenue%252CmonetizedPlaybacks%252CadImpressions&dimensions=video&filters=uploaderType%253D%253Dself&maxResults=10&sort=-views&startDate=2023-09-01&endDate=2024-03-31&&ids=contentOwner%253D%253DCONTENT_OWNER_ID">dimensions=video metrics=views,estimatedMinutesWatched,estimatedRevenue,estimatedAdRevenue,monetizedPlaybacks,adImpressions filters=uploaderType==self maxResults=10 sort=-views</a></code> </pre> <h4 id="content_owner_10_most_watched_videos" data-text="Top 10 – Most watched videos for a content owner" tabindex="-1">Top 10 – Most watched videos for a content owner</h4> <p>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.</p> <pre class="prettyprint query notranslate" dir="ltr"> <code translate="no" dir="ltr"><a href="https://developers.google.com/apis-explorer/#p/youtubeAnalytics/v2/youtubeAnalytics.reports.query?metrics=estimatedMinutesWatched%252CaverageViewDuration%252CaverageViewPercentage%252Cviews%252CsubscribersGained&dimensions=video&filters=uploaderType%253D%253Dself&maxResults=10&sort=-estimatedMinutesWatched&startDate=2023-09-01&endDate=2024-03-31&&ids=contentOwner%253D%253DCONTENT_OWNER_ID">dimensions=video metrics=estimatedMinutesWatched,averageViewDuration,averageViewPercentage,views,subscribersGained filters=uploaderType==self maxResults=10 sort=-estimatedMinutesWatched</a></code> </pre> <h4 id="content_owner_10_most_viewed_channel_videos" data-text="Top 10 – Most viewed videos for a content owner's channel" tabindex="-1">Top 10 – Most viewed videos for a content owner's channel</h4> <p>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 <code translate="no" dir="ltr">CHANNEL_ID</code> in the <code translate="no" dir="ltr">filters</code> parameter value with a comma-separated list of up to 500 channel IDs for your channels.</p> <pre class="prettyprint query notranslate" dir="ltr"> <code translate="no" dir="ltr"><a href="https://developers.google.com/apis-explorer/#p/youtubeAnalytics/v2/youtubeAnalytics.reports.query?metrics=views&dimensions=video&filters=channel%253D%253DCHANNEL_ID&maxResults=10&sort=-views&startDate=2023-09-01&endDate=2024-03-31&&ids=contentOwner%253D%253DCONTENT_OWNER_ID">dimensions=video metrics=views filters=channel==CHANNEL_ID maxResults=10 sort=-views</a></code> </pre> <h4 id="content_owner_top_10_videos_annotation_ctr" data-text="Top 10 – Annotation click-through rates for a channel's most viewed videos" tabindex="-1">Top 10 – Annotation click-through rates for a channel's most viewed videos</h4> <p>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 <code translate="no" dir="ltr">CHANNEL_ID</code> in the <code translate="no" dir="ltr">filters</code> parameter value with a comma-separated list of up to 500 channel IDs for your channels.</p> <pre class="prettyprint query notranslate" dir="ltr"> <code translate="no" dir="ltr"><a href="https://developers.google.com/apis-explorer/#p/youtubeAnalytics/v2/youtubeAnalytics.reports.query?metrics=views%252Clikes%252CannotationClickThroughRate%252CannotationCloseRate%252CannotationImpressions&dimensions=video&filters=channel%253D%253DCHANNEL_ID&maxResults=10&sort=-views&startDate=2023-09-01&endDate=2024-03-31&&ids=contentOwner%253D%253DCONTENT_OWNER_ID">dimensions=video metrics=views,likes,annotationClickThroughRate,annotationCloseRate,annotationImpressions filters=channel==CHANNEL_ID maxResults=10 sort=-views</a></code> </pre> <h3 id="content-owner-basic-stats-playlist-reports" data-text="Playlist reports" tabindex="-1">Playlist reports</h3> <h4 id="content_owner_playlist_views" data-text="Playlist views for a content owner's channels" tabindex="-1">Playlist views for a content owner's channels</h4> <p>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 <code translate="no" dir="ltr">playlistViews</code> 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 <a href="/youtube/analytics/v1/dimsmets/dims#playlist">playlist</a> or <a href="/youtube/analytics/v1/dimsmets/dims#group">group</a> filter.</p> <pre class="prettyprint query notranslate" dir="ltr"> <code translate="no" dir="ltr"><a href="https://developers.google.com/apis-explorer/#p/youtubeAnalytics/v2/youtubeAnalytics.reports.query?metrics=playlistStarts%252CplaylistEstimatedMinutesWatched%252CplaylistViews%252CviewsPerPlaylistStart&startDate=2023-09-01&endDate=2024-03-31&&ids=contentOwner%253D%253DCONTENT_OWNER_ID">metrics=playlistViews,playlistStarts,playlistEstimatedMinutesWatched,viewsPerPlaylistStart</a></code> </pre> <h4 id="content_owner_playlist_views" data-text="Statistics for a specific playlist" tabindex="-1">Statistics for a specific playlist</h4> <p>This request retrieves total playlist starts, estimated minutes watched, views (an <a href="/youtube/analytics/content_owner_reports#aggregated-video-metrics">aggregated video metric</a>), playlist views (an <a href="/youtube/analytics/content_owner_reports#in-playlist-metrics">in-playlist</a> 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 <code translate="no" dir="ltr">PLAYLIST_ID</code> in the <code translate="no" dir="ltr">filters</code> parameter value with the playlist ID for a playlist in one of the content owner's channels.</p> <pre class="prettyprint query notranslate" dir="ltr"> <code translate="no" dir="ltr"><a href="https://developers.google.com/apis-explorer/#p/youtubeAnalytics/v2/youtubeAnalytics.reports.query?metrics=views%252CestimatedMinutesWatched%252CplaylistStarts%252CplaylistViews%252CviewsPerPlaylistStart&filters=playlist%253D%253DPLAYLIST_ID&startDate=2023-09-01&endDate=2024-03-31&&ids=contentOwner%253D%253DCONTENT_OWNER_ID">metrics=views,estimatedMinutesWatched,playlistStarts,playlistViews,viewsPerPlaylistStart filters=playlist==PLAYLIST_ID</a></code> </pre> <p>To retrieve aggregate statistics for multiple playlists, you can also replace the string <code translate="no" dir="ltr">PLAYLIST_ID</code> with a comma-separated list of up to 500 playlists IDs for playlists in the content owner's channels.</p> </article> <article> <header id="content-owner-time-based-reports">Time-based</header> <h3 id="content-owner-time-based-video-reports" data-text="Video reports" tabindex="-1">Video reports</h3> <h4 id="content_owner_daily_watchtime" data-text="Daily watch time metrics for self-uploaded content" tabindex="-1">Daily watch time metrics for self-uploaded content</h4> <p>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.</p> <pre class="prettyprint query notranslate" dir="ltr"> <code translate="no" dir="ltr"><a href="https://developers.google.com/apis-explorer/#p/youtubeAnalytics/v2/youtubeAnalytics.reports.query?metrics=estimatedMinutesWatched%252CaverageViewPercentage%252Cviews%252CmonetizedPlaybacks%252CadImpressions&dimensions=day&filters=uploaderType%253D%253Dself&sort=day&startDate=2023-09-01&endDate=2024-03-31&&ids=contentOwner%253D%253DCONTENT_OWNER_ID">dimensions=day metrics=estimatedMinutesWatched,averageViewPercentage,views,monetizedPlaybacks,adImpressions filters=uploaderType==self sort=day</a></code> </pre> <h4 id="content_owner_annotations" data-text="Annotation metrics for claimed content" tabindex="-1">Annotation metrics for claimed content</h4> <p>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.</p> <pre class="prettyprint query notranslate" dir="ltr"> <code translate="no" dir="ltr"><a href="https://developers.google.com/apis-explorer/#p/youtubeAnalytics/v2/youtubeAnalytics.reports.query?metrics=views%252CannotationClickThroughRate%252CannotationCloseRate%252CannotationImpressions&dimensions=day&filters=claimedStatus%253D%253Dclaimed&sort=day&startDate=2023-09-01&endDate=2024-03-31&&ids=contentOwner%253D%253DCONTENT_OWNER_ID">dimensions=day metrics=views,likes,annotationClickThroughRate,annotationCloseRate,annotationImpressions filters=claimedStatus==claimed sort=day</a></code> </pre> <h3 id="content-owner-time-based-playlist-reports" data-text="Playlist reports" tabindex="-1">Playlist reports</h3> <h4 id="content_owner_daily_playlist_views" data-text="Daily playlist views for a content owner" tabindex="-1">Daily playlist views for a content owner</h4> <p>This request retrieves metrics for daily user interactions with videos in the content owner's playlists. The metrics retrieved in the report are <a href="/youtube/analytics/v1/dimsmets/mets#playlistViews">playlistViews</a>, <a href="/youtube/analytics/v1/dimsmets/mets#playlistStarts">playlistStarts</a>, <a href="/youtube/analytics/v1/dimsmets/mets#playlistEstimatedMinutesWatched">playlistEstimatedMinutesWatched</a>, and <a href="/youtube/analytics/v1/dimsmets/mets#viewsPerPlaylistStart">viewsPerPlaylistStart</a>. All of these metrics are <a href="/youtube/analytics/channel_reports#in-playlist-metrics">in-playlist</a> metrics. Since all of the requested metrics are in-playlist metrics, the request does not need to also include the <a href="/youtube/analytics/v1/dimsmets/dims#playlist">playlist</a> or <a href="/youtube/analytics/v1/dimsmets/dims#group">group</a> filter.</p> <pre class="prettyprint query notranslate" dir="ltr"> <code translate="no" dir="ltr"><a href="https://developers.google.com/apis-explorer/#p/youtubeAnalytics/v2/youtubeAnalytics.reports.query?metrics=playlistViews%252CplaylistEstimatedMinutesWatched%252CplaylistStarts%252CviewsPerPlaylistStart&dimensions=day&sort=day&startDate=2023-09-01&endDate=2024-03-31&&ids=contentOwner%253D%253DCONTENT_OWNER_ID">dimensions=day metrics=playlistViews,playlistStarts,playlistEstimatedMinutesWatched,viewsPerPlaylistStart sort=day</a></code> </pre> </article> <article> <header id="content-owner-geographic-reports">Geographic</header> <h3 id="content-owner-geographic-video-reports" data-text="Video reports" tabindex="-1">Video reports</h3> <h4 id="content_owner_country_watchtime" data-text="Country-specific watch time metrics for self-uploaded content" tabindex="-1">Country-specific watch time metrics for self-uploaded content</h4> <p>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.</p> <pre class="prettyprint query notranslate" dir="ltr"> <code translate="no" dir="ltr"><a href="https://developers.google.com/apis-explorer/#p/youtubeAnalytics/v2/youtubeAnalytics.reports.query?metrics=views%252CestimatedMinutesWatched%252CaverageViewDuration%252CaverageViewPercentage%252CestimatedRevenue%252CestimatedAdRevenue%252CgrossRevenue&dimensions=country&filters=uploaderType%253D%253Dself&sort=-estimatedMinutesWatched&startDate=2023-09-01&endDate=2024-03-31&&ids=contentOwner%253D%253DCONTENT_OWNER_ID">dimensions=country metrics=views,estimatedMinutesWatched,averageViewDuration,averageViewPercentage,estimatedRevenue,estimatedAdRevenue,grossRevenue filters=uploaderType==self sort=-estimatedMinutesWatched</a></code> </pre> <h4 id="content_owner_country_annotations" data-text="Country-specific annotation metrics for self-uploaded content" tabindex="-1">Country-specific annotation metrics for self-uploaded content</h4> <p>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.</p> <pre class="prettyprint query notranslate" dir="ltr"> <code translate="no" dir="ltr"><a href="https://developers.google.com/apis-explorer/#p/youtubeAnalytics/v2/youtubeAnalytics.reports.query?metrics=views%252CannotationClickThroughRate%252CannotationCloseRate%252CannotationImpressions&dimensions=country&filters=uploaderType%253D%253Dself&sort=-annotationClickThroughRate&startDate=2023-09-01&endDate=2024-03-31&&ids=contentOwner%253D%253DCONTENT_OWNER_ID">dimensions=country metrics=views,likes,annotationClickThroughRate,annotationCloseRate,annotationImpressions filters=uploaderType==self sort=-annotationClickThroughRate</a></code> </pre> <h4 id="content_owner_province_statistics" data-text="Province-specific metrics for U.S. states and Washington D.C." tabindex="-1">Province-specific metrics for U.S. states and Washington D.C.</h4> <p>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 U.S. states and Washington D.C. Results are sorted alphabetically by provinces' ISO 3166-2 codes</a>.</p> <pre class="prettyprint query notranslate" dir="ltr"> <code translate="no" dir="ltr"><a href="https://developers.google.com/apis-explorer/#p/youtubeAnalytics/v2/youtubeAnalytics.reports.query?metrics=views%252CestimatedMinutesWatched%252CaverageViewDuration&dimensions=province&filters=claimedStatus%253D%253Dclaimed%253Bcountry%253D%253DUS&sort=province&startDate=2023-09-01&endDate=2024-03-31&&ids=contentOwner%253D%253DCONTENT_OWNER_ID">dimensions=province metrics=views,estimatedMinutesWatched,averageViewDuration filters=claimedStatus==claimed;country==US sort=province</a></code> </pre> <h4 id="content_owner_top_10_us_cities_by_views" data-text="Top 10 U.S. cities by total views" tabindex="-1">Top 10 U.S. cities by total views</h4> <p>This query retrieves a list of the 10 U.S. 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 <a href="/youtube/analytics/v1/dimsmets/dims#country">country</a> 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 <a href="/youtube/analytics/v1/dimsmets/dims#subContinent">subContinent</a> filter and one of its valid values. Other filters are supported, too. Results are sorted by view count in descending order.</p> <pre class="prettyprint query notranslate" dir="ltr"> <code translate="no" dir="ltr"><a href="https://developers.google.com/apis-explorer/#p/youtubeAnalytics/v2/youtubeAnalytics.reports.query?metrics=views&dimensions=city&maxResults=10&filters=claimedStatus%253D%253Dclaimed%253Bcountry%253D%253DUS&sort=-views&startDate=2023-09-01&endDate=2024-03-31&&ids=channel%253D%253DMINE">dimensions=city metrics=views filters=claimedStatus==claimed;country==US maxResults=10 sort=-views</a></code> </pre> <h4 id="content_owner_top_10_us_cities_by_content_type" data-text="Top 10 U.S. cities by total views for each content type" tabindex="-1">Top 10 U.S. cities by total views for each content type</h4> <p>This query retrieves a list of the 10 U.S. cities that accounted for the most views of the content owner's claimed content during the specified date range for each supported <a href="/youtube/analytics/v1/dimsmets/dims#creatorContentType">creatorContentType</a>. Results are sorted by view count in descending order.</p> <pre class="prettyprint query notranslate" dir="ltr"> <code translate="no" dir="ltr"><a href="https://developers.google.com/apis-explorer/#p/youtubeAnalytics/v2/youtubeAnalytics.reports.query?metrics=views&dimensions=city%252CcreatorContentType&maxResults=10&filters=claimedStatus%253D%253Dclaimed%253Bcountry%253D%253DUS&sort=-views&startDate=2023-09-01&endDate=2024-03-31&&ids=channel%253D%253DMINE">dimensions=city,creatorContentType metrics=views filters=claimedStatus==claimed;country==US maxResults=10 sort=-views</a></code> </pre> <h4 id="content_owner_top_10_us_cities_by_day" data-text="Top 10 U.S. cities by total watch time" tabindex="-1">Top 10 U.S. cities by total watch time</h4> <p>This query retrieves a list of the top 10 days during the specified date range when any U.S. 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.</p> <pre class="prettyprint query notranslate" dir="ltr"> <code translate="no" dir="ltr"><a href="https://developers.google.com/apis-explorer/#p/youtubeAnalytics/v2/youtubeAnalytics.reports.query?metrics=estimatedWatchTime&dimensions=city%252Cday&maxResults=10&filters=claimedStatus%253D%253Dclaimed%253Bcountry%253D%253DUS&sort=-estimatedWatchTime&startDate=2023-09-01&endDate=2024-03-31&&ids=channel%253D%253DMINE">dimensions=city,day metrics=estimatedWatchTime filters=claimedStatus==claimed;country==US maxResults=10 sort=-estimatedWatchTime</a></code> </pre> <h4 id="content_owner_10_most_viewed_in_continent" data-text="Top 10 – Most watched videos in Europe" tabindex="-1">Top 10 – Most watched videos in Europe</h4> <p>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 <a href="/youtube/analytics/v1/dimsmets/dims#continent">continent</a> 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 <a href="/youtube/analytics/v1/dimsmets/dims#subContinent">subContinent</a> filter and one of its valid values. Results are sorted by view count in descending order.</p> <pre class="prettyprint query notranslate" dir="ltr"> <code translate="no" dir="ltr"><a href="https://developers.google.com/apis-explorer/#p/youtubeAnalytics/v2/youtubeAnalytics.reports.query?metrics=views%252CestimatedMinutesWatched%252Clikes%252CsubscribersGained&dimensions=video&maxResults=10&filters=claimedStatus%253D%253Dclaimed%253Bcontinent%253D%253D150&sort=-estimatedMinutesWatched&startDate=2023-09-01&endDate=2024-03-31&&ids=channel%253D%253DMINE">dimensions=video metrics=views,estimatedMinutesWatched,likes,subscribersGained filters=claimedStatus==claimed;filters=continent==150 maxResults=10 sort=-estimatedMinutesWatched</a></code> </pre> <h3 id="content-owner-geographic-playlist-reports" data-text="Playlist reports" tabindex="-1">Playlist reports</h3> <h4 id="content_owner_playlist_watchtime_by_country" data-text="Country-specific watch time metrics for a content owner's playlists" tabindex="-1">Country-specific watch time metrics for a content owner's playlists</h4> <p>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.</p> <pre class="prettyprint query notranslate" dir="ltr"> <code translate="no" dir="ltr"><a href="https://developers.google.com/apis-explorer/#p/youtubeAnalytics/v2/youtubeAnalytics.reports.query?metrics=playlistViews%252CplaylistEstimatedMinutesWatched%252CaverageTimeInPlaylist%252CplaylistStarts&dimensions=country&&sort=-playlistEstimatedMinutesWatched&startDate=2023-09-01&endDate=2024-03-31&&ids=contentOwner%253D%253DCONTENT_OWNER_ID">dimensions=country metrics=playlistViews,playlistEstimatedMinutesWatched,playlistStarts,averageTimeInPlaylist sort=-playlistEstimatedMinutesWatched</a></code> </pre> <h4 id="content_owner_10_most_started_playlists" data-text="Top 10 – Most started playlists in the United States" tabindex="-1">Top 10 – Most started playlists in the United States</h4> <p>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.</p> <p class="note"><strong>Note:</strong> Since this report uses the <code translate="no" dir="ltr"><a href="/youtube/analytics/dimensions#playlist">playlist</a></code> dimension, you must specify a value for the <code translate="no" dir="ltr">sort</code> request parameter and also set th <code translate="no" dir="ltr">maxResults</code> parameter to an integer value of <code translate="no" dir="ltr">10</code> or less.</p> <pre class="prettyprint query notranslate" dir="ltr"> <code translate="no" dir="ltr"><a href="https://developers.google.com/apis-explorer/#p/youtubeAnalytics/v2/youtubeAnalytics.reports.query?metrics=playlistStarts%252CplaylistViews%252CplaylistEstimatedMinutesWatched%252CplaylistAverageViewDuration&dimensions=playlist&filters=country%253D%253DUS&maxResults=10&sort=-playlistStarts&startDate=2023-09-01&endDate=2024-03-31&&ids=contentOwner%253D%253DCONTENT_OWNER_ID">dimensions=playlist metrics=playlistStarts,playlistViews,playlistEstimatedMinutesWatched,playlistAverageViewDuration filters=country==US maxResults=10 sort=-playlistStarts</a></code> </pre> </article> <article> <header id="content-owner-playback-details-reports">Playback details</header> <h3 id="content-owner-playback-details-video-reports" data-text="Video reports" tabindex="-1">Video reports</h3> <h4 id="content_owner_playback_details_content_type" data-text="Likes and dislikes by content type" tabindex="-1">Likes and dislikes by content type</h4> <p>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 <code translate="no" dir="ltr">CHANNEL_ID</code> in the <code translate="no" dir="ltr">filters</code> parameter value with a comma-separated list of up to 500 channel IDs for your channels.</p> <pre class="prettyprint query notranslate" dir="ltr"> <code translate="no" dir="ltr"><a href="https://developers.google.com/apis-explorer/#p/youtubeAnalytics/v2/youtubeAnalytics.reports.query?metrics=likes%dislikes&dimensions=creatorContentType&filters=channel%253D%253DCHANNEL_ID&startDate=2023-09-01&endDate=2024-03-31&&ids=contentOwner%253D%253DCONTENT_OWNER_ID">dimensions=creatorContentType metrics=likes,dislikes filters=channel==CHANNEL_ID</a></code> </pre> </article> <article> <header id="content-owner-playback-location-reports">Playback location</header> <h3 id="content-owner-playback-location-video-reports" data-text="Video reports" tabindex="-1">Video reports</h3> <h4 id="content_owner_playback_locations" data-text="Viewcounts and watch time from different playback locations" tabindex="-1">Viewcounts and watch time from different playback locations</h4> <p>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 <code translate="no" dir="ltr">CHANNEL_ID</code> in the <code translate="no" dir="ltr">filters</code> parameter value with a comma-separated list of up to 500 channel IDs for your channels.</p> <pre class="prettyprint query notranslate" dir="ltr"> <code translate="no" dir="ltr"><a href="https://developers.google.com/apis-explorer/#p/youtubeAnalytics/v2/youtubeAnalytics.reports.query?metrics=estimatedMinutesWatched%252Cviews&dimensions=insightPlaybackLocationType&filters=channel%253D%253DCHANNEL_ID&sort=-views&startDate=2023-09-01&endDate=2024-03-31&&ids=contentOwner%253D%253DCONTENT_OWNER_ID">dimensions=insightPlaybackLocationType metrics=estimatedMinutesWatched,views filters=channel==CHANNEL_ID sort=-views</a></code> </pre> <h4 id="content_owner_daily_playback_locations" data-text="Daily view counts and watch time from different playback locations" tabindex="-1">Daily view counts and watch time from different playback locations</h4> <p>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 <code translate="no" dir="ltr">CHANNEL_ID</code> in the <code translate="no" dir="ltr">filters</code> parameter value with a comma-separated list of up to 500 channel IDs for your channels.</p> <pre class="prettyprint query notranslate" dir="ltr"> <code translate="no" dir="ltr"><a href="https://developers.google.com/apis-explorer/#p/youtubeAnalytics/v2/youtubeAnalytics.reports.query?metrics=estimatedMinutesWatched%252Cviews&dimensions=day%252CinsightPlaybackLocationType&filters=country==US%253Bchannel%253D%253DCHANNEL_ID&sort=-day&startDate=2023-09-01&endDate=2024-03-31&&ids=contentOwner%253D%253DCONTENT_OWNER_ID">dimensions=day,insightPlaybackLocationType metrics=estimatedMinutesWatched,views filters=country==US;channel==CHANNEL_ID sort=-day</a></code> </pre> <h4 id="content_owner_top_10_third_party_sites" data-text="Top 10 – Third-party sites that generate the most views for an embedded video" tabindex="-1">Top 10 – Third-party sites that generate the most views for an embedded video</h4> <p>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 <code translate="no" dir="ltr">VIDEO_ID</code> in the <code translate="no" dir="ltr">filters</code> parameter value with a comma-separated list of up to 500 video IDs for your uploaded videos.</p> <pre class="prettyprint query notranslate" dir="ltr"> <code translate="no" dir="ltr"><a href="https://developers.google.com/apis-explorer/#p/youtubeAnalytics/v2/youtubeAnalytics.reports.query?metrics=views%252CestimatedMinutesWatched&dimensions=insightPlaybackLocationDetail&filters=video%253D%253DVIDEO_ID%253BinsightPlaybackLocationType%253D%253DEMBEDDED&maxResults=10&sort=-views&startDate=2023-09-01&endDate=2024-03-31&&ids=contentOwner%253D%253DCONTENT_OWNER_ID">dimensions=insightPlaybackLocationDetail metrics=views,estimatedMinutesWatched filters=video==VIDEO_ID;insightPlaybackLocationType==EMBEDDED maxResults=10 sort=-views</a></code> </pre> <h3 id="content-owner-playback-location-playlist-reports" data-text="Playlist reports" tabindex="-1">Playlist reports</h3> <h4 id="content_owner_playlist_playback_locations" data-text="Playlist view counts and watch time from different playback locations" tabindex="-1">Playlist view counts and watch time from different playback locations</h4> <p>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.</p> <pre class="prettyprint query notranslate" dir="ltr"> <code translate="no" dir="ltr"><a href="https://developers.google.com/apis-explorer/#p/youtubeAnalytics/v2/youtubeAnalytics.reports.query?metrics=playlistViews%252CplaylistEstimatedMinutesWatched%252CplaylistStarts&dimensions=insightPlaybackLocationType&sort=-playlistStarts&startDate=2023-09-01&endDate=2024-03-31&&ids=contentOwner%253D%253DCONTENT_OWNER_ID">dimensions=insightPlaybackLocationType metrics=playlistViews,playlistEstimatedMinutesWatched,playlistStarts sort=-playlistStarts</a></code> </pre> <h4 id="content_owner_daily_playlist_playback_locations" data-text="Playlist view counts and watch time from different playback locations" tabindex="-1">Playlist view counts and watch time from different playback locations</h4> <p>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.</p> <pre class="query notranslate" dir="ltr"> <a href="https://developers.google.com/apis-explorer/#p/youtubeAnalytics/v2/youtubeAnalytics.reports.query?metrics=playlistStarts%252CplaylistViews%252CplaylistEstimatedMinutesWatched&dimensions=insightPlaybackLocationType&filters=country%253D%253DUS&startDate=2023-09-01&endDate=2024-03-31&&ids=contentOwner%253D%253DCONTENT_OWNER_ID">dimensions=day,insightPlaybackLocationType metrics=playlistStarts,playlistViews,playlistEstimatedMinutesWatched filters=country==US</a> </pre> </article> <article> <header id="content-owner-traffic-source-reports">Traffic source</header> <h3 id="content-owner-traffic-source-video-reports" data-text="Video reports" tabindex="-1">Video reports</h3> <h4 id="content_owner_traffic_sources" data-text="Viewcounts and watch time from different traffic sources" tabindex="-1">Viewcounts and watch time from different traffic sources</h4> <p>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.</p> <pre class="prettyprint query notranslate" dir="ltr"> <code translate="no" dir="ltr"><a href="https://developers.google.com/apis-explorer/#p/youtubeAnalytics/v2/youtubeAnalytics.reports.query?metrics=views%252CestimatedMinutesWatched&dimensions=insightTrafficSourceType&filters=uploaderType%253D%253Dself&startDate=2023-09-01&endDate=2024-03-31&&ids=contentOwner%253D%253DCONTENT_OWNER_ID">dimensions=insightTrafficSourceType metrics=views,estimatedMinutesWatched filters=uploaderType==self</a></code> </pre> <h4 id="content_owner_daily_traffic_sources" data-text="Daily view counts and watch time from different traffic sources" tabindex="-1">Daily view counts and watch time from different traffic sources</h4> <p>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.</p> <pre class="prettyprint query notranslate" dir="ltr"> <code translate="no" dir="ltr"><a href="https://developers.google.com/apis-explorer/#p/youtubeAnalytics/v2/youtubeAnalytics.reports.query?metrics=views%252CestimatedMinutesWatched&dimensions=day%252CinsightTrafficSourceType&filters=uploaderType%253D%253Dself&sort=-day&startDate=2023-09-01&endDate=2024-03-31&&ids=contentOwner%253D%253DCONTENT_OWNER_ID">dimensions=day,insightTrafficSourceType metrics=views,estimatedMinutesWatched filters=uploaderType==self sort=-day</a></code> </pre> <p class="note"><strong>Note:</strong> The next two sample reports are only supported for specific traffic sources. <code translate="no" dir="ltr"><strong>VIDEO_REMIXES</strong></code>, <code translate="no" dir="ltr"><strong>NOTIFICATION</strong></code>, <code translate="no" dir="ltr"><strong>END_SCREEN</strong></code>, <code translate="no" dir="ltr"><strong>CAMPAIGN_CARD</strong></code>, <code translate="no" dir="ltr"><strong>VIDEO_REMIXES</strong></code>, and <code translate="no" dir="ltr"><strong>NO_LINK_EMBEDDED</strong></code> traffic sources are some of the unsupported ones.</p> <h4 id="content_owner_top_10_YT_search_terms" data-text="Top 10 – YouTube search terms that generate the most traffic for a video" tabindex="-1">Top 10 – YouTube search terms that generate the most traffic for a video</h4> <p>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 <code translate="no" dir="ltr">VIDEO_ID</code> in the <code translate="no" dir="ltr">filters</code> parameter value with a comma-separated list of up to 500 video IDs for your uploaded videos.</p> <pre class="prettyprint query notranslate" dir="ltr"> <code translate="no" dir="ltr"><a href="https://developers.google.com/apis-explorer/#p/youtubeAnalytics/v2/youtubeAnalytics.reports.query?metrics=views&dimensions=insightTrafficSourceDetail&filters=video%253D%253DVIDEO_ID%253BinsightTrafficSourceType%253D%253DYT_SEARCH&maxResults=10&sort=-views&startDate=2023-09-01&endDate=2024-03-31&&ids=contentOwner%253D%253DCONTENT_OWNER_ID">dimensions=insightTrafficSourceDetail metrics=views filters=video==VIDEO_ID;insightTrafficSourceType==YT_SEARCH maxResults=10 sort=-views</a></code> </pre> <h4 id="content_owner_top_10_Google_search_terms" data-text="Top 10 – External websites that generate the most traffic for a video" tabindex="-1">Top 10 – External websites that generate the most traffic for a video</h4> <p>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 <code translate="no" dir="ltr">VIDEO_ID</code> in the <code translate="no" dir="ltr">filters</code> parameter value with a comma-separated list of up to 500 video IDs for your uploaded videos.</p> <pre class="prettyprint query notranslate" dir="ltr"> <code translate="no" dir="ltr"><a href="https://developers.google.com/apis-explorer/#p/youtubeAnalytics/v2/youtubeAnalytics.reports.query?metrics=estimatedMinutesWatched%252Cviews&dimensions=insightTrafficSourceDetail&filters=video%253D%253DVIDEO_ID%253BinsightTrafficSourceType%253D%253DEXT_URL&maxResults=25&sort=-estimatedMinutesWatched&startDate=2023-09-01&endDate=2024-03-31&&ids=contentOwner%253D%253DCONTENT_OWNER_ID">dimensions=insightTrafficSourceDetail metrics=estimatedMinutesWatched,views filters=video==VIDEO_ID;insightTrafficSourceType==EXT_URL maxResults=25 sort=-estimatedMinutesWatched</a></code> </pre> <h3 id="content-owner-traffic-source-playlist-reports" data-text="Playlist reports" tabindex="-1">Playlist reports</h3> <h4 id="content_owner_playlist_traffic_sources" data-text="Playlist view counts and watch time from different traffic sources in a country" tabindex="-1">Playlist view counts and watch time from different traffic sources in a country</h4> <p>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.</p> <pre class="prettyprint query notranslate" dir="ltr"> <code translate="no" dir="ltr"><a href="https://developers.google.com/apis-explorer/#p/youtubeAnalytics/v2/youtubeAnalytics.reports.query?metrics=playlistViews%252CplaylistStarts%252CplaylistEstimatedMinutesWatched&dimensions=insightTrafficSourceType&filters=country%253D%253DUS&startDate=2023-09-01&endDate=2024-03-31&&ids=contentOwner%253D%253DCONTENT_OWNER_ID">dimensions=insightTrafficSourceType metrics=playlistViews,playlistStarts,playlistEstimatedMinutesWatched filters=country==US</a></code> </pre> <h4 id="content_owner_daily_playlist_traffic_sources" data-text="Playlist view counts and watch time from different traffic sources" tabindex="-1">Playlist view counts and watch time from different traffic sources</h4> <p>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 <code translate="no" dir="ltr">CHANNEL_ID</code> in the <code translate="no" dir="ltr">filters</code> parameter value with a comma-separated list of up to 500 channel IDs for your channels.</p> <pre class="prettyprint query notranslate" dir="ltr"> <code translate="no" dir="ltr"><a href="https://developers.google.com/apis-explorer/#p/youtubeAnalytics/v2/youtubeAnalytics.reports.query?metrics=playlistViews%252CplaylistStarts%252CplaylistEstimatedMinutesWatched&dimensions=insightTrafficSourceType&filters=channel%253D%253DCHANNEL_ID&startDate=2023-09-01&endDate=2024-03-31&&ids=contentOwner%253D%253DCONTENT_OWNER_ID">dimensions=day,insightTrafficSourceType metrics=playlistViews,playlistStarts,playlistEstimatedMinutesWatched filters=channel==CHANNEL_ID</a></code> </pre> </article> <article> <header id="content-owner-device-os-reports">Device/OS</header> <h3 id="content-owner-device-os-video-reports" data-text="Video reports" tabindex="-1">Video reports</h3> <h4 id="content_owner_device_types" data-text="Daily device type metrics for claimed videos" tabindex="-1">Daily device type metrics for claimed videos</h4> <p>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.</p> <pre class="prettyprint query notranslate" dir="ltr"> <code translate="no" dir="ltr"><a href="https://developers.google.com/apis-explorer/#p/youtubeAnalytics/v2/youtubeAnalytics.reports.query?metrics=estimatedMinutesWatched%252Cviews&dimensions=day%252CdeviceType&filters=claimedStatus%253D%253Dclaimed&sort=day&startDate=2023-09-01&endDate=2024-03-31&&ids=contentOwner%253D%253DCONTENT_OWNER_ID">dimensions=day,deviceType metrics=estimatedMinutesWatched,views filters=claimedStatus==claimed sort=day</a></code> </pre> <h4 id="content_owner_operating_systems" data-text="Daily operating system metrics for claimed videos viewed on mobile devices" tabindex="-1">Daily operating system metrics for claimed videos viewed on mobile devices</h4> <p>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.</p> <pre class="prettyprint query notranslate" dir="ltr"> <code translate="no" dir="ltr"><a href="https://developers.google.com/apis-explorer/#p/youtubeAnalytics/v2/youtubeAnalytics.reports.query?metrics=estimatedMinutesWatched%252Cviews&dimensions=day%252CoperatingSystem&filters=claimedStatus%253D%253Dclaimed%253BdeviceType%253D%253DMOBILE&sort=day&startDate=2023-09-01&endDate=2024-03-31&&ids=contentOwner%253D%253DCONTENT_OWNER_ID">dimensions=day,operatingSystem metrics=estimatedMinutesWatched,views filters=claimedStatus==claimed;deviceType==MOBILE sort=day</a></code> </pre> <h4 id="content_owner_daily_operating_system_device_type" data-text="Daily operating system and device type metrics" tabindex="-1">Daily operating system and device type metrics</h4> <p>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.</p> <pre class="prettyprint query notranslate" dir="ltr"> <code translate="no" dir="ltr"><a href="https://developers.google.com/apis-explorer/#p/youtubeAnalytics/v2/youtubeAnalytics.reports.query?metrics=estimatedMinutesWatched%252Cviews&dimensions=day%252CoperatingSystem%252CdeviceType&filters=claimedStatus%253D%253Dclaimed&sort=day&startDate=2023-09-01&endDate=2024-03-31&&ids=contentOwner%253D%253DCONTENT_OWNER_ID">dimensions=day,operatingSystem,deviceType metrics=estimatedMinutesWatched,views sort=day</a></code> </pre> <h3 id="content-owner-device-os-playlist-reports" data-text="Playlist reports" tabindex="-1">Playlist reports</h3> <h4 id="content_owner_daily_playlist_device_types" data-text="Device type metrics for playlist views on the Android operating system" tabindex="-1">Device type metrics for playlist views on the Android operating system</h4> <p>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 <code translate="no" dir="ltr">CHANNEL_ID</code> in the <code translate="no" dir="ltr">filters</code> parameter value with a comma-separated list of up to 500 channel IDs for your channels.</p> <pre class="prettyprint query notranslate" dir="ltr"> <code translate="no" dir="ltr"><a href="https://developers.google.com/apis-explorer/#p/youtubeAnalytics/v2/youtubeAnalytics.reports.query?metrics=playlistEstimatedMinutesWatched%252CplaylistViews&dimensions=deviceType&filters=channel%253D%253DCHANNEL_ID%253BoperatingSystem%253D%253DANDROID&startDate=2023-09-01&endDate=2024-03-31&&ids=contentOwner%253D%253DCONTENT_OWNER_ID">dimensions=deviceType metrics=playlistViews,playlistEstimatedMinutesWatched filters=channel==CHANNEL_ID;operatingSystem==ANDROID</a></code> </pre> <h4 id="content_owner_daily_playlist_operating_system" data-text="Operating system metrics for playlist views on mobile devices" tabindex="-1">Operating system metrics for playlist views on mobile devices</h4> <p>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.</p> <pre class="prettyprint query notranslate" dir="ltr"> <code translate="no" dir="ltr"><a href="https://developers.google.com/apis-explorer/#p/youtubeAnalytics/v2/youtubeAnalytics.reports.query?metrics=playlistEstimatedMinutesWatched%252CplaylistViews&dimensions=operatingSystem&filters=isCurated%253D%253D1%253BdeviceType%253D%253DMOBILE&startDate=2023-09-01&endDate=2024-03-31&&ids=contentOwner%253D%253DCONTENT_OWNER_ID">dimensions=operatingSystem metrics=views,estimatedMinutesWatched filters=deviceType==MOBILE</a></code> </pre> </article> <article> <header id="content-owner-demographic-reports">Demographic</header> <h3 id="content-owner-demographic-video-reports" data-text="Video reports" tabindex="-1">Video reports</h3> <h4 id="content-owner-playlist-viewer-demographics" data-text="Viewer demographics in California (age group and gender)" tabindex="-1">Viewer demographics in California (age group and gender)</h4> <p>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 U.S. state by adjusting the <code translate="no" dir="ltr">filters</code> parameter value.</p> <pre class="prettyprint query notranslate" dir="ltr"> <code translate="no" dir="ltr"><a href="https://developers.google.com/apis-explorer/#p/youtubeAnalytics/v2/youtubeAnalytics.reports.query?metrics=viewerPercentage&dimensions=ageGroup%252Cgender&filters=claimedStatus%253D%253Dclaimed%253Bprovince%253D%253DUS-CA&sort=gender%252CageGroup&startDate=2023-09-01&endDate=2024-03-31&&ids=contentOwner%253D%253DCONTENT_OWNER_ID">dimensions=ageGroup,gender metrics=viewerPercentage filters=claimedStatus==claimed;province==US-CA sort=gender,ageGroup</a></code> </pre> </article> <article> <header id="content-owner-social-reports">Social</header> <h4 id="content_owner_sharing" data-text="Sharing metrics, aggregated by service where videos were shared" tabindex="-1">Sharing metrics, aggregated by service where videos were shared</h4> <p>This request retrieves the number of times that users used the <code translate="no" dir="ltr">Share</code> 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.</p> <pre class="prettyprint query notranslate" dir="ltr"> <code translate="no" dir="ltr"><a href="https://developers.google.com/apis-explorer/#p/youtubeAnalytics/v2/youtubeAnalytics.reports.query?metrics=shares&dimensions=sharingService&filters=uploaderType%253D%253Dself&sort=-shares&startDate=2023-09-01&endDate=2024-03-31&&ids=contentOwner%253D%253DCONTENT_OWNER_ID">dimensions=sharingService metrics=shares filters=uploaderType==self sort=-shares</a></code> </pre> </article> <article> <header id="content-owner-audience-retention-reports">Audience retention</header> <h4 id="content_owner_audience_retention" data-text="Audience retention metrics for a video" tabindex="-1">Audience retention metrics for a video</h4> <p>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 <code translate="no" dir="ltr">VIDEO_ID</code> in the <code translate="no" dir="ltr">filters</code> 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 <code translate="no" dir="ltr">video</code> filter.</p> <p>In this example, the report uses the <code translate="no" dir="ltr"><a href="/youtube/analytics/dimensions#audienceType">audienceType</a></code> 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.</p> <p>Note that data for the <code translate="no" dir="ltr">audienceType</code> 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.</p> <pre class="prettyprint query notranslate" dir="ltr"> <code translate="no" dir="ltr"><a href="https://developers.google.com/apis-explorer/#p/youtubeAnalytics/v2/youtubeAnalytics.reports.query?metrics=audienceWatchRatio%252CrelativeRetentionPerformance&dimensions=elapsedVideoTimeRatio&filters=video%253D%253DVIDEO_ID%253BaudienceType%253D%253DORGANIC&startDate=2023-09-01&endDate=2024-03-31&&ids=contentOwner%253D%253DCONTENT_OWNER_ID">dimensions=elapsedVideoTimeRatio metrics=audienceWatchRatio,relativeRetentionPerformance filters=video==VIDEO_ID;audienceType==ORGANIC</a></code> </pre> </article> <article> <header id="content-owner-revenue-ads-reports">Revenue/Ads</header> <h4 id="content_owner_revenue" data-text="Revenue and ad performance metrics for claimed content" tabindex="-1">Revenue and ad performance metrics for claimed content</h4> <p>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.</p> <pre class="prettyprint query notranslate" dir="ltr"> <code translate="no" dir="ltr"><a href="https://developers.google.com/apis-explorer/#p/youtubeAnalytics/v2/youtubeAnalytics.reports.query?metrics=views%252CestimatedRevenue%252CestimatedAdRevenue%252CestimatedRedPartnerRevenue%252CgrossRevenue%252CadImpressions%252Ccpm%252CplaybackBasedCpm%252CmonetizedPlaybacks&filters=claimedStatus%253D%253Dclaimed&startDate=2023-09-01&endDate=2024-03-31&&ids=contentOwner%253D%253DCONTENT_OWNER_ID">metrics=views,estimatedRevenue,estimatedAdRevenue,estimatedRedPartnerRevenue,grossRevenue,adImpressions,cpm,playbackBasedCpm,monetizedPlaybacks filters=claimedStatus==claimed</a></code> </pre> <h4 id="content_owner_daily_revenue" data-text="Daily revenue and ad performance metrics" tabindex="-1">Daily revenue and ad performance metrics</h4> <p>This request retrieves daily revenue and ad performance metrics for the content owner's claimed content.</p> <pre class="prettyprint query notranslate" dir="ltr"> <code translate="no" dir="ltr"><a href="https://developers.google.com/apis-explorer/#p/youtubeAnalytics/v2/youtubeAnalytics.reports.query?metrics=views%252CestimatedRevenue%252CestimatedAdRevenue%252CestimatedRedPartnerRevenue%252CgrossRevenue%252CadImpressions%252Ccpm%252CplaybackBasedCpm%252CmonetizedPlaybacks&dimensions=day&filters=claimedStatus%253D%253Dclaimed&startDate=2023-09-01&endDate=2024-03-31&&ids=contentOwner%253D%253DCONTENT_OWNER_ID">dimensions=day metrics=views,estimatedRevenue,estimatedAdRevenue,estimatedRedPartnerRevenue,grossRevenue,adImpressions,cpm,playbackBasedCpm,monetizedPlaybacks filters=claimedStatus==claimed</a></code> </pre> <h4 id="content_owner_country_revenue" data-text="Country-specific revenue and ad performance metrics" tabindex="-1">Country-specific revenue and ad performance metrics</h4> <p>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.</p> <pre class="prettyprint query notranslate" dir="ltr"> <code translate="no" dir="ltr"><a href="https://developers.google.com/apis-explorer/#p/youtubeAnalytics/v2/youtubeAnalytics.reports.query?metrics=views%252CestimatedRevenue%252CestimatedAdRevenue%252CestimatedRedPartnerRevenue%252CgrossRevenue%252CadImpressions%252Ccpm%252CplaybackBasedCpm%252CmonetizedPlaybacks&dimensions=country&filters=claimedStatus%253D%253Dclaimed&sort=-estimatedRevenue&startDate=2023-09-01&endDate=2024-03-31&&ids=contentOwner%253D%253DCONTENT_OWNER_ID">dimensions=country metrics=views,estimatedRevenue,estimatedAdRevenue,estimatedRedPartnerRevenue,grossRevenue,adImpressions,cpm,playbackBasedCpm,monetizedPlaybacks filters=claimedStatus==claimed sort=-estimatedRevenue</a></code> </pre> <h4 id="content_owner_top_10_videos_by_revenue" data-text="Top 10 – Videos with the highest revenue" tabindex="-1">Top 10 – Videos with the highest revenue</h4> <p>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.</p> <pre class="prettyprint query notranslate" dir="ltr"> <code translate="no" dir="ltr"><a href="https://developers.google.com/apis-explorer/#p/youtubeAnalytics/v2/youtubeAnalytics.reports.query?metrics=views%252CestimatedRevenue%252CestimatedAdRevenue%252CestimatedRedPartnerRevenue%252CgrossRevenue%252CadImpressions%252Ccpm%252CplaybackBasedCpm%252CmonetizedPlaybacks&dimensions=video&filters=claimedStatus%253D%253Dclaimed&maxResults=10&sort=-estimatedRevenue&startDate=2023-09-01&endDate=2024-03-31&&ids=contentOwner%253D%253DCONTENT_OWNER_ID">dimensions=video metrics=views,estimatedRevenue,estimatedAdRevenue,estimatedRedPartnerRevenue,grossRevenue,adImpressions,cpm,playbackBasedCpm,monetizedPlaybacks filters=claimedStatus==claimed maxResults=10 sort=-estimatedRevenue</a></code> </pre> <h4 id="content_owner_ad_performance" data-text="Ad performance metrics for different ad types" tabindex="-1">Ad performance metrics for different ad types</h4> <p>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.</p> <pre class="prettyprint query notranslate" dir="ltr"> <code translate="no" dir="ltr"><a href="https://developers.google.com/apis-explorer/#p/youtubeAnalytics/v2/youtubeAnalytics.reports.query?metrics=grossRevenue%252CadImpressions%252Ccpm&dimensions=adType&filters=claimedStatus%253D%253Dclaimed&sort=-adType&startDate=2023-09-01&endDate=2024-03-31&&ids=contentOwner%253D%253DCONTENT_OWNER_ID">dimensions=adType metrics=grossRevenue,adImpressions,cpm filters=claimedStatus==claimed sort=-adType</a></code> </pre> </article> </section> </div> <devsite-recommendations display="in-page" hidden yield> </devsite-recommendations> <devsite-thumb-rating position="footer"> </devsite-thumb-rating> <devsite-recommendations id="recommendations-link" yield></devsite-recommendations> <div class="devsite-floating-action-buttons"> </div> </article> <devsite-content-footer class="nocontent"> <p>Except as otherwise noted, the content of this page is licensed under the <a href="https://creativecommons.org/licenses/by/4.0/">Creative Commons Attribution 4.0 License</a>, and code samples are licensed under the <a href="https://www.apache.org/licenses/LICENSE-2.0">Apache 2.0 License</a>. For details, see the <a href="https://developers.google.com/site-policies">Google Developers Site Policies</a>. Java is a registered trademark of Oracle and/or its affiliates.</p> <p>Last updated 2024-10-16 UTC.</p> </devsite-content-footer> <devsite-notification > </devsite-notification> <div class="devsite-content-data"> <template class="devsite-content-data-template"> [[["Easy to understand","easyToUnderstand","thumb-up"],["Solved my problem","solvedMyProblem","thumb-up"],["Other","otherUp","thumb-up"]],[["Missing the information I need","missingTheInformationINeed","thumb-down"],["Too complicated / too many steps","tooComplicatedTooManySteps","thumb-down"],["Out of date","outOfDate","thumb-down"],["Samples / code issue","samplesCodeIssue","thumb-down"],["Other","otherDown","thumb-down"]],["Last updated 2024-10-16 UTC."],[],[]] </template> </div> </devsite-content> </main> <devsite-footer-promos class="devsite-footer"> <nav class="devsite-footer-promos nocontent" aria-label="Promotions"> <ul class="devsite-footer-promos-list"> <li class="devsite-footer-promo"> <a href="https://blog.youtube" class="devsite-footer-promo-title gc-analytics-event" data-category="Site-Wide Custom Events" data-label="Footer Promo Link (index 1)" > <picture> <img class="devsite-footer-promo-icon" src="/static/site-assets/logo-youtube.svg" loading="lazy" alt="Blog"> </picture> <span class="devsite-footer-promo-label"> Blog </span> </a> <div class="devsite-footer-promo-description">The latest news on the YouTube blog</div> </li> <li class="devsite-footer-promo"> <a href="https://github.com/youtube/api-samples" class="devsite-footer-promo-title gc-analytics-event" data-category="Site-Wide Custom Events" data-label="Footer Promo Link (index 2)" > <picture> <img class="devsite-footer-promo-icon" src="/static/site-assets/logo-github.svg" loading="lazy" alt="GitHub"> </picture> <span class="devsite-footer-promo-label"> GitHub </span> </a> <div class="devsite-footer-promo-description">Find API code samples and other YouTube open-source projects.</div> </li> <li class="devsite-footer-promo"> <a href="https://issuetracker.google.com/issues/new?component=186600&template=874803" class="devsite-footer-promo-title gc-analytics-event" data-category="Site-Wide Custom Events" data-label="Footer Promo Link (index 3)" > <picture> <img class="devsite-footer-promo-icon" src="/static/site-assets/developers_64dp.png" loading="lazy" alt="Issue Tracker"> </picture> <span class="devsite-footer-promo-label"> Issue Tracker </span> </a> <div class="devsite-footer-promo-description">Something wrong? Send us a bug report!</div> </li> <li class="devsite-footer-promo"> <a href="http://stackoverflow.com/questions/ask?tags=youtube-api" class="devsite-footer-promo-title gc-analytics-event" data-category="Site-Wide Custom Events" data-label="Footer Promo Link (index 4)" > <picture> <img class="devsite-footer-promo-icon" src="/static/site-assets/logo-stack-overflow.svg" loading="lazy" alt="Stack Overflow"> </picture> <span class="devsite-footer-promo-label"> Stack Overflow </span> </a> <div class="devsite-footer-promo-description">Ask a question under the youtube-api tag</div> </li> <li class="devsite-footer-promo"> <a href="https://research.youtube/" class="devsite-footer-promo-title gc-analytics-event" data-category="Site-Wide Custom Events" data-label="Footer Promo Link (index 5)" > <picture> <img class="devsite-footer-promo-icon" src="/static/site-assets/logo-youtube.svg" loading="lazy" alt="YouTube Researcher Program"> </picture> <span class="devsite-footer-promo-label"> YouTube Researcher Program </span> </a> <div class="devsite-footer-promo-description">For researchers interested in using data from YouTube’s global API</div> </li> </ul> </nav> </devsite-footer-promos> <devsite-footer-linkboxes class="devsite-footer"> <nav class="devsite-footer-linkboxes nocontent" aria-label="Footer links"> <ul class="devsite-footer-linkboxes-list"> <li class="devsite-footer-linkbox "> <h3 class="devsite-footer-linkbox-heading no-link">Tools</h3> <ul class="devsite-footer-linkbox-list"> <li class="devsite-footer-linkbox-item"> <a href="https://developers.google.com/apis-explorer/#p/" class="devsite-footer-linkbox-link gc-analytics-event" data-category="Site-Wide Custom Events" data-label="Footer Link (index 1)" > Google APIs Explorer </a> </li> <li class="devsite-footer-linkbox-item"> <a href="/youtube/youtube_player_demo" class="devsite-footer-linkbox-link gc-analytics-event" data-category="Site-Wide Custom Events" data-label="Footer Link (index 2)" > YouTube Player Demo </a> </li> <li class="devsite-footer-linkbox-item"> <a href="/youtube/youtube_subscribe_button" class="devsite-footer-linkbox-link gc-analytics-event" data-category="Site-Wide Custom Events" data-label="Footer Link (index 3)" > Configure a Subscribe Button </a> </li> </ul> </li> <li class="devsite-footer-linkbox "> <h3 class="devsite-footer-linkbox-heading no-link">Issue Tracker</h3> <ul class="devsite-footer-linkbox-list"> <li class="devsite-footer-linkbox-item"> <a href="https://issuetracker.google.com/issues/new?component=186600&template=874803" class="devsite-footer-linkbox-link gc-analytics-event" data-category="Site-Wide Custom Events" data-label="Footer Link (index 1)" > File a bug </a> </li> <li class="devsite-footer-linkbox-item"> <a href="https://issuetracker.google.com/issues/new?component=186600&template=874803" class="devsite-footer-linkbox-link gc-analytics-event" data-category="Site-Wide Custom Events" data-label="Footer Link (index 2)" > Request a feature </a> </li> <li class="devsite-footer-linkbox-item"> <a href="https://issuetracker.google.com/issues?q=componentid:186600" class="devsite-footer-linkbox-link gc-analytics-event" data-category="Site-Wide Custom Events" data-label="Footer Link (index 3)" > See open issues </a> </li> </ul> </li> <li class="devsite-footer-linkbox "> <h3 class="devsite-footer-linkbox-heading no-link">Product Info</h3> <ul class="devsite-footer-linkbox-list"> <li class="devsite-footer-linkbox-item"> <a href="/youtube/terms/api-services-terms-of-service" class="devsite-footer-linkbox-link gc-analytics-event" data-category="Site-Wide Custom Events" data-label="Footer Link (index 1)" > Terms of Service </a> </li> <li class="devsite-footer-linkbox-item"> <a href="/youtube/terms/developer-policies" class="devsite-footer-linkbox-link gc-analytics-event" data-category="Site-Wide Custom Events" data-label="Footer Link (index 2)" > Developer Policies </a> </li> <li class="devsite-footer-linkbox-item"> <a href="/youtube/terms/required-minimum-functionality" class="devsite-footer-linkbox-link gc-analytics-event" data-category="Site-Wide Custom Events" data-label="Footer Link (index 3)" > Required Minimum Functionality </a> </li> <li class="devsite-footer-linkbox-item"> <a href="/youtube/terms/branding-guidelines" class="devsite-footer-linkbox-link gc-analytics-event" data-category="Site-Wide Custom Events" data-label="Footer Link (index 4)" > Branding Guidelines </a> </li> </ul> </li> </ul> </nav> </devsite-footer-linkboxes> <devsite-footer-utility class="devsite-footer"> <div class="devsite-footer-utility nocontent"> <nav class="devsite-footer-sites" aria-label="Other Google Developers websites"> <a href="https://developers.google.com/" class="devsite-footer-sites-logo-link gc-analytics-event" data-category="Site-Wide Custom Events" data-label="Footer Google Developers Link"> <picture> <img class="devsite-footer-sites-logo" src="https://www.gstatic.com/devrel-devsite/prod/v870e399c64f7c43c99a3043db4b3a74327bb93d0914e84a0c3dba90bbfd67625/developers/images/lockup-google-for-developers.svg" loading="lazy" alt="Google Developers"> </picture> </a> <ul class="devsite-footer-sites-list"> <li class="devsite-footer-sites-item"> <a href="//developer.android.com" class="devsite-footer-sites-link gc-analytics-event" data-category="Site-Wide Custom Events" data-label="Footer Android Link" > Android </a> </li> <li class="devsite-footer-sites-item"> <a href="//developer.chrome.com/home" class="devsite-footer-sites-link gc-analytics-event" data-category="Site-Wide Custom Events" data-label="Footer Chrome Link" > Chrome </a> </li> <li class="devsite-footer-sites-item"> <a href="//firebase.google.com" class="devsite-footer-sites-link gc-analytics-event" data-category="Site-Wide Custom Events" data-label="Footer Firebase Link" > Firebase </a> </li> <li class="devsite-footer-sites-item"> <a href="//cloud.google.com" class="devsite-footer-sites-link gc-analytics-event" data-category="Site-Wide Custom Events" data-label="Footer Google Cloud Platform Link" > Google Cloud Platform </a> </li> <li class="devsite-footer-sites-item"> <a href="//ai.google.dev/" class="devsite-footer-sites-link gc-analytics-event" data-category="Site-Wide Custom Events" data-label="Footer Google AI Link" > Google AI </a> </li> <li class="devsite-footer-sites-item"> <a href="/products" class="devsite-footer-sites-link gc-analytics-event" data-category="Site-Wide Custom Events" data-label="Footer All products Link" > All products </a> </li> </ul> </nav> <nav class="devsite-footer-utility-links" aria-label="Utility links"> <ul class="devsite-footer-utility-list"> <li class="devsite-footer-utility-item "> <a class="devsite-footer-utility-link gc-analytics-event" href="/terms/site-terms" data-category="Site-Wide Custom Events" data-label="Footer Terms link" > Terms </a> </li> <li class="devsite-footer-utility-item "> <a class="devsite-footer-utility-link gc-analytics-event" href="//policies.google.com/privacy" data-category="Site-Wide Custom Events" data-label="Footer Privacy link" > Privacy </a> </li> <li class="devsite-footer-utility-item glue-cookie-notification-bar-control"> <a class="devsite-footer-utility-link gc-analytics-event" href="#" data-category="Site-Wide Custom Events" data-label="Footer Manage cookies link" aria-hidden="true" > Manage cookies </a> </li> <li class="devsite-footer-utility-item devsite-footer-utility-button"> <span class="devsite-footer-utility-description">Sign up for the Google for Developers newsletter</span> <a class="devsite-footer-utility-link gc-analytics-event" href="/newsletter/subscribe" data-category="Site-Wide Custom Events" data-label="Footer Subscribe link" > Subscribe </a> </li> </ul> <devsite-language-selector> <ul role="presentation"> <li role="presentation"> <a role="menuitem" lang="en" >English</a> </li> <li role="presentation"> <a role="menuitem" lang="de" >Deutsch</a> </li> <li role="presentation"> <a role="menuitem" lang="es" >Español</a> </li> <li role="presentation"> <a role="menuitem" lang="es_419" >Español – América Latina</a> </li> <li role="presentation"> <a role="menuitem" lang="fr" >Français</a> </li> <li role="presentation"> <a role="menuitem" lang="id" >Indonesia</a> </li> <li role="presentation"> <a role="menuitem" lang="it" >Italiano</a> </li> <li role="presentation"> <a role="menuitem" lang="pl" >Polski</a> </li> <li role="presentation"> <a role="menuitem" lang="pt_br" >Português – Brasil</a> </li> <li role="presentation"> <a role="menuitem" lang="vi" >Tiếng Việt</a> </li> <li role="presentation"> <a role="menuitem" lang="tr" >Türkçe</a> </li> <li role="presentation"> <a role="menuitem" lang="ru" >Русский</a> </li> <li role="presentation"> <a role="menuitem" lang="he" >עברית</a> </li> <li role="presentation"> <a role="menuitem" lang="ar" >العربيّة</a> </li> <li role="presentation"> <a role="menuitem" lang="fa" >فارسی</a> </li> <li role="presentation"> <a role="menuitem" lang="hi" >हिंदी</a> </li> <li role="presentation"> <a role="menuitem" lang="bn" >বাংলা</a> </li> <li role="presentation"> <a role="menuitem" lang="th" >ภาษาไทย</a> </li> <li role="presentation"> <a role="menuitem" lang="zh_cn" >中文 – 简体</a> </li> <li role="presentation"> <a role="menuitem" lang="zh_tw" >中文 – 繁體</a> </li> <li role="presentation"> <a role="menuitem" lang="ja" >日本語</a> </li> <li role="presentation"> <a role="menuitem" lang="ko" >한국어</a> </li> </ul> </devsite-language-selector> </nav> </div> </devsite-footer-utility> <devsite-panel></devsite-panel> <devsite-concierge data-info-panel data-ai-panel data-api-explorer-panel > </devsite-concierge> </section></section> <devsite-sitemask></devsite-sitemask> <devsite-snackbar></devsite-snackbar> <devsite-tooltip ></devsite-tooltip> <devsite-heading-link></devsite-heading-link> <devsite-analytics> <script type="application/json" analytics>[{"dimensions": {"dimension3": false, "dimension5": "en", "dimension11": false, "dimension4": "YouTube Analytics and Reporting APIs", "dimension1": "Signed out", "dimension6": "en"}, "gaid": "UA-24532603-1", "metrics": {"ratings_value": "metric1", "ratings_count": "metric2"}, "purpose": 1}]</script> <script type="application/json" tag-management>{"at": "True", "ga4": [{"id": "G-272J68FCRF", "purpose": 1}], "ga4p": [{"id": "G-272J68FCRF", "purpose": 1}], "gtm": [], "parameters": {"internalUser": "False", "language": {"machineTranslated": "False", "requested": "en", "served": "en"}, "pageType": "article", "projectName": "YouTube Analytics and Reporting APIs", "signedIn": "False", "tenant": "developers", "recommendations": {"sourcePage": "", "sourceType": 0, "sourceRank": 0, "sourceIdenticalDescriptions": 0, "sourceTitleWords": 0, "sourceDescriptionWords": 0, "experiment": ""}, "experiment": {"ids": ""}}}</script> </devsite-analytics> <devsite-badger></devsite-badger> <script nonce="NJhq+p9gCRhWWEi3wddDzDE2RBDylc"> (function(d,e,v,s,i,t,E){d['GoogleDevelopersObject']=i; t=e.createElement(v);t.async=1;t.src=s;E=e.getElementsByTagName(v)[0]; E.parentNode.insertBefore(t,E);})(window, document, 'script', 'https://www.gstatic.com/devrel-devsite/prod/v870e399c64f7c43c99a3043db4b3a74327bb93d0914e84a0c3dba90bbfd67625/developers/js/app_loader.js', '[1,"en",null,"/js/devsite_app_module.js","https://www.gstatic.com/devrel-devsite/prod/v870e399c64f7c43c99a3043db4b3a74327bb93d0914e84a0c3dba90bbfd67625","https://www.gstatic.com/devrel-devsite/prod/v870e399c64f7c43c99a3043db4b3a74327bb93d0914e84a0c3dba90bbfd67625/developers","https://developers-dot-devsite-v2-prod.appspot.com",null,null,["/_pwa/developers/manifest.json","https://www.gstatic.com/devrel-devsite/prod/v870e399c64f7c43c99a3043db4b3a74327bb93d0914e84a0c3dba90bbfd67625/images/video-placeholder.svg","https://www.gstatic.com/devrel-devsite/prod/v870e399c64f7c43c99a3043db4b3a74327bb93d0914e84a0c3dba90bbfd67625/developers/images/favicon-new.png","https://fonts.googleapis.com/css?family=Google+Sans:400,500|Roboto:400,400italic,500,500italic,700,700italic|Roboto+Mono:400,500,700&display=swap"],1,null,[1,6,8,12,14,17,21,25,50,52,63,70,75,76,80,87,91,92,93,97,98,100,101,102,103,104,105,107,108,109,110,112,113,117,118,120,122,124,125,126,127,129,130,131,132,133,134,135,136,138,140,141,147,148,149,151,152,156,157,158,159,161,163,164,168,169,170,179,180,182,183,186,191,193,196],"AIzaSyAP-jjEJBzmIyKR4F-3XITp8yM9T1gEEI8","AIzaSyB6xiKGDR5O3Ak2okS4rLkauxGUG7XP0hg","developers.google.com","AIzaSyAQk0fBONSGUqCNznf6Krs82Ap1-NV6J4o","AIzaSyCCxcqdrZ_7QMeLCRY20bh_SXdAYqy70KY",null,null,null,["Search__enable_ai_search_summaries_restricted","TpcFeatures__enable_mirror_tenant_redirects","Cloud__enable_cloud_shell","Profiles__enable_completecodelab_endpoint","Cloud__enable_legacy_calculator_redirect","EngEduTelemetry__enable_engedu_telemetry","MiscFeatureFlags__enable_firebase_utm","Search__enable_ai_search_summaries","Cloud__enable_free_trial_server_call","Significatio__enable_by_tenant","MiscFeatureFlags__enable_view_transitions","Cloud__enable_cloud_shell_fte_user_flow","Cloud__enable_cloud_dlp_service","MiscFeatureFlags__developers_footer_image","Profiles__enable_public_developer_profiles","CloudShell__cloud_shell_button","MiscFeatureFlags__enable_variable_operator","Search__enable_ai_eligibility_checks","CloudShell__cloud_code_overflow_menu","Cloud__enable_llm_concierge_chat","Concierge__enable_concierge_restricted","Profiles__enable_developer_profiles_callout","Profiles__enable_page_saving","Profiles__enable_awarding_url","DevPro__enable_developer_subscriptions","Profiles__enable_dashboard_curated_recommendations","Cloud__enable_cloudx_ping","Analytics__enable_clearcut_logging","Cloud__enable_cloudx_experiment_ids","Search__enable_dynamic_content_confidential_banner","Profiles__require_profile_eligibility_for_signin","Concierge__enable_pushui","MiscFeatureFlags__enable_project_variables","Profiles__enable_release_notes_notifications","MiscFeatureFlags__enable_explain_this_code","Profiles__enable_recognition_badges","Search__enable_page_map","TpcFeatures__enable_required_headers","MiscFeatureFlags__developers_footer_dark_image","Profiles__enable_complete_playlist_endpoint","Profiles__enable_profile_collections","MiscFeatureFlags__emergency_css","Experiments__reqs_query_experiments","Concierge__enable_concierge","Search__enable_suggestions_from_borg","BookNav__enable_tenant_cache_key","DevPro__enable_cloud_innovators_plus","Cloud__enable_cloud_facet_chat"],null,null,"AIzaSyBLEMok-5suZ67qRPzx0qUtbnLmyT_kCVE","https://developerscontentserving-pa.clients6.google.com","AIzaSyCM4QpTRSqP5qI4Dvjt4OAScIN8sOUlO-k","https://developerscontentsearch-pa.clients6.google.com",1,4,null,"https://developerprofiles-pa.clients6.google.com",[1,"developers","Google for Developers","developers.google.com",null,"developers-dot-devsite-v2-prod.appspot.com",null,null,[1,1,[1],null,null,null,null,null,null,null,null,[1],null,null,null,null,null,null,[1],[1,null,null,[1,20],"/recommendations/information"],null,null,null,[1,1,1],[1,1,null,1,1]],null,[null,null,null,null,null,null,"/images/lockup-new.svg","/images/touchicon-180-new.png",null,null,null,null,1,null,null,null,null,null,null,null,null,1,null,null,null,"/images/lockup-dark-theme-new.svg",[]],[],null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,[6,1,14,15,20,22,23,29,32,36],null,[[null,null,null,[3,7,10,2,39,17,4,32,24,11,12,13,34,15,25],null,null,[1,[["docType","Choose a content type",[["Tutorial",null,null,null,null,null,null,null,null,"Tutorial"],["Guide",null,null,null,null,null,null,null,null,"Guide"],["Sample",null,null,null,null,null,null,null,null,"Sample"]]],["product","Choose a product",[["Android",null,null,null,null,null,null,null,null,"Android"],["ARCore",null,null,null,null,null,null,null,null,"ARCore"],["ChromeOS",null,null,null,null,null,null,null,null,"ChromeOS"],["Firebase",null,null,null,null,null,null,null,null,"Firebase"],["Flutter",null,null,null,null,null,null,null,null,"Flutter"],["Assistant",null,null,null,null,null,null,null,null,"Google Assistant"],["GoogleCloud",null,null,null,null,null,null,null,null,"Google Cloud"],["GoogleMapsPlatform",null,null,null,null,null,null,null,null,"Google Maps Platform"],["GooglePay",null,null,null,null,null,null,null,null,"Google Pay & Google Wallet"],["GooglePlay",null,null,null,null,null,null,null,null,"Google Play"],["Tensorflow",null,null,null,null,null,null,null,null,"TensorFlow"]]],["category","Choose a topic",[["AiAndMachineLearning",null,null,null,null,null,null,null,null,"AI and Machine Learning"],["Data",null,null,null,null,null,null,null,null,"Data"],["Enterprise",null,null,null,null,null,null,null,null,"Enterprise"],["Gaming",null,null,null,null,null,null,null,null,"Gaming"],["Mobile",null,null,null,null,null,null,null,null,"Mobile"],["Web",null,null,null,null,null,null,null,null,"Web"]]]]]],[1,1],null,1],[[["UA-24532603-1"],["UA-22084204-5"],null,null,["UA-24532603-5"],null,null,[["G-272J68FCRF"],null,null,[["G-272J68FCRF",2]]],[["UA-24532603-1",2]],null,[["UA-24532603-5",2]],null,1],[[15,12],[14,11],[5,4],[1,1],[13,10],[6,5],[12,9],[3,2],[16,13],[4,3],[11,8]],[[1,1],[2,2]]],null,4,null,null,null,null,null,null,null,null,null,null,null,null,null,"developers.devsite.google"],null,"pk_live_5170syrHvgGVmSx9sBrnWtA5luvk9BwnVcvIi7HizpwauFG96WedXsuXh790rtij9AmGllqPtMLfhe2RSwD6Pn38V00uBCydV4m"]') </script> <devsite-a11y-announce></devsite-a11y-announce> </body> </html>

CINXE.COM

Sample API Requests | YouTube Analytics and Reporting APIs | Google for Developers