Tiktok Search Scraper

A powerful Apify Actor that scrapes TikTok search results for any keyword or search URL. Extract video metadata, author information, statistics, and more from TikTok's search pages.

Why Choose Us?

• 🌍 Country Targeting: Scrape TikTok results from 20+ countries with proper geolocation and language settings
• 🚀 Batch Processing: Process multiple keywords efficiently in a single browser session
• 🔄 Live Saving: Results are saved immediately as they're scraped, so you don't lose data if the Actor stops
• 🛡️ Anti-Detection: Uses undetected Chrome driver with fingerprint masking for reliable scraping
• 📊 Rich Data: Extract comprehensive video metadata including stats, music info, author details, and more
• ⚙️ Flexible Configuration: Support for custom proxy settings, scroll behavior, and country presets

Key Features

• Multi-Keyword Support: Process multiple search keywords in one run
• URL-Based Input: Extract keywords from TikTok search URLs automatically
• Country-Specific Results: Target specific countries with preset configurations (US, UK, CA, AU, JP, KR, CN, DE, FR, ES, IT, BR, MX, IN, TH, VN, ID, PH, MY, SG)
• Proxy Integration: Built-in support for Apify proxies and custom proxy configurations
• Deduplication: Automatically removes duplicate videos across keywords
• Error Recovery: Automatic retry for failed keywords with fallback processing
• Comprehensive Data: Extract video URLs, descriptions, author info, stats, music details, and more

Input

The Actor accepts the following input parameters:

{
  "search": ["anime", "music", "dance"],
  "startUrls": [
    "https://www.tiktok.com/search?q=challenge"
  ],
  "maxItems": 100,
  "country": {
    "preset": "US"
  },
  "proxyConfiguration": {
    "useApifyProxy": true
  },
  "scrollCount": 12,
  "scrollPause": 2,
  "headless": true
}

Input Parameters

• search (array, optional): List of keywords to search on TikTok (e.g., ["anime", "music"])
• startUrls (array, optional): List of TikTok search URLs. Keywords will be automatically extracted from the q parameter
• maxItems (integer, default: 100): Maximum number of unique videos to scrape across all keywords (1-10000)
• country (object, optional): Country targeting configuration
  • preset (string, optional): Predefined country preset. Options: US, UK, CA, AU, JP, KR, CN, DE, FR, ES, IT, BR, MX, IN, TH, VN, ID, PH, MY, SG
  • code (string, optional): ISO country code (overrides preset)
  • language (string, optional): Language code (e.g., en, ja, ko, fr)
  • timezone (string, optional): Timezone (e.g., America/New_York, Europe/London)
• proxyConfiguration (object, optional): Proxy settings. Use Apify proxy editor or provide custom proxy details. Recommended for country targeting
• scrollCount (integer, default: 12): Number of times to scroll down to load more videos (1-50)
• scrollPause (integer, default: 2): Pause duration between scrolls in seconds (1-10)
• headless (boolean, default: true): Run browser in headless mode (recommended for production)

Output

The Actor outputs structured data to the default dataset. Each item represents a TikTok video with the following structure:

{
  "id": "7234567890123456789",
  "url": "https://www.tiktok.com/@username/video/7234567890123456789",
  "desc": "Video description text",
  "createTime": "1670685477",
  "author": "username",
  "nickname": "Display Name",
  "authorId": "6789012345678901234",
  "authorSecId": "MS4wLjABAAAA...",
  "avatarThumb": "https://p16-sign-va.tiktokcdn.com/...",
  "video": {
    "id": "7234567890123456789",
    "height": 1920,
    "width": 1080,
    "duration": 15000,
    "cover": "https://p16-sign-va.tiktokcdn.com/...",
    "playAddr": "https://v16-webapp-prime.tiktok.com/...",
    "downloadAddr": "https://v16-webapp-prime.tiktok.com/..."
  },
  "stats": {
    "diggCount": 12345,
    "shareCount": 678,
    "commentCount": 234,
    "playCount": 567890
  },
  "music": {
    "id": "7123456789012345678",
    "title": "Original Sound",
    "authorName": "username",
    "duration": 15
  }
}

Output Fields

• id: Unique video ID
• url: Direct link to the TikTok video
• desc: Video description/caption
• createTime: Video creation timestamp
• author: Author username
• nickname: Author display name
• authorId: Author user ID
• authorSecId: Author secure ID
• avatarThumb: Author profile picture URL
• video: Video metadata (dimensions, duration, cover images, play URLs)
• stats: Video statistics (likes, shares, comments, views)
• music: Music/audio information used in the video

🚀 How to Use the Actor (via Apify Console)

1. Log in at https://console.apify.com and go to Actors
2. Find tiktok-search-scraper and click it
3. Configure inputs:
   • Add search keywords in the search field (e.g., ["anime", "music"])
   • Optionally add TikTok search URLs in startUrls
   • Set maxItems to limit the number of results
   • Select country preset if you want country-specific results
   • Configure proxy settings (recommended for country targeting)
4. Click Start to run the Actor
5. Monitor logs in real time to see progress
6. Access results in the OUTPUT tab once the run completes
7. Export results to JSON, CSV, or Excel format

Best Use Cases

• Market Research: Analyze trending content in specific countries or languages
• Content Discovery: Find popular videos by keywords across different regions
• Competitor Analysis: Monitor competitor content and engagement metrics
• Trend Analysis: Track trending topics and hashtags in various markets
• Influencer Research: Discover creators and analyze their content performance
• SEO Research: Understand what content performs well for specific keywords
• Localization Studies: Compare content preferences across different countries

Frequently Asked Questions

Do I need a proxy?

For accurate country targeting, yes. TikTok uses your IP address to determine location. Without a proxy, you'll get results based on your actual location. Apify proxy is recommended and can be easily configured in the input.

How many videos can I scrape?

The maxItems parameter controls the maximum number of unique videos across all keywords. The default is 100, but you can set it up to 10,000. Note that scraping more items will take longer and consume more resources.

Can I scrape from multiple countries in one run?

Currently, the Actor processes one country configuration per run. To scrape from multiple countries, run the Actor multiple times with different country presets.

What if a keyword fails?

The Actor automatically retries failed keywords individually. If a keyword still fails after retry, it will be logged and the Actor will continue with other keywords.

How long does scraping take?

Scraping time depends on:

• Number of keywords
• scrollCount and scrollPause settings
• maxItems limit
• Network speed and proxy latency

Typically, processing 5 keywords with default settings takes 5-10 minutes.

Is the data real-time?

Yes, the Actor scrapes live data from TikTok's search pages. Results reflect current TikTok search results at the time of scraping.

Support and Feedback

For issues, questions, or feature requests, please contact support or open an issue in the Actor repository.

Cautions

• Data is collected only from publicly available sources on TikTok
• No data is taken from private accounts or password-protected content
• The end user is responsible for ensuring legal compliance (spam laws, privacy, data protection, etc.)
• Respect TikTok's Terms of Service and rate limits
• Use proxies responsibly and avoid aggressive scraping patterns

---

Note: This Actor is designed for legitimate research and data collection purposes. Always comply with TikTok's Terms of Service and applicable laws in your jurisdiction.