API referenceTikTok
TikTok comment replies
The reply thread under one comment.
TikTok nests exactly one level, so replies never have replies of their own.
Paging caveat, verified live: the platform reply cursor is off by one, page
2 repeats the last reply of page 1, so walking a thread yields duplicates
(and can skip the final reply). The cursor is passed through unchanged
rather than adjusted, because nudging it would risk dropping replies
silently. De-duplicate on comment_id, and use total to see the real
thread size. Requesting a page large enough to hold the whole thread in one
call avoids the issue entirely.
Authorization
ApiKeyAuth X-API-Key<token>
Your API key. Sent on every request.
In: header
Request Body
application/json
TypeScript Definitions
Use the request body type in TypeScript.
Response Body
application/json
application/json
application/json
application/json
curl -X POST "https://example.com/v1/scrapers/tiktok-comment-replies-v4" \ -H "Content-Type: application/json" \ -d '{ "video_id": "7612965843596479751", "comment_id": "7612966844110914334", "count": 20 }'{ "request_id": "req_8f2c1d94e7b0", "success": true, "status": { "code": "OK", "message": "Scrape completed.", "retryable": false }, "data": { "aweme_id": "7612965843596479751", "comment_id": "7612966844110914334", "comments": [ { "aweme_id": "7612965843596479751", "cid": "7612967610280805138", "comment_language": null, "create_time": 1772532161, "digg_count": 38, "image_list": null, "is_author_digged": null, "reply_comment": null, "reply_comment_total": null, "reply_id": null, "reply_to_reply_id": null, "status": 1, "text": "Thx𓀠𓀠", "text_extra": null, "user": { "avatar_larger": { "height": null, "uri": "https://p19-common-sign.tiktokcdn-us.com/tos-alisg-avt-0068/05fb1570b7fe0e2957d819ea183b2aa7~tplv-tiktokx-cropcenter-q:100:100:q70.jpeg?dr=8835&idc=useast5&ps=87d6e48a&refresh_token=f3e16f1c&s=COMMENT_LIST&sc=avatar&shcp=ff37627b&shp=30310797&t=223449c4&x-expires=1787572800&x-signature=Lat6nrntwFREsrEjTVlUMHwP42I%3D", "url_list": [ "https://p19-common-sign.tiktokcdn-us.com/tos-alisg-avt-0068/05fb1570b7fe0e2957d819ea183b2aa7~tplv-tiktokx-cropcenter-q:100:100:q70.jpeg?dr=8835&idc=useast5&ps=87d6e48a&refresh_token=f3e16f1c&s=COMMENT_LIST&sc=avatar&shcp=ff37627b&shp=30310797&t=223449c4&x-expires=1787572800&x-signature=Lat6nrntwFREsrEjTVlUMHwP42I%3D" ], "url_prefix": null, "width": null }, "avatar_medium": { "height": null, "uri": "https://p19-common-sign.tiktokcdn-us.com/tos-alisg-avt-0068/05fb1570b7fe0e2957d819ea183b2aa7~tplv-tiktokx-cropcenter-q:100:100:q70.jpeg?dr=8835&idc=useast5&ps=87d6e48a&refresh_token=f3e16f1c&s=COMMENT_LIST&sc=avatar&shcp=ff37627b&shp=30310797&t=223449c4&x-expires=1787572800&x-signature=Lat6nrntwFREsrEjTVlUMHwP42I%3D", "url_list": [ "https://p19-common-sign.tiktokcdn-us.com/tos-alisg-avt-0068/05fb1570b7fe0e2957d819ea183b2aa7~tplv-tiktokx-cropcenter-q:100:100:q70.jpeg?dr=8835&idc=useast5&ps=87d6e48a&refresh_token=f3e16f1c&s=COMMENT_LIST&sc=avatar&shcp=ff37627b&shp=30310797&t=223449c4&x-expires=1787572800&x-signature=Lat6nrntwFREsrEjTVlUMHwP42I%3D" ], "url_prefix": null, "width": null }, "avatar_thumb": { "height": null, "uri": "https://p19-common-sign.tiktokcdn-us.com/tos-alisg-avt-0068/05fb1570b7fe0e2957d819ea183b2aa7~tplv-tiktokx-cropcenter-q:100:100:q70.jpeg?dr=8835&idc=useast5&ps=87d6e48a&refresh_token=f3e16f1c&s=COMMENT_LIST&sc=avatar&shcp=ff37627b&shp=30310797&t=223449c4&x-expires=1787572800&x-signature=Lat6nrntwFREsrEjTVlUMHwP42I%3D", "url_list": [ "https://p19-common-sign.tiktokcdn-us.com/tos-alisg-avt-0068/05fb1570b7fe0e2957d819ea183b2aa7~tplv-tiktokx-cropcenter-q:100:100:q70.jpeg?dr=8835&idc=useast5&ps=87d6e48a&refresh_token=f3e16f1c&s=COMMENT_LIST&sc=avatar&shcp=ff37627b&shp=30310797&t=223449c4&x-expires=1787572800&x-signature=Lat6nrntwFREsrEjTVlUMHwP42I%3D" ], "url_prefix": null, "width": null }, "aweme_count": 0, "create_time": null, "favoriting_count": 0, "follower_count": 0, "following_count": 0, "language": null, "nickname": "ちい/Chii", "region": "JP", "sec_uid": "MS4wLjABAAAANiBD2T6ao7u2cE5Xj1zRRiVjShx-oKRUIDUFgHqmbyUkUOH-bk4iehKJ7eOsUkrJ", "secret": false, "signature": "⸝⋆꙳⟡.· ⋆ 𖦹ܾ 𖥧🪵🌿 \n \n🗺ɪɴꜱᴛᴀɢʀᴀᴍ : @ artchiist\n \nꜱᴜʙ:@たいやきくん(ちい) 🚹: @壱", "total_favorited": 0, "uid": "7093407411964986370", "unique_id": "artchiist", "verified": false }, "user_digged": null }, { "aweme_id": "7612965843596479751", "cid": "7613210339131638535", "comment_language": null, "create_time": 1772588679, "digg_count": 0, "image_list": null, "is_author_digged": null, "reply_comment": null, "reply_comment_total": null, "reply_id": null, "reply_to_reply_id": null, "status": 1, "text": "Can i get your phone number, miss", "text_extra": null, "user": { "avatar_larger": { "height": null, "uri": "https://p16-common-sign.tiktokcdn-us.com/tos-alisg-avt-0068/6e1e70870dcf01c258c6f90d6cd459a1~tplv-tiktokx-cropcenter-q:100:100:q70.jpeg?dr=8835&idc=useast5&ps=87d6e48a&refresh_token=b3ee73b7&s=COMMENT_LIST&sc=avatar&shcp=ff37627b&shp=30310797&t=223449c4&x-expires=1787572800&x-signature=d3HnYOnpyMczlhxf8hDCgYyfTuA%3D", "url_list": [ "https://p16-common-sign.tiktokcdn-us.com/tos-alisg-avt-0068/6e1e70870dcf01c258c6f90d6cd459a1~tplv-tiktokx-cropcenter-q:100:100:q70.jpeg?dr=8835&idc=useast5&ps=87d6e48a&refresh_token=b3ee73b7&s=COMMENT_LIST&sc=avatar&shcp=ff37627b&shp=30310797&t=223449c4&x-expires=1787572800&x-signature=d3HnYOnpyMczlhxf8hDCgYyfTuA%3D" ], "url_prefix": null, "width": null }, "avatar_medium": { "height": null, "uri": "https://p16-common-sign.tiktokcdn-us.com/tos-alisg-avt-0068/6e1e70870dcf01c258c6f90d6cd459a1~tplv-tiktokx-cropcenter-q:100:100:q70.jpeg?dr=8835&idc=useast5&ps=87d6e48a&refresh_token=b3ee73b7&s=COMMENT_LIST&sc=avatar&shcp=ff37627b&shp=30310797&t=223449c4&x-expires=1787572800&x-signature=d3HnYOnpyMczlhxf8hDCgYyfTuA%3D", "url_list": [ "https://p16-common-sign.tiktokcdn-us.com/tos-alisg-avt-0068/6e1e70870dcf01c258c6f90d6cd459a1~tplv-tiktokx-cropcenter-q:100:100:q70.jpeg?dr=8835&idc=useast5&ps=87d6e48a&refresh_token=b3ee73b7&s=COMMENT_LIST&sc=avatar&shcp=ff37627b&shp=30310797&t=223449c4&x-expires=1787572800&x-signature=d3HnYOnpyMczlhxf8hDCgYyfTuA%3D" ], "url_prefix": null, "width": null }, "avatar_thumb": { "height": null, "uri": "https://p16-common-sign.tiktokcdn-us.com/tos-alisg-avt-0068/6e1e70870dcf01c258c6f90d6cd459a1~tplv-tiktokx-cropcenter-q:100:100:q70.jpeg?dr=8835&idc=useast5&ps=87d6e48a&refresh_token=b3ee73b7&s=COMMENT_LIST&sc=avatar&shcp=ff37627b&shp=30310797&t=223449c4&x-expires=1787572800&x-signature=d3HnYOnpyMczlhxf8hDCgYyfTuA%3D", "url_list": [ "https://p16-common-sign.tiktokcdn-us.com/tos-alisg-avt-0068/6e1e70870dcf01c258c6f90d6cd459a1~tplv-tiktokx-cropcenter-q:100:100:q70.jpeg?dr=8835&idc=useast5&ps=87d6e48a&refresh_token=b3ee73b7&s=COMMENT_LIST&sc=avatar&shcp=ff37627b&shp=30310797&t=223449c4&x-expires=1787572800&x-signature=d3HnYOnpyMczlhxf8hDCgYyfTuA%3D" ], "url_prefix": null, "width": null }, "aweme_count": 0, "create_time": null, "favoriting_count": 0, "follower_count": 0, "following_count": 0, "language": null, "nickname": "zammsss_22810", "region": "ID", "sec_uid": "MS4wLjABAAAABLij8PZwNj6XHC_PTwhs0O2ITZEqhEVbB3VgSLIo_-OauKJbyq8DRmkSBEouesZA", "secret": false, "signature": null, "total_favorited": 0, "uid": "7495258080557712405", "unique_id": "zee.shahab_001", "verified": false }, "user_digged": null }, "… 1 more item in the full response" ], "cursor": null, "extra": null, "has_more": false, "log_pb": null, "status_code": 0, "status_msg": "", "total": 4 }, "error": null, "meta": { "client_id": "client_abc123", "scraper": "tiktok-comment-replies-v4", "billable": true, "duration_ms": 359 }}