Skip to main content
POST /v1/data/tiktok/comments/run Pricing: $0.0005 per comment ($0.5 per 1,000).

Ways to call it

  • Video URL: set postURLs (optional: commentsPerPost, topLevelCommentsPerPost)
  • Profile: set profiles (optional: resultsPerPage, commentsPerPost, topLevelCommentsPerPost, profileScrapeSections, profileSorting, excludePinnedPosts)

Request

Send the inputs under params. Only the keys below are accepted; any other key returns 422 invalid_params.
string
TikTok video URL to get comments from. E.g. https://www.tiktok.com/@username/video/1234567890.Format e.g. https://www.tiktok.com/@looooooooch/video/7332342275151760642.
string
TikTok username whose videos’ comments you want (with or without @). The actor pulls comments from the profile’s videos; use Videos Per Profile to control how many.Format e.g. https://www.tiktok.com/@khaby.lame.
integer
Number of comments to return. Use 0 for all. Actual counts can vary on very high-comment videos due to TikTok API limits.
integer
Optional cap on top-level (non-reply) comments per video.
integer
default:"1"
By Profile mode only. Number of videos to pull comments from per profile.
string[]
default:"[\"videos\"]"
By Profile mode only. Which sections to pull videos from.Allowed values: videos (Videos), reposts (Reposts).
string
default:"latest"
By Profile mode only. Order videos by latest, most popular, or oldest.Allowed values: latest (Latest), popular (Most popular), oldest (Oldest).
boolean
default:"false"
By Profile mode only. Skip pinned videos at the top of a profile.

Example

Response fields

Each row in data is one comment, keyed by these fields.

Example response

Abridged: long text and lists are shortened.
For the video itself use tiktok/posts; for a video’s 14-day growth curve use tiktok/video-analytics.