Skip to content

Structured TikTok data: send urls. Cursor-paginated, 1 credit per successful call.

GET Β· POST1 credit / successful callCursor-paginatedLong-running
GEThttps://api.scrapier.io/api/v2/tiktok-comment-replies/Open in Playground

Call GET /api/v2/tiktok-comment-replies/ with urls. 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-comment-replies/" \
-H "X-API-Key: YOUR_API_KEY" \
--data-urlencode "urls=https://www.tiktok.com/@gordonramsayofficial/video/7229884545150061851" \
--max-time 210
NameTypeRequiredDefaultDescription
X-API-Key headerstringyesβ€”Your API key from the dashboard.
urlsstringyese.g. https://www.tiktok.com/@gordonramsayofficial/video/7229884545150061851TikTok video URL (/video/ or /photo/), vm./vt./tiktok.com/t/ short link or bare 19-digit video id. One video per call; required on the first call, 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.
comments_per_postintegerno100Top-level comments to walk over the whole cursor chain, most relevant first (default 100; 0 = all).
locked in cursor
max_replies_per_commentintegerno1Replies per top-level comment (default 1; 0 = the whole thread β€” long threads are then split across calls by their native reply cursor).
locked in cursor
include_top_commentsbooleannotrueEmit the top-level comment row before its replies.
locked in cursor
hostsstringnousDatacenter walked by this cursor chain: us.tiktok.com (default) or www.tiktok.com β€” they order top-level comments differently, so each cursor chain walks ONE host.
uswww
locked in cursor
trimbooleannofalsetrue drops the heavy native object and detailed_mentions from every row.
locked in cursor
labelstringnoβ€”Comma list of judge presets to add (sentiment, question, purchase_intent, complaint run by default; spam, toxic, low_quality, injection on request; "none" = off).
locked in cursor
judgmentsstringnoonoff = no computed.labels.
onoff
locked in cursor
dropstringnoβ€”Comma subset of spam,low_quality dropped at p >= 0.8 (preset must be in label).
locked in cursor
evidencebooleannofalse1 adds computed.labels_evidence for the presets named in label.
locked in cursor
estimatebooleannofalse1 = one type: estimate row, no fetch, next_cursor null.
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": {
"urls": "https://www.tiktok.com/@gordonramsayofficial/video/7229884545150061851",
"video_id": "7229884545150061851",
"video_web_url": "https://www.tiktok.com/@gordonramsayofficial/video/7229884545150061851",
"host": "us",
"page": 1,
"page_size": 17,
"comments": [
{
"input_url": "https://www.tiktok.com/@gordonramsayofficial/video/7229884545150061851",
"video_id": "7229884545150061851",
"position": 1,
"type": "comment",
"video_web_url": "https://www.tiktok.com/@gordonramsayofficial/video/7229884545150061851",
"input": "gordonramsayofficial",
"cid": "7232628789942174466",
"create_time": 1683977626,
"create_time_iso": "2023-05-13T11:33:46.000Z",
"text": "any butter 🧈 left ???",
"digg_count": 2615,
"liked_by_author": false,
"pinned_by_author": false,
"replies_to_id": null,
"reply_comment_total": 4,
"uid": "207553808304951296",
"unique_id": "ryanparsons9",
"avatar_thumbnail": "https://p16-common-sign.tiktokcdn-us.com/tos-alisg-avt-0068/7334331588898979858~tplv-tiktokx-cropcenter:100:100.jpg?...",
"mentions": [],
"detailed_mentions": [],
"nickname": "Ryan Parsons",
"sec_uid": "MS4wLjABAAAAYrW8k_5EJfmut0B_Hna4DXqHkiKRrO18DGDaPVyNGiOxqMW1tak67FP-7zdWSOBs",
"comment_url": "https://m.tiktok.com/v/7229884545150061851.html?...&share_comment_id=7232628789942174466&...",
"comment_language": "en",
"is_high_purchase_intent": false,
"parent_comment_id": null,
"is_top_level": true,
"reply_to_reply_id": null,
"thread_has_more": false,
"user_verified": false,
"aweme_id": "7229884545150061851",
"native": {
"cid": "7232628789942174466",
"text": "any butter 🧈 left ???",
"digg_count": 2615,
"reply_id": "0",
"reply_comment_total": 4,
"user": {
"uid": "207553808304951296",
"unique_id": "ryanparsons9",
"nickname": "Ryan Parsons"
},
"...": "every other native TikTok comment field"
},
"computed": {
"labels": {
"sentiment": 0.5,
"question": 0.995,
"purchase_intent": 0.2315,
"complaint": 0.2142
}
},
"scraped_at": "2026-09-20T09:56:04.512Z"
},
{
"input_url": "https://www.tiktok.com/@gordonramsayofficial/video/7229884545150061851",
"video_id": "7229884545150061851",
"position": 2,
"type": "reply",
"video_web_url": "https://www.tiktok.com/@gordonramsayofficial/video/7229884545150061851",
"input": "gordonramsayofficial",
"cid": "7241426078106895150",
"create_time": 1686025914,
"create_time_iso": "2023-06-06T04:31:54.000Z",
"text": "You would have chopped me for that high heat and burnt burger πŸ” look at the onions there on fire πŸ”₯ lol",
"digg_count": 16,
"liked_by_author": false,
"pinned_by_author": false,
"replies_to_id": "7232628789942174466",
"reply_comment_total": 0,
"uid": "6838683227356890117",
"unique_id": "t_hill559",
"avatar_thumbnail": "https://p16-common-sign.tiktokcdn-us.com/...",
"mentions": [],
"detailed_mentions": [],
"nickname": "T-Hill",
"sec_uid": "MS4wLjABAAAAD0x7JDGQnc8tDkiZXRSujh__ina3KHeAppjFZRrHfdBukfNov8CO9sFPlsIc-SQQ",
"comment_url": "https://m.tiktok.com/v/7229884545150061851.html?...&share_comment_id=7241426078106895150&...",
"comment_language": "en",
"is_high_purchase_intent": false,
"parent_comment_id": "7232628789942174466",
"is_top_level": false,
"reply_to_reply_id": null,
"thread_has_more": false,
"user_verified": false,
"aweme_id": "7229884545150061851",
"native": {
"cid": "7241426078106895150",
"reply_id": "7232628789942174466",
"reply_to_reply_id": "0",
"digg_count": 16,
"user": {
"uid": "6838683227356890117",
"unique_id": "t_hill559",
"nickname": "T-Hill"
},
"...": "every other native TikTok comment field"
},
"computed": {
"labels": {
"sentiment": 0.8581,
"question": 0.3775,
"purchase_intent": 0.2315,
"complaint": 0.2142
}
},
"scraped_at": "2026-09-20T09:56:04.512Z"
},
"... 15 more rows in the same shape (next top-level comment, its reply, ...)"
],
"top_level_consumed": 13,
"in_thread": null,
"pending_threads": 0,
"warnings": [],
"next_cursor": "eyJ2IjoiNzIyOTg4NDU0NTE1MDA2MTg1MSIsInUiOiJodHRwczovL3d3dy50aWt0b2suY29tL0Bnb3Jkb25yYW1zYXlvZmZpY2lhbC92aWRlby83MjI5ODg0NTQ1MTUwMDYxODUxIiwidnUiOi4uLg"
}
}

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

FieldTypeExampleDescription
urlsstringhttps://www.tiktok.com/@gordonramsayofficial/…—
video_idstring7229884545150061851β€”
video_web_urlstringhttps://www.tiktok.com/@gordonramsayofficial/…—
hoststringusβ€”
pageinteger1β€”
page_sizeinteger17β€”
commentsarray[3 items]The results.
top_level_consumedinteger13β€”
in_threadnullnullβ€”
pending_threadsinteger0β€”
warningsarray[]β€”
next_cursorstringeyJ2IjoiNzIyOTg4NDU0NTE1MDA2MTg1MSIsInUiOiJod…Pass back as cursor for the next page. null on the last page.
comments[].input_urlstringhttps://www.tiktok.com/@gordonramsayofficial/…—
comments[].video_idstring7229884545150061851β€”
comments[].positioninteger1β€”
comments[].typestringcommentβ€”
comments[].video_web_urlstringhttps://www.tiktok.com/@gordonramsayofficial/…—
comments[].inputstringgordonramsayofficialβ€”
comments[].cidstring7232628789942174466β€”
comments[].create_timeinteger1683977626β€”
comments[].create_time_isostring2023-05-13T11:33:46.000Zβ€”
comments[].textstringany butter 🧈 left ???β€”
comments[].digg_countinteger2615β€”
comments[].liked_by_authorbooleanfalseβ€”
comments[].pinned_by_authorbooleanfalseβ€”
comments[].replies_to_idnullnullβ€”
comments[].reply_comment_totalinteger4β€”
comments[].uidstring207553808304951296β€”
comments[].unique_idstringryanparsons9β€”
comments[].avatar_thumbnailstringhttps://p16-common-sign.tiktokcdn-us.com/tos-…—
comments[].mentionsarray[]β€”
comments[].detailed_mentionsarray[]β€”
comments[].nicknamestringRyan Parsonsβ€”
comments[].sec_uidstringMS4wLjABAAAAYrW8k_5EJfmut0B_Hna4DXqHkiKRrO18D…—
comments[].comment_urlstringhttps://m.tiktok.com/v/7229884545150061851.ht…—
comments[].comment_languagestringenβ€”
comments[].is_high_purchase_intentbooleanfalseβ€”
comments[].parent_comment_idnullnullβ€”
comments[].is_top_levelbooleantrueβ€”
comments[].reply_to_reply_idnullnullβ€”
comments[].thread_has_morebooleanfalseβ€”
comments[].user_verifiedbooleanfalseβ€”
comments[].aweme_idstring7229884545150061851β€”
comments[].nativeobject{…}β€”
comments[].computedobject{…}β€”
comments[].scraped_atstring2026-09-20T09:56:04.512Zβ€”

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-comment-replies/";
let params = { urls: "https://www.tiktok.com/@gordonramsayofficial/video/7229884545150061851" };
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
  • Locked into the cursor: comments_per_post, max_replies_per_comment, include_top_comments, hosts, trim, label, judgments, drop, evidence. Set them on the first call; later pages reuse them.
  • This endpoint can take several minutes. Set your client timeout to at least 210 seconds.
  • 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.