Pricing

Rating

Developer

Actor stats

Categories

Share

TikTok Metrics Scraper

📊 What does TikTok Metrics Scraper do?

TikTok Metrics Scraper collects public TikTok video metrics and profile metrics from TikTok video URLs, share links, profile URLs, and @handles.

Use it when you need clean TikTok data for creator research, influencer reporting, campaign tracking, competitor monitoring, social analytics, dashboards, warehouse loads, and scheduled metric snapshots.

The Actor returns flat CSV/API-friendly rows with TikTok views, likes, comments, shares, saves, reposts, profile stats, IDs, captions, hashtags, music, thumbnails, timestamps, status fields, and metric quality labels.

This Actor does not log in, use cookies, scrape private TikTok content, collect comment text, or bypass TikTok access controls. It only returns data that is available from public TikTok surfaces at run time.

With TikTok Metrics Scraper, you can:

• 📈 Track TikTok video performance from known video URLs and share links.
• 👤 Discover recent public videos from TikTok profile URLs and @handles.
• 💬 Collect public views, likes, comments, shares, saves, and reposts when available.
• 🧑‍🎤 Add public profile metrics such as followers, following, total likes, and video counts.
• 🆔 Extract useful IDs such as profileId and postId.
• 🎵 Save captions, hashtags, music metadata, thumbnails, duration, and created dates.
• 🎯 Check metric precision and availability instead of treating every count as equally exact.
• 📦 Export results as JSON, JSONL, CSV, Excel, XML, RSS, or HTML.

📦 What TikTok metric data can I extract?

Each dataset row represents one TikTok video.

Metric availability depends on what TikTok exposes publicly for each video or profile. If a public source does not expose a metric, the Actor marks that metric as unavailable instead of filling it with a fake zero.

⚙️ Can I use this Actor through an API?

Yes. You can run TikTok Metrics Scraper manually in Apify Console or use it through:

• Apify API
• Python SDK
• Node.js SDK
• Webhooks
• Scheduled runs
• Apify integrations

This makes it useful for social media dashboards, influencer lists, competitive intelligence, creator databases, campaign reporting, data warehouses, and automated market research workflows.

🎯 Why scrape TikTok video and profile metrics?

TikTok public metrics help you understand which creators, videos, sounds, hashtags, campaigns, and competitors are gaining traction.

💵 How much does scraping TikTok metrics cost?

TikTok Metrics Scraper uses Pay Per Event pricing: $2.00 per 1,000 TikTok metric rows ($0.002 per row), with platform usage included. Higher Apify subscription tiers may receive lower per-row pricing on the Actor's Pricing tab.

Start with a small batch of 3 to 10 URLs when testing. The run summary and dataset statuses show which URLs resolved, which returned public metrics, which returned no public metrics, and whether any URLs failed.

🚀 How do I use TikTok Metrics Scraper?

1. Create or log in to your Apify account.
2. Open TikTok Metrics Scraper.
3. Choose Auto-detect URLs and handles, Video URLs only, or Profile discovery only.
4. Paste TikTok video URLs, share links, profile URLs, @handles, or a mix of them.
5. Set the maximum number of metric rows to collect.
6. Leave the default settings for your first run.
7. Click Start.
8. Open the Output tab to inspect the dataset and run summary.
9. Download your data in JSON, JSONL, CSV, Excel, XML, RSS, or HTML.

⬇️ Input

The main input is startUrls. Paste at least one TikTok video URL, share link, profile URL, or @handle. https:// is optional for normal TikTok URLs.

For a quick test, run a known public MrBeast TikTok video:

{
"mode":"auto",
"startUrls":["https://www.tiktok.com/@mrbeast/video/7654638524729216287"],
"maxItems":25,
"includeProfileMetrics":true
}

In Auto-detect URLs and handles mode, you can paste direct video URLs and profile inputs into the same list. The Actor combines direct videos and profile-discovered videos, deduplicates them, and applies one shared metric row cap.

🔗 TikTok URLs and handles

Supported input shapes include:

www.tiktok.com/@creator/video/1234567890123456789
https://www.tiktok.com/@creator/video/1234567890123456789
https://www.tiktok.com/t/ZTxxxxxxxx/
https://vm.tiktok.com/ZMxxxxxxxx/
https://vt.tiktok.com/ZSxxxxxxxx/
https://www.tiktok.com/@creator
@creator
creator
creator.name

Best results usually come from direct public video URLs and public profile URLs that open in a logged-out browser.

👤 Profile discovery

Use profile discovery when you want the Actor to find recent public videos from a TikTok profile before collecting metrics.

{
"mode":"profileUrls",
"startUrls":["@mrbeast"],
"maxItems":25,
"maxItemsPerProfile":10,
"includeProfileMetrics":true
}

Use maxItemsPerProfile to control how many public video URLs are discovered from each profile. The shared maxItems cap still limits total output rows for the whole run.

🎛️ Settings

⬆️ Output sample

The results are stored in the default dataset. Each result is one TikTok video row.

{
"platform":"tiktok",
"inputUrl":"www.tiktok.com/@examplecreator/video/7651772538292342046",
"postUrl":"https://www.tiktok.com/@examplecreator/video/7651772538292342046",
"postId":"7651772538292342046",
"postType":"video",
"description":"Example caption text #marketing #tiktok",
"publishedAt":"2026-06-22T12:00:00.000Z",
"thumbnailUrl":"https://p16-sign-va.tiktokcdn.com/example.jpg",
"videoDurationSeconds":42,
"hashtagNames":["marketing","tiktok"],
"musicTitle":"Example sound",
"musicAuthorName":"Example Artist",
"profileId":"1234567890123456789",
"profileHandle":"examplecreator",
"profileName":"Example Creator",
"profileUrl":"https://www.tiktok.com/@examplecreator",
"profileVerified":true,
"views":1234567,
"likes":23456,
"comments":345,
"shares":456,
"saves":567,
"reposts":12,
"postMetricStatus":[
{
"metric":"views",
"status":"present",
"precision":"exact"
}
],
"profileFollowersCount":1250000,
"profileFollowingCount":418,
"profileLikesCount":24800000,
"profileVideosCount":412,
"profileMetricStatus":[
{
"metric":"profileFollowersCount",
"status":"present",
"precision":"exact"
}
],
"status":"ok",
"statusReason":null,
"scrapedAt":"2026-06-22T12:05:00.000Z"
}

🎯 Metric precision and availability

TikTok public pages can expose full integers, compact display counts, or already rounded public counts. TikTok Metrics Scraper labels metric precision instead of pretending all numbers are equally exact.

postMetricStatus and profileMetricStatus show metric-by-metric status and precision. The top-level metric columns hold the counts.

When both a compact display count and a full integer are present, the Actor prefers the full integer. It does not emit derived engagement-rate columns. Calculate rates downstream from the returned counts and precision labels if you need them.

🚦 Output statuses

🧭 Practical notes

This Actor collects public TikTok data only. It does not use login, cookies, private accounts, or private content access.

Profile discovery is best effort. Some profiles expose profile metrics but not recent public video URLs in the public surfaces available at run time.

TikTok counts change continuously. Treat each run as a point-in-time snapshot. For monitoring, schedule repeated runs and compare rows by postId and scrapedAt.

For large TikTok URL lists, split work into smaller runs. This keeps retries, timeouts, and result inspection easier to manage.

❓ Common questions

Can this scrape TikTok saves and reposts?

The dataset includes fields for saves and reposts. The Actor collects them when TikTok exposes those metrics in public page data. If TikTok does not expose them for a specific video, the fields are marked unavailable with postMetricStatus.

Can this scrape TikTok comments?

This Actor collects the public comment count. It does not scrape comment text, comment authors, or comment threads.

Can this scrape TikTok followers?

Yes, when TikTok exposes public profile metrics. The Actor can return follower, following, total likes, and video counts for the creator profile.

Can I use it for TikTok competitor tracking?

Yes. Paste public competitor video URLs, profile URLs, or handles, then schedule the Actor to collect repeat metric snapshots over time.

Can I run it through the Apify API?

Yes. The Actor is designed for both Apify Console runs and API workflows. Use the flat output rows for dashboards, data warehouses, exports, and monitoring pipelines.

Why are some metrics unavailable?

TikTok does not expose every metric on every public surface. When a metric is missing, the Actor keeps the row, marks the metric unavailable, and includes status fields so your pipeline can handle the row cleanly.