TikTok User Profile Scraper — TikTok Followers, Videos, Stats
Pricing
from $1.90 / 1,000 profiles
Scrape TikTok user profiles by username, URL, user id or secUid: exact follower count, likes and video count, user id, secUid, created date, bio link, plus each profile's videos with plays and captions, followers and following lists. TikTok stats and profile data as an API. No login.
row_type
Optional
profile, video, user (a follower or following account) or playlist.
input
Optional
What you gave in profiles, verbatim.
profile_status
Optional
ok, private (counts shown, videos not), not_found (no such account: the handle is free, or the account was banned or deleted), region_restricted (TikTok hides the account from readers in the read country), unavailable (TikTok withholds the account from every reader: not private, the handle is not free; typically suspended), invalid_input (the entry is not a TikTok account; the others in the run are still read) or failed. Only ok rows with videos are charged.
status_detail
Optional
Why a profile is not ok, in words, with TikTok's own status code; on an ok row, a read that is not quite what was asked (TikTok answered for another region than the read country).
read_country
Optional
The country the row was read from (readCountries). TikTok shows counts and videos by the reader's country.
page_region
Optional
The region TikTok's page says it served (webapp.app-context.region).
scraped_at
Optional
When the row was read (UTC).
user_id
Optional
TikTok's numeric user id, as a string. Stable across renames.
sec_uid
Optional
TikTok's secUid, the id its own APIs take.
username
Optional
The handle, without @.
nickname
Optional
The display name.
bio
Optional
The profile text.
bio_link
Optional
The link set in the profile; null when none.
bio_link_risk
Optional
TikTok's own risk score of the bio link (bioLink.risk; 0 = no risk seen); null when no link.
profile_url
Optional
avatar_url
Optional
The avatar at 1080 px (an expiring TikTok link).
avatar_medium_url
Optional
The avatar at 720 px.
avatar_thumb_url
Optional
The avatar at 100 px.
verified
Optional
TikTok's verified badge.
private_account
Optional
The account is private.
is_organization
Optional
TikTok marks the account as an organization.
business_category
Optional
The category of a business account ("Shopping & Retail").
commerce_user
Optional
A business (commerce) account.
tt_seller
Optional
The account sells on TikTok Shop.
language
Optional
The account's language as TikTok records it.
created_at
Optional
When the account (profile rows) or the video (video rows) was created (UTC).
username_modified_at
Optional
When the handle was last changed (uniqueIdModifyTime). TikTok gives 0 to a logged-out reader for most accounts (every read in stage 4), so null does not mean never renamed.
nickname_modified_at
Optional
When the display name was last changed (nickNameModifyTime); null when TikTok gives 0, which does not mean never.
followers
Optional
Followers, exact (TikTok's statsV2), for the read country.
following
Optional
Accounts followed, exact.
likes
Optional
Likes received (hearts) on a profile, exact; likes of the video on a video row.
videos
Optional
The account's video count as TikTok shows it to the read country.
friends
Optional
Mutual follows.
liked_videos
Optional
Videos the account has liked.
followers_shown
Optional
Followers as the app rounds them (143,700 for 143,661).
following_shown
Optional
Following as the app shows it.
likes_shown
Optional
Likes as the app rounds them.
videos_shown
Optional
Videos as the app shows them.
counts_precision
Optional
exact (TikTok's exact counts), as_shown (only the rounded ones were served), or on videos exact_plays_rounded (TikTok's web rounds plays even in its exact counts).
live_room_id
Optional
The live room id while the account is live.
is_live
Optional
The account is live at read time.
has_story
Optional
The account has an active story.
comment_setting
Optional
everyone, friends or nobody.
duet_setting
Optional
everyone, friends or nobody.
stitch_setting
Optional
everyone, friends or nobody.
download_setting
Optional
everyone, friends or nobody.
following_visibility
Optional
public, private or friends.
liked_public
Optional
The account shows the videos it liked.
embed_allowed
Optional
The account allows its profile to be embedded.
playlists_tab
Optional
The profile shows a Playlists tab.
videos_requested
Optional
maxVideosPerProfile for this run.
videos_delivered
Optional
The profile's own videos this run delivered.
videos_route
Optional
embed (the 10 newest, each from its video page) or browser (the profile's video list walked in a browser).
videos_coverage
Optional
COMPLETE (everything asked, or every video TikTok lists), TRUNCATED (TikTok stopped serving before), PARTIAL (a read failed; the rest is delivered), CAPPED (maxItems or your maximum charge cut it).
videos_note
Optional
How the walk went: unique videos seen against TikTok's count, list pages, why it stopped.
engagement_videos
Optional
The delivered posts the engagement figures are computed from (at least 3).
engagement_rate
Optional
Mean over the videos of (likes + comments + shares + saves) / plays, in percent.
engagement_rate_followers
Optional
Mean (likes + comments + shares + saves) per video / followers, in percent.
avg_plays
Optional
Mean plays of those videos.
median_plays
Optional
Median plays of those videos.
avg_likes
Optional
Mean likes of those videos.
avg_comments
Optional
Mean comments of those videos.
avg_saves
Optional
Mean saves of those videos.
posts_per_week
Optional
Those videos divided by the weeks between the oldest and the newest of them.
creator_score
Optional
0-100: 40 x reach (log10 followers / 8) + 40 x engagement (rate / 10 %) + 20 x activity (posts per week / 7), each capped at 1.
top_content_categories
Optional
TikTok's own content category codes of those videos, most frequent first: [{category, videos}].
posting_hours_utc
Optional
Videos per hour of the day: [{hour, videos}].
posting_weekdays_utc
Optional
Videos per weekday: [{weekday, videos}].
followers_delivered
Optional
Follower rows this run delivered for the profile.
following_delivered
Optional
Following rows delivered.
reposts_delivered
Optional
Repost rows delivered.
liked_delivered
Optional
Liked-video rows delivered.
stories_delivered
Optional
Story rows delivered.
playlists_delivered
Optional
Playlist rows delivered.
change_type
Optional
With a monitoring memory: new (first delivery), changed or unchanged since the last delivery.
changed_fields
Optional
The watched fields that moved since the last delivery.
previous_read_at
Optional
When the memory last delivered this account.
previous_followers
Optional
Followers at the previous delivery.
followers_change
Optional
Followers now minus at the previous delivery.
followers_change_per_day
Optional
That change per day since the previous delivery.
likes_change
Optional
Likes now minus at the previous delivery.
videos_change
Optional
Videos now minus at the previous delivery.
previous_handle
Optional
The handle the memory knew this user id by, when it changed.
first_read_at
Optional
When the memory first read this account.
times_read
Optional
How many runs read this account into the memory.
count_history
Optional
The memory's reads of this account, newest last: [{at, followers, following, likes, videos}] (up to 30).
media_files
Optional
Files this row stored in the run's key-value store (downloadMedia): [{kind, key, url, bytes, reused}].
avatar_file_url
Optional
The avatar in the run's key-value store: the link works as long as the store is kept (Apify's data retention for the run's default store).
run_tag
Optional
runTag, copied onto every row.
video_source
Optional
posts, reposts, liked, story, playlist or collection.
source_route
Optional
video_page (the video's own page), browser_list (the profile's list in a browser), open_list (TikTok's open lists) or embed (only the embed's fields: the video page failed).
playlist_id
Optional
The playlist of the video, or of the playlist row.
video_id
Optional
TikTok's video id, as a string.
video_url
Optional
https://www.tiktok.com/@/video/ (photo for slideshows).
caption
Optional
The video's caption.
text_language
Optional
The caption's language as TikTok detects it.
plays
Optional
Plays as TikTok's web shows them (TikTok rounds plays even in its exact counts).
saves
Optional
Saves (favourites), exact.
reposts
Optional
Reposts, exact.
is_pinned
Optional
Pinned to the profile (known on the browser route; null on the others).
is_ad
Optional
TikTok marks the video as an ad.
is_branded_content
Optional
The creator's paid-partnership (branded content) toggle is on.
is_slideshow
Optional
A photo slideshow, not a video.
has_shop_product
Optional
A TikTok Shop product is attached.
is_ai_generated
Optional
TikTok's AI-generated content label.
ai_label
Optional
TikTok's AI-generated content description.
is_private_video
Optional
The video itself is private.
duration_s
Optional
Video length in seconds.
width
Optional
Video width in pixels.
height
Optional
Video height in pixels.
definition
Optional
720p, 1080p, ...
video_format
Optional
The file format (mp4).
size_bytes
Optional
The video file's size.
bitrate
Optional
The video bitrate.
cover_url
Optional
The cover at full size (an expiring TikTok link).
cover_720_url
Optional
The cover at 720 px (AVIF).
dynamic_cover_url
Optional
The animated cover.
play_url
Optional
TikTok's play link (signed, expiring; it serves only the session that read the page).
download_url
Optional
TikTok's download link (signed, expiring).
media_expires_at
Optional
When the soonest of the row's TikTok media links stops working (UTC).
caption_tracks
Optional
TikTok's caption tracks: [{language, format, source (ASR = automatic, MT = machine translation), version, url, expires_at}].
transcript
Optional
The spoken text from the caption track (includeTranscripts).
transcript_language
Optional
The caption track's language.
music_id
Optional
The sound's id, as a string.
music_title
Optional
The sound's title.
music_original
Optional
The sound is the creator's own.
music_url
Optional
The sound's audio link.
music_cover_url
Optional
The sound's cover image (TikTok's link, expires).
music_duration_s
Optional
The sound's length.
mentions
Optional
Accounts mentioned in the caption (full rows: [{user_id, username, sec_uid}]; clockworks rows: [@username]).
slideshow_images
Optional
The images of a slideshow, in order.
anchors
Optional
Links TikTok attaches to the video (an app, an effect, a product): [{type, kind, name}].
poi_id
Optional
The tagged place's id.
poi_name
Optional
The tagged place's name.
poi_address
Optional
The tagged place's address.
poi_city
Optional
The tagged place's city.
poi_category
Optional
The tagged place's category.
location_created
Optional
The country TikTok records the video was posted from (video page route).
content_category
Optional
TikTok's own content category code (CategoryType).
content_labels
Optional
TikTok's own content labels (diversificationLabels), when given.
duet_enabled
Optional
Duets are allowed on this video.
stitch_enabled
Optional
Stitches are allowed.
comments_enabled
Optional
Comments are open.
can_repost
Optional
The video can be reposted.
cover_file_url
Optional
The cover (720 px) or the first slideshow image in the run's store.
video_file_url
Optional
The video file in the run's store (downloadMedia: videos).
relation
Optional
On user rows: follower (follows of_username) or following (of_username follows them).
of_user_id
Optional
The profile whose list this row comes from.
of_username
Optional
That profile's handle.
playlist_name
Optional
The playlist's name.
playlist_url
Optional
The playlist's page.
playlist_video_count
Optional
Videos in the playlist.
rowType
Optional
clockworks shape: profile or video.
id
Optional
clockworks shape: the video id.
text
Optional
clockworks shape: the caption.
textLanguage
Optional
clockworks shape: the caption's language.
createTime
Optional
clockworks shape: the video's creation time, unix seconds.
createTimeISO
Optional
clockworks shape: the video's creation time (UTC).
isAd
Optional
clockworks shape: an ad.
isPinned
Optional
clockworks shape: pinned (browser route).
isSponsored
Optional
clockworks shape: branded content or Spark Ads authorized.
isSlideshow
Optional
clockworks shape: a slideshow.
playCount
Optional
clockworks shape: plays.
diggCount
Optional
clockworks shape: likes, exact.
commentCount
Optional
clockworks shape: comments.
collectCount
Optional
clockworks shape: saves.
repostCount
Optional
clockworks shape: reposts.
detailedMentions
Optional
clockworks shape: [{id, name, profileUrl}] — the profile URL uses the handle.
musicMeta
Optional
clockworks shape: {musicId, musicName, musicAuthor, musicOriginal, playUrl, coverMediumUrl, originalCoverMediumUrl}.
videoMeta
Optional
clockworks shape: {height, width, duration, coverUrl, originalCoverUrl, definition, format, subtitleLinks [{language, downloadLink, tiktokLink, source, sourceUnabbreviated, version}], aiVideoDescription, aiVideoSummary, transcriptionLink (null)}.
webVideoUrl
Optional
clockworks shape: the video's URL.
mediaUrls
Optional
clockworks shape: stored video files.
fromProfileSection
Optional
clockworks shape: profile, videos (the profile's own), reposts, liked, story, playlist or collection.
isStory
Optional
clockworks shape: a story.
readCountry
Optional
clockworks shape: the read country.
profileStatus
Optional
clockworks shape: the profile status (ok, private, not_found, region_restricted, unavailable, failed).
hasTikTokShopProduct
Optional
clockworks shape: the video links a TikTok Shop product.
effectStickers
Optional
clockworks shape: always empty (the web record has none).
commentsDatasetUrl
Optional
clockworks shape: always null (comments are not read).
shortDramaSeriesInfo
Optional
clockworks shape: always null.
comments
Optional
Comments, exact.