← API Store
Social
YouTube
YouTube
YouTube video comments
GET /youtube/v1/commentsPass 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
| Name | Type | Description |
|---|---|---|
video_idrequired | string | Example: dQw4w9WgXcQ |
sort | top | newest | top (default) or newest, as in the comments header; next_cursor keeps the order. |
cursor | string | Cursor 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 |
$.cached | boolean |
$.comments | array |
$.comments[] | object | string |
$.comments[].author | string |
$.comments[].author_avatar | string |
$.comments[].author_channel_id | string |
$.comments[].author_handle | string |
$.comments[].author_is_artist | boolean |
$.comments[].author_url | string |
$.comments[].by_creator | boolean |
$.comments[].comment_key | string |
$.comments[].heart_tooltip | string |
$.comments[].hearted_by_creator | boolean |
$.comments[].id | string |
$.comments[].is_reply | boolean |
$.comments[].like_count | integer |
$.comments[].like_count_text | string |
$.comments[].likes | string |
$.comments[].pinned | boolean |
$.comments[].pinned_text | null |
$.comments[].published | string |
$.comments[].replies_cursor | string |
$.comments[].reply_count | integer |
$.comments[].reply_level | integer |
$.comments[].text | string |
$.comments[].verified | boolean |
$.credits_used | integer |
$.next_cursor | string |
$.total_comments | null |
$.video_id | string |