Docs · Comment replies

Comment replies

The replies under one comment, oldest first.

1 credit per callFresh within 5 minutesMCP tool: tiktok_comment_replies

GEThttps://api.lurkapi.com/v1/tiktok/video/comment/replies

When to use this

Use it to read a comment's thread. Get comment_id from a comment's cid in video comments. reply_to_reply_id shows which reply a reply answers.

Pagination. 50 replies per page. Pass the response's cursor back as cursor (with the same url and comment_id); it's null at the end.

Parameters

All parameters go in the query string.

Parameter	Description
`url` stringrequired	The video's URL, e.g. `https://www.tiktok.com/@hubspot/video/7671325437229845774`. Photo post URLs and bare video ids work too. Example `https://www.tiktok.com/@scout2015/video/6718335390845095173`
`comment_id` stringrequired	The comment's `cid`, from video comments. Example `6718335906996502534`
`cursor` stringoptional	The `cursor` from the previous response, to get the next page.

Example request

Replace YOUR_API_KEY with your key, or set LURKAPI_KEY for the code. Get a free key.

curlJavaScriptPython

curl · paste into a terminal

curl "https://api.lurkapi.com/v1/tiktok/video/comment/replies?url=https%3A%2F%2Fwww.tiktok.com%2F%40scout2015%2Fvideo%2F6718335390845095173&comment_id=6718335906996502534" \
  -H "x-api-key: YOUR_API_KEY"

JavaScript · reads your key from LURKAPI_KEY

const params = new URLSearchParams({
  url: "https://www.tiktok.com/@scout2015/video/6718335390845095173",
  comment_id: "6718335906996502534",
});
const res = await fetch(`https://api.lurkapi.com/v1/tiktok/video/comment/replies?${params}`, {
  headers: { "x-api-key": process.env.LURKAPI_KEY },
});
const data = await res.json();
if (!data.success) throw new Error(`${data.code}: ${data.error}`);
console.log(data.comments);

Python · reads your key from LURKAPI_KEY

import os
import requests

res = requests.get(
    "https://api.lurkapi.com/v1/tiktok/video/comment/replies",
    params={
        "url": "https://www.tiktok.com/@scout2015/video/6718335390845095173",
        "comment_id": "6718335906996502534",
    },
    headers={"x-api-key": os.environ["LURKAPI_KEY"]},
    timeout=60,
)
data = res.json()
if not data["success"]:
    raise RuntimeError(f"{data['code']}: {data['error']}")
print(data["comments"])

Example response

A real response from this endpoint, captured from the live API and trimmed to a couple of items. Strings over 96 characters (mostly signed media URLs) are cut short and end in ….

Show the example response (2 KB)

{
  "success": true,
  "credits_remaining": 99980,
  "credits_charged": 1,
  "comments": [
    {
      "cid": "6718605798119555078",
      "text": "dorotea?",
      "create_time": 1564297316,
      "digg_count": 0,
      "reply_comment_total": 0,
      "comment_language": "un",
      "author_pin": false,
      "is_author_digged": false,
      "reply_id": "6718335906996502534",
      "reply_to_reply_id": "0",
      "aweme_id": "6718335390845095173",
      "user": {
        "uid": "6654948959952060422",
        "unique_id": "marladraws",
        "nickname": "💫marladraws💫",
        "sec_uid": "MS4wLjABAAAAzF1KjnfSfE_eWFjkxNFtBs50oCJyfErzibw8CT92-_TP3jMBhgTvxab7VEr7yhhC",
        "avatar_thumb": "https://p16-common-sign.tiktokcdn-us.com/tos-maliva-avt-0068/0a9840d173e…"
      }
    },
    {
      "cid": "6718648089844400133",
      "text": "yes!",
      "create_time": 1564307161,
      "digg_count": 2,
      "reply_comment_total": 0,
      "comment_language": "un",
      "author_pin": false,
      "is_author_digged": false,
      "reply_id": "6718335906996502534",
      "reply_to_reply_id": "6718605798119555078",
      "aweme_id": "6718335390845095173",
      "user": {
        "uid": "6650133637952618502",
        "unique_id": "flamigo_kisses",
        "nickname": "flamigoo",
        "sec_uid": "MS4wLjABAAAA2MsvjMy0b24-FHIEBfHzeBhZelr6GpESRqTxE-LAA5ByJY5rSolRWE3rXB4Mfqt6",
        "avatar_thumb": "https://p16-common-sign.tiktokcdn-us.com/tos-maliva-avt-0068/73363709566…"
      }
    }
  ],
  "total": 56,
  "has_more": true,
  "cursor": "50"
}

Response fields

Every field of a successful response. [] marks a list: a[].b is the b of each item in a. nullable fields can be null; optional fields can be missing.

Show all 24 fields

Field	Type	Description
success	true	Always true here; errors have `success: false`.
credits_remaining	number	Your balance after this call. On anonymous playground calls: free tries left today.
credits_charged	number	Credits this call cost; 0 on free endpoints. On anonymous playground calls: tries used (1).
comments	object[]	Replies, oldest first.
comments[].cid	string	Comment id; pass it as `comment_id` to comment replies.
comments[].text	string	Comment text.
comments[].create_time	number	Posted at, Unix seconds.
comments[].digg_count	number	Likes.
comments[].reply_comment_total	number	Replies to this comment. Always 0 on replies.
comments[].comment_language	stringnullable	Language as TikTok detects it, e.g. `en`; `un` = undetermined.
comments[].author_pin	boolean	Pinned by the video's creator.
comments[].is_author_digged	boolean	Liked by the video's creator.
comments[].reply_id	string	On replies: the comment it belongs to. `0` on top-level comments.
comments[].reply_to_reply_id	string	On replies: the reply it answers, if any. `0` otherwise.
comments[].aweme_id	string	The video's id.
comments[].user	object	Who wrote it.
comments[].user.uid	string	Numeric user id.
comments[].user.unique_id	string	Username (handle), without @.
comments[].user.nickname	string	Display name.
comments[].user.sec_uid	string	TikTok's long, stable user id.
comments[].user.avatar_thumb	stringnullable	Small avatar URL (expires after a few days); null if TikTok has none.
total	number	Comments TikTok counts in this thread (may include some it no longer shows).
has_more	boolean	More comments after this page.
cursor	stringnullable	Pass as `cursor` for the next page. null on the last page.

Pagination

Pass the response's cursor back as cursor, with the other parameters unchanged, for the next page. It's null on the last page. Each page costs 1 credit.

The first five pages, in JavaScript

let cursor = null;
for (let page = 1; page <= 5; page++) {
  const params = new URLSearchParams({ url: "https://www.tiktok.com/@scout2015/video/6718335390845095173", comment_id: "6718335906996502534" });
  if (cursor) params.set("cursor", cursor);
  const res = await fetch(`https://api.lurkapi.com/v1/tiktok/video/comment/replies?${params}`, {
    headers: { "x-api-key": process.env.LURKAPI_KEY },
  });
  const data = await res.json();
  if (!data.success) throw new Error(`${data.code}: ${data.error}`);
  console.log(data.comments);
  cursor = data.cursor;
  if (!cursor) break; // last page
}

Caching and freshness

Responses are cached for up to 5 minutes, so a repeat call within that window can return the same data. It still costs 1 credit.

Errors return { success: false, error, code, docs } with the HTTP status below. Validation errors, 401/402/429 rejections and 5xx failures are free; not_found is charged (how charging works). All error codes.

Status	Code	Meaning
401	`missing_api_key`	No API key. Send it in the `x-api-key` header.
401	`invalid_api_key`	The key is unknown or was revoked.
402	`insufficient_credits`	Not enough credits for this call. Buy a pack or wait for tomorrow's top-up.
404	`not_found`	The endpoint, or the thing you asked for (ad, post, subreddit), doesn't exist. Charged when the platform was checked.
405	`method_not_allowed`	Endpoints take GET with query params.
429	`rate_limited`	Too many calls at once. Wait for the `retry-after` seconds, then retry.
500	`internal_error`	Something broke on our side. Retry; 5xx errors are free.
502	`upstream_error`	The platform didn't give a usable answer. Retry; 5xx errors are free.
503	`upstream_busy`	All our connections to the platform are busy. Retry in a few seconds; 5xx errors are free.
504	`upstream_timeout`	The platform took over 30 seconds to answer. Retry; timeouts are free.

Use it in Claude

Once LurkAPI is connected to Claude, this endpoint is the tiktok_comment_replies tool. Ask in plain English, for example:

Ask Claude

Use LurkAPI's tiktok_comment_replies with url "https://www.tiktok.com/@scout2015/video/6718335390845095173", comment_id "6718335906996502534" and summarize what you find.

Claude calls tiktok_comment_replies with arguments like these, and each call costs 1 credit:

Tool arguments

{
  "url": "https://www.tiktok.com/@scout2015/video/6718335390845095173",
  "comment_id": "6718335906996502534"
}

Tool results skip nulls and empty lists to save tokens.