Social Fetch
Get API key
TikTok hub

TikTok comment replies API

Pass a parent commentId and the video URL to page nested replies with text, likes, and authors — separate from the top-level comments list.

GET /v1/tiktok/videos/comments/replies

1 credit per successful request.

Try in playgroundFull API docs

About this endpoint

Top-level comment lists tell you who spoke first. Brand and research jobs often need the back-and-forth under a specific comment: clarifications, pushback, creator replies. Pulling that thread from scraped HTML or a one-shot dump mixes parents and children and loses which `commentId` owns which page.

`GET /v1/tiktok/videos/comments/replies` requires `commentId` (from `data.comments[].id` on `GET /v1/tiktok/videos/comments`) and the same video `url` (`/@user/video/…` or `vm.tiktok.com` short links). Optional `cursor` pages further. On a found lookup, read `data.replies` and `data.page`. Each reply can include `id`, `text`, `createdAt`, `likes`, `replyCount`, `language`, and an `author` object (`handle`, `displayName`, `avatarUrl`, optional `platformUserId` / `secUid`). Branch on `data.lookupStatus` (`found` or `not_found`) before you store rows; `totalReplies` may be null when the thread did not resolve.

Pagination matches the comments list: when `data.page.hasMore` is true, pass `data.page.nextCursor` as `cursor`. Page size is not fixed. Cost is 1 credit per successful page; confirm with `meta.creditsCharged`. Listing top-level comments is a different operation and bills on its own.

TikTok comment replies API FAQ

How do I list replies to a TikTok comment via API?

Call GET /v1/tiktok/videos/comments/replies with your Social Fetch API key (x-api-key), a required commentId from a prior comments list response, and the video url query param. Read data.lookupStatus, then data.replies and data.page. Full parameters and examples are in the API docs.

How much does the TikTok comment replies endpoint cost?

Pricing is documented on the operation in the API registry (shown on this page). Confirm on every response with meta.creditsCharged — that field is the billing source of truth. Each paginated page is a separate billed request.

Where does commentId come from?

Use the id field on a top-level row from GET /v1/tiktok/videos/comments (data.comments[].id). Pass that value as commentId together with the same video url. Invented or unrelated ids will not resolve a thread.

How does pagination work on TikTok comment replies?

Each response includes data.page.nextCursor and data.page.hasMore. When hasMore is true, pass nextCursor as the cursor query param on the next request. Page size is not fixed — do not assume a constant number of replies per page or stop based on totalReplies alone.

What fields are in each TikTok reply?

Reply rows can include id, text, createdAt, likes, replyCount, language, and author (handle, displayName, avatarUrl, optional platformUserId and secUid). Always branch on data.lookupStatus before treating replies as present.

TikTok comments list vs comment replies?

GET /v1/tiktok/videos/comments pages top-level comments for a video URL and may expose replyCount on each row. This route pages the nested thread for one parent commentId. They are separate marketplace operations, each billed on its own.

What does data.lookupStatus mean on TikTok comment replies?

found means the parent comment thread resolved and the replies page (which may be empty) is valid. not_found means the thread could not be resolved; replies is empty and totalReplies is null. HTTP 200 alone does not mean you have replies to store.

Do I need TikTok OAuth to read comment replies?

No. You authenticate to Social Fetch with an API key. The route reads public reply data; it does not act on behalf of a logged-in TikTok user.

Other TikTok endpoints