Social Fetch
TikTok

List TikTok video comments

Get comments on a TikTok video.

GET/v1/tiktok/videos/comments
1credit
x-api-key*stringheader

API key (`sfk_...`)

Parameters
3
url*stringquery

Link to the TikTok video whose comments should be listed.

min 1 chars · max 4096 chars

cursorstringoptionalquery

Opaque cursor from a previous response to fetch the next page.

min 1 chars

trimbooleanoptionalquery

When true, returns a smaller response with fewer fields.

Response fields
23

Endpoint-specific response payload.

datalookupStatus
string

Whether the video was resolved for this request.

one of: found, not_found

Top-level comments for the resolved video.

datacomments[]id
string

Stable identifier for the comment when provided by TikTok; otherwise a deterministic placeholder derived from available fields.

min 1 chars

datacomments[]text
string

Comment text.

datacomments[]createdAt
string

ISO-8601 timestamp when the comment was created.

datacomments[]likes
integer

Like count on the comment.

≥ 0

datacomments[]replyCount
integer

Direct reply count for the comment thread.

≥ 0

datacomments[]language
string

Reported language code for the comment text.

Comment author.

datacomments[]authorhandle
string

Public TikTok username without a leading @.

min 1 chars

datacomments[]authordisplayName
stringnullable

Display name shown on the commenter profile.

datacomments[]authoravatarUrl
stringnullable

Profile image URL for the commenter when available.

datacomments[]authorplatformUserId
stringoptional

Numeric user id for the commenter when available.

datacomments[]authorsecUid
stringoptional

Opaque stable user identifier when available.

Pagination information for this response.

datapagenextCursor
stringnullable

Cursor to pass in the next request when more pages exist.

datapagehasMore
boolean

Whether another page of comments is available.

datatotalComments
integernullable

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.

metarequestId
string

Unique request identifier for tracing this API call.

min 1 chars

metacreditsCharged
integer

Credits charged for this request.

≥ 0

metaversion
string

Public API version that served the response.

one of: v1

Code example

curl "https://api.socialfetch.dev/v1/tiktok/videos/comments?url=https://www.tiktok.com/@mrbeast/video/7596844935442189598" \
  -H "x-api-key: YOUR_API_KEY"

Responses

Comment listing result. Check `data.lookupStatus` for `found` or `not_found`.

On this page

No Headings