Skip to content
truescrape
Free key

Contents

Site

YouTube Video Comments API

Open in ChatGPTOpen in ClaudeOpen in Gemini

Top-level comments on a video, about 20 per page. Pass pagination.cursor back as cursor for the next page. Each item that has replies also appears in replyCursors; feed that cursor to /v1/youtube/video/comment-replies. Use order=newest when polling for new comments, since top is re-ranked by YouTube and will churn. Calls cost 1 credit each. A cache hit is free, and a failed or empty response is never charged.

Try it

Prefilled with the request that produced the example below. No key yet? Get a free key.

Request

GET/v1/youtube/video/comments
ParameterTypeRequiredDescription
urlstringyesVideo URL or 11-character video id
ordertop | newestnodefaults to top
cursorstringnopagination.cursor from a previous response

Also accepts cache_max_age (a hit costs 0 credits) and include_raw (returns the untouched upstream payload under raw).

curl
curl "$API/v1/youtube/video/comments?url=https%3A%2F%2Fwww.youtube.com%2Fwatch%3Fv%3D0e3GPea1Tyg&cache_max_age=7d" \
  -H "x-api-key: $KEY"
JavaScript
const query = new URLSearchParams({
  url: 'https://www.youtube.com/watch?v=0e3GPea1Tyg',
  cache_max_age: '7d',
});

const response = await fetch(`${API}/v1/youtube/video/comments?${query}`, {
  headers: { 'x-api-key': KEY },
});

const body = await response.json();
if (!body.success) throw new Error(body.error.code);

// 1 credit, 0 on a cache hit
console.log(body.data, body.meta.creditsCharged);
Python
import os, httpx

r = httpx.get(
    f"{os.environ['API']}/v1/youtube/video/comments",
    params={
        "url": "https://www.youtube.com/watch?v=0e3GPea1Tyg",
        "cache_max_age": "7d",
    },
    headers={"x-api-key": os.environ["KEY"]},
    timeout=30,
)

body = r.json()
if not body["success"]:
    raise RuntimeError(body["error"]["code"])

print(body["data"], body["meta"]["creditsCharged"])

Example response

Captured on , with raw removed and lists cut to two items. A live call returns current data.

response
{
  "success": true,
  "data": {
    "items": [
      {
        "platform": "youtube",
        "id": "UgzH8vliQSJKHQMGZjx4AaABAg",
        "postId": "0e3GPea1Tyg",
        "parentId": null,
        "text": "Like I said in the video, subscribe if you haven’t already and you could win $10,000!",
        "authorId": "UCX6OQ3DkcsbYNE6H8uQQuVA",
        "authorHandle": "MrBeast",
        "authorName": "@MrBeast",
        "authorAvatarUrl": "https://yt3.ggpht.com/nxYrc_1_2f77DoBadyxMTmv7ZpRZapHR5jbuYe7PlPd5cIRJxtNNEYyOC0ZsxaDyJJzXrnJiuDE=s88-c-k-c0x00ffffff-no-rj",
        "likeCount": 1100000,
        "replyCount": 740,
        "isPinned": false,
        "isAuthorReply": true,
        "publishedAt": null
      },
      {
        "platform": "youtube",
        "id": "Ugz2W0D6UB1nWoB6wG14AaABAg",
        "postId": "0e3GPea1Tyg",
        "parentId": null,
        "text": "The sets in this are INCREDIBLE. Would love to know more about the team that designed and built them!",
        "authorId": "example-user-1",
        "authorHandle": "example_user_1",
        "authorName": "Example User 1",
        "authorAvatarUrl": "https://example.com/media/1.jpg",
        "likeCount": 69000,
        "replyCount": 200,
        "isPinned": false,
        "isAuthorReply": false,
        "publishedAt": null
      }
    ],
    "replyCursors": [
      {
        "commentId": "UgzH8vliQSJKHQMGZjx4AaABAg",
        "cursor": "eyJ0IjoiRWcwU0N6QmxNMGRRWldFeFZIbG5HQVl5Z3dFYVVCSWFWV2Q2U0RoMmJHbFJVMHBMU0ZGTlIxcHFlRFJCWVVGQ1FXY2lBZ2dBS2hoVlExZzJUMUV6Ukd0amMySlpUa1UyU0RoMVVWRjFWa0V5Q3pCbE0wZFFaV0V4VkhsblFBQklDb0lCQWdnQlFpOWpiMjF0Wlc1MExYSmxjR3hwWlhNdGFYUmxiUzFWWjNwSU9IWnNhVkZUU2t0SVVVMUhXbXA0TkVGaFFVSkJadyUzRCUzRCIsInYiOiJDZ3RJT0hKWFpWcFNhbDlrYnlpZ3QtRFdCaklLQ2dKVlV4SUVHZ0FnWkdLNUFncTJBa04xVlVKRFFWVlRiSGRGUWpoUlduVmFaMFpyWVVkQkxYTkZNMVpMV1V4R1pqZHhXRVp2VTBOQ1lWVlNaVlJITkVoYVpFZ3hPR0oxVDJrNVlVRm5ka3RGUTJ0clluQTBXRnBhZDJsT01rOW1TM0ozU1ZWWFJIVlFVR1oxVkRSNFQxQnVjR1pSTWtveFNqSnFZVnB4T0VGaVJWOHRRMDl1YUZkbVZGUlhaV3hpVVRWQk1tOHhXbmw0UzA1bFZsaGxVekEzYmpSc1FuVnZURTVJYldKa1IyRmtXSEJhUVZWb09VZFBlbDlrWDJoTE5tVnlOMGRHVGxablRVdE1YM1Y1UTBSR2JUUjNZa0oyVUVGbVZtbFhkemx0U3psMlMwRlZlVkpSU0dWeFdqRlFlVk56VjNCWVpubGtTa2gxV1hRMVYxcHphVVkwUjNWMVNHcDJNRzV4T1hScGVXVmlZMDlrV0RCdlNtSlJWamxqV2t4dmNFb3lSVFZpWkZONWRsaGFXbWxMUmtveGNYa3laVTVCWW5SaGVsVnBWR1JxUWtFJTNEIn0"
      },
      {
        "commentId": "Ugz2W0D6UB1nWoB6wG14AaABAg",
        "cursor": "eyJ0IjoiRWcwU0N6QmxNMGRRWldFeFZIbG5HQVl5Z3dFYVVCSWFWV2Q2TWxjd1JEWlZRakZ1VjI5Q05uZEhNVFJCWVVGQ1FXY2lBZ2dBS2hoVlExZzJUMUV6Ukd0amMySlpUa1UyU0RoMVVWRjFWa0V5Q3pCbE0wZFFaV0V4VkhsblFBRklDb0lCQWdnQlFpOWpiMjF0Wlc1MExYSmxjR3hwWlhNdGFYUmxiUzFWWjNveVZ6QkVObFZDTVc1WGIwSTJkMGN4TkVGaFFVSkJadyUzRCUzRCIsInYiOiJDZ3RJT0hKWFpWcFNhbDlrYnlpZ3QtRFdCaklLQ2dKVlV4SUVHZ0FnWkdLNUFncTJBa04xVlVKRFFWVlRiSGRGUWpoUlduVmFaMFpyWVVkQkxYTkZNMVpMV1V4R1pqZHhXRVp2VTBOQ1lWVlNaVlJITkVoYVpFZ3hPR0oxVDJrNVlVRm5ka3RGUTJ0clluQTBXRnBhZDJsT01rOW1TM0ozU1ZWWFJIVlFVR1oxVkRSNFQxQnVjR1pSTWtveFNqSnFZVnB4T0VGaVJWOHRRMDl1YUZkbVZGUlhaV3hpVVRWQk1tOHhXbmw0UzA1bFZsaGxVekEzYmpSc1FuVnZURTVJYldKa1IyRmtXSEJhUVZWb09VZFBlbDlrWDJoTE5tVnlOMGRHVGxablRVdE1YM1Y1UTBSR2JUUjNZa0oyVUVGbVZtbFhkemx0U3psMlMwRlZlVkpSU0dWeFdqRlFlVk56VjNCWVpubGtTa2gxV1hRMVYxcHphVVkwUjNWMVNHcDJNRzV4T1hScGVXVmlZMDlrV0RCdlNtSlJWamxqV2t4dmNFb3lSVFZpWkZONWRsaGFXbWxMUmtveGNYa3laVTVCWW5SaGVsVnBWR1JxUWtFJTNEIn0"
      }
    ]
  },
  "pagination": {
    "cursor": "eyJ0IjoiRWcwU0N6QmxNMGRRWldFeFZIbG5HQVl5bHdNSzJnSm5aWFJmY21GdWEyVmtYM04wY21WaGJYTXRMVU54V1VKRFNVRkZSbEpsTXpCVVoyRnRkMFZMYkdkRlNUSkdPRkZuUVZGWlFubExURUZhZFVkelJscE1SREo2U1hKWlVUaGhTakp6Wm01U01tcDBTbmhIY3pjd1FrMHpha0pQTVZKVmJrUnBRbVE0YjFoQ1FqQkxkRWN5VDIxNFUwdFJibUpTTVMxcVVqaEhOSEE0TTAwMWJuaGpjalppV2pOc1pYaHNVMlU0UkdWV1VVb3pWMFpoTkdoQ1MwRnVNVWxGY0ZZd2MwY3hRVkZaZEVaZlpESkJWREp0U3paR1ZGVm5hRkJyWTBONlpYazNia1JvUjBKSFJVNDBkVWRaVUd0WGJXcGtUREl0VkhWQ2EwTkJiMm8yTUdONFFXaHVRblpPZUVFeFkydFJSa0pKU0VOSlZXZEZRVkZaUVZKSlNFTkpZMmRGUVVWWlFVSkpSa05MWjJkSFFVRlRRbEZwU1VsQ1owRkZaMk5KYVZOQlVVRlNaMEZGWjFWSmFHbEJXVUZDU1VaRFRVRm5SMEZCVTBKM2FVVkpRa0ZRUjBGRlUwSlJhVGRKUW1kQlZVRkNXVUZSSWhFaUN6QmxNMGRRWldFeFZIbG5NQUI0QVNnVU1BRkNJV1Z1WjJGblpXMWxiblF0Y0dGdVpXd3RZMjl0YldWdWRITXRjMlZqZEdsdmJnJTNEJTNEIiwidiI6IkNndElPSEpYWlZwU2FsOWtieWlndC1EV0JqSUtDZ0pWVXhJRUdnQWdaR0s1QWdxMkFrTjFWVUpEUVZWVGJIZEZRamhSV25WYVowWnJZVWRCTFhORk0xWkxXVXhHWmpkeFdFWnZVME5DWVZWU1pWUkhORWhhWkVneE9HSjFUMms1WVVGbmRrdEZRMnRyWW5BMFdGcGFkMmxPTWs5bVMzSjNTVlZYUkhWUVVHWjFWRFI0VDFCdWNHWlJNa294U2pKcVlWcHhPRUZpUlY4dFEwOXVhRmRtVkZSWFpXeGlVVFZCTW04eFdubDRTMDVsVmxobFV6QTNialJzUW5WdlRFNUliV0prUjJGa1dIQmFRVlZvT1VkUGVsOWtYMmhMTm1WeU4wZEdUbFpuVFV0TVgzVjVRMFJHYlRSM1lrSjJVRUZtVm1sWGR6bHRTemwyUzBGVmVWSlJTR1Z4V2pGUWVWTnpWM0JZWm5sa1NraDFXWFExVjFwemFVWTBSM1YxU0dwMk1HNXhPWFJwZVdWaVkwOWtXREJ2U21KUlZqbGpXa3h2Y0VveVJUVmlaRk41ZGxoYVdtbExSa294Y1hreVpVNUJZblJoZWxWcFZHUnFRa0UlM0QifQ",
    "hasMore": true,
    "count": 20
  },
  "meta": {
    "platform": "youtube",
    "endpoint": "youtube.videoComments",
    "creditsCharged": 1,
    "cached": false,
    "cacheAgeSeconds": null,
    "durationMs": 3618,
    "requestId": "req_oh7mgbj3b3pdh64zx6ur"
  }
}

Returns

Returns an object with items, replyCursors.

Fields
FieldTypePresentDescription
itemsComment[]always
replyCursorsobject[]always
replyCursors[].commentIdstringalways
replyCursors[].cursorstringalwaysPass as `cursor` to /v1/youtube/video/comment-replies

Cost and behaviour

Credits1 per live request, 0 on a cache hit
Cacheableyes: cache_max_age accepts a cached copy
Batchableyes: usable as a target in POST /v1/jobs/batch
Subscribableyes: as often as every 3600 seconds, firing a webhook only on a change

Other YouTube endpoints

All YouTube endpointsThe unified schema