TikTok Profile Scraper – Posts, Views & Followers
Pricing
$1.00 / 1,000 profile reads
Scrape any public TikTok profile for its latest posts — caption, hashtags, views, likes, comments, shares, video files, photo carousels and the sound used — plus the account record with exact follower count. No login, no cookies, no API key. Up to 13 latest posts per profile. Unofficial.
type
Optional
"video" or "photo" for a post, "error" for an account that could not be read.
id
Optional
TikTok's own numeric ID for the post.
url
Optional
Permanent link to the post on tiktok.com. Built from the post's owner, so a post owned by another account still links where it lives.
inputUrl
Optional
The profile URL this run was asked for.
profileUrl
Optional
Canonical profile URL of the account that was read.
caption
Optional
The post's caption, as written.
mentions
Optional
Handles mentioned, from TikTok's entity list. The caption renders a mention as the account's display name, so these are the real handles and cannot be recovered from the text.
mentionDetails
Optional
The same mentions with TikTok's numeric user ID beside each handle: [{ username, userId }]. Null when post details were not read.
timestamp
Optional
When the post was published, ISO 8601 UTC.
timestampUnix
Optional
The same moment in unix seconds.
timestampIsApproximate
Optional
True when the time was recovered from the post ID rather than read from TikTok — accurate to about a minute. Only happens when post details were not read.
isPinned
Optional
True if TikTok pinned this post to the top of the profile. A pinned post can be much older than the rest.
playCount
Optional
Views. TikTok rounds this figure.
likeCount
Optional
Likes. Null when post details were not read.
commentCount
Optional
Comments. Null when post details were not read.
engagementRatePercent
Optional
Likes, comments and shares as a percentage of views, to two decimals. Approximate, because TikTok rounds views. Null when any count is missing.
ownerUsername
Optional
Handle of the account that owns the post.
ownerId
Optional
Numeric ID of the owning account.
ownerNickname
Optional
Display name of the owning account.
ownerIsVerified
Optional
Whether the owning account is verified.
coverUrl
Optional
Cover image for the post.
originalCoverUrl
Optional
Full-resolution cover image.
dynamicCoverUrl
Optional
Animated preview image, as TikTok shows on hover.
videoUrl
Optional
Direct playable video file. Signed and short-lived — it expires within hours, so download it promptly and store "url" as the durable link.
videoWidth
Optional
Video width in pixels.
videoHeight
Optional
Video height in pixels.
videoQuality
Optional
TikTok's own quality label, e.g. "720p".
videoDuration
Optional
Length of the video in seconds. Null for a photo post, or when post details were not read.
images
Optional
Images of a photo post, each with url, width and height. Empty for a video.
imageCount
Optional
How many images a photo post carries.
musicId
Optional
TikTok's ID for the sound used.
musicName
Optional
Name of the sound, e.g. "original sound - NASA".
musicAuthor
Optional
Who the sound is credited to.
musicUrl
Optional
Direct audio file for the sound. Signed and short-lived.
musicCoverUrl
Optional
Cover art for the sound.
challenges
Optional
TikTok hashtag campaigns this post joined, each with id, name, description and isCommerce.
stickerTexts
Optional
On-screen text stickers, which often carry the point of a post with a bare caption.
duetFromId
Optional
ID of the post this one duets, if any.
isAd
Optional
Whether TikTok marks the post as advertising.
isBrandedContent
Optional
True when the creator disclosed a paid partnership on the post (TikTok's "Paid partnership" label), whether or not TikTok is also promoting it as an ad. Null when post details were not read.
isPrivatePost
Optional
Whether the post itself is private.
isFriendsOnly
Optional
True when the post is visible to the account's friends only. Null when post details were not read.
contentWarnings
Optional
TikTok's own content labels on the post, as it words them. Usually empty. Null when post details were not read.
stitchEnabled
Optional
Whether others may stitch the post.
createdInRegion
Optional
Country the post was uploaded from, as TikTok recorded it.
scrapedAt
Optional
When this run read the account, ISO 8601 UTC.
error
Optional
On an error row: why the account could not be read. "not_found" no such account or TikTok refused the handle, "private" the account exists but its posts need a login, "audience_restricted" the creator turned on audience controls, which hide the account from anyone not logged in, "bad_input" the text given could never be a TikTok handle or a date could not be read, "window_too_wide" the window reaches further back than the one batch TikTok renders, "read_failed" TikTok or the proxy could not be reached, "parse_failed" TikTok answered and this Actor could not read what came back. The first five are answers about the account and the run still succeeds; only read_failed and parse_failed can fail a run, and only when every account in the run is one of them. Act on the presence of this field rather than on the run status.
errorDescription
Optional
On an error row: the same reason in words.
commentsEnabled
Optional
Whether comments are open on the post.