TikTok Search Scraper

A powerful Apify Actor for scraping TikTok videos by search keywords, usernames, or URLs with advanced proxy configuration and automatic fallback.

🚀 How to Use the Actor (via Apify Console)

1. Log in at https://console.apify.com and go to Actors.
2. Find your actor and click it.
3. Configure inputs in the Input tab.
4. Run the actor.
5. Monitor logs in real time.
6. Access results in the OUTPUT tab.
7. Export results to JSON or CSV.

Input

{
  "startUrls": [
    "anime",
    "@charlidamelio",
    "https://www.tiktok.com/search?q=dance",
    "music"
  ],
  "sortOrder": "0",
  "maxItems": 500,
  "maxComments": 0,
  "scrollCount": 12,
  "scrollPause": 2,
  "proxyConfiguration": {
    "useApifyProxy": true,
    "apifyProxyGroups": ["RESIDENTIAL"]
  }
}

Input Fields

• startUrls (array, required): List of search keywords (e.g., "anime", "music"), TikTok URLs (e.g., "https://www.tiktok.com/search?q=dance"), or usernames (e.g., "@username" or "username")
• sortOrder (string): Sort by "0" (Relevance), "1" (Recent), "2" (Popular)
• maxItems (integer): Maximum videos to scrape (1-10000)
• maxComments (integer): Maximum comments per video (0-100, not yet implemented)
• scrollCount (integer): Number of scroll iterations (1-20)
• scrollPause (integer): Pause between scrolls in seconds (1-10)
• proxyConfiguration (object): Apify proxy settings

Output

The actor outputs structured data for each scraped TikTok video:

{
  "url": "https://www.tiktok.com/@username/video/123456789",
  "id": "123456789",
  "desc": "Video description",
  "createTime": "1760802738",
  "author": "username",
  "video": {
    "height": 1024,
    "width": 576,
    "duration": 17,
    "cover": "https://...",
    "playAddr": "https://..."
  },
  "stats": {
    "diggCount": 1234,
    "shareCount": 56,
    "playCount": 7890,
    "commentCount": 12
  }
}

Key Features

• 🔍 Multi-input support: Keywords, URLs, and usernames
• 🔄 Automatic proxy fallback: No proxy → datacenter → residential
• 📊 Comprehensive data: Video details, author info, statistics
• ⚡ Live saving: Data saved immediately as scraped
• 🎯 Sorting options: Relevance, recent, or popular videos
• 🛡️ Anti-detection: Uses undetected-chromedriver

Proxy Configuration

The actor implements intelligent proxy fallback:

1. First attempt: No proxy (direct connection)
2. Second attempt: Datacenter proxy (if blocked)
3. Final attempt: Residential proxy with 3 retries (if datacenter fails)

Proxy events are logged clearly for monitoring.

Why Choose This Actor?

• Reliable scraping with automatic error handling and retries
• Complete TikTok data extraction including video URLs and metadata
• Production-ready with proper logging and error handling
• Flexible input supporting multiple search types
• Scalable architecture using Apify's cloud infrastructure

Support and Feedback

For issues or feature requests, please contact the actor maintainer.