> ## Documentation Index
> Fetch the complete documentation index at: https://docs.scraperize.com/llms.txt
> Use this file to discover all available pages before exploring further.
# Comment replies
> Scrapes the replies to a comment on a public TikTok video. Pass the video `url` and the comment’s `commentId` (the `id` from `/v1/tiktok/video/comments`). Each reply comes with its id, text, created date, detected language, like count, author (id, secUid, username, nickname, avatar, profile link), who it answers when it’s a reply to another reply (`replyTo`: user id, username, nickname, reply id), whether the creator liked it, TikTok’s labels, photo attachments, sticker (static and animated renditions), emoji tokens, share info (a deep link to the reply) and its parent / reply-to ids — about 20 per page, TikTok’s most-liked replies first, then the newest. Pass the returned `cursor` (with the same url and commentId) to get the next page; it is null on the last page. TikTok can repeat a reply or two at a page boundary, so de-duplicate by `id` when collecting a whole thread. A comment with no replies — or an id TikTok doesn’t know — returns an empty list.
**Cost: 1 credit** per successful request. Errors and cache hits (`cache_max_age`) are free.
Paste this into ChatGPT, Claude or your coding assistant to generate working code for this endpoint (use the copy button).
```text Prompt
I want to make an API call to /v1/tiktok/video/comment/replies. Here are the details:
Endpoint: GET https://api.scraperize.com/v1/tiktok/video/comment/replies
Description: Scrapes the replies to a comment on a public TikTok video. Pass the video `url` and the comment’s `commentId` (the `id` from `/v1/tiktok/video/comments`). Each reply comes with its id, text, created date, detected language, like count, author (id, secUid, username, nickname, avatar, profile link), who it answers when it’s a reply to another reply (`replyTo`: user id, username, nickname, reply id), whether the creator liked it, TikTok’s labels, photo attachments, sticker (static and animated renditions), emoji tokens, share info (a deep link to the reply) and its parent / reply-to ids — about 20 per page, TikTok’s most-liked replies first, then the newest. Pass the returned `cursor` (with the same url and commentId) to get the next page; it is null on the last page. TikTok can repeat a reply or two at a page boundary, so de-duplicate by `id` when collecting a whole thread. A comment with no replies — or an id TikTok doesn’t know — returns an empty list.
Required Headers:
- x-api-key: Your API key
Parameters:
- url (string) [required]: The URL of the TikTok video the comment is on, e.g. https://www.tiktok.com/@user/video/7683891628230315295.
- commentId (string) [required]: The comment’s id — the `id` of a comment from `/v1/tiktok/video/comments`.
- cursor (string): The `cursor` from the previous response, to get the next page. Omit for the first page.
- cache_max_age (select): Optional. Return a cached result if one this age or newer exists — served for **0 credits** with `meta.cached=true` and `meta.cachedAt`. Otherwise a fresh scrape runs (**1 credit**) and refreshes the cache. Omit to always scrape fresh.
Example Response:
{
"data": {
"video": {
"id": "7683891628230315295",
"url": "https://www.tiktok.com/@natgeo/video/7683891628230315295",
"handle": "natgeo"
},
"commentId": "7684049714988352276",
"replies": [
{
"id": "7684132893522559762",
"videoId": "7683891628230315295",
"parentId": "7684049714988352276",
"replyToId": null,
"text": "Australia is just the size of one African country 💀",
"createdAt": "2026-09-11T04:40:23.000Z",
"language": "en",
"likeCount": 57,
"author": {
"id": "7591198143678743608",
"secUid": "MS4wLjABAAAA3S83VV2xvaFVOQbLL5KnAhqnadk1Mrw_9EQNlmN4_BDhpX-sOAYk0MXr71W5NV78",
"handle": "hiluxman33",
"nickname": "jumpman",
"avatarUrl": "https://p16-common-sign.tiktokcdn.com/tos-alisg-avt-0068/689db69225a6dd3bbb48daa4bb9c7589~tplv-tiktokx-cropcenter:100:100.jpg?dr=14579&refresh_token=06525f84&x-…",
"url": "https://www.tiktok.com/@hiluxman33"
},
"isLikedByCreator": false,
"labels": [],
"images": [],
"sticker": null,
"emojis": [],
"isTranslatable": true,
"shareInfo": {
"url": "https://m.tiktok.com/v/7683891628230315295.html?_d=f6004hkm87m931&comment_author_id=7591198143678743608&preview_pb=0&share_comment_id=7684132893522559762&share_…",
"title": "Presented by @ROLEX. Welcome to Africa 🌍 Africa Earth's Wild Home takes you deep into the heart of our wildest continent, bringing you closer to its animals, l…",
"description": "jumpman’s comment: Australia is just the size of one African country 💀",
"acl": {
"code": 0,
"addToStoryCode": 0
}
},
"replyTo": null
}
],
"count": 15,
"total": 15,
"cursor": null,
"hasMore": false,
"fetchedAt": "2026-10-05T14:45:00.860Z"
},
"meta": {
"requestId": "req_8f0c2b7e-1a2b-4c3d-9e8f-0a1b2c3d4e5f",
"creditsCharged": 1,
"creditsRemaining": 4999,
"cached": false
}
}
Please help me write code in my preferred programming language to make this API call and handle the response appropriately. Include error handling and best practices.
```
## OpenAPI
````yaml /api-reference/openapi.json get /v1/tiktok/video/comment/replies
openapi: 3.0.3
info:
title: Scraperize API
version: 1.0.0
description: >-
Extract public data from social media platforms as clean JSON. Endpoints are
split by platform and by what they return, e.g. `GET /v1/twitter/tweet`.
## Authentication
Send your API key in the `x-api-key` header (or `Authorization: Bearer
`). Create keys in your dashboard.
## Credits
Each successful live scrape costs **1 credit**. Credits are prepaid and
never expire.
## Caching
Every endpoint accepts an optional `cache_max_age`
(`1d`|`3d`|`7d`|`14d`|`30d`). A cache hit within that window is returned for
**0 credits**.
## Responses
Success returns `{ "data": …, "meta": { "requestId", … } }`. Errors return
`{ "error": { "code", "message", "requestId" } }` with a matching HTTP
status. `meta` on a scrape carries `creditsCharged`, `creditsRemaining`,
`cached`, and (on a hit) `cachedAt`.
## Rate limits
Requests are limited per team per minute; over the limit returns `429` with
a `Retry-After` header.
servers:
- url: https://api.scraperize.com
description: Production
security:
- ApiKeyAuth: []
tags:
- name: Twitter
description: Twitter / X scraping endpoints
- name: Facebook
description: Facebook scraping endpoints
- name: Linkme
description: Linkme (link.me) scraping endpoints
- name: Amazon
description: Amazon (creator shop / storefront) scraping endpoints
- name: Linkbio
description: Linkbio (lnk.bio) scraping endpoints
- name: Pillar
description: Pillar (pillar.io) scraping endpoints
- name: Komi
description: Komi (komi.io) scraping endpoints
- name: Linktree
description: Linktree (linktr.ee) scraping endpoints
- name: Kick
description: Kick (kick.com) scraping endpoints
- name: Snapchat
description: Snapchat (snapchat.com) scraping endpoints
- name: Telegram
description: Telegram (t.me) scraping endpoints
- name: LinkedIn
description: LinkedIn scraping endpoints
- name: Twitch
description: Twitch scraping endpoints
- name: TikTok
description: TikTok (tiktok.com) scraping endpoints
paths:
/v1/tiktok/video/comment/replies:
get:
tags:
- TikTok
summary: Comment replies
description: >-
Scrapes the replies to a comment on a public TikTok video. Pass the
video `url` and the comment’s `commentId` (the `id` from
`/v1/tiktok/video/comments`). Each reply comes with its id, text,
created date, detected language, like count, author (id, secUid,
username, nickname, avatar, profile link), who it answers when it’s a
reply to another reply (`replyTo`: user id, username, nickname, reply
id), whether the creator liked it, TikTok’s labels, photo attachments,
sticker (static and animated renditions), emoji tokens, share info (a
deep link to the reply) and its parent / reply-to ids — about 20 per
page, TikTok’s most-liked replies first, then the newest. Pass the
returned `cursor` (with the same url and commentId) to get the next
page; it is null on the last page. TikTok can repeat a reply or two at a
page boundary, so de-duplicate by `id` when collecting a whole thread. A
comment with no replies — or an id TikTok doesn’t know — returns an
empty list.
parameters:
- name: url
in: query
required: true
description: >-
The URL of the TikTok video the comment is on, e.g.
https://www.tiktok.com/@user/video/7683891628230315295.
schema:
type: string
example: https://www.tiktok.com/@natgeo/video/7683891628230315295
- name: commentId
in: query
required: true
description: >-
The comment’s id — the `id` of a comment from
`/v1/tiktok/video/comments`.
schema:
type: string
pattern: ^\d{8,25}$
example: '7684049714988352276'
- name: cursor
in: query
required: false
description: >-
The `cursor` from the previous response, to get the next page. Omit
for the first page.
schema:
type: string
pattern: ^\d{1,10}$
example: '3'
- name: cache_max_age
in: query
required: false
description: >-
Optional. Return a cached result if one this age or newer exists —
served for **0 credits** with `meta.cached=true` and
`meta.cachedAt`. Otherwise a fresh scrape runs (**1 credit**) and
refreshes the cache. Omit to always scrape fresh.
schema:
type: string
enum:
- 1d
- 3d
- 7d
- 14d
- 30d
example: 7d
responses:
'200':
description: One page of the comment’s replies.
content:
application/json:
schema:
type: object
properties:
data:
type: object
properties:
video:
type: object
properties:
id:
type: string
url:
type: string
handle:
type: string
commentId:
type: string
replies:
type: array
items:
type: object
count:
type: integer
total:
type: integer
nullable: true
description: Total replies TikTok reports for the comment.
cursor:
type: string
nullable: true
hasMore:
type: boolean
fetchedAt:
type: string
format: date-time
meta:
type: object
description: >-
requestId + credit/caching metadata (creditsCharged,
creditsRemaining, cached, cachedAt).
required:
- data
- meta
example:
data:
video:
id: '7683891628230315295'
url: https://www.tiktok.com/@natgeo/video/7683891628230315295
handle: natgeo
commentId: '7684049714988352276'
replies:
- id: '7684132893522559762'
videoId: '7683891628230315295'
parentId: '7684049714988352276'
replyToId: null
text: Australia is just the size of one African country 💀
createdAt: '2026-09-11T04:40:23.000Z'
language: en
likeCount: 57
author:
id: '7591198143678743608'
secUid: >-
MS4wLjABAAAA3S83VV2xvaFVOQbLL5KnAhqnadk1Mrw_9EQNlmN4_BDhpX-sOAYk0MXr71W5NV78
handle: hiluxman33
nickname: jumpman
avatarUrl: >-
https://p16-common-sign.tiktokcdn.com/tos-alisg-avt-0068/689db69225a6dd3bbb48daa4bb9c7589~tplv-tiktokx-cropcenter:100:100.jpg?dr=14579&refresh_token=06525f84&x-expires=1791295200&x-signature=GqeYVxXsMzKoU0NfVr9%2B%2B%2B4LrIw%3D&t=4d5b0474&ps=13740610&shp=30310797&shcp=ff37627b&idc=my2
url: https://www.tiktok.com/@hiluxman33
isLikedByCreator: false
labels: []
images: []
sticker: null
emojis: []
isTranslatable: true
shareInfo:
url: >-
https://m.tiktok.com/v/7683891628230315295.html?_d=f6004hkm87m931&comment_author_id=7591198143678743608&preview_pb=0&share_comment_id=7684132893522559762&share_item_id=7683891628230315295&sharer_language=en&source=h5_m&u_code=0
title: >-
Presented by @ROLEX. Welcome to Africa 🌍 Africa
Earth's Wild Home takes you deep into the heart of our
wildest continent, bringing you closer to its animals,
landscapes, and the people watching over it than ever
before. Through its partnership with the National
Geographic Society and as part of its Perpetual Planet
Initiative, #Rolex supports expeditions exploring and
protecting remarkable places around the world, a
selection of which are featured in Africa Earth’s Wild
Home. #PerpetualPlanet Africa Earth's Wild Home,
narrated by Wunmi Mosaku, premieres Friday, October 2
at 8/7c on National Geographic. Streaming next day on
@Disney+ and @hulu.
description: >-
jumpman’s comment: Australia is just the size of one
African country 💀
acl:
code: 0
addToStoryCode: 0
replyTo: null
- id: '7684544868471882503'
videoId: '7683891628230315295'
parentId: '7684049714988352276'
replyToId: '7684132893522559762'
text: >-
3 times the size of algeria, the biggest African country
but yeah 😭
createdAt: '2026-09-12T07:18:59.000Z'
language: en
likeCount: 0
author:
id: '7497884025308546054'
secUid: >-
MS4wLjABAAAAkkTmTp-TPBTfkTw4sMTt8ATsBD8Pym9TM79FbS_4Lgj7IlhZFLUglgnCJrb3G7Ll
handle: idfw.mello
nickname: mello
avatarUrl: >-
https://p16-common-sign.tiktokcdn.com/tos-alisg-avt-0068/2bf7d319d123c5a6215a8050a82cbfd1~tplv-tiktokx-cropcenter:100:100.jpg?dr=14579&refresh_token=e1f4ba23&x-expires=1791295200&x-signature=RQEg9vCYC4jGZlHybwHxvta37tY%3D&t=4d5b0474&ps=13740610&shp=30310797&shcp=ff37627b&idc=my2
url: https://www.tiktok.com/@idfw.mello
isLikedByCreator: false
labels: []
images: []
sticker: null
emojis: []
isTranslatable: true
shareInfo:
url: >-
https://m.tiktok.com/v/7683891628230315295.html?_d=f6004hkm87m931&comment_author_id=7497884025308546054&preview_pb=0&share_comment_id=7684544868471882503&share_item_id=7683891628230315295&sharer_language=en&source=h5_m&u_code=0
title: >-
Presented by @ROLEX. Welcome to Africa 🌍 Africa
Earth's Wild Home takes you deep into the heart of our
wildest continent, bringing you closer to its animals,
landscapes, and the people watching over it than ever
before. Through its partnership with the National
Geographic Society and as part of its Perpetual Planet
Initiative, #Rolex supports expeditions exploring and
protecting remarkable places around the world, a
selection of which are featured in Africa Earth’s Wild
Home. #PerpetualPlanet Africa Earth's Wild Home,
narrated by Wunmi Mosaku, premieres Friday, October 2
at 8/7c on National Geographic. Streaming next day on
@Disney+ and @hulu.
description: >-
mello ’s comment: 3 times the size of algeria, the
biggest African country but yeah 😭
acl:
code: 0
addToStoryCode: 0
replyTo:
commentId: '7684132893522559762'
userId: '7591198143678743608'
handle: hiluxman33
nickname: jumpman
- id: '7687196142128251664'
videoId: '7683891628230315295'
parentId: '7684049714988352276'
replyToId: '7684544868471882503'
text: But majority of it is completely uninhabitable
createdAt: '2026-09-19T10:47:33.000Z'
language: en
likeCount: 0
author:
id: '6982524138750067717'
secUid: >-
MS4wLjABAAAA4eueTYNu7g2hjsu6ilsH9PZO13ZHMRxQtqA3_kPiCrftxiEilW6XnCp6wKCGc_IB
handle: archangel396
nickname: archangel396
avatarUrl: >-
https://p19-common-sign.tiktokcdn.com/tos-maliva-avt-0068/7329504842770120709~tplv-tiktokx-cropcenter:100:100.jpg?dr=14579&refresh_token=730ceae3&x-expires=1791295200&x-signature=qIJIj7%2BlSvwT%2F2btGkf99e2DGSo%3D&t=4d5b0474&ps=13740610&shp=30310797&shcp=ff37627b&idc=my2
url: https://www.tiktok.com/@archangel396
isLikedByCreator: false
labels: []
images: []
sticker: null
emojis: []
isTranslatable: true
shareInfo:
url: >-
https://m.tiktok.com/v/7683891628230315295.html?_d=f6004hkm87m931&comment_author_id=6982524138750067717&preview_pb=0&share_comment_id=7687196142128251664&share_item_id=7683891628230315295&sharer_language=en&source=h5_m&u_code=0
title: >-
Presented by @ROLEX. Welcome to Africa 🌍 Africa
Earth's Wild Home takes you deep into the heart of our
wildest continent, bringing you closer to its animals,
landscapes, and the people watching over it than ever
before. Through its partnership with the National
Geographic Society and as part of its Perpetual Planet
Initiative, #Rolex supports expeditions exploring and
protecting remarkable places around the world, a
selection of which are featured in Africa Earth’s Wild
Home. #PerpetualPlanet Africa Earth's Wild Home,
narrated by Wunmi Mosaku, premieres Friday, October 2
at 8/7c on National Geographic. Streaming next day on
@Disney+ and @hulu.
description: >-
archangel396’s comment: But majority of it is
completely uninhabitable
acl:
code: 0
addToStoryCode: 0
replyTo:
commentId: '7684544868471882503'
userId: '7497884025308546054'
handle: idfw.mello
nickname: mello
count: 15
total: 15
cursor: null
hasMore: false
fetchedAt: '2026-10-05T14:45:00.860Z'
meta:
requestId: req_8f0c2b7e-1a2b-4c3d-9e8f-0a1b2c3d4e5f
creditsCharged: 1
creditsRemaining: 4999
cached: false
'400':
description: Invalid cursor.
content:
application/json:
schema:
$ref: '#/components/schemas/Error'
example:
error:
code: BAD_REQUEST
message: The request was invalid.
requestId: req_8f0c2b7e-1a2b-4c3d-9e8f-0a1b2c3d4e5f
'401':
description: Missing, invalid, or revoked API key.
content:
application/json:
schema:
$ref: '#/components/schemas/Error'
example:
error:
code: UNAUTHORIZED
message: API key required — pass it in the `x-api-key` header.
requestId: req_8f0c2b7e-1a2b-4c3d-9e8f-0a1b2c3d4e5f
'402':
description: Not enough credits for this request.
content:
application/json:
schema:
$ref: '#/components/schemas/Error'
example:
error:
code: INSUFFICIENT_CREDITS
message: >-
This request costs 1 credit, but your balance is 0. Top up
to continue.
requestId: req_8f0c2b7e-1a2b-4c3d-9e8f-0a1b2c3d4e5f
'404':
description: >-
Video not found, deleted, private, or unavailable — or the comment
isn’t on that video.
content:
application/json:
schema:
$ref: '#/components/schemas/Error'
example:
error:
code: NOT_FOUND
message: >-
The requested content was not found (it may not exist, be
deleted, or be private).
requestId: req_8f0c2b7e-1a2b-4c3d-9e8f-0a1b2c3d4e5f
'422':
description: >-
Invalid query parameters (missing url / commentId, or not a TikTok
video URL / numeric id).
content:
application/json:
schema:
$ref: '#/components/schemas/Error'
example:
error:
code: VALIDATION_ERROR
message: Request validation failed
requestId: req_8f0c2b7e-1a2b-4c3d-9e8f-0a1b2c3d4e5f
details:
- path: url
message: Required
'429':
description: Over the per-minute rate limit — honour `Retry-After`.
content:
application/json:
schema:
$ref: '#/components/schemas/Error'
example:
error:
code: RATE_LIMITED
message: >-
Rate limit exceeded — max 100 requests per 60s. Retry in
~30s.
requestId: req_8f0c2b7e-1a2b-4c3d-9e8f-0a1b2c3d4e5f
'503':
description: >-
Temporarily unavailable — retry after `Retry-After`. `error.code`
tells you why: `UPSTREAM_BLOCKED` (the source blocked this request),
`EXTRACTION_FAILED` (the source returned unexpected data),
`PLATFORM_UNAVAILABLE` (the source is down), or
`SERVICE_UNAVAILABLE` (we are at capacity).
content:
application/json:
schema:
$ref: '#/components/schemas/Error'
example:
error:
code: UPSTREAM_BLOCKED
message: >-
The source is temporarily unavailable. Please try again
shortly.
requestId: req_8f0c2b7e-1a2b-4c3d-9e8f-0a1b2c3d4e5f
components:
schemas:
Error:
type: object
properties:
error:
type: object
properties:
code:
type: string
example: NOT_FOUND
message:
type: string
example: The requested content was not found.
requestId:
type: string
example: req_8f0c2b7e-1a2b-4c3d-9e8f-0a1b2c3d4e5f
details:
type: array
items:
type: object
description: Present on validation errors.
required:
- code
- message
- requestId
required:
- error
securitySchemes:
ApiKeyAuth:
type: apiKey
in: header
name: x-api-key
description: >-
Your API key. Send it in the `x-api-key` header (or `Authorization:
Bearer `). Create and manage keys from your dashboard.
````
This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.