InsightSocial API
TikTok

Comment

GET
/v1/tiktok/comment

Returns one TikTok comment with its current like count, reply count, pinned flag, author, and timestamp, found by link, by id, or by its text.

Use it to re-check a single known comment without paging the whole section; use post/comments when you want the section itself.

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

Re-running the exact same call within 6h is free.

Authorization

apiKey
x-api-key<token>

Your key from the dashboard. It starts with isk_.

In: header

Query Parameters

comment_url?string

A TikTok comment URL: https://www.tiktok.com/@{handle}/video/{videoId}?comment_id={cid}, the m.tiktok.com/v/{id}.html?...&share_comment_id={cid} share form, or a vm.tiktok.com/{code} / tiktok.com/t/{code} shortlink. The cid/comment_id/share_comment_id query value may be numeric or the base64 form TikTok's share sheet emits (?cid=NzY1...): both are accepted; base64 is decoded automatically. Mutually exclusive with post_url+comment_id. Provide at least one of: comment_url, post_url.

post_url?string

The post URL (https://www.tiktok.com/@{handle}/video/{videoId}). Combine with comment_id, or with author_username/text_contains for a search. Provide at least one of: comment_url, post_url.

comment_id?string

The target comment's numeric id (the cid from the comments endpoint). Requires post_url. Note that TikTok share links carry a base64-encoded cid: pass such a link as comment_url instead (decoded automatically), or base64-decode the value to its digits before passing it here.

parent_comment_id?string

The parent comment's numeric id: supply this when the target is a reply so it can be resolved directly via the native replies endpoint.

author_username?string

Return up to max comments authored by this username (no comment id needed). Mutually exclusive with text_contains and any comment id.

text_contains?string

Return up to max comments whose text contains this snippet (case-insensitive). Mutually exclusive with author_username and any comment id.

deep_scan?boolean

Widen the scan budget for deeply-buried comments (raises the page ceiling and deadline).

position_hint?string

Opaque token from a prior lookup's lookup.position_hint. Passing it back probes the comment's last-known location first, making a re-check of an already-found comment cheap.

max?integer

For author_username/text_contains search: max matches to return (1-20, default 5).

Response Body

application/json

application/json

application/json

application/json

application/json

application/json

application/json

application/json

application/json

curl -X GET "https://example.com/v1/tiktok/comment"
{  "success": true,  "platform": "instagram",  "endpoint": "/v1/instagram/profile/posts",  "data": {    "items": [      "…"    ],    "dropped": 0  },  "pagination": {    "next_cursor": "is2.eyJwIjoyfQ",    "has_more": true,    "page_size": 12  },  "credits_used": 20,  "credits_remaining": 9980,  "request_id": "req_1a2b3c4d5e6f",  "cached": false,  "idempotent_replay": false,  "charge_reason": "miss",  "free_call": false}

Collection › Videos GET

Returns the public videos inside a TikTok collection, each with caption, play like comment share and save counts, author, and a playable URL. Use it when you have a collection URL and want the videos saved there, paging with max_cursor. **20 credits** per call. Re-running the exact same call within 6h is free. Paginates by `cursor` — see [Pagination](/docs/pagination).

Effect › Videos GET

Returns public TikTok videos created with a camera effect, each with engagement counts, caption, author, and a playable URL. Use it with an effect id from effects, and send the cursor back unchanged. TikTok picks its own page size here and ignores the one you ask for. **20 credits** per call. Re-running the exact same call within 6h is free. Paginates by `cursor` — see [Pagination](/docs/pagination).