TikTok 🔥 Viral Atlas

What does TikTok 🔥 Viral Atlas do?

TikTok 🔥 Viral Atlas enables you to gain deeper insights into TikTok content diffusion and virality patterns than the official TikTok API allows.

TikTok 🔥 Viral Atlas can extract:

• Related video discovery and content clustering
• Comprehensive video metadata (posting time, views, likes, shares, comments)
• Creator information and clustering analysis
• Real-time engagement analytics and trends
• Posting-time intelligence revealing when content goes viral
• Network-style viral trend visualization and reporting
• Content diffusion patterns across the platform

---

Demo Video

Watch the full actor in action with interactive HTML report:

---

Input

Provide the following JSON input:

{
  "profileUrl": "https://www.tiktok.com/@arayfer_ha/video/7632888578372013320",
  "maxVideosToDiscover": 15,
  "runFullPipeline": true,
  "testMode": false
}

---

Input Fields

Field	Type	Required	Default	Description
profileUrl	string	✅	-	TikTok video URL to start crawling from. Must contain /video/.
maxVideosToDiscover	integer	❌	10	Number of related videos to discover (minimum 2, maximum 50).
runFullPipeline	boolean	❌	false	Set to true to scrape full metadata and generate the enhanced HTML report.
testMode	boolean	❌	false	Enable quick test mode (only scrapes 1 video with minimal data).

---

Output

The actor produces a flat array of objects with the following structure:

[
{
  "seedVideoUrl": "https://www.tiktok.com/@username/video/1234567890123456789",
  "seedUsername": "username",
  "relatedVideoUrl": "https://www.tiktok.com/@creator/video/9876543210987654321",
  "relatedCreator": "creator",
  "relatedScrapedAt": "2026-06-05T13:53:00.000Z",
  "postedTimestampUTC": 1749120000000,
  "postedDateUTC": "2025-06-05",
  "postedTimeUTC": "12:00:00",
  "sequenceNumber": 123456,
  "machineId": null,
  "authorHandle": "@creator",
  "authorName": "Creator Name",
  "description": "This is an example video description 🔥",
  "hashtags": ["#trending", "#viral", "#fyp"],
  "views": "2450000",
  "likes": "124500",
  "comments": "3240",
  "shares": "8750",
  "bookmarks": "12400",
  "music": "Original Sound - Creator Name",
  "pageTitle": "TikTok | Example Video Title",
  "scrapedAt": "2026-06-05T13:53:22.147Z"
}
]

---

Results

The actor returns structured JSON data including:

{
  "videoId": "7123456789012345678",
  "description": "Amazing viral moment 🔥",
  "views": 2500000,
  "likes": 125000,
  "shares": 45000,
  "comments": 12000,
  "creatorId": "user123",
  "creatorUsername": "@creator_name",
  "postTime": "2024-01-15T14:30:00Z",
  "viralScore": 0.92,
  "relatedVideos": ["id1", "id2", "id3"],
  "engagementRate": 0.068,
  "diffusionPattern": "exponential"
}

---

HTML Report Visualization

When runFullPipeline is enabled, the actor creates a professional interactive HTML visualization:

• Interactive network graph showing seed video → related videos
• Hover tooltips with rich metadata
• Full sortable data table
• Clean and shareable report

This makes it very easy to analyze TikTok content clusters visually.

How It Works

• Crawl Related Videos

• The crawler navigates to the provided TikTok video URL using PlaywrightCrawler.

• Extracts links to related videos from TikTok’s discovery feed.

• Ensures unique creators and avoids duplicates.

Fetch Metadata

Retrieves posting time, likes, comments, shares, bookmarks, views, hashtags, music, and more.

Flatten Results

Combines the related video info and metadata into a single output array.

---

Configuration Tips

Concurrency: maxConcurrency: 3 – up to 3 pages can be scraped in parallel. Adjust carefully to avoid TikTok rate limits.

Session Pool: Sessions last up to 3600 seconds. Avoid persistState to reduce session conflicts and blocks.

Retries & Timeout: Each request retries up to 5 times (maxRequestRetries: 5) and allows 300 seconds (requestHandlerTimeoutSecs: 300) to handle slow responses.

---

Installation & Running Locally

git clone <repo_url>
cd tiktok-video-discovery-engine
npm install

Run locally with:

APIFY_TOKEN=<your_token> node src/main.js

** Or deploy as an Apify actor and provide input via the web interface. **

---

Why scrape TikTok?

With over 1 billion active users, TikTok is one of the world's most influential social media platforms and an invaluable source of data for understanding viral content dynamics and audience behavior.

Here are just some of the ways you could use TikTok data:

• Identify trending topics and viral patterns to stay ahead of market trends
• Analyze creator strategies and posting times to optimize your own content
• Monitor brand mentions and competitor performance in real-time
• Understand audience engagement patterns and virality mechanics
• Discover emerging creators and niche communities in your industry
• Build data-driven content calendars based on viral intelligence
• Conduct market research and consumer behavior analysis

If you would like more inspiration on how scraping TikTok could help your business or organization, check out our industry pages.

How to scrape TikTok

It's easy to scrape TikTok with TikTok 🔥 Viral Atlas. Just follow these few steps and you'll get your data in minutes.

1. Click on Try for free.
2. Enter the Starting TikTok Video URL.
3. Enable Run Full Pipeline (Fetch Statistics)
4. Select the Maximum Videos to Discover - Click on Run - Start.
5. When TikTok 🔥 Viral Atlas has finished, preview or download your data from the Dataset tab.

How much will it cost to scrape TikTok?

Apify gives you $5 free usage credits every month on the Apify Free plan. You can scrape a substantial amount of TikTok data with that allocation, so your initial analysis will be completely free!

If you need to gather data regularly from TikTok, we recommend our $49/month Starter plan - perfect for ongoing trend monitoring and content analysis.

For large-scale research and enterprise needs, the Scale plan at $499/month offers unlimited data collection and advanced analytics features.

Please check actor pricing tab for pricing.

Tips for scraping TikTok

• Use specific hashtags and keywords to focus your viral trend analysis
• Schedule regular scraping runs to track how virality evolves over time
• Combine posting-time data with engagement metrics to identify optimal content timing
• Analyze creator clusters to find influencers within your niche
• Export network visualizations for presentations and stakeholder reports
• Monitor competitor hashtags and creator accounts for competitive intelligence

Is it legal to scrape TikTok?

Note that personal data is protected by GDPR in the European Union and by other regulations around the world.

You should not scrape personal data unless you have a legitimate reason to do so. If you're unsure whether your reason is legitimate, consult your lawyers.

In test mode, the actor runs in validation mode and does not scrape real TikTok data.

We also recommend that you read our blog post: is web scraping legal?

---

For more information and to get started, visit the TikTok 🔥 Viral Atlas actor page.