TikTok Scraper: Videos, Profiles, Hashtags, Sounds
Pricing
from $0.70 / 1,000 results
Scrape public TikTok without a login or API key: video engagement (views, likes, comments, shares) plus the uploader's follower and likes counts, account profiles, videos on a hashtag page, and videos using a sound. HTTP-only via TikTok's own embed and oEmbed surfaces - no browser.
Mode
_mode
Optional
Which surface produced this row: video, profile, hashtag, music or oembed.
Input
_input
Optional
The target this row belongs to, as resolved from your input entry. For a short link resolved to a canonical url, this keeps the short link you supplied.
Source
_source
Optional
embed-frontity-state when the row was parsed out of an embed page's server-rendered state, oembed-api when it came from TikTok's oEmbed endpoint, or none on a failure row.
Scraped at
_scrapedAt
Optional
UTC ISO 8601 timestamp of the scrape.
Index
_index
Optional
Position of this video within a hashtag or music page listing, starting at 1. Null for the single-row modes.
Warning
_warning
Optional
Non-fatal ceiling affecting this row. Values: single_page_surface_embed_playlist_is_not_paginable (the hashtag/music embed ships one page and its loader API is signature-gated), playlist_rows_carry_play_count_only_no_digg_or_comment_counts, profile_embed_does_not_publish_a_video_list, play_count_rounded_by_tiktok (TikTok serves 11000, not 11043). Multiple values are joined with a semicolon.
Error
_error
Optional
INVALID_INPUT (the entry could not be parsed for this mode), NOT_FOUND (the username, video, hashtag or sound does not resolve publicly), PRIVATE_ACCOUNT, EMPTY_RESULT (the entity exists but its embed shipped no videos), BLOCKED_AFTER_RETRIES (every retry and TLS profile was exhausted - add or rotate a proxy), UPSTREAM_SHAPE_CHANGED (TikTok moved the payload; the parser needs updating).
Error detail
_errorDetail
Optional
Human-readable explanation of _error, including the HTTP status or payload keys observed.
Video id
videoId
Optional
TikTok's numeric video id, as a string to survive JSON number precision.
Video URL
videoUrl
Optional
Canonical watch url, rebuilt from the author handle and video id.
Description
description
Optional
The video caption, including its inline hashtags as the author typed them.
Created (unix)
createTime
Optional
Upload time as a unix timestamp. Video mode only.
Created (ISO)
createTimeIso
Optional
Upload time as a UTC ISO 8601 string. Video mode only.
Views
playCount
Optional
Play count as TikTok publishes it - rounded at scale (11000 rather than 11043). The only counter available in hashtag and music rows.
Likes
diggCount
Optional
Like count. Video mode only.
Comments
commentCount
Optional
Comment count. The comments themselves are not available: TikTok's comment API is signature-gated. Video mode only.
Width
videoWidth
Optional
Video width in pixels.
Height
videoHeight
Optional
Video height in pixels.
Duration
videoDuration
Optional
Duration in seconds. TikTok serves the placeholder 99 on some videos; reported as served rather than corrected.
Ratio
videoRatio
Optional
Quality label such as 720p. Hashtag and music rows.
Cover URL
coverUrl
Optional
Static thumbnail on TikTok's CDN. The url carries a signed expiry.
Original cover URL
originCoverUrl
Optional
Uncropped thumbnail. Hashtag and music rows.
Animated cover URL
dynamicCoverUrl
Optional
Animated thumbnail.
Play address
playAddr
Optional
Direct media url as served to the embed player. Signed and short-lived. Hashtag and music rows.
Photo post
isPhotoPost
Optional
True when the post is an image carousel rather than a video.
Private item
isPrivateItem
Optional
True when the listing marks the video private. Hashtag and music rows.
Is ad
isAd
Optional
True when TikTok flags the video as an ad.
Original sound
isOriginal
Optional
True when the video uses the author's original audio.
Official
isOfficial
Optional
TikTok's official-content flag.
Shop video
isEcommerceVideo
Optional
True when the video is tagged as TikTok Shop content.
Branded content type
brandOrganicType
Optional
TikTok's branded-content disclosure type, empty on ordinary posts.
Country created
locationCreated
Optional
Two-letter country code TikTok attributes the upload to.
User id
userId
Optional
Numeric account id as a string. Profile mode.
Username
uniqueId
Optional
The @handle without the @. Profile mode.
Display name
nickname
Optional
Account display name. Profile mode.
Bio
signature
Optional
Account bio text. Profile mode.
Verified
verified
Optional
Blue-tick status. Profile mode.
Private account
privateAccount
Optional
True for a private account; the row also carries _error=PRIVATE_ACCOUNT. Profile mode.
Followers
followerCount
Optional
Follower count, rounded by TikTok at scale. Profile mode.
Following
followingCount
Optional
Accounts this account follows. Profile mode.
Total likes
heartCount
Optional
Lifetime likes across the account's videos. Profile mode.
Avatar URL
avatarUrl
Optional
Profile picture on TikTok's CDN. Profile mode.
Profile URL
profileUrl
Optional
Canonical profile url. Profile mode.
Sound id
musicId
Optional
Numeric sound id as a string. Feed it back in through music mode to see other videos using it.
Sound name
musicName
Optional
Sound title. Video mode.
Sound artist
musicAuthorName
Optional
Artist credited for the sound. Video mode.
Sound URL
musicPlayUrl
Optional
Direct audio url, signed and short-lived. Video mode.
Listing type
playlistType
Optional
hashtag or music, as TikTok labels the embed playlist.
Listing entity id
entityId
Optional
Id of the hashtag or sound the listing belongs to.
Listing artist
musicArtist
Optional
Artist of the sound behind a music listing.
Listing total videos
entityVideoCount
Optional
How many videos TikTok says use this sound or tag in total - far more than the page ships, and the reason the single-page ceiling is worth knowing.
Listing cover URL
entityCoverUrl
Optional
Cover image of the sound or tag.
oEmbed title
title
Optional
Video caption as TikTok's oEmbed endpoint reports it. oembed mode.
Thumbnail URL
thumbnailUrl
Optional
Thumbnail image. oembed mode.
Thumbnail width
thumbnailWidth
Optional
oembed mode.
Thumbnail height
thumbnailHeight
Optional
oembed mode.
Embed width
embedWidth
Optional
Suggested iframe width. oembed mode.
Embed height
embedHeight
Optional
Suggested iframe height. oembed mode.
Embed type
embedType
Optional
oEmbed product type, e.g. video. oembed mode.
Provider
providerName
Optional
Always TikTok. oembed mode.
