List TikTok video comments
Lists top-level comments for a TikTok video URL with optional cursor-based pagination.
Operation
/v1/tiktok/videos/commentsHeaders
API key (`sfk_...`)
Parameters
Link to the TikTok video whose comments should be listed.
min 1 chars · max 4096 chars
Opaque cursor from a previous response to fetch the next page.
min 1 chars
When true, returns a smaller response with fewer fields.
Response fields
Endpoint-specific response payload.
Whether the video was resolved for this request.
one of: found, not_found
Top-level comments for the resolved video.
Stable identifier for the comment when provided by TikTok; otherwise a deterministic placeholder derived from available fields.
min 1 chars
Comment text.
ISO-8601 timestamp when the comment was created.
Like count on the comment.
≥ 0
Direct reply count for the comment thread.
≥ 0
Reported language code for the comment text.
Comment author.
Public TikTok username without a leading @.
min 1 chars
Display name shown on the commenter profile.
Profile image URL for the commenter when available.
Numeric user id for the commenter when available.
Opaque stable user identifier when available.
Pagination information for this response.
Cursor to pass in the next request when more pages exist.
Whether another page of comments is available.
Total comment count reported for the video when available; null when the video could not be resolved.
≥ 0
Metadata describing the request and billing outcome.
Unique request identifier for tracing this API call.
min 1 chars
Credits charged for this request.
≥ 0
Public API version that served the response.
one of: v1
Code example
Responses
Comment listing result. Check `data.lookupStatus` for `found` or `not_found`.
Error codes