TikTok Hashtag Scraper

A powerful and efficient actor that scrapes TikTok videos by hashtag, extracting comprehensive metadata including author information, engagement statistics, video details, and music information.

🌟 Features

• 🏷️ Multi-Hashtag Scraping - Scrape videos from multiple hashtags in a single run
• ⚡ Parallel Processing - Fast data extraction using batch processing (3x faster)
• 📊 Rich Metadata - Comprehensive data including:
  • Author details (username, nickname, avatar, verification status, bio)
  • Video metadata (duration, resolution, cover image, download URL)
  • Music information (song title, artist, cover image)
  • Engagement statistics (likes, comments, shares, views, saves)
  • Timestamps (creation date, scrape date)
• 🔐 Proxy Support - Built-in Apify Proxy integration for reliable access
• 🎯 Smart Extraction - Uses multiple extraction methods (JSON + DOM) for reliability
• 💾 Real-time Export - Data pushed to dataset as it's collected

🚀 Quick Start

1. Add hashtags you want to scrape (without # symbol)
2. Set number of results per hashtag (1-100)
3. Enable Apify Proxy (RESIDENTIAL recommended)
4. Run the actor and watch results appear in real-time!

📥 Input Configuration

Required Settings

Field	Type	Description
Hashtags	Array	List of hashtags to scrape (e.g., ["travel", "food", "tech"])

Optional Settings

Field	Type	Default	Description
Results Per Hashtag	Integer	20	Number of videos to scrape per hashtag (1-100)
Get Detailed Data	Boolean	true	Visit each video page for complete details (slower but more data)
Proxy Configuration	Object	-	Apify Proxy settings (highly recommended)
Download Videos	Boolean	false	Download actual video files (increases storage)
Download Covers	Boolean	false	Download video cover images

Example Input

{
  "hashtags": ["travel", "foodie", "tech"],
  "resultsPerPage": 30,
  "getDetailedData": true,
  "proxyConfiguration": {
    "useApifyProxy": true,
    "apifyProxyGroups": ["RESIDENTIAL"]
  }
}

📤 Output Format

Each scraped video contains:

{
  "videoUrl": "https://www.tiktok.com/@username/video/1234567890",
  "videoId": "7484313881280564526",
  "text": "Video description with hashtags...",
  "hashtag": "travel",
  
  "authorMeta": {
    "name": "username",
    "nickname": "Display Name",
    "avatar": "https://...",
    "verified": false,
    "signature": "User bio text"
  },
  
  "videoMeta": {
    "duration": 15,
    "width": 720,
    "height": 1280,
    "coverUrl": "https://...",
    "downloadUrl": "https://..."
  },
  
  "musicMeta": {
    "musicId": "7249132457248737282",
    "musicName": "Song Title",
    "musicAuthor": "Artist Name",
    "musicOriginal": false,
    "coverUrl": "https://..."
  },
  
  "stats": {
    "likesCount": 122600,
    "commentsCount": 255,
    "sharesCount": 4867,
    "viewsCount": 775200,
    "savedCount": 13806
  },
  
  "createTime": "1742577652",
  "createTimeISO": "2025-03-21T17:20:52.000Z",
  "scrapedAt": "2024-12-14T16:39:49.802993"
}

Alternative Options

• Use your own proxy server (configure in input)
• Deploy on servers in TikTok-supported regions
• Use VPN before running locally

📊 Performance

• Speed: ~2-3 minutes for 40 videos (with detailed data)
• Accuracy: 95%+ data extraction success rate
• Reliability: Automatic fallback mechanisms if extraction fails

🎯 Use Cases

• Social Media Analytics - Track hashtag performance and trends
• Content Research - Discover popular content in your niche
• Competitor Analysis - Monitor competitor hashtags and engagement
• Market Research - Understand audience preferences and behaviors
• Influencer Discovery - Find creators in specific niches
• Trend Monitoring - Stay updated with viral content

⚠️ Limitations

• Maximum 100 videos per hashtag per run
• TikTok may change their structure (actor maintained regularly)
• CAPTCHA challenges may appear (rare with good proxies)
• Some videos may be region-restricted
• Rate limiting applies (built-in delays prevent blocking)

🔧 Troubleshooting

Actor fails to connect

Solution: Enable Apify Proxy with RESIDENTIAL group in input settings

No videos found

Possible causes:

• Hashtag has no recent content
• TikTok changed their HTML structure
• CAPTCHA appeared (check logs)
• Proxy issue (try different proxy group)

Slow performance

Solutions:

• Set getDetailedData: false for faster scraping (less data)
• Reduce resultsPerPage number
• Use RESIDENTIAL proxies (faster than datacenter)

Missing data fields

Cause: TikTok occasionally updates their data structure

Solution: Check for actor updates or report issue

📝 Best Practices

1. Start Small - Test with 10-20 videos first
2. Use Residential Proxies - Better success rate and speed
3. Enable Detailed Data - For complete information (slightly slower)
4. Monitor Costs - Check usage in Apify Console
5. Respect Rate Limits - Don't scrape thousands of videos at once
6. Regular Updates - Keep actor updated for best performance

🔐 Legal & Ethics

• ✅ Respect TikTok's Terms of Service
• ✅ Use scraped data responsibly
• ✅ Do not scrape private or sensitive content
• ✅ Be mindful of creator rights and privacy
• ✅ Follow data protection regulations (GDPR, etc.)
• ✅ Rate limiting is built-in to prevent abuse

Note: This tool is for research and analytics purposes. Users are responsible for how they use the scraped data.

🆘 Support

• Issues: Report bugs or request features in Apify Console
• Documentation: Apify Documentation
• Community: Apify Discord

🏆 Why Choose This Actor?

• ⚡ Fast - Parallel processing for maximum speed
• 📊 Comprehensive - Extracts 20+ data fields per video
• 🔒 Reliable - Multiple extraction methods + error handling
• 💰 Affordable - Optimized to minimize compute costs
• 🎯 Easy - Simple configuration, no coding required
• 🔄 Maintained - Regular updates for TikTok changes

---