Search APIs
Loading…
← API Store
Social

YouTube

YouTube

YouTube video comments

GET /youtube/v1/comments
Test this endpoint

Pass next_cursor back as cursor for the next comments. next_cursor is null on the last page.

Every response includes credits_used: the credits this call cost.

Each call costs 1 credits; failed calls are free. Run it in the console playground to see a live result.

Parameters

NameTypeDescription
video_idrequiredstring Example: dQw4w9WgXcQ
sorttop | newesttop (default) or newest, as in the comments header; next_cursor keeps the order.
cursorstringCursor from `next_cursor` on the previous response; `next_cursor` is null on the last page.

Every endpoint also takes: raw、fields、fresh、output、records

{
  "cached": false,
  "comments": [
    {
      "author": "@grustache4569",
      "author_avatar": "https://yt3.ggpht.com/ytc/AIdro_kDD-FhIbth2qcBbI9VGxR41dJa0kE3kN9iVlGzNgRU_g=s88-c-k-c0x00ffffff-no-rj",
      "author_channel_id": "UCKrzgYonJnMd0Dk7zQXjYXw",
      "author_handle": "@grustache4569",
      "author_is_artist": false,
      "author_url": "https://www.youtube.com/@grustache4569",
      "by_creator": false,
      "comment_key": "EhpVZ3pLWWtzcWVRNWdBM3QwZzBGNEFhQUJBZyAoKAE%3D",
      "heart_tooltip": "❤ by @RickAstleyYT",
      "hearted_by_creator": true,
      "id": "UgzKYksqeQ5gA3t0g0F4AaABAg",
      "is_reply": false,
      "like_count": 105000,
      "like_count_text": "105K likes",
      "likes": "105K",
      "pinned": false,
      "pinned_text": null,
      "published": "6 years ago (edited)",
      "replies_cursor": "Eg0SC2RRdzR3OVdnWGNRGAYygwEaUBIaVWd6S1lrc3FlUTVnQTN0MGcwRjRBYUFCQWciAggAKhhVQ3VBWEZrZ3N3MUw3eGFDZm5kNUpKT3cyC2RRdzR3OVdnWGNRQAFICoIBAggBQi9j…",
      "reply_count": 635,
      "reply_level": 0,
      "text": "I Rick rolled my entire French class because we had to study a city in France and make a quiz about it as well as a presentation, I decided …",
      "verified": false
    },
    {
      "author": "@candycake9531",
      "author_avatar": "https://yt3.ggpht.com/ytc/AIdro_mEO82VrM8XtyGrBUkJgbAYgpAmDpUZixd1QvK9kyA=s88-c-k-c0x00ffffff-no-rj",
      "author_channel_id": "UCNLgzvqrGzFi5SEAbVkFchg",
      "author_handle": "@candycake9531",
      "author_is_artist": false,
      "author_url": "https://www.youtube.com/@candycake9531",
      "by_creator": false,
      "comment_key": "EhpVZ3h6YnZfWmVaWE5SY2Z3c1NGNEFhQUJBZyAoKAE%3D",
      "heart_tooltip": "❤ by @RickAstleyYT",
      "hearted_by_creator": true,
      "id": "Ugxzbv_ZeZXNRcfwsSF4AaABAg",
      "is_reply": false,
      "like_count": 292000,
      "like_count_text": "292K likes",
      "likes": "292K",
      "pinned": false,
      "pinned_text": null,
      "published": "6 years ago",
      "replies_cursor": "Eg0SC2RRdzR3OVdnWGNRGAYygwEaUBIaVWd4emJ2X1plWlhOUmNmd3NTRjRBYUFCQWciAggAKhhVQ3VBWEZrZ3N3MUw3eGFDZm5kNUpKT3cyC2RRdzR3OVdnWGNRQAFICoIBAggBQi9j…",
      "reply_count": 712,
      "reply_level": 0,
      "text": "Is everyone going to ignore the fact that Rick Astley looks like a twelve year old boy but has a uniquely deep voice?",
      "verified": false
    },
    "… 18 more"
  ],
  "credits_used": 1,
  "next_cursor": "Eg0SC2RRdzR3OVdnWGNRGAYylAMK1wJnZXRfcmFua2VkX3N0cmVhbXMtLUNxWUJDSUFFRlJlMzBUZ2Ftd0VLbGdFSTJGOFFnQVFZQnlLTEFadmdQUlZ2YlhiMU1Sa1BiWHBleWdhU0JW…",
  "total_comments": null,
  "video_id": "dQw4w9WgXcQ"
}
Response fields (31)

Field paths and types observed in the sample response; the live response is authoritative.

$object
$.cachedboolean
$.commentsarray
$.comments[]object | string
$.comments[].authorstring
$.comments[].author_avatarstring
$.comments[].author_channel_idstring
$.comments[].author_handlestring
$.comments[].author_is_artistboolean
$.comments[].author_urlstring
$.comments[].by_creatorboolean
$.comments[].comment_keystring
$.comments[].heart_tooltipstring
$.comments[].hearted_by_creatorboolean
$.comments[].idstring
$.comments[].is_replyboolean
$.comments[].like_countinteger
$.comments[].like_count_textstring
$.comments[].likesstring
$.comments[].pinnedboolean
$.comments[].pinned_textnull
$.comments[].publishedstring
$.comments[].replies_cursorstring
$.comments[].reply_countinteger
$.comments[].reply_levelinteger
$.comments[].textstring
$.comments[].verifiedboolean
$.credits_usedinteger
$.next_cursorstring
$.total_commentsnull
$.video_idstring