TikTok API: List video comments (v3)

List a video's top-level comments with text, likes, reply counts and authors. Paginate with cursor and has_more; a page can hold fewer than count. An unknown video returns data: null.

1 credit / requestBilled only on success

Authorization

ApiKeyAuth

x-api-key<token>

In: header

Query Parameters

id*string

Numeric ID of the video whose comments are listed.

Match^\d{5,25}$

count?integer

Items to request per page, 1 to 50. A page can hold fewer.

Range1 <= value <= 50

Default30

cursor?string

cursor from the previous response. Omit for the first page and send it unchanged for later pages.

Match^\d{1,20}$

curl -X GET "https://example.com/v3/tiktok/video/comments?id=7665075736742530317" \  -H "x-api-key: YOUR_API_KEY"

{  "data": {    "items": [      {        "id": "7665263325262201622",        "video_id": "7665075736742530317",        "parent_id": null,        "text": "Howdy partners! 🚀✨",        "created_at": "2026-07-22T08:17:14.000Z",        "likes": 7198,        "replies": 69,        "language": "en",        "pinned": false,        "liked_by_creator": true,        "author": {          "id": "7374008994362803233",          "sec_uid": "MS4wLjABAAAAO3hlTAUHbGbHi8AwqGL_DKEgOZ7D9DcGrnZOrF9F0GePNzJUuxFVk4BSnW2wf3ac",          "username": "europeanspaceagency",          "nickname": "ESA",          "avatar": "https://p16-common-sign.tiktokcdn-us.com/tos-maliva-avt-0068/c499c845e2214ff42384cf18619c566b~tplv-tiktokx-cropcenter-q:100:100:q70.heic?dr=8835&refresh_token=8bf68633&x-expires=1792249200&x-signature=uHfQuaYiTupXZTKtQ1lTJe3ha2M%3D&t=223449c4&ps=87d6e48a&shp=30310797&shcp=ff37627b&idc=useast8&sc=avatar&s=COMMENT_LIST",          "verified": true        }      },      {        "id": "7665081157037802254",        "video_id": "7665075736742530317",        "parent_id": null,        "text": "TO THE MOON!! 🚀",        "created_at": "2026-07-21T20:30:12.000Z",        "likes": 4437,        "replies": 69,        "language": "en",        "pinned": false,        "liked_by_creator": true,        "author": {          "id": "7620511313148298254",          "sec_uid": "MS4wLjABAAAAcUnlSlfGShgrEm-3x9L6s3uuIaxHiHEA5VHD7EX9I0ZoTnOIBD8xrE8XuwXda56o",          "username": "usedgov",          "nickname": "U.S. Department of Education",          "avatar": "https://p19-common-sign.tiktokcdn-us.com/tos-useast5-avt-0068-tx/319856f5fe39f433892d30fa3ee3fce5~tplv-tiktokx-cropcenter-q:100:100:q70.heic?dr=8835&refresh_token=3458bd6b&x-expires=1792249200&x-signature=JNErf3qxlIXCKFxAK72rWyC3ax0%3D&t=223449c4&ps=87d6e48a&shp=30310797&shcp=ff37627b&idc=useast8&sc=avatar&s=COMMENT_LIST",          "verified": true        }      }    ],    "count": 2,    "cursor": "50",    "has_more": true  }}