TikTok Video Details Scraper avatar

TikTok Video Details Scraper

Pricing

from $1.19 / 1,000 results

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

from $1.19 / 1,000 results

Rating

5.0

(1)

Developer

Neuro Scraper

Neuro Scraper

Maintained by Community

Actor stats

2

Bookmarked

38

Total users

1

Monthly active users

2 days ago

Last modified

Features

Full permissions

Share

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

The TikTok Video Details Scraper collects public TikTok video details and returns it as a clean dataset you can download as JSON, CSV or Excel, or read through the Apify API. No login, no cookies and no code: give the TikTok Video Details Scraper your input, start it and get structured TikTok data for research, monitoring, analytics or lead generation. You pay only for the results you receive.

⭐ Featured by Neuro Scraper: Facebook Reels Scraper - scrape Facebook Reels from any page, profile or reel link with exact views and plays, every reaction type (Like, Love, Care, Haha, Wow, Sad, Angry), comments, shares, captions, music and video links. No login and no cookies. Try the Facebook Reels Scraper →

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 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 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 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 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 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 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 videoFile link that works from any browser.

Stored files follow your Apify plan's data retention (on the Free plan the 10 most recent runs are kept for 4 months); give the storage a name to keep the files indefinitely.

The 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 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.

The 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.

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 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 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 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 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 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.

Why use the scraper

The TikTok Video Details Scraper is a TikTok scraper and TikTok data extractor for anyone who needs public TikTok video details as clean data. The TikTok Video Details Scraper handles web scraping, proxy rotation and retries for you, so you get a ready dataset instead of raw pages. Use the TikTok Video Details Scraper for market research, competitor analysis, lead generation, analytics or monitoring, and export the results to JSON, CSV, Excel or Google Sheets.

  • No login and no code: the TikTok Video Details Scraper runs on Apify with one click or one API call.
  • Pay per result: the TikTok Video Details Scraper charges only for rows delivered - no monthly TikTok API fee.
  • Complete fields: the TikTok Video Details Scraper returns every public field, with a stable schema for automation.
  • Integrations: connect the TikTok Video Details Scraper to Zapier, Make, n8n, Google Sheets, a webhook or your CRM.

The scraper use cases

  • Market research: the TikTok Video Details Scraper collects TikTok video details at scale, so you can compare trends across weeks and niches.
  • Competitor analysis: run the TikTok Video Details Scraper on a schedule and export the dataset to Google Sheets or Excel to watch what competitors publish.
  • Lead generation and B2B prospecting: the TikTok Video Details Scraper gives a sales or agency team a clean list to load into a CRM.
  • Content and social media monitoring: the TikTok Video Details Scraper keeps a fresh copy of TikTok data through an Apify schedule and a webhook.
  • Analytics and dashboards: send the TikTok Video Details Scraper output as JSON through the Apify API into Python, Node.js or a BI tool.
  • Academic and data science projects: the TikTok Video Details Scraper returns a consistent schema, ready for pandas, R or a notebook.
  • Price, product and brand tracking: the TikTok Video Details Scraper turns public TikTok data into a dataset you can diff run by run.
  • Automation workflows: connect the TikTok Video Details Scraper to Zapier, Make or n8n so every new row starts your next step.

How to run it with the API, Python and Node.js

Start the TikTok Video Details Scraper from the Apify Console, or call it from code. The TikTok Video Details Scraper returns its dataset as JSON, CSV or Excel. With the Apify API you can run the TikTok Video Details Scraper from Python or Node.js, wait for it to finish and read the rows, which makes the TikTok Video Details Scraper easy to plug into an automation, a data pipeline or a scheduled export.

  1. Open the TikTok Video Details Scraper on Apify and fill in the input (or send the same input as JSON to the API).
  2. Start the TikTok Video Details Scraper. Follow the run log while the TikTok Video Details Scraper collects public TikTok data.
  3. Download the dataset as CSV, JSON, Excel or XLSX, or let a webhook send it on.
  4. Schedule the TikTok Video Details Scraper to keep your TikTok data fresh for monitoring and analytics.

Tips for better results

  • Start small: run the TikTok Video Details Scraper with a low maximum first, check the fields, then scale up the same input.
  • Split big jobs: several smaller TikTok Video Details Scraper runs (by keyword, URL list or date) finish faster and are easier to resume.
  • Keep a history: name a dataset or use a schedule so each TikTok Video Details Scraper run adds to your TikTok data over time.
  • Filter early: use the input filters of the TikTok Video Details Scraper so you only pay for the TikTok video details you really need.
  • Automate the hand-off: a webhook or the Zapier and Make integrations can move every TikTok Video Details Scraper result straight to Google Sheets, a CRM or a database.
  • Watch the run log: the TikTok Video Details Scraper writes what it is doing and why an item was skipped, so a surprising result is easy to explain.

The scraper FAQ

Get started

Open the TikTok Video Details Scraper, paste your input and press Start. In a few minutes the TikTok Video Details Scraper hands you clean TikTok data as JSON, CSV or Excel, ready for analytics, monitoring, research or your CRM. Questions or a missing field? Write to us from the TikTok Video Details Scraper page on Apify - we answer fast and add features users ask for.

More scrapers from Neuro Scraper

ActorWhat it extracts
⭐ Facebook Reels ScraperFacebook Reels with exact views, plays, every reaction type, comments and shares
TikTok Profile ScraperTikTok profile data with all public fields, exported to JSON, CSV or Excel
Snapchat Profile ScraperSnapchat profile data with all public fields, exported to JSON, CSV or Excel
Amazon ScraperAmazon data with all public fields, exported to JSON, CSV or Excel
Instagram Reels ScraperInstagram reels with all public fields, exported to JSON, CSV or Excel
Facebook Video Details ScraperFacebook video details with all public fields, exported to JSON, CSV or Excel
Facebook Reels Scraper AdvancedFacebook reels advanced data with all public fields, exported to JSON, CSV or Excel
Facebook Reels DownloaderFacebook reels with all public fields, exported to JSON, CSV or Excel
Instagram Search ScraperInstagram search data with all public fields, exported to JSON, CSV or Excel
Instagram Hashtag ScraperInstagram hashtag data with all public fields, exported to JSON, CSV or Excel
Amazon Best Sellers ScraperAmazon best sellers with all public fields, exported to JSON, CSV or Excel
Facebook Photos ScraperFacebook photos with all public fields, exported to JSON, CSV or Excel
Instagram Reels DownloaderInstagram reels with all public fields, exported to JSON, CSV or Excel