Comments: list | YouTube Data API

<!doctype html> <html lang="en" dir="ltr"> <head><script type="text/javascript" src="/_static/js/bundle-playback.js?v=HxkREWBo" charset="utf-8"></script> <script type="text/javascript" src="/_static/js/wombat.js?v=txqj7nKC" charset="utf-8"></script> <script>window.RufflePlayer=window.RufflePlayer||{};window.RufflePlayer.config={"autoplay":"on","unmuteOverlay":"hidden"};</script> <script type="text/javascript" src="/_static/js/ruffle/ruffle.js"></script> <script type="text/javascript"> __wm.init("https://web.archive.org/web"); __wm.wombat("https://developers.google.com/youtube/v3/docs/comments/list","20211123091127","https://web.archive.org/","web","/_static/", "1637658687"); </script> <link rel="stylesheet" type="text/css" href="/_static/css/banner-styles.css?v=S1zqJCYt" /> <link rel="stylesheet" type="text/css" href="/_static/css/iconochive.css?v=3PDvdIFv" />  <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 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="/web/20211123091127/https://developers.google.com/_pwa/developers/manifest.json" crossorigin="use-credentials"> <link rel="preconnect" href="//web.archive.org/web/20211123091127/https://www.gstatic.com/" crossorigin> <link rel="preconnect" href="//web.archive.org/web/20211123091127/https://fonts.gstatic.com/" crossorigin> <link rel="preconnect" href="//web.archive.org/web/20211123091127/https://fonts.googleapis.com/" crossorigin> <link rel="preconnect" href="//web.archive.org/web/20211123091127/https://apis.google.com/" crossorigin> <link rel="preconnect" href="//web.archive.org/web/20211123091127/https://www.google-analytics.com/" crossorigin><link rel="stylesheet" href="//web.archive.org/web/20211123091127cs_/https://fonts.googleapis.com/css?family=Google+Sans_old:400,500|Roboto:400,400italic,500,500italic,700,700italic|Roboto+Mono:400,500,700&display=swap"> <link rel="stylesheet" href="//web.archive.org/web/20211123091127cs_/https://fonts.googleapis.com/css?family=Material+Icons&display=block"><link rel="stylesheet" href="https://web.archive.org/web/20211123091127cs_/https://www.gstatic.com/devrel-devsite/prod/v83c28b42a9d2de845cf6ea5b33e8c3314f0e1ea60229353829f7578993509959/developers/css/app.css"> <link rel="shortcut icon" href="https://web.archive.org/web/20211123091127im_/https://www.gstatic.com/devrel-devsite/prod/v83c28b42a9d2de845cf6ea5b33e8c3314f0e1ea60229353829f7578993509959/developers/images/favicon.png"> <link rel="apple-touch-icon" href="https://web.archive.org/web/20211123091127im_/https://www.gstatic.com/devrel-devsite/prod/v83c28b42a9d2de845cf6ea5b33e8c3314f0e1ea60229353829f7578993509959/developers/images/touchicon-180.png"><link rel="canonical" href="https://web.archive.org/web/20211123091127/https://developers.google.com/youtube/v3/docs/comments/list"><link rel="search" type="application/opensearchdescription+xml" title="Google Developers" href="https://web.archive.org/web/20211123091127/https://developers.google.com/s/opensearch.xml"> <title>Comments: list  |  YouTube Data API  |  Google Developers</title> <meta property="og:title" content="Comments: list | YouTube Data API | Google Developers"><meta property="og:url" content="https://web.archive.org/web/20211123091127/https://developers.google.com/youtube/v3/docs/comments/list"><meta property="og:image" content="https://web.archive.org/web/20211123091127im_/https://www.gstatic.com/devrel-devsite/prod/v83c28b42a9d2de845cf6ea5b33e8c3314f0e1ea60229353829f7578993509959/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://web.archive.org/web/20211123091127/https://schema.org", "@type": "BreadcrumbList", "itemListElement": [{ "@type": "ListItem", "position": 1, "name": "YouTube", "item": "https://web.archive.org/web/20211123091127/https://developers.google.com/youtube" },{ "@type": "ListItem", "position": 2, "name": "Data API", "item": "https://web.archive.org/web/20211123091127/https://developers.google.com/youtube/v3" },{ "@type": "ListItem", "position": 3, "name": "Comments: list", "item": "https://web.archive.org/web/20211123091127/https://developers.google.com/youtube/v3/docs/comments/list" }] } </script> </head> <body class="docs" template="page" theme="youtube-theme" type="reference" layout="docs" pending> <devsite-progress type="indeterminate" id="app-progress"></devsite-progress> <section class="devsite-wrapper"><devsite-header> <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://web.archive.org/web/20211123091127/https://developers.google.com/youtube"> <div class="devsite-product-logo-container" size="medium"> <img class="devsite-product-logo" alt="YouTube" src="https://web.archive.org/web/20211123091127im_/https://developers.google.com/site-assets/logo-youtube.svg" srcset="" sizes="64px" loading="lazy"> </div> </a> <span class="devsite-product-name"> <ul class="devsite-breadcrumb-list" aria-label="Product breadcrumb"> <li class="devsite-breadcrumb-item "> <a href="https://web.archive.org/web/20211123091127/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://web.archive.org/web/20211123091127/https://developers.google.com/youtube/v3" 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 Data API"> Data API </a> </li> </ul> </span> </div> <div class="devsite-top-logo-row-middle"> <div class="devsite-header-upper-tabs"> </div> <devsite-search aria-expanded="false" aria-haspopup="listbox" enable-signin enable-search enable-suggestions enable-query-completion project-name="YouTube Data API" tenant-name="Google Developers" project-scope="/youtube/v3" url-scoped="https://developers.google.com/s/results/youtube/v3" role="combobox"> <form class="devsite-search-form" action="https://web.archive.org/web/20211123091127/https://developers.google.com/s/results" method="GET"> <div class="devsite-search-container"> <div class="devsite-searchbox"> <input aria-activedescendant="" aria-autocomplete="list" aria-label="Search" aria-haspopup="false" aria-multiline="false" aria-label="Search box" autocomplete="off" class="devsite-search-field devsite-search-query" name="q" placeholder="Search" role="searchbox" type="text" value=""> <div class="devsite-search-image material-icons" aria-hidden="true"></div> </div> <button type="button" search-open class="devsite-search-button devsite-header-icon-button button-flat material-icons" aria-label="Open search"></button> </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> <devsite-select class="devsite-language-selector-menu"> <select aria-label="Select your language preference." class="devsite-language-selector-select" name="language" track-name="click" track-type="languageSelector"> <option>Language</option> <option value="en" lang="en"> English </option> <option value="id" lang="id"> Bahasa Indonesia </option> <option value="de" lang="de"> Deutsch </option> <option value="es" lang="es"> Español </option> <option value="fr" lang="fr"> Français </option> <option value="pt_br" lang="pt_br"> Português – Brasil </option> <option value="ru" lang="ru"> Русский </option> <option value="zh_cn" lang="zh_cn"> 中文 – 简体 </option> <option value="ja" lang="ja"> 日本語 </option> <option value="ko" lang="ko"> 한국어 </option> </select> </devsite-select> </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://web.archive.org/web/20211123091127/https://developers.google.com/youtube/v3" class="gc-analytics-event " track-type="nav" track-name="home" track-metadata-eventdetail="https://developers.google.com/youtube/v3" track-metadata-position="nav - home" track-metadata-module="primary nav" data-category="Site-Wide Custom Events" data-label="Tab: Home"> Home </a> </tab> <tab> <a href="https://web.archive.org/web/20211123091127/https://developers.google.com/youtube/v3/getting-started" class="gc-analytics-event " track-type="nav" track-name="guides" track-metadata-eventdetail="https://developers.google.com/youtube/v3/getting-started" track-metadata-position="nav - guides" track-metadata-module="primary nav" data-category="Site-Wide Custom Events" data-label="Tab: Guides"> Guides </a> </tab> <tab active> <a href="https://web.archive.org/web/20211123091127/https://developers.google.com/youtube/v3/docs" class="gc-analytics-event " track-type="nav" track-name="reference" track-metadata-eventdetail="https://developers.google.com/youtube/v3/docs" track-metadata-position="nav - reference" track-metadata-module="primary nav" aria-label="Reference, selected" data-category="Site-Wide Custom Events" data-label="Tab: Reference"> Reference </a> </tab> <tab> <a href="https://web.archive.org/web/20211123091127/https://developers.google.com/youtube/v3/code_samples" class="gc-analytics-event " track-type="nav" track-name="samples" track-metadata-eventdetail="https://developers.google.com/youtube/v3/code_samples" track-metadata-position="nav - samples" track-metadata-module="primary nav" data-category="Site-Wide Custom Events" data-label="Tab: Samples"> Samples </a> </tab> <tab> <a href="https://web.archive.org/web/20211123091127/https://developers.google.com/youtube/v3/support" class="gc-analytics-event " track-type="nav" track-name="support" track-metadata-eventdetail="https://developers.google.com/youtube/v3/support" track-metadata-position="nav - support" track-metadata-module="primary nav" data-category="Site-Wide Custom Events" data-label="Tab: Support"> Support </a> </tab> </nav> </devsite-tabs> </div> </div> </div> </div> </devsite-header> <devsite-book-nav scrollbars> <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://web.archive.org/web/20211123091127/https://developers.google.com/youtube"> <div class="devsite-product-logo-container" size="medium"> <img class="devsite-product-logo" alt="YouTube" src="https://web.archive.org/web/20211123091127im_/https://developers.google.com/site-assets/logo-youtube.svg" srcset="" sizes="64px" loading="lazy"> </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://web.archive.org/web/20211123091127/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://web.archive.org/web/20211123091127/https://developers.google.com/youtube/v3" 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 Data API"> Data API </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="/web/20211123091127/https://developers.google.com/youtube/v3" class="devsite-nav-title gc-analytics-event " data-category="Site-Wide Custom Events" data-label="Responsive Tab: Home" track-type="navMenu" track-metadata-eventdetail="globalMenu" track-metadata-position="nav" track-name="home"> <span class="devsite-nav-text" tooltip> Home </span> </a> </li> <li class="devsite-nav-item"> <a href="/web/20211123091127/https://developers.google.com/youtube/v3/getting-started" class="devsite-nav-title gc-analytics-event devsite-nav-has-children " data-category="Site-Wide Custom Events" data-label="Responsive Tab: Guides" track-type="navMenu" track-metadata-eventdetail="globalMenu" track-metadata-position="nav" track-name="guides"> <span class="devsite-nav-text" tooltip> Guides </span> <span class="devsite-nav-icon material-icons" data-icon="forward"> </span> </a> </li> <li class="devsite-nav-item"> <a href="/web/20211123091127/https://developers.google.com/youtube/v3/docs" class="devsite-nav-title gc-analytics-event devsite-nav-has-children devsite-nav-active" data-category="Site-Wide Custom Events" data-label="Responsive Tab: Reference" track-type="navMenu" track-metadata-eventdetail="globalMenu" track-metadata-position="nav" track-name="reference"> <span class="devsite-nav-text" tooltip> Reference </span> <span class="devsite-nav-icon material-icons" data-icon="forward"> </span> </a> </li> <li class="devsite-nav-item"> <a href="/web/20211123091127/https://developers.google.com/youtube/v3/code_samples" class="devsite-nav-title gc-analytics-event devsite-nav-has-children " data-category="Site-Wide Custom Events" data-label="Responsive Tab: Samples" track-type="navMenu" track-metadata-eventdetail="globalMenu" track-metadata-position="nav" track-name="samples"> <span class="devsite-nav-text" tooltip> Samples </span> <span class="devsite-nav-icon material-icons" data-icon="forward"> </span> </a> </li> <li class="devsite-nav-item"> <a href="/web/20211123091127/https://developers.google.com/youtube/v3/support" class="devsite-nav-title gc-analytics-event devsite-nav-has-children " data-category="Site-Wide Custom Events" data-label="Responsive Tab: Support" track-type="navMenu" track-metadata-eventdetail="globalMenu" track-metadata-position="nav" track-name="support"> <span class="devsite-nav-text" tooltip> Support </span> <span class="devsite-nav-icon material-icons" data-icon="forward"> </span> </a> </li> </ul> </div> <div class="devsite-mobile-nav-bottom" role="navigation"> <ul class="devsite-nav-list" menu="_book"> <li class="devsite-nav-item"><a href="/web/20211123091127/https://developers.google.com/youtube/v3/docs" class="devsite-nav-title"><span class="devsite-nav-text" tooltip>Overview</span></a></li> <li class="devsite-nav-item devsite-nav-expandable"><devsite-expandable-nav collapsed> <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>Activities</span></div><ul class="devsite-nav-section"><li class="devsite-nav-item"><a href="/web/20211123091127/https://developers.google.com/youtube/v3/docs/activities" class="devsite-nav-title"><span class="devsite-nav-text" tooltip>Overview</span></a></li><li class="devsite-nav-item"><a href="/web/20211123091127/https://developers.google.com/youtube/v3/docs/activities/list" class="devsite-nav-title"><span class="devsite-nav-text" tooltip>list</span></a></li><li class="devsite-nav-item devsite-nav-deprecated"><a href="/web/20211123091127/https://developers.google.com/youtube/v3/docs/activities/insert" class="devsite-nav-title"><span class="devsite-nav-text" tooltip>insert</span><span class="devsite-nav-icon material-icons" data-icon="deprecated" data-title="Deprecated" aria-hidden="true"></span></a></li></ul></devsite-expandable-nav></li> <li class="devsite-nav-item devsite-nav-expandable"><devsite-expandable-nav collapsed> <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>Captions</span></div><ul class="devsite-nav-section"><li class="devsite-nav-item"><a href="/web/20211123091127/https://developers.google.com/youtube/v3/docs/captions" class="devsite-nav-title"><span class="devsite-nav-text" tooltip>Overview</span></a></li><li class="devsite-nav-item"><a href="/web/20211123091127/https://developers.google.com/youtube/v3/docs/captions/list" class="devsite-nav-title"><span class="devsite-nav-text" tooltip>list</span></a></li><li class="devsite-nav-item"><a href="/web/20211123091127/https://developers.google.com/youtube/v3/docs/captions/insert" class="devsite-nav-title"><span class="devsite-nav-text" tooltip>insert</span></a></li><li class="devsite-nav-item"><a href="/web/20211123091127/https://developers.google.com/youtube/v3/docs/captions/update" class="devsite-nav-title"><span class="devsite-nav-text" tooltip>update</span></a></li><li class="devsite-nav-item"><a href="/web/20211123091127/https://developers.google.com/youtube/v3/docs/captions/download" class="devsite-nav-title"><span class="devsite-nav-text" tooltip>download</span></a></li><li class="devsite-nav-item"><a href="/web/20211123091127/https://developers.google.com/youtube/v3/docs/captions/delete" class="devsite-nav-title"><span class="devsite-nav-text" tooltip>delete</span></a></li></ul></devsite-expandable-nav></li> <li class="devsite-nav-item devsite-nav-expandable"><devsite-expandable-nav collapsed> <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>ChannelBanners</span></div><ul class="devsite-nav-section"><li class="devsite-nav-item"><a href="/web/20211123091127/https://developers.google.com/youtube/v3/docs/channelBanners" class="devsite-nav-title"><span class="devsite-nav-text" tooltip>Overview</span></a></li><li class="devsite-nav-item"><a href="/web/20211123091127/https://developers.google.com/youtube/v3/docs/channelBanners/insert" class="devsite-nav-title"><span class="devsite-nav-text" tooltip>insert</span></a></li></ul></devsite-expandable-nav></li> <li class="devsite-nav-item devsite-nav-expandable"><devsite-expandable-nav collapsed> <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>Channels</span></div><ul class="devsite-nav-section"><li class="devsite-nav-item"><a href="/web/20211123091127/https://developers.google.com/youtube/v3/docs/channels" class="devsite-nav-title"><span class="devsite-nav-text" tooltip>Overview</span></a></li><li class="devsite-nav-item"><a href="/web/20211123091127/https://developers.google.com/youtube/v3/docs/channels/list" class="devsite-nav-title"><span class="devsite-nav-text" tooltip>list</span></a></li><li class="devsite-nav-item"><a href="/web/20211123091127/https://developers.google.com/youtube/v3/docs/channels/update" class="devsite-nav-title"><span class="devsite-nav-text" tooltip>update</span></a></li></ul></devsite-expandable-nav></li> <li class="devsite-nav-item devsite-nav-expandable"><devsite-expandable-nav collapsed> <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>ChannelSections</span></div><ul class="devsite-nav-section"><li class="devsite-nav-item"><a href="/web/20211123091127/https://developers.google.com/youtube/v3/docs/channelSections" class="devsite-nav-title"><span class="devsite-nav-text" tooltip>Overview</span></a></li><li class="devsite-nav-item"><a href="/web/20211123091127/https://developers.google.com/youtube/v3/docs/channelSections/list" class="devsite-nav-title"><span class="devsite-nav-text" tooltip>list</span></a></li><li class="devsite-nav-item"><a href="/web/20211123091127/https://developers.google.com/youtube/v3/docs/channelSections/insert" class="devsite-nav-title"><span class="devsite-nav-text" tooltip>insert</span></a></li><li class="devsite-nav-item"><a href="/web/20211123091127/https://developers.google.com/youtube/v3/docs/channelSections/update" class="devsite-nav-title"><span class="devsite-nav-text" tooltip>update</span></a></li><li class="devsite-nav-item"><a href="/web/20211123091127/https://developers.google.com/youtube/v3/docs/channelSections/delete" class="devsite-nav-title"><span class="devsite-nav-text" tooltip>delete</span></a></li></ul></devsite-expandable-nav></li> <li class="devsite-nav-item devsite-nav-expandable"><devsite-expandable-nav collapsed> <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>Comments</span></div><ul class="devsite-nav-section"><li class="devsite-nav-item"><a href="/web/20211123091127/https://developers.google.com/youtube/v3/docs/comments" class="devsite-nav-title"><span class="devsite-nav-text" tooltip>Overview</span></a></li><li class="devsite-nav-item"><a href="/web/20211123091127/https://developers.google.com/youtube/v3/docs/comments/list" class="devsite-nav-title"><span class="devsite-nav-text" tooltip>list</span></a></li><li class="devsite-nav-item"><a href="/web/20211123091127/https://developers.google.com/youtube/v3/docs/comments/insert" class="devsite-nav-title"><span class="devsite-nav-text" tooltip>insert</span></a></li><li class="devsite-nav-item"><a href="/web/20211123091127/https://developers.google.com/youtube/v3/docs/comments/update" class="devsite-nav-title"><span class="devsite-nav-text" tooltip>update</span></a></li><li class="devsite-nav-item"><a href="/web/20211123091127/https://developers.google.com/youtube/v3/docs/comments/markAsSpam" class="devsite-nav-title"><span class="devsite-nav-text" tooltip>markAsSpam</span></a></li><li class="devsite-nav-item"><a href="/web/20211123091127/https://developers.google.com/youtube/v3/docs/comments/setModerationStatus" class="devsite-nav-title"><span class="devsite-nav-text" tooltip>setModerationStatus</span></a></li><li class="devsite-nav-item"><a href="/web/20211123091127/https://developers.google.com/youtube/v3/docs/comments/delete" class="devsite-nav-title"><span class="devsite-nav-text" tooltip>delete</span></a></li></ul></devsite-expandable-nav></li> <li class="devsite-nav-item devsite-nav-expandable"><devsite-expandable-nav collapsed> <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>CommentThreads</span></div><ul class="devsite-nav-section"><li class="devsite-nav-item"><a href="/web/20211123091127/https://developers.google.com/youtube/v3/docs/commentThreads" class="devsite-nav-title"><span class="devsite-nav-text" tooltip>Overview</span></a></li><li class="devsite-nav-item"><a href="/web/20211123091127/https://developers.google.com/youtube/v3/docs/commentThreads/list" class="devsite-nav-title"><span class="devsite-nav-text" tooltip>list</span></a></li><li class="devsite-nav-item"><a href="/web/20211123091127/https://developers.google.com/youtube/v3/docs/commentThreads/insert" class="devsite-nav-title"><span class="devsite-nav-text" tooltip>insert</span></a></li></ul></devsite-expandable-nav></li> <li class="devsite-nav-item devsite-nav-expandable"><devsite-expandable-nav collapsed> <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>i18nLanguages</span></div><ul class="devsite-nav-section"><li class="devsite-nav-item"><a href="/web/20211123091127/https://developers.google.com/youtube/v3/docs/i18nLanguages" class="devsite-nav-title"><span class="devsite-nav-text" tooltip>Overview</span></a></li><li class="devsite-nav-item"><a href="/web/20211123091127/https://developers.google.com/youtube/v3/docs/i18nLanguages/list" class="devsite-nav-title"><span class="devsite-nav-text" tooltip>list</span></a></li></ul></devsite-expandable-nav></li> <li class="devsite-nav-item devsite-nav-expandable"><devsite-expandable-nav collapsed> <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>i18nRegions</span></div><ul class="devsite-nav-section"><li class="devsite-nav-item"><a href="/web/20211123091127/https://developers.google.com/youtube/v3/docs/i18nRegions" class="devsite-nav-title"><span class="devsite-nav-text" tooltip>Overview</span></a></li><li class="devsite-nav-item"><a href="/web/20211123091127/https://developers.google.com/youtube/v3/docs/i18nRegions/list" class="devsite-nav-title"><span class="devsite-nav-text" tooltip>list</span></a></li></ul></devsite-expandable-nav></li> <li class="devsite-nav-item devsite-nav-expandable"><devsite-expandable-nav collapsed> <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>Members</span></div><ul class="devsite-nav-section"><li class="devsite-nav-item"><a href="/web/20211123091127/https://developers.google.com/youtube/v3/docs/members" class="devsite-nav-title"><span class="devsite-nav-text" tooltip>Overview</span></a></li><li class="devsite-nav-item"><a href="/web/20211123091127/https://developers.google.com/youtube/v3/docs/members/list" class="devsite-nav-title"><span class="devsite-nav-text" tooltip>list</span></a></li></ul></devsite-expandable-nav></li> <li class="devsite-nav-item devsite-nav-expandable"><devsite-expandable-nav collapsed> <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>MembershipsLevels</span></div><ul class="devsite-nav-section"><li class="devsite-nav-item"><a href="/web/20211123091127/https://developers.google.com/youtube/v3/docs/membershipsLevels" class="devsite-nav-title"><span class="devsite-nav-text" tooltip>Overview</span></a></li><li class="devsite-nav-item"><a href="/web/20211123091127/https://developers.google.com/youtube/v3/docs/membershipsLevels/list" class="devsite-nav-title"><span class="devsite-nav-text" tooltip>list</span></a></li></ul></devsite-expandable-nav></li> <li class="devsite-nav-item devsite-nav-expandable"><devsite-expandable-nav collapsed> <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>PlaylistItems</span></div><ul class="devsite-nav-section"><li class="devsite-nav-item"><a href="/web/20211123091127/https://developers.google.com/youtube/v3/docs/playlistItems" class="devsite-nav-title"><span class="devsite-nav-text" tooltip>Overview</span></a></li><li class="devsite-nav-item"><a href="/web/20211123091127/https://developers.google.com/youtube/v3/docs/playlistItems/list" class="devsite-nav-title"><span class="devsite-nav-text" tooltip>list</span></a></li><li class="devsite-nav-item"><a href="/web/20211123091127/https://developers.google.com/youtube/v3/docs/playlistItems/insert" class="devsite-nav-title"><span class="devsite-nav-text" tooltip>insert</span></a></li><li class="devsite-nav-item"><a href="/web/20211123091127/https://developers.google.com/youtube/v3/docs/playlistItems/update" class="devsite-nav-title"><span class="devsite-nav-text" tooltip>update</span></a></li><li class="devsite-nav-item"><a href="/web/20211123091127/https://developers.google.com/youtube/v3/docs/playlistItems/delete" class="devsite-nav-title"><span class="devsite-nav-text" tooltip>delete</span></a></li></ul></devsite-expandable-nav></li> <li class="devsite-nav-item devsite-nav-expandable"><devsite-expandable-nav collapsed> <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>Playlists</span></div><ul class="devsite-nav-section"><li class="devsite-nav-item"><a href="/web/20211123091127/https://developers.google.com/youtube/v3/docs/playlists" class="devsite-nav-title"><span class="devsite-nav-text" tooltip>Overview</span></a></li><li class="devsite-nav-item"><a href="/web/20211123091127/https://developers.google.com/youtube/v3/docs/playlists/list" class="devsite-nav-title"><span class="devsite-nav-text" tooltip>list</span></a></li><li class="devsite-nav-item"><a href="/web/20211123091127/https://developers.google.com/youtube/v3/docs/playlists/insert" class="devsite-nav-title"><span class="devsite-nav-text" tooltip>insert</span></a></li><li class="devsite-nav-item"><a href="/web/20211123091127/https://developers.google.com/youtube/v3/docs/playlists/update" class="devsite-nav-title"><span class="devsite-nav-text" tooltip>update</span></a></li><li class="devsite-nav-item"><a href="/web/20211123091127/https://developers.google.com/youtube/v3/docs/playlists/delete" class="devsite-nav-title"><span class="devsite-nav-text" tooltip>delete</span></a></li></ul></devsite-expandable-nav></li> <li class="devsite-nav-item devsite-nav-expandable"><devsite-expandable-nav collapsed> <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>Search</span></div><ul class="devsite-nav-section"><li class="devsite-nav-item"><a href="/web/20211123091127/https://developers.google.com/youtube/v3/docs/search" class="devsite-nav-title"><span class="devsite-nav-text" tooltip>Overview</span></a></li><li class="devsite-nav-item"><a href="/web/20211123091127/https://developers.google.com/youtube/v3/docs/search/list" class="devsite-nav-title"><span class="devsite-nav-text" tooltip>list</span></a></li></ul></devsite-expandable-nav></li> <li class="devsite-nav-item devsite-nav-expandable"><devsite-expandable-nav collapsed> <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>Subscriptions</span></div><ul class="devsite-nav-section"><li class="devsite-nav-item"><a href="/web/20211123091127/https://developers.google.com/youtube/v3/docs/subscriptions" class="devsite-nav-title"><span class="devsite-nav-text" tooltip>Overview</span></a></li><li class="devsite-nav-item"><a href="/web/20211123091127/https://developers.google.com/youtube/v3/docs/subscriptions/list" class="devsite-nav-title"><span class="devsite-nav-text" tooltip>list</span></a></li><li class="devsite-nav-item"><a href="/web/20211123091127/https://developers.google.com/youtube/v3/docs/subscriptions/insert" class="devsite-nav-title"><span class="devsite-nav-text" tooltip>insert</span></a></li><li class="devsite-nav-item"><a href="/web/20211123091127/https://developers.google.com/youtube/v3/docs/subscriptions/delete" class="devsite-nav-title"><span class="devsite-nav-text" tooltip>delete</span></a></li></ul></devsite-expandable-nav></li> <li class="devsite-nav-item devsite-nav-expandable"><devsite-expandable-nav collapsed> <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>Thumbnails</span></div><ul class="devsite-nav-section"><li class="devsite-nav-item"><a href="/web/20211123091127/https://developers.google.com/youtube/v3/docs/thumbnails" class="devsite-nav-title"><span class="devsite-nav-text" tooltip>Overview</span></a></li><li class="devsite-nav-item"><a href="/web/20211123091127/https://developers.google.com/youtube/v3/docs/thumbnails/set" class="devsite-nav-title"><span class="devsite-nav-text" tooltip>set</span></a></li></ul></devsite-expandable-nav></li> <li class="devsite-nav-item devsite-nav-expandable"><devsite-expandable-nav collapsed> <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>VideoAbuseReportReasons</span></div><ul class="devsite-nav-section"><li class="devsite-nav-item"><a href="/web/20211123091127/https://developers.google.com/youtube/v3/docs/videoAbuseReportReasons" class="devsite-nav-title"><span class="devsite-nav-text" tooltip>Overview</span></a></li><li class="devsite-nav-item"><a href="/web/20211123091127/https://developers.google.com/youtube/v3/docs/videoAbuseReportReasons/list" class="devsite-nav-title"><span class="devsite-nav-text" tooltip>list</span></a></li></ul></devsite-expandable-nav></li> <li class="devsite-nav-item devsite-nav-expandable"><devsite-expandable-nav collapsed> <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>VideoCategories</span></div><ul class="devsite-nav-section"><li class="devsite-nav-item"><a href="/web/20211123091127/https://developers.google.com/youtube/v3/docs/videoCategories" class="devsite-nav-title"><span class="devsite-nav-text" tooltip>Overview</span></a></li><li class="devsite-nav-item"><a href="/web/20211123091127/https://developers.google.com/youtube/v3/docs/videoCategories/list" class="devsite-nav-title"><span class="devsite-nav-text" tooltip>list</span></a></li></ul></devsite-expandable-nav></li> <li class="devsite-nav-item devsite-nav-expandable"><devsite-expandable-nav collapsed> <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>Videos</span></div><ul class="devsite-nav-section"><li class="devsite-nav-item"><a href="/web/20211123091127/https://developers.google.com/youtube/v3/docs/videos" class="devsite-nav-title"><span class="devsite-nav-text" tooltip>Overview</span></a></li><li class="devsite-nav-item"><a href="/web/20211123091127/https://developers.google.com/youtube/v3/docs/videos/list" class="devsite-nav-title"><span class="devsite-nav-text" tooltip>list</span></a></li><li class="devsite-nav-item"><a href="/web/20211123091127/https://developers.google.com/youtube/v3/docs/videos/insert" class="devsite-nav-title"><span class="devsite-nav-text" tooltip>insert</span></a></li><li class="devsite-nav-item"><a href="/web/20211123091127/https://developers.google.com/youtube/v3/docs/videos/update" class="devsite-nav-title"><span class="devsite-nav-text" tooltip>update</span></a></li><li class="devsite-nav-item"><a href="/web/20211123091127/https://developers.google.com/youtube/v3/docs/videos/rate" class="devsite-nav-title"><span class="devsite-nav-text" tooltip>rate</span></a></li><li class="devsite-nav-item"><a href="/web/20211123091127/https://developers.google.com/youtube/v3/docs/videos/getRating" class="devsite-nav-title"><span class="devsite-nav-text" tooltip>getRating</span></a></li><li class="devsite-nav-item"><a href="/web/20211123091127/https://developers.google.com/youtube/v3/docs/videos/reportAbuse" class="devsite-nav-title"><span class="devsite-nav-text" tooltip>reportAbuse</span></a></li><li class="devsite-nav-item"><a href="/web/20211123091127/https://developers.google.com/youtube/v3/docs/videos/delete" class="devsite-nav-title"><span class="devsite-nav-text" tooltip>delete</span></a></li></ul></devsite-expandable-nav></li> <li class="devsite-nav-item devsite-nav-expandable"><devsite-expandable-nav collapsed> <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>Watermarks</span></div><ul class="devsite-nav-section"><li class="devsite-nav-item"><a href="/web/20211123091127/https://developers.google.com/youtube/v3/docs/watermarks" class="devsite-nav-title"><span class="devsite-nav-text" tooltip>Overview</span></a></li><li class="devsite-nav-item"><a href="/web/20211123091127/https://developers.google.com/youtube/v3/docs/watermarks/set" class="devsite-nav-title"><span class="devsite-nav-text" tooltip>set</span></a></li><li class="devsite-nav-item"><a href="/web/20211123091127/https://developers.google.com/youtube/v3/docs/watermarks/unset" class="devsite-nav-title"><span class="devsite-nav-text" tooltip>unset</span></a></li></ul></devsite-expandable-nav></li> <li class="devsite-nav-item devsite-nav-expandable devsite-nav-deprecated"><devsite-expandable-nav collapsed> <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>GuideCategories</span><span class="devsite-nav-icon material-icons" data-icon="deprecated" data-title="Deprecated" aria-hidden="true"></span></div><ul class="devsite-nav-section"><li class="devsite-nav-item"><a href="/web/20211123091127/https://developers.google.com/youtube/v3/docs/guideCategories" class="devsite-nav-title"><span class="devsite-nav-text" tooltip>Overview</span></a></li><li class="devsite-nav-item"><a href="/web/20211123091127/https://developers.google.com/youtube/v3/docs/guideCategories/list" class="devsite-nav-title"><span class="devsite-nav-text" tooltip>list</span></a></li></ul></devsite-expandable-nav></li> <li class="devsite-nav-item devsite-nav-external"><a href="https://web.archive.org/web/20211123091127/https://cloud.google.com/apis/docs/system-parameters" class="devsite-nav-title"><span class="devsite-nav-text" tooltip>Standard Query Parameters</span><span class="devsite-nav-icon material-icons" data-icon="external" data-title="External" aria-hidden="true"></span></a></li> <li class="devsite-nav-item devsite-nav-expandable"><devsite-expandable-nav collapsed> <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>YouTube Data API Errors</span></div><ul class="devsite-nav-section"><li class="devsite-nav-item"><a href="/web/20211123091127/https://developers.google.com/youtube/v3/docs/errors" class="devsite-nav-title"><span class="devsite-nav-text" tooltip>Overview</span></a></li><li class="devsite-nav-item"><a href="/web/20211123091127/https://developers.google.com/youtube/v3/docs/core_errors" class="devsite-nav-title"><span class="devsite-nav-text" tooltip>Global Domain Errors</span></a></li></ul></devsite-expandable-nav></li> </ul> </div> </div> </nav> </devsite-book-nav> <section id="gc-wrapper"> <main role="main" class="devsite-main-content" has-book-nav has-sidebar> <div class="devsite-sidebar"> <div class="devsite-sidebar-content"> <devsite-toc class="devsite-nav" role="navigation" aria-label="On this page" depth="2" scrollbars></devsite-toc> <devsite-recommendations-sidebar class="nocontent devsite-nav"> </devsite-recommendations-sidebar> </div> </div> <devsite-content> <article class="devsite-article"> <div class="devsite-article-meta nocontent" role="navigation"> <ul class="devsite-breadcrumb-list" aria-label="Breadcrumb"> <li class="devsite-breadcrumb-item "> <a href="https://web.archive.org/web/20211123091127/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://web.archive.org/web/20211123091127/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://web.archive.org/web/20211123091127/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://web.archive.org/web/20211123091127/https://developers.google.com/youtube/v3" 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 Data API"> Data API </a> </li> <li class="devsite-breadcrumb-item "> <div class="devsite-breadcrumb-guillemet material-icons" aria-hidden="true"></div> <a href="https://web.archive.org/web/20211123091127/https://developers.google.com/youtube/v3/docs" 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=""> Reference </a> </li> </ul> <devsite-thumb-rating position="header"> </devsite-thumb-rating> </div> <h1 class="devsite-page-title">Comments: list</h1> <devsite-bookmark></devsite-bookmark> <devsite-toc class="devsite-nav" depth="2" devsite-toc-embedded> </devsite-toc> <devsite-recommendations-dropdown class="nocontent"></devsite-recommendations-dropdown> <div class="devsite-article-body clearfix "> <div itemscope itemtype="http://developers.google.com/ReferenceObject"> <meta itemprop="name" content="list"/> <meta itemprop="path" content="comments"/> <section id="overview"> <p>Returns a list of comments that match the API request parameters.</p> <p class="special"><b>Quota impact:</b> A call to this method has a <a href="/web/20211123091127/https://developers.google.com/youtube/v3/getting-started#quota">quota cost</a> of 1 unit.</p> </section> <h2 style="margin-bottom: 8px" id="common-use-cases" data-text="Common use cases">Common use cases</h2> <style> iframe + section > h2 { margin-top: 12px; } </style> <devsite-iframe><iframe src="/web/20211123091127if_/https://developers.google.com/youtube/v3/docs/comments/list_02af874dd5e776a393f848e81731bfc4869d5edda8875024926eb17012337b3a.frame" class="framebox inherit-locale " allow="clipboard-write https://developers-dot-devsite-v2-prod.appspot.com" allowfullscreen is-upgraded></iframe></devsite-iframe> <section id="request"> <h2 id="request" data-text="Request">Request</h2> <section id="request_url"> <h3 id="http-request" data-text="HTTP request">HTTP request</h3> <pre translate="no" dir="ltr">GET https://www.googleapis.com/youtube/v3/comments</pre> </section> <section id="params"> <h3 id="parameters" data-text="Parameters">Parameters</h3> <p>The following table lists the parameters that this query supports. All of the parameters listed are query parameters.</p> <table class="responsive details"> <thead> <tr> <th colspan="2">Parameters</th> </tr> </thead> <tbody> <tr id="required-parameters" class="alt"> <td colspan="3"><b>Required parameters</b></td> </tr> <tr id="part"> <td><code itemprop="property" translate="no" dir="ltr">part</code></td> <td><code class="apitype" translate="no" dir="ltr">string</code><br> The <code translate="no" dir="ltr"><strong>part</strong></code> parameter specifies a comma-separated list of one or more <code translate="no" dir="ltr">comment</code> resource properties that the API response will include.<br><br>The following list contains the <code translate="no" dir="ltr">part</code> names that you can include in the parameter value:<br><ul> <li><code translate="no" dir="ltr">id</code></li> <li><code translate="no" dir="ltr">snippet</code></li> </ul> </td> </tr> <tr id="filter-parameters" class="alt"> <td colspan="3"><b>Filters <span style="color:#555">(specify exactly one of the following parameters)</span></b></td> </tr> <tr id="id"> <td><code itemprop="property" translate="no" dir="ltr">id</code></td> <td><code class="apitype" translate="no" dir="ltr">string</code><br> The <code translate="no" dir="ltr"><strong>id</strong></code> parameter specifies a comma-separated list of comment IDs for the resources that are being retrieved. In a <code translate="no" dir="ltr">comment</code> resource, the <code translate="no" dir="ltr">id</code> property specifies the comment's ID.</td> </tr> <tr id="parentId"> <td><code itemprop="property" translate="no" dir="ltr">parentId</code></td> <td><code class="apitype" translate="no" dir="ltr">string</code><br> The <code translate="no" dir="ltr"><strong>parentId</strong></code> parameter specifies the ID of the comment for which replies should be retrieved. <br><br><strong>Note:</strong> YouTube currently supports replies only for top-level comments. However, replies to replies may be supported in the future.</td> </tr> <tr id="optional-parameters" class="alt"> <td colspan="3"><b>Optional parameters</b></td> </tr> <tr id="maxResults"> <td><code itemprop="property" translate="no" dir="ltr">maxResults</code></td> <td><code class="apitype" translate="no" dir="ltr">unsigned integer</code><br> The <code translate="no" dir="ltr"><strong>maxResults</strong></code> parameter specifies the maximum number of items that should be returned in the result set.<br><br><strong>Note:</strong> This parameter is not supported for use in conjunction with the <code translate="no" dir="ltr"><a href="#id">id</a></code> parameter. Acceptable values are <code translate="no" dir="ltr">1</code> to <code translate="no" dir="ltr">100</code>, inclusive. The default value is <code translate="no" dir="ltr">20</code>.</td> </tr> <tr id="pageToken"> <td><code itemprop="property" translate="no" dir="ltr">pageToken</code></td> <td><code class="apitype" translate="no" dir="ltr">string</code><br> The <code translate="no" dir="ltr"><strong>pageToken</strong></code> parameter identifies a specific page in the result set that should be returned. In an API response, the <code translate="no" dir="ltr">nextPageToken</code> property identifies the next page of the result that can be retrieved.<br><br><strong>Note:</strong> This parameter is not supported for use in conjunction with the <code translate="no" dir="ltr"><a href="#id">id</a></code> parameter.</td> </tr> <tr id="textFormat"> <td><code itemprop="property" translate="no" dir="ltr">textFormat</code></td> <td><code class="apitype" translate="no" dir="ltr">string</code><br> This parameter indicates whether the API should return comments formatted as HTML or as plain text. The default value is <code translate="no" dir="ltr">html</code>.<br/><br/>Acceptable values are: <ul> <li><code translate="no" dir="ltr"><strong>html</code></strong> – Returns the comments in HTML format. This is the default value.</li> <li><code translate="no" dir="ltr"><strong>plainText</code></strong> – Returns the comments in plain text format.</li> </ul> </td> </tr> </tbody> </table> </section> <section id="request_body"> <h3 id="request-body" data-text="Request body">Request body</h3> <p>Do not provide a request body when calling this method.</p> </section> </section> <section id="response"> <h2 id="response" data-text="Response">Response</h2> <section id="resource"> <p>If successful, this method returns a response body with the following structure:</p> <pre id="alt-json" class="prettyprint notranslate" style="max-height: 500px; overflow: auto" dir="ltr">{ "kind": "youtube#commentListResponse", "etag": <var class="apiparam" translate="no">etag</var>, "nextPageToken": <var class="apiparam" translate="no">string</var>, "pageInfo": { "totalResults": <var class="apiparam" translate="no">integer</var>, "resultsPerPage": <var class="apiparam" translate="no">integer</var> }, "items": [ <a href="/web/20211123091127/https://developers.google.com/youtube/v3/docs/comments#resource" class="resource-link" resource="comment">comment Resource</a> ] }</pre> </section> <section id="properties"> <h3 id="properties" data-text="Properties">Properties</h3> <p>The following table defines the properties that appear in this resource:</p> <table class="responsive properties" id="property-table"> <thead> <tr> <th colspan="2">Properties</th> </tr> </thead> <tbody> <tr id="kind"> <td><code itemprop="property" translate="no" dir="ltr">kind</code></td> <td><code class="apitype notranslate" dir="ltr">string</code><br> Identifies the API resource's type. The value will be <code translate="no" dir="ltr">youtube#commentListResponse</code>.</td> </tr> <tr id="etag"> <td><code itemprop="property" translate="no" dir="ltr">etag</code></td> <td><code class="apitype notranslate" dir="ltr">etag</code><br> The Etag of this resource.</td> </tr> <tr id="nextPageToken"> <td><code itemprop="property" translate="no" dir="ltr">nextPageToken</code></td> <td><code class="apitype notranslate" dir="ltr">string</code><br> The token that can be used as the value of the <code translate="no" dir="ltr">pageToken</code> parameter to retrieve the next page in the result set.</td> </tr> <tr id="pageInfo"> <td><code itemprop="property" translate="no" dir="ltr">pageInfo</code></td> <td><code class="apitype notranslate" dir="ltr">object</code><br> The <code translate="no" dir="ltr">pageInfo</code> object encapsulates paging information for the result set.</td> </tr> <tr id="pageInfo.totalResults"> <td><code itemprop="property" translate="no" dir="ltr"><span class="quiet">pageInfo.</span>totalResults</code></td> <td><code class="apitype notranslate" dir="ltr">integer</code><br> The total number of results in the result set.</td> </tr> <tr id="pageInfo.resultsPerPage"> <td><code itemprop="property" translate="no" dir="ltr"><span class="quiet">pageInfo.</span>resultsPerPage</code></td> <td><code class="apitype notranslate" dir="ltr">integer</code><br> The number of results included in the API response.</td> </tr> <tr id="items[]"> <td><code itemprop="property" translate="no" dir="ltr">items[]</code></td> <td><code class="apitype notranslate" dir="ltr">list</code><br> A list of comments that match the request criteria.</td> </tr> </tbody> </table> </section> </section> <section id="errors"> <h2 id="errors" data-text="Errors">Errors</h2> <p>The following table identifies error messages that the API could return in response to a call to this method. Please see the <a href="/web/20211123091127/https://developers.google.com/youtube/v3/docs/errors">error message</a> documentation for more detail.</p> <table class="matchpre" id="property-table"> <thead> <tr> <th>Error type</th> <th>Error detail</th> <th>Description</th> </tr> </thead> <tbody> <tr id="youtube.comments.list-badRequest-operationNotSupported"> <td class="error-name"><code translate="no" dir="ltr">badRequest (400)</code></td> <td class="error-reason"><code itemprop="property" translate="no" dir="ltr">operationNotSupported</code></td> <td class="error-cause">The id filter is only compatible with comments based on Google+.</td> </tr> <tr id="youtube.comments.list-forbidden-forbidden"> <td class="error-name"><code translate="no" dir="ltr">forbidden (403)</code></td> <td class="error-reason"><code itemprop="property" translate="no" dir="ltr">forbidden</code></td> <td class="error-cause">One or more of the requested comments cannot be retrieved due to insufficient permissions. The request might not be properly authorized.</td> </tr> <tr id="youtube.comments.list-notFound-commentNotFound"> <td class="error-name"><code translate="no" dir="ltr">notFound (404)</code></td> <td class="error-reason"><code itemprop="property" translate="no" dir="ltr">commentNotFound</code></td> <td class="error-cause">One or more of the specified comments cannot be found. Check the values of the request's <code translate="no" dir="ltr"><a href="/web/20211123091127/https://developers.google.com/youtube/v3/docs/comments/list#id">id</a></code> and <code translate="no" dir="ltr"><a href="/web/20211123091127/https://developers.google.com/youtube/v3/docs/comments/list#parentId">parentId</a></code> parameters to ensure that they are correct.</td> </tr> </tbody> </table> </section> <section id="try-it"> <h2 id="try-it" data-text="Try it!">Try it!</h2> <p>Use the <span class="notranslate">APIs Explorer</span> to call this API and see the API request and response.</p> <div class="devsite-apix"> <div class="apis-explorer" data-method-id="youtube.comments.list" data-show-code-button="true" data-discovery-rest-url="https://www.googleapis.com/discovery/v1/apis/youtube/v3/rest" data-default-scopes="https://www.googleapis.com/auth/youtube.readonly"></div> </div> </section> </div> </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> </article> <devsite-content-footer class="nocontent"> <p>Except as otherwise noted, the content of this page is licensed under the <a href="https://web.archive.org/web/20211123091127/https://creativecommons.org/licenses/by/4.0/">Creative Commons Attribution 4.0 License</a>, and code samples are licensed under the <a href="https://web.archive.org/web/20211123091127/https://www.apache.org/licenses/LICENSE-2.0">Apache 2.0 License</a>. For details, see the <a href="https://web.archive.org/web/20211123091127/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 2020-07-29 UTC.</p> </devsite-content-footer> <div class="devsite-content-data"> <template class="devsite-thumb-rating-down-categories"> [{ "type": "thumb-down", "id": "missingTheInformationINeed", "label":"Missing the information I need" },{ "type": "thumb-down", "id": "tooComplicatedTooManySteps", "label":"Too complicated / too many steps" },{ "type": "thumb-down", "id": "outOfDate", "label":"Out of date" },{ "type": "thumb-down", "id": "samplesCodeIssue", "label":"Samples / code issue" },{ "type": "thumb-down", "id": "otherDown", "label":"Other" }] </template> <template class="devsite-thumb-rating-up-categories"> [{ "type": "thumb-up", "id": "easyToUnderstand", "label":"Easy to understand" },{ "type": "thumb-up", "id": "solvedMyProblem", "label":"Solved my problem" },{ "type": "thumb-up", "id": "otherUp", "label":"Other" }] </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://web.archive.org/web/20211123091127/http://apiblog.youtube.com/" class="devsite-footer-promo-title gc-analytics-event" data-category="Site-Wide Custom Events" data-label="Footer Promo Link (index 1)"> <img class="devsite-footer-promo-icon" src="https://web.archive.org/web/20211123091127im_/https://www.gstatic.com/images/icons/material/product/2x/blogger_64dp.png" loading="lazy" alt="Blog"> Blog </a> <div class="devsite-footer-promo-description">The latest news on the YouTube API blog</div> </li> <li class="devsite-footer-promo"> <a href="https://web.archive.org/web/20211123091127/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)"> <img class="devsite-footer-promo-icon" src="/web/20211123091127im_/https://developers.google.com/site-assets/logo-github.svg" loading="lazy" alt="GitHub"> GitHub </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://web.archive.org/web/20211123091127/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)"> <img class="devsite-footer-promo-icon" src="/web/20211123091127im_/https://developers.google.com/site-assets/developers_64dp.png" loading="lazy" alt="Issue Tracker"> Issue Tracker </a> <div class="devsite-footer-promo-description">Something wrong? Send us a bug report!</div> </li> <li class="devsite-footer-promo"> <a href="https://web.archive.org/web/20211123091127/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)"> <img class="devsite-footer-promo-icon" src="/web/20211123091127im_/https://developers.google.com/site-assets/logo-stack-overflow.svg" loading="lazy" alt="Stack Overflow"> Stack Overflow </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://web.archive.org/web/20211123091127/https://www.youtube.com/user/YouTubeDev" class="devsite-footer-promo-title gc-analytics-event" data-category="Site-Wide Custom Events" data-label="Footer Promo Link (index 5)"> <img class="devsite-footer-promo-icon" src="/web/20211123091127im_/https://developers.google.com/site-assets/logo-youtube.svg" loading="lazy" alt="Videos"> Videos </a> <div class="devsite-footer-promo-description">Check out the YouTube Developer Relations team's YouTube channel</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://web.archive.org/web/20211123091127/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="/web/20211123091127/https://developers.google.com/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="/web/20211123091127/https://developers.google.com/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://web.archive.org/web/20211123091127/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://web.archive.org/web/20211123091127/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://web.archive.org/web/20211123091127/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="/web/20211123091127/https://developers.google.com/youtube/terms" 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="/web/20211123091127/https://developers.google.com/youtube/branding_guidelines" class="devsite-footer-linkbox-link gc-analytics-event" data-category="Site-Wide Custom Events" data-label="Footer Link (index 2)"> Branding Guidelines </a> </li> <li class="devsite-footer-linkbox-item"> <a href="/web/20211123091127/https://developers.google.com/youtube/creating_monetizable_applications" class="devsite-footer-linkbox-link gc-analytics-event" data-category="Site-Wide Custom Events" data-label="Footer Link (index 3)"> Monetization Guidelines </a> </li> <li class="devsite-footer-linkbox-item"> <a href="/web/20211123091127/https://developers.google.com/youtube/youtube-api-list" class="devsite-footer-linkbox-link gc-analytics-event" data-category="Site-Wide Custom Events" data-label="Footer Link (index 4)"> APIs subject to Deprecation Policy </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://web.archive.org/web/20211123091127/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"> <img class="devsite-footer-sites-logo" src="https://web.archive.org/web/20211123091127im_/https://www.gstatic.com/devrel-devsite/prod/v83c28b42a9d2de845cf6ea5b33e8c3314f0e1ea60229353829f7578993509959/developers/images/lockup-developers.svg" loading="lazy" alt="Google Developers"> </a> <ul class="devsite-footer-sites-list"> <li class="devsite-footer-sites-item"> <a href="//web.archive.org/web/20211123091127/https://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="//web.archive.org/web/20211123091127/https://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="//web.archive.org/web/20211123091127/https://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="//web.archive.org/web/20211123091127/https://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="/web/20211123091127/https://developers.google.com/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="/web/20211123091127/https://developers.google.com/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="//web.archive.org/web/20211123091127/https://policies.google.com/privacy" data-category="Site-Wide Custom Events" data-label="Footer Privacy link"> Privacy </a> </li> <li class="devsite-footer-utility-item devsite-footer-utility-button"> <span class="devsite-footer-utility-description">Sign up for the Google Developers newsletter</span> <a class="devsite-footer-utility-link gc-analytics-event" href="//web.archive.org/web/20211123091127/https://services.google.com/fb/forms/googledevelopersnewsletter/?utm_medium=referral&utm_source=google-products&utm_team=googledevs&utm_campaign=201611-newsletter-launch" data-category="Site-Wide Custom Events" data-label="Footer Subscribe link"> Subscribe </a> </li> </ul> <devsite-language-selector> <devsite-select class="devsite-language-selector-menu"> <select aria-label="Select your language preference." class="devsite-language-selector-select" name="language" track-name="click" track-type="languageSelector"> <option>Language</option> <option value="en" lang="en"> English </option> <option value="id" lang="id"> Bahasa Indonesia </option> <option value="de" lang="de"> Deutsch </option> <option value="es" lang="es"> Español </option> <option value="fr" lang="fr"> Français </option> <option value="pt_br" lang="pt_br"> Português – Brasil </option> <option value="ru" lang="ru"> Русский </option> <option value="zh_cn" lang="zh_cn"> 中文 – 简体 </option> <option value="ja" lang="ja"> 日本語 </option> <option value="ko" lang="ko"> 한국어 </option> </select> </devsite-select> </devsite-language-selector> </nav> </div> </devsite-footer-utility> <devsite-panel></devsite-panel> </section></section> <devsite-sitemask></devsite-sitemask> <devsite-snackbar> </devsite-snackbar> <devsite-tooltip></devsite-tooltip> <devsite-heading-link></devsite-heading-link> <devsite-analytics enable-analytics-iframe> <script type="application/json" analytics>[{"gaid": "UA-24532603-1", "dimensions": {"dimension5": "en", "dimension1": "Signed out", "dimension3": false, "dimension4": "YouTube Data API", "dimension11": false, "dimension6": "en"}, "metrics": {"ratings_value": "metric1", "ratings_count": "metric2"}}]</script> <script type="application/json" gtm>{"parameters": {"freeTrialEligibleUser": "False", "internalUser": "False", "language": {"machineTranslated": "False", "requested": "en", "served": "en"}, "pageType": "reference", "projectName": "YouTube Data API", "signedIn": "False", "tenant": "developers", "recommendations": {"sourcePage": "", "sourceType": 0, "sourceRank": 0, "sourceIdenticalDescriptions": 0, "sourceTitleWords": 0, "sourceDescriptionWords": 0, "experiment": ""}}}</script> </devsite-analytics> <devsite-badger></devsite-badger> <script nonce="92TkAyYtpjq/hQjE9Giz8vNaRWDRNr"> (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://web.archive.org/web/20211123091127/https://www.gstatic.com/devrel-devsite/prod/v83c28b42a9d2de845cf6ea5b33e8c3314f0e1ea60229353829f7578993509959/developers/js/app_loader.js', '[1,"en",null,"/js/devsite_app_module.js","https://web.archive.org/web/20211123091127/https://www.gstatic.com/devrel-devsite/prod/v83c28b42a9d2de845cf6ea5b33e8c3314f0e1ea60229353829f7578993509959","https://web.archive.org/web/20211123091127/https://www.gstatic.com/devrel-devsite/prod/v83c28b42a9d2de845cf6ea5b33e8c3314f0e1ea60229353829f7578993509959/developers","https://web.archive.org/web/20211123091127/https://developers-dot-devsite-v2-prod.appspot.com",null,null,["/_pwa/developers/manifest.json","https://web.archive.org/web/20211123091127/https://www.gstatic.com/devrel-devsite/prod/v83c28b42a9d2de845cf6ea5b33e8c3314f0e1ea60229353829f7578993509959/images/video-placeholder.svg","https://web.archive.org/web/20211123091127/https://www.gstatic.com/devrel-devsite/prod/v83c28b42a9d2de845cf6ea5b33e8c3314f0e1ea60229353829f7578993509959/developers/images/favicon.png","https://web.archive.org/web/20211123091127/https://fonts.googleapis.com/css?family=Google+Sans_old: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,40,45,50,63,70,75,76,80,87,91,92,93,97,98,100,101,102,103,104,105,107,108,109,110,111,112,113,115,116,117,118,120,122,123,124,125,126,127,128,129,130,131,132,133,134,135,136,138,141,142,144,147,148,149,150,151,152,153,154,157,159,161,164,165],"AIzaSyAP-jjEJBzmIyKR4F-3XITp8yM9T1gEEI8","AIzaSyB6xiKGDR5O3Ak2okS4rLkauxGUG7XP0hg","developers.google.com","AIzaSyAQk0fBONSGUqCNznf6Krs82Ap1-NV6J4o\n"]') </script> <devsite-a11y-announce></devsite-a11y-announce> </body> </html>

CINXE.COM

Comments: list | YouTube Data API | Google Developers