TikTok Video Metrics Scraper

What does TikTok Video Metrics Scraper do?

TikTok Video Metrics Scraper reads the public metrics of specific TikTok posts you already know the URLs of. Fetch metrics and metadata for specific public TikTok video URLs. Give it your inputs, press Start, and the Output tab fills with one clean row per record, ready to download as JSON, CSV, or Excel.

It works entirely with public TikTok data and never asks for TikTok login credentials. Because it runs on Apify you also get a REST API, scheduled runs, webhooks, integrations with tools such as Google Sheets, Slack, Make, and Zapier, proxy rotation, and a full log of every execution.

This Actor is deliberately narrow. Its input form asks only for the values this one job needs and its Output view shows only the columns this job produces, so nobody has to pick a technical mode to get a useful result.

Why use TikTok Video Metrics Scraper?

Report on a campaign without asking for screenshots

Collect the URLs your creators published and get an objective, timestamped metrics table for every post in one run.

Verify what a creator claims

Numbers come from the live public page, so a delivery report can be checked against reality in seconds.

Watch a post as it grows

Schedule the same URL list hourly or daily and append the results to build a view curve for each post.

Cheap and direct

This mode reads public pages itself with no third-party provider, so repeated monitoring stays inexpensive.

How to use TikTok Video Metrics Scraper

1. Click Try for free or open the Actor in Apify Console.
2. On the Input tab, fill in TikTok video URLs.
3. Set a result limit. A small number is the right choice for a first run.
4. Press Start and watch the log.
5. Open the Output tab to browse the results, or use Export for JSON, CSV, or Excel.
6. Happy with the setup? Press Save as task so you can repeat or schedule it in one click.

Ready-made tasks

These input presets ship with the Actor and are ready to run or schedule as they are.

Task	Saved as
Track campaign posts	campaign-post-tracking
Check a single video	single-video-check

Input

Field	Label	Type	Required	Default	Notes
videoUrls	TikTok video URLs	array	Yes		Paste one or more full public TikTok video URLs.
maxResults	Maximum results	integer	No	100	Stop after this many output records. Start small on your first run.
maxConcurrency	Maximum concurrency	integer	No	1	Parallel requests. Keep at 1 for the most reliable TikTok access.

Example input:

{
    "videoUrls": [
        "https://www.tiktok.com/@tiktok/video/7106594312292453675",
        "https://www.tiktok.com/@tiktok/video/7668726289376808222"
    ],
    "maxResults": 100,
    "maxConcurrency": 1
}

Limits apply to the complete run, not separately to each input, so a limit of 100 spread over four inputs returns roughly 25 records each.

Output

The Actor returns one normalized metrics record per available public video. Every record below came from a real verification run.

{
    "resultType": "video",
    "sourceInput": "https://www.tiktok.com/@tiktok/video/7106594312292453675",
    "videoId": "7106594312292453675",
    "videoUrl": "https://www.tiktok.com/@tiktok/video/7106594312292453675",
    "authorUsername": "tiktok",
    "authorName": "TikTok",
    "caption": "how many frogs did you find? 🐸 check out tiktok’s #Minecraft community today! @Gorillo",
    "hashtags": [
        "minecraft"
    ],
    "likes": 98800,
    "views": 566700,
    "shares": 342,
    "comments": 1273,
    "saves": 58552,
    "duration": 24,
    "coverUrl": "https://p16-common-sign.tiktokcdn-us.com/tos-useast5-p-0068-tx/beee36ba02ef449397b2d128bc32dd9d_1654632931~tplv-tiktokx-origin.image",
    "musicTitle": "original sound",
    "authorFollowers": null,
    "uploadedAt": "2022-06-07T20:15:29.000Z",
    "scrapedAt": "2026-08-02T12:45:48.308Z"
}

You can download the dataset in various formats such as JSON, HTML, CSV, or Excel, pull it from the Apify API, or push it onward through an integration. Each run also stores a COST_ESTIMATE record and an INTELLIGENCE_RUN_SUMMARY record in its key-value store.

Output fields

Field	Type	Meaning
videoId	string	TikTok video ID
videoUrl	string	Canonical link to the video
authorUsername	string	Creator handle without the @
authorName	string	Creator display name
authorFollowers	number	Creator follower count when the source exposes it
caption	string	Full post caption
hashtags	array	Hashtags parsed out of the post
views	number	Play count
likes	number	Like count
comments	number	Comment count
shares	number	Share count
saves	number	Save or favourite count
duration	number	Video length in seconds
musicTitle	string	Sound or track attached to the post
coverUrl	string	Thumbnail image URL
uploadedAt	date	Publication time in UTC
sourceInput	string	Keyword, handle, or URL that produced the row
scrapedAt	date	Collection time in UTC

Missing values are returned as null or as an empty string rather than being dropped, so exported columns stay aligned across every row.

How much does it cost to scrape TikTok?

This Actor is priced pay per event, so you are charged for results rather than for runtime.

Event	Price	When it is charged
Actor start	$0.005	Charged once when a run begins.
Video metrics result	$0.001	Metrics and metadata for one public TikTok video. No third-party provider is used by this mode.

Apify Store plan discounts apply automatically to the result event, so larger plans pay less per record:

Your Apify plan	Free	Starter	Scale	Business
Price per 1,000 results	$1.00	$0.90	$0.85	$0.80

You also pay your own Apify platform usage for the run, the same as any Actor you run yourself. The Apify free plan includes monthly credit that covers small runs.

This job reads public TikTok pages directly with no third-party data provider, which makes it the cheaper half of this Actor family to schedule. TikTok can still challenge requests, so low concurrency is the safest default.

Before collection starts the Actor writes a COST_ESTIMATE record with the maximum price of that specific run, so the ceiling is visible in the run storage before any significant work happens. The Apify free plan includes monthly platform credit that covers small runs, and the cheapest way to control spend is a modest result limit rather than a large run you abort.

Tips and advanced options

• Keep concurrency at 1 for the most reliable access. Video pages are heavier than profile pages.
• Short links such as vm.tiktok.com should be expanded to full www.tiktok.com URLs before submitting them.
• Schedule the same list and append to a named dataset to turn single snapshots into a growth curve.
• authorFollowers can be null on a video page. Use the TikTok Profile Scraper when you need reliable follower numbers.
• Start with one input and a small limit to confirm the shape of the output before scaling up.
• Filter on sourceInput when a single run covers several handles, keywords, or URLs.
• Treat private, removed, or region-blocked content as unavailable rather than as a zero metric.

Related TikTok Actors

Actor	What it does
TikTok Creator Comparison	Compare TikTok creators with rankings, engagement rates, median views, viral outliers, content patterns, and change tracking.
TikTok Keyword Video Search	Find public TikTok videos matching keywords and export their creators, captions, and engagement metrics.
TikTok Profile Videos Scraper	Collect public videos from one or more TikTok profiles with normalized post and engagement data.
TikTok Comments Scraper	Extract public TikTok comments, authors, likes, replies, pinned status, and creator-like signals.
TikTok Profile Scraper	Look up public TikTok profiles and export follower counts, bios, verification, and account statistics.
TikTok Followers Scraper	Collect normalized public follower profiles for one or more TikTok accounts.

All of them share the same collection engine and the same field names, so their datasets join together cleanly.

FAQ

Which URL formats are accepted?

Full public video URLs in the https://www.tiktok.com/@handle/video/ID form. Photo posts and private or removed videos are reported as unavailable.

How current are the numbers?

They are read live at run time and stamped with scrapedAt, so every row is self-documenting.

Can I monitor hundreds of posts?

Yes, up to 1000 URLs per run. For continuous monitoring, attach a schedule instead of raising the limit.

Is scraping TikTok legal?

Collecting public data is generally legal in most jurisdictions, and this Actor only reads pages any logged-out visitor can see. You remain responsible for how you use what you collect: follow TikTok's terms, honour applicable privacy law such as GDPR and CCPA when records describe identifiable people, and do not republish personal data you have no basis to process.

Something looks wrong. What now?

Public pages and upstream schemas change. If a field stops populating or a run fails, open the Issues tab on this Actor with the run ID and the input you used. Feature requests and custom export formats are welcome through the same channel.