TikTok post comments

Fetch a TikTok post's comments, including their nested replies.

GET /v1/tiktok/post/{video_id}/comments

Path parameters

Parameter	Type	Description
video_id	string	Required. The numeric video id, or a full video URL.

Query parameters

Parameter	Type	Default	Description
count	integer	30	Comments requested per page. Maximum 50.
max_pages	integer	1	Number of pages to fetch. Maximum 20.

Example

curl -G "$LISTENX_BASE/v1/tiktok/post/7523456789012345678/comments" \
  -H "X-API-Key: $LISTENX_KEY" \
  --data-urlencode 'max_pages=3'

Response

{
  "video_id": "7523456789012345678",
  "pages_requested": 3,
  "pages_fetched": 3,
  "comment_count": 238,
  "returned": 90,
  "has_more": true,
  "comments": [
    {
      "id": "7524000000000000000",
      "text": "This actually works 🙌",
      "created_at": "2025-06-13T09:14:02+00:00",
      "like_count": 412,
      "reply_count": 3,
      "author": {
        "id": "99887766",
        "unique_id": "janedoe",
        "nickname": "Jane",
        "sec_uid": "MS4wLjABAAAA…",
        "avatar_url": "https://…"
      },
      "replies": [
        {
          "id": "7524000000000000111",
          "text": "glad it helped!",
          "created_at": "2025-06-13T10:02:11+00:00",
          "like_count": 12,
          "reply_count": 0,
          "author": { "unique_id": "doc", "nickname": "Dr. Smile" },
          "replies": []
        }
      ]
    }
  ],
  "billing": {
    "endpoint": "tiktok.comments",
    "units": 3,
    "unit_price": "0.010000",
    "amount": "0.030000",
    "balance_after": "96.000000",
    "request_id": "…"
  }
}

Fields

Field	Description
comment_count	Total comments on the post (may exceed those returned).
returned	Number of top-level comments in comments.
has_more	true if more comment pages remain.
comments[]	Top-level comments; each has a nested replies[] array.

Billing

Charged per page fetched — units = pages_fetched, minimum 1. See Billing.