InsightSocial API
TikTok

TikTok Video Comments API reference

Your first 10 calls are free, no card needed. Pricing and FAQ

Get a free API key
Example request
curl "https://api.insightsocial.app/v1/tiktok/post/comments?url=https%3A%2F%2Fwww.tiktok.com%2F%40mrbeast%2Fvideo%2F7654638524729216287" \
  -H "x-api-key: $INSIGHTSOCIAL_API_KEY"
GET
/v1/tiktok/post/comments

Returns a page of comments on one TikTok video, each with the commenter's username, comment text, like count, reply count, and timestamp.

Use it to read a video's comment section; to expand one thread, take a comment's id and call video/comment/replies.

Metered: 10–30 credits. We reserve the ceiling when the call starts and charge what it actually used when it finishes.

Paginates by cursor: see Pagination.

Authorization

apiKey
x-api-key<token>

Your key from the dashboard. It starts with isk_.

In: header

Query Parameters

url*string

Full URL of the TikTok video to fetch comments for

cursor?string

Cursor to get more comments. Get 'cursor' from previous response.

trim?boolean

Accepted for compatibility; the response is already the canonical shape, so this flag has no effect.

sort?string

Optional. Without it, comments come in TikTok's own order (a relevance ranking, not newest first). recent returns them newest first by published_at; top returns them by like count. TikTok has no newest-first order of its own, so recent sorts the comments that were read: set scan_pages to read more of the thread.

Value in

  • "top"
  • "recent"
scan_pages?integer

Optional, 1 to 3, default 1. Reads that many pages, drops comments repeated across pages, and returns them all in the sort order (TikTok's own order when sort is absent).

Range1 <= value <= 3
dry_run?"1"

Set to 1 to get the price of this call without making it: data.dry_run carries credits_min and credits_max. Nothing is charged.

Value in

  • "1"

Response Body

application/json

application/json

application/json

application/json

application/json

application/json

application/json

application/json

application/json

curl -X GET "https://api.insightsocial.app/v1/tiktok/post/comments?url=string"
{  "success": true,  "platform": "string",  "endpoint": "string",  "schema_version": "2",  "pagination": {    "next_cursor": "string",    "has_more": true,    "page_size": 0,    "stopped_at": "since"  },  "unavailable": [    "string"  ],  "credits_used": 0,  "credits_remaining": 0,  "request_id": "string",  "cached": true,  "idempotent_replay": true,  "charge_reason": "string",  "free_call": true,  "data": {    "items": [      {        "comment": {          "id": "string",          "url": "http://example.com",          "parent_id": "string",          "post_id": "string",          "text": "string",          "author": {            "id": "string",            "username": "string",            "display_name": "string",            "avatar_url": "http://example.com",            "verified": true          },          "engagement": {            "likes": 0,            "replies": 0          },          "flags": {            "pinned": true,            "deleted": true          },          "published_at": "2019-08-24T14:15:22Z",          "language": "string",          "replies": [            {}          ],          "ext": {            "property1": null,            "property2": null          }        }      }    ],    "total": 0,    "truncated": true,    "ext": {      "property1": null,      "property2": null    }  }}

Playlist › Videos GET

Returns the videos inside one of a creator's profile playlists, in playlist order, each with engagement counts, caption, author, and a playable URL.

Post › Transcript GET

Returns the spoken text of a TikTok video from its captions, with an option to fall back to AI transcription when no captions exist.