Docs · Comment replies

Comment replies

The replies to one YouTube comment.

1 credit per callFresh within 10 minutesMCP tool: youtube_comment_replies

GEThttps://api.lurkapi.com/v1/youtube/video/comment/replies

When to use this

Use it to read the conversation under a comment. Pass a comment's repliesContinuationToken from video comments as continuationToken. About 10 replies on the first page and up to 50 on later ones, oldest first.

Pagination. Pass the response's continuationToken back as continuationToken for more replies; it's null at the end.

Parameters

All parameters go in the query string.

Parameter	Description
`continuationToken` stringrequired	A comment's `repliesContinuationToken` from video comments, or the `continuationToken` from a previous replies page. Example `Eg0SC2RRdzR3OVdnWGNRGAYygwEaUBIaVWd6Z2UzNDBkQmdCNzVoV0JtNTRBYUFCQWciAggAKhhVQ3VBWEZrZ3N3MUw3eGFDZm5kNUpKT3cyC2RRdzR3OVdnWGNRQABICoIBAggBQi9jb21tZW50LXJlcGxpZXMtaXRlbS1VZ3pnZTM0MGRCZ0I3NWhXQm01NEFhQUJBZw%3D%3D`

Example request

Replace YOUR_API_KEY with your key, or set LURKAPI_KEY for the code. Get a free key.

curlJavaScriptPython

curl · paste into a terminal

curl "https://api.lurkapi.com/v1/youtube/video/comment/replies?continuationToken=Eg0SC2RRdzR3OVdnWGNRGAYygwEaUBIaVWd6Z2UzNDBkQmdCNzVoV0JtNTRBYUFCQWciAggAKhhVQ3VBWEZrZ3N3MUw3eGFDZm5kNUpKT3cyC2RRdzR3OVdnWGNRQABICoIBAggBQi9jb21tZW50LXJlcGxpZXMtaXRlbS1VZ3pnZTM0MGRCZ0I3NWhXQm01NEFhQUJBZw%253D%253D" \
  -H "x-api-key: YOUR_API_KEY"

JavaScript · reads your key from LURKAPI_KEY

const params = new URLSearchParams({
  continuationToken: "Eg0SC2RRdzR3OVdnWGNRGAYygwEaUBIaVWd6Z2UzNDBkQmdCNzVoV0JtNTRBYUFCQWciAggAKhhVQ3VBWEZrZ3N3MUw3eGFDZm5kNUpKT3cyC2RRdzR3OVdnWGNRQABICoIBAggBQi9jb21tZW50LXJlcGxpZXMtaXRlbS1VZ3pnZTM0MGRCZ0I3NWhXQm01NEFhQUJBZw%3D%3D",
});
const res = await fetch(`https://api.lurkapi.com/v1/youtube/video/comment/replies?${params}`, {
  headers: { "x-api-key": process.env.LURKAPI_KEY },
});
const data = await res.json();
if (!data.success) throw new Error(`${data.code}: ${data.error}`);
console.log(data.comments);

Python · reads your key from LURKAPI_KEY

import os
import requests

res = requests.get(
    "https://api.lurkapi.com/v1/youtube/video/comment/replies",
    params={
        "continuationToken": "Eg0SC2RRdzR3OVdnWGNRGAYygwEaUBIaVWd6Z2UzNDBkQmdCNzVoV0JtNTRBYUFCQWciAggAKhhVQ3VBWEZrZ3N3MUw3eGFDZm5kNUpKT3cyC2RRdzR3OVdnWGNRQABICoIBAggBQi9jb21tZW50LXJlcGxpZXMtaXRlbS1VZ3pnZTM0MGRCZ0I3NWhXQm01NEFhQUJBZw%3D%3D",
    },
    headers={"x-api-key": os.environ["LURKAPI_KEY"]},
    timeout=60,
)
data = res.json()
if not data["success"]:
    raise RuntimeError(f"{data['code']}: {data['error']}")
print(data["comments"])

Example response

A real response from this endpoint, captured from the live API and trimmed to a couple of items. Strings over 96 characters (mostly signed media URLs) are cut short and end in ….

Show the example response (2 KB)

{
  "success": true,
  "credits_remaining": 999983,
  "credits_charged": 1,
  "comments": [
    {
      "id": "Ugzge340dBgB75hWBm54AaABAg.AHE8_QAWJx9AHE9eIiztxR",
      "content": "YOUTUBE AND ONE LIKE WOOHAAAAH",
      "publishedTimeText": "1 year ago",
      "publishedTime": "2025-09-30T14:34:02.154Z",
      "replyLevel": 1,
      "author": {
        "name": "@linganguliguliwatcha",
        "channelId": "UCjFRISlX-LPxiqViJAE3h6Q",
        "isVerified": false,
        "isCreator": false,
        "avatarUrl": "https://yt3.ggpht.com/AbGqKNjK9k5tyOqdV7cdXx-GgnGuuGQ5wj8RN42U5YCDvYHT0v…",
        "channelUrl": "https://www.youtube.com/@linganguliguliwatcha"
      },
      "engagement": {
        "likes": 7500,
        "replies": 5
      },
      "repliesContinuationToken": null,
      "isPinned": false,
      "isHearted": false
    },
    {
      "id": "Ugzge340dBgB75hWBm54AaABAg.AHE8_QAWJx9AHEAB_-JmDA",
      "content": "HEY YOUTUBE",
      "publishedTimeText": "1 year ago",
      "publishedTime": "2025-09-30T14:34:02.154Z",
      "replyLevel": 1,
      "author": {
        "name": "@_bugrabilgin",
        "channelId": "UCg9tPtxMOieUEyhSv63uJ4g",
        "isVerified": false,
        "isCreator": false,
        "avatarUrl": "https://yt3.ggpht.com/LvMpN24GYYr8w43sGoMeYZYejDPJz_skehI6jm_XGGhfM5YeRa…",
        "channelUrl": "https://www.youtube.com/@_bugrabilgin"
      },
      "engagement": {
        "likes": 3100,
        "replies": 2
      },
      "repliesContinuationToken": null,
      "isPinned": false,
      "isHearted": false
    }
  ],
  "continuationToken": "Eg0SC2RRdzR3OVdnWGNRGAYy2AEKUWdldF9jb21tZW50X3dpdGhfcmVwbGllc19zdHJlYW0t…"
}

Response fields

Every field of a successful response. [] marks a list: a[].b is the b of each item in a. nullable fields can be null; optional fields can be missing.

Show all 23 fields

Field	Type	Description
success	true	Always true here; errors have `success: false`.
credits_remaining	number	Your balance after this call. On anonymous playground calls: free tries left today.
credits_charged	number	Credits this call cost; 0 on free endpoints. On anonymous playground calls: tries used (1).
comments	object[]	One page of replies (`replyLevel: 1`).
comments[].id	string	Comment id. Replies are `<parent id>.<reply id>`.
comments[].content	string	Comment text.
comments[].publishedTimeText	string	When it was posted, as YouTube shows it, e.g. "3 days ago" or "6 years ago (edited)".
comments[].publishedTime	stringnullable	Approximate post time, ISO 8601, worked out from publishedTimeText: only as precise as that text ("6 years ago" is ±6 months).
comments[].replyLevel	number	0 for a comment, 1 for a reply.
comments[].author	object	Who wrote it.
comments[].author.name	string	Author's handle, e.g. `@YouTube`.
comments[].author.channelId	stringnullable	Author's channel id, `UC…`.
comments[].author.isVerified	boolean	The author has a verified badge.
comments[].author.isCreator	boolean	The author is the video's creator.
comments[].author.avatarUrl	stringnullable	Author's avatar URL.
comments[].author.channelUrl	stringnullable	Author's channel page.
comments[].engagement	object	Likes and replies.
comments[].engagement.likes	number	Likes; YouTube rounds above 1,000 (321K → 321000).
comments[].engagement.replies	number	Number of replies.
comments[].repliesContinuationToken	stringnullable	Pass as `continuationToken` to comment replies to read the replies. null when there are none (and always on replies).
comments[].isPinned	boolean	Pinned by the creator.
comments[].isHearted	boolean	Hearted by the creator.
continuationToken	stringnullable	Pass as `continuationToken` for more replies. null on the last page.

Caching and freshness

Responses are cached for up to 10 minutes, so a repeat call within that window can return the same data. It still costs 1 credit.

Errors

Errors return { success: false, error, code, docs } with the HTTP status below. Validation errors, 401/402/429 rejections and 5xx failures are free; not_found is charged (how charging works). All error codes.

Status	Code	Meaning
401	`missing_api_key`	No API key. Send it in the `x-api-key` header.
401	`invalid_api_key`	The key is unknown or was revoked.
402	`insufficient_credits`	Not enough credits for this call. Buy a pack or wait for tomorrow's top-up.
405	`method_not_allowed`	Endpoints take GET with query params.
429	`rate_limited`	Too many calls at once. Wait for the `retry-after` seconds, then retry.
500	`internal_error`	Something broke on our side. Retry; 5xx errors are free.
502	`upstream_error`	The platform didn't give a usable answer. Retry; 5xx errors are free.
503	`upstream_busy`	All our connections to the platform are busy. Retry in a few seconds; 5xx errors are free.
504	`upstream_timeout`	The platform took over 30 seconds to answer. Retry; timeouts are free.

Use it in Claude

Once LurkAPI is connected to Claude, this endpoint is the youtube_comment_replies tool. Ask in plain English, for example:

Ask Claude

Use LurkAPI's youtube_comment_replies with continuationToken "Eg0SC2RRdzR3OVdnWGNRGAYygwEaUBIaVWd6Z2UzNDBkQmdCNzVoV0JtNTRBYUFCQWciAggAKhhVQ3VBWEZrZ3N3MUw3eGFDZm5kNUpKT3cyC2RRdzR3OVdnWGNRQABICoIBAggBQi9jb21tZW50LXJlcGxpZXMtaXRlbS1VZ3pnZTM0MGRCZ0I3NWhXQm01NEFhQUJBZw%3D%3D" and summarize what you find.

Claude calls youtube_comment_replies with arguments like these, and each call costs 1 credit:

Tool arguments

{
  "continuationToken": "Eg0SC2RRdzR3OVdnWGNRGAYygwEaUBIaVWd6Z2UzNDBkQmdCNzVoV0JtNTRBYUFCQWciAggAKhhVQ3VBWEZrZ3N3MUw3eGFDZm5kNUpKT3cyC2RRdzR3OVdnWGNRQABICoIBAggBQi9jb21tZW50LXJlcGxpZXMtaXRlbS1VZ3pnZTM0MGRCZ0I3NWhXQm01NEFhQUJBZw%3D%3D"
}

Tool results skip nulls and empty lists to save tokens.