📈 TikTok Video Tracker

TikTok Video Tracker monitors public TikTok video performance over time instead of returning only a one-time snapshot.

Track views, likes, comments, shares, historical growth, view velocity, viral acceleration, and fastest-growing videos without manually checking every post.

• 📊 Track video growth across repeated runs
• ⏱ Compare 1-hour, 24-hour, and 7-day performance
• 🚀 Detect acceleration in recent view velocity
• 🏆 Rank the fastest-growing videos in the current batch
• 🕒 Build persistent historical snapshots
• 🛡 Keep successful results when another video fails
• ⚡ Process up to 5 TikTok requests concurrently
• 🔁 Retry temporary HTTP and network failures
• 🔌 Use results through Apify Dataset, API, integrations, or downstream apps

---

📦 What data does TikTok Video Tracker extract?

🆔 Video ID	🔗 TikTok video URL
👤 Creator username	📝 Video caption
📅 Published timestamp	👁 Current views
❤️ Current likes	💬 Current comments
🔁 Current shares	🕒 Snapshot timestamp
📈 Views gained	⚡ Views per hour
🕐 1-hour metrics	🗓 24-hour metrics
📆 7-day metrics	🚀 Viral acceleration
🏆 1-hour growth rank	📚 Snapshot count
⚠️ Status	🧾 Error message when applicable

Historical fields remain null until a suitable comparison snapshot exists. The Actor does not invent growth data.

---

🚀 Features

• Up to 200 TikTok video URLs per run
• Persistent tracking history across Actor runs
• Previous-snapshot comparison
• 1-hour growth window
• 24-hour growth window
• 7-day growth window
• Views-per-hour calculations using actual elapsed time
• Viral acceleration using 1h vs 24h and 24h vs 7d velocity
• Fastest-growing ranking by 1-hour view velocity
• Duplicate video-ID protection
• Retry handling for temporary HTTP/network failures
• Partial-failure protection
• Up to 5 concurrent TikTok fetches
• Structured Dataset output
• HTTP-first architecture

---

⬇️ Input

Paste one or more public TikTok video URLs.

Minimum: 1 TikTok video URL
Maximum: 200 TikTok video URLs

Expected format:

https://www.tiktok.com/@username/video/VIDEO_ID

Example:

{
  "videoUrls": [
    "https://www.tiktok.com/@creator/video/1234567890123456789",
    "https://www.tiktok.com/@anothercreator/video/9876543210987654321"
  ]
}

Duplicate valid video IDs are processed once.

---

⬆️ Output

Results are stored in the Actor's default Apify Dataset and can be accessed from Output, Storage, the Apify API, or integrations.

Example successful result:

{
  "status": "ok",
  "videoId": "1234567890123456789",
  "url": "https://www.tiktok.com/@creator/video/1234567890123456789",
  "creator": "creator",
  "caption": "Example TikTok caption",
  "publishedAt": "2026-09-01T10:00:00.000Z",
  "currentViews": 200000,
  "currentLikes": 24000,
  "currentComments": 1800,
  "currentShares": 950,
  "checkedAt": "2026-09-08T05:00:00.000Z",
  "viewsGained1h": 10000,
  "viewsPerHour1h": 10000,
  "viewsGained24h": 48000,
  "viewsPerHour24h": 2000,
  "viewsGained7d": 84000,
  "viewsPerHour7d": 500,
  "acceleration1hVs24h": 5,
  "accelerationPercent1hVs24h": 400,
  "acceleration24hVs7d": 4,
  "accelerationPercent24hVs7d": 300,
  "snapshotCount": 42,
  "growthRank1h": 1
}

Example error result:

{
  "status": "error",
  "videoId": "9999999999999999999",
  "url": "https://www.tiktok.com/@creator/video/9999999999999999999",
  "error": "TikTok video details were not found",
  "checkedAt": "2026-09-08T05:00:00.000Z"
}

---

🕒 Historical tracking

The first successful run creates a baseline snapshot. Later runs reuse stored history and calculate real changes over time.

History is stored in the named Apify Key-Value Store:

tiktok-video-tracker-history

This enables repeated tracking rather than treating every run as unrelated data.

---

🕐 1-hour growth tracking

Fields include:

viewsGained1h
likesGained1h
commentsGained1h
sharesGained1h
viewsGrowthPercent1h
viewsPerHour1h

The tracker looks for a snapshot around:

1 hour ago ± 30 minutes

If no suitable snapshot exists, the fields remain null.

---

🗓 24-hour growth tracking

Fields include:

viewsGained24h
likesGained24h
commentsGained24h
sharesGained24h
viewsGrowthPercent24h
viewsPerHour24h

Target window:

24 hours ago ± 6 hours

---

📆 7-day growth tracking

Fields include:

viewsGained7d
likesGained7d
commentsGained7d
sharesGained7d
viewsGrowthPercent7d
viewsPerHour7d

Target window:

7 days ago ± 24 hours

---

🚀 Viral acceleration

The Actor compares recent velocity with longer-term velocity using:

acceleration1hVs24h
accelerationPercent1hVs24h
acceleration24hVs7d
accelerationPercent24hVs7d

Example:

1h velocity: 10,000 views/hour
24h velocity: 2,000 views/hour

acceleration1hVs24h: 5
accelerationPercent1hVs24h: 400

---

🏆 Fastest-growing video rank

growthRank1h ranks successful videos in the current Actor batch by valid viewsPerHour1h.

Video A → 5,000 views/hour → rank 2
Video B → 12,000 views/hour → rank 1
Video C → no 1h history → null

This is a current-batch ranking, not a global TikTok ranking.

---

⚡ Performance

The Actor uses an HTTP-first architecture and does not launch a full browser for normal tracking.

Up to 5 TikTok requests can be active at the same time. When one finishes, the next pending video starts immediately.

---

🛡 Reliability

Temporary TikTok HTTP responses are retried:

429
500
502
503
504

Up to 3 total attempts are made.

Temporary network errors are also retried. If all attempts fail, the final row contains a readable error.

Videos are processed independently, so one failed video does not remove successful results from the Dataset.

---

🔌 API & integrations

Use TikTok Video Tracker with:

• Apify API
• Google Sheets
• Make
• Zapier
• Internal APIs
• Social-media dashboards
• Data warehouses
• Creator analytics systems
• Influencer campaign tools
• Monitoring systems
• AI agents
• MCP workflows

---

💡 Example use cases

🎬 Creator video monitoring

Track your own posts and compare growth across repeated runs.

📊 Influencer campaign monitoring

Compare sponsored TikTok posts from multiple creators.

🚀 Viral-content detection

Inspect short-term velocity, 24-hour velocity, acceleration, and growth rank.

🏆 Multi-video comparison

Submit multiple videos and identify the fastest-growing ones.

🔬 Social-media research

Collect repeated public performance snapshots for selected TikTok videos.

🤖 Automated monitoring

Use Apify Schedules and API workflows to run the tracker repeatedly.

---

⚠️ Current limitations

The current version does not perform:

TikTok profile discovery
Hashtag search
Keyword search
Follower tracking
Comment extraction
Separate hashtag extraction
Separate music metadata extraction
Private video access
Age-restricted/private-account bypass
TikTok login automation
Short-link resolution
Browser fallback
Proxy configuration
Built-in scheduling UI
Global TikTok rankings

Scheduling should currently be handled using Apify Schedules or another automation workflow.

TikTok may change its public page structure or apply rate limits, which can temporarily affect availability.

---

❓ FAQ

Can I track the same video over time?

Yes. Repeated runs are the main purpose of this Actor.

Why are historical fields null on the first run?

The first successful run creates the baseline. Historical metrics require a suitable earlier snapshot.

How often should I run it?

For strong 1-hour tracking, an hourly Apify Schedule is recommended.

What happens if one URL fails?

That input receives status: "error" while successful videos remain available.

Can I use it through an API?

Yes. Start the Actor through the Apify API and consume the Dataset programmatically.

Is a browser required?

Not for the current normal tracking workflow.

Does the Actor fabricate missing data?

No. Missing historical comparisons remain null; unavailable videos return error rows.

---

🧭 Recommended workflow

1. Add the TikTok videos you want to monitor
2. Run once to create baseline snapshots
3. Create a recurring Apify Schedule
4. Run the same videos repeatedly
5. Watch 1h / 24h / 7d metrics populate
6. Compare growthRank1h and viral acceleration
7. Export or send Dataset results to your analytics workflow

---

💬 Feedback & support

Found a bug or have a feature request?

Use the Actor's Issues tab on Apify.

Useful future additions may include short-link resolution, profile-based discovery, hashtag/music metadata, more growth windows, engagement-rate analytics, configurable concurrency, and additional leaderboard modes.

---

🚀 TikTok growth analytics without the manual checking

Paste your public TikTok video URLs, run the Actor, and receive structured current statistics plus historical growth analytics ready for creator monitoring, influencer campaigns, research, APIs, dashboards, and automation.