Skip to content

Structured TikTok data: every input is optional. Cursor-paginated, 1 credit per successful call.

GET · POST1 credit / successful callCursor-paginated
GEThttps://api.scrapier.io/api/v2/tiktok-comments/Open in Playground

Call GET /api/v2/tiktok-comments/. The results are in data.comments; send data.next_cursor back as cursor to get the next page. 11 optional parameters refine the call (see Parameters).

Terminal window
curl -G "https://api.scrapier.io/api/v2/tiktok-comments/" \
-H "X-API-Key: YOUR_API_KEY" \
--max-time 210
NameTypeRequiredDefaultDescription
X-API-Key headerstringyes—Your API key from the dashboard.
usernamesstringnomrbeastTikTok username (@ optional). Required on first call when manual_video_urls is not supplied; ignored when cursor is supplied.
manual_video_urlsstringno—TikTok video: full URL, vm.tiktok.com / vt.tiktok.com short link, or numeric video id. Takes precedence over usernames. Ignored when cursor is supplied.
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.
results_per_profileintegerno30Max videos discovered per profile. Locked into the cursor.
comments_per_postintegerno100Max top-level comments per video. Video input: empty = walk all comments. Usernames input: default 100 per video. Locked into the cursor.
max_replies_per_commentintegerno2Max replies fetched per comment (capped at 500; 0 = skip reply threads, fastest). Reply threads are fetched in parallel within a ~5s window per call; threads not fetched in time keep reply_comment_total and are listed in warning. Locked into the cursor.
profile_sectionsstringnovideosProfile section: videos or reposts (first one is used). Locked into the cursor.
profile_sortingstringnolatestSort: latest, oldest, or popular. Locked into the cursor.
oldest_post_datestringno—YYYY-MM-DD or days ago (e.g. 30). Locked into the cursor.
newest_post_datestringno—YYYY-MM-DD. Locked into the cursor.
exclude_pinnedbooleannofalseExclude pinned posts when scraping profiles. Locked into the 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": {
"manual_video_urls": "https://www.tiktok.com/@mrbeast/video/7606031409408478495",
"page": 1,
"page_size": 50,
"video_id": "7606031409408478495",
"total_comments": 41922,
"comments": [
{
"video_web_url": "https://www.tiktok.com/@mrbeast/video/7606031409408478495",
"submitted_video_url": "https://www.tiktok.com/@mrbeast/video/7606031409408478495",
"input": "https://www.tiktok.com/@mrbeast/video/7606031409408478495",
"video_id": "7606031409408478495",
"cid": "7606047946819388182",
"create_time": 1770921048,
"create_time_iso": "2026-02-12T18:30:48.000Z",
"text": "Mr beast should start a YouTube channel",
"digg_count": 47954,
"liked_by_author": false,
"pinned_by_author": false,
"replies_to_id": null,
"reply_comment_total": 340,
"uid": "7496601188525212704",
"unique_id": "bethel_slayys",
"nickname": "Bethel",
"avatar_thumbnail": "https://p16-common-sign.tiktokcdn.com/tos-maliva-avt-0068/ff59b62dbc0f46b34639e408f841b02b~tplv-tiktokx-cropcenter:100:100.jpg",
"mentions": [],
"detailed_mentions": [],
"replies": [
{
"video_web_url": "https://www.tiktok.com/@mrbeast/video/7606031409408478495",
"submitted_video_url": "https://www.tiktok.com/@mrbeast/video/7606031409408478495",
"input": "https://www.tiktok.com/@mrbeast/video/7606031409408478495",
"video_id": "7606031409408478495",
"cid": "7606097511056720661",
"create_time": 1770932595,
"create_time_iso": "2026-02-12T21:43:15.000Z",
"text": "re u telling me u don't know his YouTube channel???",
"digg_count": 2136,
"liked_by_author": false,
"pinned_by_author": false,
"replies_to_id": "7606047946819388182",
"reply_comment_total": 0,
"uid": "7569614956049581112",
"unique_id": "zha_bob",
"nickname": "Bob",
"avatar_thumbnail": "https://p16-common-sign.tiktokcdn.com/tos-alisg-avt-0068/3cb7c1199759fbe31a2d25e6ba0befc3~tplv-tiktokx-cropcenter:100:100.jpg",
"mentions": [],
"detailed_mentions": []
}
]
}
],
"next_cursor": "tc1.eNqlkN1ugjAARt-ltyOjKIKQLJlWJ06ZA0GnN4afDiuWYql2YHz39QF2t7svOfnOxbkDClxwAxq4kVwt24IW7BsmdEw4NO2h6QwUk4ochagbV9ellM-ClIKVzxmj-ivlKU4aoas_Zvrff1L9U5ABdwA1oDSmpYEauIYGGuVkO3uyOEU57PFUz6fzL1S0R6ce0uxKxlFpT7dxMg4DIv0ya8ZPSKS3NJ5sK-Jt0H4ZMHz1MG93HeKTERkthIcRii6VXgx3pzS2kiambShaOvIvTL6v51EsR2wdhscUBcaKB3YqM_vcrc7ZD5HO_BsWSbRwSM0tiIrgRp4G_Tzj_VWMzI-u6BZc_5yHYlYVV-j333YV9XiWG3sCcdw57ZpFpTGFpc9RsN9Siy0Npzni2cnfDLz3GcSb1K--r8XLi0pyLoF7BzT5OXBcnwluDjXmB1WU4kqoNAZ4aEAN03B6vccvSnCZqA"
}
}

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

FieldTypeExampleDescription
manual_video_urlsstringhttps://www.tiktok.com/@mrbeast/video/7606031…—
pageinteger1—
page_sizeinteger50—
video_idstring7606031409408478495—
total_commentsinteger41922—
commentsarray[1 item]The results.
next_cursorstringtc1.eNqlkN1ugjAARt-ltyOjKIKQLJlWJ06ZA0GnN4afD…Pass back as cursor for the next page. null on the last page.
comments[].video_web_urlstringhttps://www.tiktok.com/@mrbeast/video/7606031…—
comments[].submitted_video_urlstringhttps://www.tiktok.com/@mrbeast/video/7606031…—
comments[].inputstringhttps://www.tiktok.com/@mrbeast/video/7606031…—
comments[].video_idstring7606031409408478495—
comments[].cidstring7606047946819388182—
comments[].create_timeinteger1770921048—
comments[].create_time_isostring2026-02-12T18:30:48.000Z—
comments[].textstringMr beast should start a YouTube channel—
comments[].digg_countinteger47954—
comments[].liked_by_authorbooleanfalse—
comments[].pinned_by_authorbooleanfalse—
comments[].replies_to_idnullnull—
comments[].reply_comment_totalinteger340—
comments[].uidstring7496601188525212704—
comments[].unique_idstringbethel_slayys—
comments[].nicknamestringBethel—
comments[].avatar_thumbnailstringhttps://p16-common-sign.tiktokcdn.com/tos-mal…—
comments[].mentionsarray[]—
comments[].detailed_mentionsarray[]—
comments[].repliesarray[1 item]—

Pass data.next_cursor back as cursor until it is null. Required inputs are ignored once a cursor is sent. Each page is one billed call. More in Pagination.

const url = "https://api.scrapier.io/api/v2/tiktok-comments/";
let params = {};
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.comments ?? []));
if (!data.next_cursor) break; // null = last page
params = { cursor: data.next_cursor };
}

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
  • Nothing special: send the inputs, read the result.
  • TikTok Ad Library Leads — Structured TikTok data: every input is optional. Single lookup, 3 credits per successful call.
  • TikTok Ad Library — Structured TikTok data: send urls. Cursor-paginated, 1 credit per successful call.
  • TikTok Ads Top — Structured TikTok data: every input is optional. Cursor-paginated, 1 credit per successful call.
  • TikTok Collection Videos — Structured TikTok data: send urls. Cursor-paginated, 1 credit per successful call.