Skip to content

Structured YouTube data: send continuation_tokens. Cursor-paginated, 1 credit per successful call.

GET · POST1 credit / successful callCursor-paginatedNeeds your session cookie
GEThttps://api.scrapier.io/api/v2/youtube-comment-replies/Open in Playground

Call GET /api/v2/youtube-comment-replies/ with continuation_tokens. The results are in data.thread; send data.next_cursor back as cursor to get the next page. 4 optional parameters refine the call (see Parameters).

Terminal window
curl -G "https://api.scrapier.io/api/v2/youtube-comment-replies/" \
-H "X-API-Key: YOUR_API_KEY" \
--data-urlencode "continuation_tokens=YOUR_CONTINUATION_TOKENS" \
--max-time 210
NameTypeRequiredDefaultDescription
X-API-Key headerstringyes—Your API key from the dashboard.
continuation_tokensstringyes—Base64url reply continuation token from a "Show more replies" call -> ONE thread record (comments nested inside). Single lookup: next_cursor is always null. A truncated thread (hit max_items / an absolute page cap / a transport error) reports next_continuation_token on the row — resubmit it as a fresh continuation_tokens value to keep walking.
cursorstringno—Pagination cursor returned in the previous response's next_cursor. Pass it back unchanged to fetch the next page. When next_cursor is null, you have reached the last page.
max_itemsintegerno0Replies per thread. 0 or omitted = walk to exhaustion.
locked in cursor
languagestringnoeninnertube hl.
locked in cursor
regionstringnoUSinnertube gl.
locked in cursor
Advanced
NameTypeDefaultDescription
use_proxybooleantrueRoute the request through Scrapier's residential proxy pool. Default: true. Leave as is unless support tells you otherwise.
raw_databooleanfalseWhen true, the response carries the full raw upstream payload(s) the scraper received (GraphQL / JSON API bodies, HTML, embedded JSON-LD -- exactly as the platform returned them) under raw_responses, in place of the formatted items. When false (default) you get the formatted output. Pagination (cursor / next_cursor) works the same in both modes.
{
"success": true,
"data": {
"continuation_tokens": "Eg0SC3Y5UXRNNnFuRzUwGAYygwEaUBIaVWd4SHlJbmw3SXluZ1d2UjhnTjRBYUFCQWci...",
"thread": {
"input_continuation_token": "Eg0SC3Y5UXRNNnFuRzUwGAYygwEaUBIaVWd4SHlJbmw3SXluZ1d2UjhnTjRBYUFCQWci...",
"video_id": "v9QtM6qnG50",
"channel_id": "UCX6OQ3DkcsbYNE6H8uQQuVA",
"parent_comment_id": "UgxHyInl7IyngWvR8gN4AaABAg",
"video_title": "I Built A City To Save Kids From Illegal Labor",
"success": true,
"error": null,
"comments": [
{
"id": "UgxHyInl7IyngWvR8gN4AaABAg.AawtXymnHK1AawtnXUJNIO",
"content": "excellent job.",
"published_time_text": "3 days ago",
"published_time": "2026-09-20T08:08:34.750Z",
"reply_level": 1,
"author": {
"name": "@flow1n26",
"channel_id": "UCINudLBlbZCxSEugSRR7dCw",
"is_verified": false,
"is_creator": false,
"avatar_url": "https://yt3.ggpht.com/ytc/AIdro_lHq7nyOQOfims3HaL7WVdERI9RRMCkFIh5R21icJiVxc15lI8jurnAjKeeUVvfLfAcZw=s88-c-k-c0x00ffffff-no-rj",
"channel_url": "https://youtube.com/@flow1n26"
},
"engagement": {
"likes": 524,
"replies": 9
}
}
],
"reply_count": 1,
"next_continuation_token": null,
"has_more": false,
"scraped_at": "2026-09-23T08:08:42.049Z"
},
"next_cursor": null
}
}

Sample from the live catalog; arrays trimmed to 3 items. Results are in data.thread.

FieldTypeExampleDescription
continuation_tokensstringEg0SC3Y5UXRNNnFuRzUwGAYygwEaUBIaVWd4SHlJbmw3S…—
threadobject{…}The results.
next_cursornullnullPass back as cursor for the next page. null on the last page.
thread.input_continuation_tokenstringEg0SC3Y5UXRNNnFuRzUwGAYygwEaUBIaVWd4SHlJbmw3S…—
thread.video_idstringv9QtM6qnG50—
thread.channel_idstringUCX6OQ3DkcsbYNE6H8uQQuVA—
thread.parent_comment_idstringUgxHyInl7IyngWvR8gN4AaABAg—
thread.video_titlestringI Built A City To Save Kids From Illegal Labor—
thread.successbooleantrue—
thread.errornullnull—
thread.commentsarray[1 item]—
thread.reply_countinteger1—
thread.next_continuation_tokennullnull—
thread.has_morebooleanfalse—
thread.scraped_atstring2026-09-23T08:08:42.049Z—

Pass data.next_cursor back as cursor until it is null. Required inputs are ignored once a cursor is sent, but continuation_tokens must be sent on every page. Each page is one billed call. More in Pagination.

const url = "https://api.scrapier.io/api/v2/youtube-comment-replies/";
let params = { continuation_tokens: "YOUR_CONTINUATION_TOKENS" };
const items = [];
for (let page = 0; page < 10; page++) { // each page is one billed call
const res = await fetch(`${url}?${new URLSearchParams(params)}`, {
headers: { "X-API-Key": "YOUR_API_KEY" },
signal: AbortSignal.timeout(210_000),
});
const body = await res.json();
if (!res.ok) throw new Error(body.error ?? body.detail ?? `HTTP ${res.status}`);
const data = body.data;
items.push(data.thread);
if (!data.next_cursor) break; // null = last page
params = { cursor: data.next_cursor, ...{ continuation_tokens: "YOUR_CONTINUATION_TOKENS" } };
}

Failed calls are free. Branch on the HTTP status and read the message from error (or detail). Full details in Errors.

StatusMeaningRetry?Charged?
400Bad or missing input.No — fix the paramsNo
401 / 403Missing, invalid or revoked API key.No — fix the keyNo
402Out of credits (body has balance).No — top upNo
404Unknown endpoint slug.No — check the slugNo
429 / 503Busy or throttled.Yes — after Retry-AfterNo
5xxTarget site or upstream failure, or timeout.Yes — with backoffNo
  • This endpoint needs your own logged-in session cookie (continuation_tokens). Use a throwaway account, send it on every page, and never share it. Request parameters, including any cookies you send, are stored in your request history and logs. See Responsible use.
  • Locked into the cursor: max_items, language, region. Set them on the first call; later pages reuse them.
  • The response data carries its own success field from the scraper. The outer success is what counts: an HTTP 200 with outer success: true is billed, even if the inner field says otherwise.