TikTok Video Details Scraper avatar

TikTok Video Details Scraper

Pricing

$5.00/month + usage

Go to Apify Store
TikTok Video Details Scraper

TikTok Video Details Scraper

TikTok Video Details Scraper SD - TikTok Video Details Scraper is a social media data tool that extracts public TikTok videos from URLs or short links: caption, date, exact plays, likes, comments, shares, saves, hashtags, music, author stats and MP4 file.

Pricing

$5.00/month + usage

Rating

5.0

(1)

Developer

Neuro Scraper

Neuro Scraper

Maintained by Community

Actor stats

2

Bookmarked

38

Total users

1

Monthly active users

3 days ago

Last modified

Share

TikTok Video Details Scraper — full public data of any TikTok video

The TikTok Video Details Scraper takes TikTok video links and returns everything public about each video: caption, post date, duration, exact plays, likes, comments, shares and saves, hashtags, mentions, music, author stats, covers and the video stream.

It accepts full video URLs, photo-post URLs and the short share links from the app (vm.tiktok.com and vt.tiktok.com). The TikTok Video Details Scraper needs no TikTok account and no login.

In our tests the TikTok Video Details Scraper read Zach King's broom video with 2,400,000,000 plays and 29,600,000 likes, and returned two default videos in 7 seconds.

Who uses the TikTok Video Details Scraper

Marketers measuring campaign videos: plays, likes, comments, shares and saves per post, exact rather than rounded.

Agencies reporting on creator deliverables: one dataset per campaign with post dates and engagement.

Researchers studying trends: hashtags, sounds, country of creation and content categories per video.

Teams archiving their own content: with the download option, the TikTok Video Details Scraper saves the MP4 of each video.

How the TikTok Video Details Scraper works

TikTok embeds each video's data as JSON inside the public video page. The TikTok Video Details Scraper reads that JSON, the same method the previous version of this Actor used.

TikTok now answers the first request for a video page with a short "Please wait..." page. It contains a small proof-of-work puzzle. The TikTok Video Details Scraper solves it from the values printed in that page, exactly like TikTok's own script, then reads the real page.

In our runs every video page started with that puzzle and every puzzle was solved; each answer was found within the first 100 tries, in under a hundredth of a second.

Each video is read in a fresh session. In our tests a second video in the same session was refused, so the TikTok Video Details Scraper uses a new session (and a new proxy IP on the platform) per video.

Short links are followed through TikTok's own redirect. When a short link leads to the TikTok home page instead of a video, the link is dead and the log says so.

Input fields for the TikTok Video Details Scraper

Give at least one video URL. With none, the run stops immediately and says so.

FieldTypeDefaultMeaning
startUrlsarray2 example videos (prefill)Video links: https://www.tiktok.com/@user/video/<id>, /photo/<id>, https://vm.tiktok.com/..., https://vt.tiktok.com/...
downloadVideosbooleanfalseSave each MP4 (up to 9 MB) in the run's key-value store and put its link in videoFile
proxyConfigurationproxyApify RESIDENTIALProxy for TikTok; residential is recommended

The field names are the same as in the previous version of the TikTok Video Details Scraper, so saved tasks and API calls keep working.

Example input for the TikTok Video Details Scraper

{"startUrls": [{"url": "https://www.tiktok.com/@zachking/video/6768504823336815877"}, {"url": "https://vt.tiktok.com/ZSffquwF2/"}], "downloadVideos": false}

Output fields of the TikTok Video Details Scraper

Every row has the same keys, so the dataset schema is stable for CSV, Excel and JSON exports.

FieldMeaning
idVideo ID
urlCanonical video URL with the current author handle
descCaption
createTime, createTimeUnixPost date (ISO) and Unix seconds
durationLength in seconds
playCountExact plays
likeCountExact likes
commentCountComments
shareCountShares
collectCountSaves (bookmarks)
repostCountReposts
hashtagsHashtags of the video, without duplicates
mentions@usernames tagged in the caption
musicSound: id, title, author, original flag, duration, album, audio URL, cover
authorCreator: id, handle, nickname, verified, private, bio, secUid, avatar, followers, following, likes, videos
cover, originCover, dynamicCoverCover images (static, original, animated)
videoUrlTikTok's stream URL; works only inside the session that opened the page
videoFileLink to the saved MP4, only when downloadVideos is on
width, height, definition, format, bitrateStream properties
locationCountry code where the video was created, e.g. US
poiTagged place, when the video has one
isAd, isAigcAd and AI-generated flags
categoriesTikTok's content labels, e.g. "Nature"
textLanguageCaption language
imagePostImage URLs of a photo post
inputUrl, scrapedAtYour input and the UTC timestamp

Example row from the TikTok Video Details Scraper

{"id": "6718335390845095173", "desc": "Scramble up ur name & I'll try to guess it ...", "createTime": "2019-07-27T13:32:38+00:00", "duration": 10, "playCount": 159400, "likeCount": 35200, "commentCount": 5487, "shareCount": 1496, "collectCount": 647, "hashtags": ["foryoupage", "PetsOfTikTok", "aesthetic", "bonevoyage"], "location": "US"}

Measured results of the TikTok Video Details Scraper

All runs on 2026-10-03 from one residential IP; platform runs use Apify residential proxy.

TestResult
2 default videos2 rows in 7 seconds, puzzle solved twice
9 mixed links (5 long, 4 short)4 rows in 33 seconds; 5 links reported with the reason: 2 removed or private videos, 1 restricted video, 1 short link to a removed video, 1 dead short link
MP4 download2,953,029-byte MP4 saved for a 10-second video in 6 seconds
profile URL, YouTube URL, plain text, made-up video ID, empty inputno crash: each input logged with the reason, run ended cleanly

How to run the TikTok Video Details Scraper

Copy the links of the videos you want, from the browser address bar or the app's Share button, and paste them into startUrls, one per line. Press Start; the first row usually arrives within a few seconds.

Mixed lists are fine: the TikTok Video Details Scraper sorts out full links, photo posts and short links by itself, and skips anything that is not a TikTok video link with a clear message.

Switch on downloadVideos only when you need the files. Without it the TikTok Video Details Scraper is faster and stores nothing but the dataset.

Reading the TikTok Video Details Scraper output

playCount, likeCount, commentCount, shareCount and collectCount are TikTok's exact counters at the moment of the run. Run again later to measure growth.

author holds the creator's current handle and statistics. If a creator renamed the account, url already uses the new handle; the orcaocean3 link in our tests now belongs to @allanafindsit.

music.original is true when the sound was recorded for this video and false for a reused track, with the track title and album when TikTok knows them.

Troubleshooting the TikTok Video Details Scraper

  • "item doesn't exist": the video was removed, made private or never existed.
  • "restricted content": TikTok hides the video from logged-out visitors; it cannot be read without an account.
  • "short link ... home page": the share link expired; open the video in the app and copy a fresh link.

TikTok binds its stream URL to the visitor session that opened the page. We measured it: the same URL streamed inside that session and answered "403 Forbidden" from a fresh one.

So a videoUrl copied from the dataset will usually not play in your browser. Switch on downloadVideos and the TikTok Video Details Scraper saves the file while the session is still valid, then gives you a permanent videoFile link.

TikTok Video Details Scraper limits, stated plainly

The TikTok Video Details Scraper reads public videos only. Removed, private and friends-only videos return TikTok's "item doesn't exist" answer and produce no row.

Some videos are hidden from logged-out visitors (TikTok marks them as restricted content). The TikTok Video Details Scraper logs those as restricted and skips them; it never logs in to see them.

It does not return the comment texts of a video. commentCount is included.

mentions is filled only when the caption tags users; none of the videos in our tests did, so we saw it empty every time.

poi (tagged place) and imagePost (photo carousel) were not present on any tested video; they appear only on videos that have them.

Video files above 9 MB are not stored, to stay inside the key-value store record limit; the row is still returned.

Export, API and automation with the TikTok Video Details Scraper

Export the TikTok Video Details Scraper dataset as CSV, JSON, Excel, XML or HTML, or read it through the Apify API with Python, JavaScript or any HTTP client. The TikTok Video Details Scraper also saves all rows together as ALL_RESULTS in the key-value store.

Connect it to Google Sheets, Make, Zapier or n8n with ready integrations, and use a webhook to start your own automation after each run.

A common setup: a daily schedule over the links of an ongoing campaign, results appended to Google Sheets, and a chart of plays and likes per video.

TikTok Video Details Scraper pricing

The TikTok Video Details Scraper uses pay-per-event pricing: you pay per video row in the dataset. The current price per 1,000 results is on the Pricing tab.

Links for which the TikTok Video Details Scraper finds no video data produce no row. Free-plan accounts get up to 30 videos per run.

The TikTok Video Details Scraper is part of a family of no-login social media scrapers from the same developer.

ActorWhat it extracts
TikTok Profile ScraperExact followers, likes, bio and verification of TikTok accounts
Snapchat Profile ScraperSnapchat subscribers, Spotlight videos with views
Instagram Reels ScraperInstagram reels with plays, likes and comments
Instagram Video DownloaderInstagram video files
Instagram Comments ScraperComments of Instagram posts
YouTube Shorts ScraperYouTube Shorts with views and likes
YouTube Video Details ScraperViews, likes and metadata of YouTube videos
YouTube Video DownloaderYouTube video files
YouTube Transcript ScraperTranscripts of YouTube videos
Facebook Reels ScraperReels of a Facebook page
Facebook Video DownloaderFacebook video files
Amazon ScraperAmazon search results by keyword

Leave a review

If the TikTok Video Details Scraper is useful to you, please leave a star rating and a short review on the Actor page. It helps other users and shows us what to improve next.

If a public video failed, open an issue with the run link and the video URL.

Frequently asked questions

Does the TikTok Video Details Scraper need a TikTok login?

No. The TikTok Video Details Scraper never logs in and uses no browser cookies, only the session cookies TikTok itself sets for every visitor.

Yes. It follows TikTok's redirect to the full video. In our tests 3 of 5 short links led to a video and 2 had expired and led to the TikTok home page, which the log reports.

Are the play and like counts exact?

Yes. The TikTok Video Details Scraper reads TikTok's exact counters, for example 159,400 plays and 35,200 likes, not rounded labels.

Can the TikTok Video Details Scraper download the video file?

Yes, switch on downloadVideos. The MP4 is saved in the run's key-value store and videoFile links to it. Our test saved a 2.9 MB file for a 10-second video.

TikTok answered that the video does not exist (removed, private or friends-only), or that it is restricted for logged-out visitors, or the short link expired. The log names the exact reason for each link.

Does the TikTok Video Details Scraper return comments?

It returns commentCount, not the comment texts.

Can I scrape all videos of a TikTok profile?

The TikTok Video Details Scraper works per video link. Collect the links first, then paste them here; for profile-level numbers use the TikTok Profile Scraper.

How fast is the TikTok Video Details Scraper?

About 3 to 4 seconds per video including the puzzle page: 2 videos took 7 seconds and 9 links took 33 seconds in our tests.

Can I call the TikTok Video Details Scraper from Python?

Yes. Start it with the Apify Python client, wait for the run, then read the dataset items as JSON, or receive them by webhook.