TikTok Comment Replies
TikTok Comment Replies are public responses beneath a known video comment, with reply text, author identity, timestamps, visible likes and reply counts, and a parent-comment reference. These conversation records support branch reconstruction, participant review, response research, and reply-level monitoring.
Features
- Comment-addressed reply scopePair one supported TikTok video URL with its known comment_id to collect the public reply feed for that comment instead of the video's top-level comments.
- Reply, author, and engagement fieldsReceive reply IDs and text, public author identity and account flags, timestamps, visible likes and reply counts, mentions, and source-video context.
- Bounded, deduplicated traversalFollow available reply cursors, remove duplicate comment IDs, and stop at the requested limit, the end of the thread, or the 100-page collection ceiling.
Parameters
| Parameters | Required | Description |
|---|---|---|
url | Required | Required TikTok video URL on tiktok.com, www.tiktok.com, or m.tiktok.com with a /video/{numeric_id} path. |
comment_id | Required | Required non-empty public comment ID for the selected top-level comment on the same video. |
results_limit | Optional | Maximum replies requested for the comment; defaults to 100 and accepts integers from 20 through 2,000. |
How to Use
Start with a top-level comment ID for one TikTok video, submit an asynchronous reply task, then read normalized records with result cursor pagination.
- Run the TikTok Comments API for the video and select the id of the top-level comment whose replies you need.
- POST the same video url, that comment_id, and an optional results_limit to /v1/tiktok/comment-replies.
- Poll /v1/tasks/{task_id} until the status is succeeded or failed.
- Read data.results.items from /v1/tasks/{task_id}?limit=50 and pass results.next_cursor while results.has_more is true.
curl -X POST "https://api.socq.ai/v1/tiktok/comment-replies" \
-H "Authorization: Bearer $SOCQ_API_KEY" \
-H "Content-Type: application/json" \
-d '{"url":"https://www.tiktok.com/@loganpaul/video/7411198650782731563","comment_id":"7411205662439736097","results_limit":20}'
# Poll GET /v1/tasks/{task_id}, then read data.results.items and follow results.next_cursor.Best Use Cases
- Known-comment branch reconstruction: Join reply IDs, extra.parent_comment_id, and extra.input_url to rebuild the public reply branch beneath one selected top-level comment.
- Reply-level response review: Use reply text, timestamps, visible likes, and reply counts to review and compare public responses within a focused conversation.
- Conversation participant mapping: Use public author IDs, usernames, profile links, avatars, and account flags to map the participants represented in the returned reply feed.
Pro Tips
- Take comment_id from the normalized id of a top-level TikTok Comments result and reuse that result's video URL; a video ID is not a comment ID.
- Validate the URL host and numeric /video/ path before submission so shortened, profile, or non-video links do not fail the input check.
- Set results_limit to the reply volume you need, recognizing that the public thread can end before the limit and collection stops after 100 source pages.
- When combining tasks, deduplicate by reply id while retaining extra.parent_comment_id and extra.input_url so replies remain tied to the correct conversation.
- Treat reply text, author fields, metrics, mentions, and timestamps as nullable, and escape user-generated text before displaying it in downstream tools.
Related APIs
Use these APIs when you need a different type of public TikTok data.
- TikTok Profiles API — Retrieve public profile identity, biographies, account flags, and audience counts by username.
- TikTok Hashtags API — Collect public videos, creators, media, sound, and engagement for specified hashtags.
- TikTok Comments API — Collect public top-level comments, authors, engagement, mentions, and creator interaction flags.
- TikTok Videos API — Retrieve creator, caption, media, music, tags, mentions, and engagement from video URLs.
- TikTok Search API — Search public videos by keyword with supported sorting and publication filters.
- TikTok Followers List API — Collect normalized profiles visible in public follower lists, with retained source context and supported metrics.
- TikTok Following List API — Collect public profiles followed by TikTok accounts with normalized identity, biographies, visible metrics, and source-account context.
- TikTok User Videos API — Collect public profile-feed videos by username with captions, creators, media, timestamps, engagement, and source-account context.
- TikTok Live Room Info API — Look up one known live room by paired room and owner IDs, returning status, owner context, cover media, and audience counts.
- TikTok Trending Feed API — Collect the current public video feed for a region with creator, caption, cover, timestamp, and visible engagement fields.
- TikTok Video Transcript API — Extract available transcript text, language, format, and source context from public video URLs.