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: 20–60 credits. We reserve the ceiling when the call starts and charge what it actually used when it finishes.

get/v1/tiktok/comment

Request

  • Base URL: https://api.insightsocial.app
  • URL: https://api.insightsocial.app/v1/tiktok/comment
  • Auth: API key in header x-api-key

Query parameters

comment_urlstring
Example:https://www.tiktok.com/@mrbeast/video/7654638524729216287?comment_id=7654640784985211670

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_urlstring

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_idstring

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_idstring

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_usernamestring

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

text_containsstring

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

deep_scanboolean

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

position_hintstring

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.

maxinteger

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

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.

Response

Success.

successtrue required
platformstring required
endpointstring required
schema_version'2' required
unavailablestring[] required
credits_usedinteger required
credits_remaininginteger required
request_idstring required
cachedboolean required
idempotent_replayboolean required
charge_reasonstring required
free_callboolean required

Changes

No recorded changes to this operation across all 1 revision of this API.