TikTok Video Discovery Engine

Description:
Discover related TikTok videos using any public video URL. Provide a TikTok video link and get recommended videos and creators from TikTok’s discovery feed. Ideal for content discovery, niche research, and competitor analysis.

---

Features

• Scrape related TikTok videos from a single video URL.
• Extract metadata including likes, comments, shares, bookmarks, views, hashtags, music, and more.
• Dynamic crawling with concurrency support for faster scraping.
• Session pool to reuse IPs and avoid frequent proxy rotations.
• Works with Apify Proxy or custom proxies.
• Fully asynchronous and fault-tolerant with retries.

---

Input

Provide a JSON object to the actor:

{
  "profileUrl": "https://www.tiktok.com/@username/video/1234567890123456789",
  "maxVideos": 10,
  "proxy": {
    "groups": ["RESIDENTIAL"],
    "countryCode": "US"
  }
}

---

Input Fields

Field	Type	Required	Description
profileUrl	string	✅	TikTok video URL to start crawling from. Must include /video/.
maxVideos	integer	❌	Maximum number of related videos to scrape (default 10).
proxy	object	❌	Proxy configuration. Defaults to Apify Residential US proxy.

---

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-02-03T02:55:00.000Z",
    "authorHandle": "creator",
    "authorName": "Creator Name",
    "description": "Video description",
    "hashtags": ["#funny", "#dance"],
    "likes": 1234,
    "comments": 56,
    "shares": 78,
    "bookmarks": 9,
    "views": 10000,
    "music": "Song Name",
    "pageTitle": "TikTok Page Title",
    "metadataScrapedAt": "2026-02-03T02:55:00.000Z"
  }
]

---

Demo Video

---

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

Calls the secondary actor badruddeen/tiktok-video-insights-extractor for detailed stats.

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

---

Pricing Notes

Each result represents one fully enriched TikTok video, including:

• Engagement metrics (likes, bookmarks, comments, shares, views)
• Creator information
• Hashtags & music metadata
• Discovery context

This actor uses real browser automation and residential proxies, which ensures high accuracy and reliability, but also incurs higher operational costs.

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