# Comment replies > The replies to one YouTube comment. - **Request:** `GET https://api.lurkapi.com/v1/youtube/video/comment/replies` - **Auth:** `x-api-key` header ([get a free key](https://lurkapi.com/login?next=/dashboard)) - **Cost:** 1 credit per call. Validation errors, `401`/`402`/`429` rejections and `5xx` failures are free; `not_found` is charged ([how charging works](https://lurkapi.com/docs.md#credits)). - **MCP tool:** `youtube_comment_replies` on `https://api.lurkapi.com/mcp` - **Freshness:** responses are cached for up to 10 minutes - **Try it live:** https://lurkapi.com/docs/youtube/comment-replies#try (no signup) - **Platform:** [YouTube](https://lurkapi.com/docs/youtube.md) (youtube.com) - **Web page:** https://lurkapi.com/docs/youtube/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. | Name | Type | Required | Default | Allowed values | Description | Example | | --- | --- | --- | --- | --- | --- | --- | | `continuationToken` | string | yes | | | A comment's `repliesContinuationToken` from video comments, or the `continuationToken` from a previous replies page. | `Eg0SC2RRdzR3OVdnWGNRGAYygwEaUBIaVWd6Z2UzNDBkQmdCNzVoV0JtNTRBYUFCQWciAggAKhhVQ3VBWEZrZ3N3MUw3eGFDZm5kNUpKT3cyC2RRdzR3OVdnWGNRQABICoIBAggBQi9jb21tZW50LXJlcGxpZXMtaXRlbS1VZ3pnZTM0MGRCZ0I3NWhXQm01NEFhQUJBZw%3D%3D` | ## Example request Replace `YOUR_API_KEY` with your key, or set `LURKAPI_KEY` for the code. [Get a free key](https://lurkapi.com/login?next=/dashboard). curl: ```bash curl "https://api.lurkapi.com/v1/youtube/video/comment/replies?continuationToken=Eg0SC2RRdzR3OVdnWGNRGAYygwEaUBIaVWd6Z2UzNDBkQmdCNzVoV0JtNTRBYUFCQWciAggAKhhVQ3VBWEZrZ3N3MUw3eGFDZm5kNUpKT3cyC2RRdzR3OVdnWGNRQABICoIBAggBQi9jb21tZW50LXJlcGxpZXMtaXRlbS1VZ3pnZTM0MGRCZ0I3NWhXQm01NEFhQUJBZw%253D%253D" \ -H "x-api-key: YOUR_API_KEY" ``` JavaScript: ```js 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: ```python 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 `…`. 200 OK (application/json): ```json { "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. | 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 `.`. | | `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` | `string`, nullable | 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` | `string`, nullable | 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` | `string`, nullable | Author's avatar URL. | | `comments[].author.channelUrl` | `string`, nullable | 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` | `string`, nullable | 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` | `string`, nullable | 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](https://lurkapi.com/docs.md#credits)). [All error codes](https://lurkapi.com/docs.md#errors). | 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](https://lurkapi.com/docs.md#claude), this endpoint is the `youtube_comment_replies` tool. Ask in plain English, for example: Ask Claude: ```text 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: ```json { "continuationToken": "Eg0SC2RRdzR3OVdnWGNRGAYygwEaUBIaVWd6Z2UzNDBkQmdCNzVoV0JtNTRBYUFCQWciAggAKhhVQ3VBWEZrZ3N3MUw3eGFDZm5kNUpKT3cyC2RRdzR3OVdnWGNRQABICoIBAggBQi9jb21tZW50LXJlcGxpZXMtaXRlbS1VZ3pnZTM0MGRCZ0I3NWhXQm01NEFhQUJBZw%3D%3D" } ``` Tool results skip nulls and empty lists to save tokens. --- Previous: [Video comments](https://lurkapi.com/docs/youtube/comments.md) · Next: [Channel details](https://lurkapi.com/docs/youtube/channel.md)