TikTok Creator & Video Scraper

Scrape TikTok profiles, videos, and hashtags. Extract follower counts, engagement metrics, video stats, and creator data for influencer research and competitive analysis. Built by John Rippy (https://johnrippy.link/).

Features

• Profile Scraping: Followers, following, likes, bio, verification status
• Video Data: Views, likes, comments, shares, saves, hashtags, sounds
• Hashtag Search: Find top videos for any hashtag
• Sound/Music Search: Find videos using specific TikTok sounds
• Engagement Metrics: Average views, engagement rate, posting frequency
• Built-in Anti-Detection: Uses residential proxies to avoid blocks

Quick Start

Try it first (Free - Demo Mode)

{
  "demoMode": true
}

This returns sample creator data so you can see the output format without any charges.

Scrape TikTok Creators by Username

{
  "scrapeType": "profiles",
  "usernames": ["charlidamelio", "khaby.lame", "addisonre"],
  "includeVideos": true,
  "videosPerProfile": 12,
  "demoMode": false
}

Find Videos by Hashtag

{
  "scrapeType": "hashtags",
  "hashtags": ["fyp", "viral", "dance"],
  "maxResults": 50,
  "demoMode": false
}

Search for Creators

{
  "scrapeType": "search",
  "searchQueries": ["fitness influencer", "cooking tutorials"],
  "minFollowers": 10000,
  "maxResults": 20,
  "demoMode": false
}

No login required! This scraper works without TikTok authentication. It uses residential proxies to access public data.

Demo Mode

Set demoMode: true to test with sample data (no charges). When you're ready for real results, set demoMode: false or omit it.

{
  "demoMode": true,
  ...
}

Input Parameters

Parameter	Type	Description
scrapeType	string	Mode: profiles, hashtags, sounds, search
usernames	array	TikTok usernames to scrape (without @)
hashtags	array	Hashtags to find videos (without #)
searchQueries	array	Search terms for creators or videos
sounds	array	TikTok sound/music IDs
includeVideos	boolean	Include recent videos (default: true)
videosPerProfile	number	Videos per creator (default: 12, max: 100)
maxResults	number	Maximum results (default: 50, max: 500)
minFollowers	number	Minimum follower threshold
minViews	number	Minimum video views threshold
sortBy	string	Sort: followers, likes, views, engagement, recent
proxyConfiguration	object	Residential proxy required for TikTok
demoMode	boolean	Test with sample data

Output Format

Creator Profile Output

{
  "username": "charlidamelio",
  "nickname": "Charli D'Amelio",
  "bio": "dancer | exclusive content on instagram",
  "profileUrl": "https://tiktok.com/@charlidamelio",
  "avatarUrl": "https://p16-sign.tiktokcdn-us.com/...",
  "followers": 155000000,
  "following": 1200,
  "likes": 11800000000,
  "videoCount": 2847,
  "verified": true,
  "privateAccount": false,
  "avgViews": 45000000,
  "avgLikes": 3500000,
  "avgComments": 45000,
  "avgShares": 120000,
  "engagementRate": 8.12,
  "recentVideos": [
    {
      "id": "7312456789012345678",
      "url": "https://tiktok.com/@charlidamelio/video/7312456789012345678",
      "description": "new dance 💃 #fyp #dance #viral",
      "createTime": "2024-12-15T18:30:00.000Z",
      "duration": 32,
      "views": 52000000,
      "likes": 4200000,
      "comments": 52000,
      "shares": 145000,
      "saves": 890000,
      "hashtags": ["fyp", "dance", "viral"],
      "mentions": [],
      "soundName": "Original Sound - Charli",
      "isAd": false,
      "engagementRate": 8.42
    }
  ],
  "scrapedAt": "2024-12-21T10:30:00.000Z"
}

Common Problems & Solutions

"No results" or "Profile not found"

Cause: Username is incorrect, or the profile is private. Fix:

• Enter usernames WITHOUT the @ symbol (e.g., charlidamelio not @charlidamelio)
• Check if the profile is public on TikTok
• Verify the username exists by visiting tiktok.com/@username

"Rate limited" or scraping stops partway

Cause: TikTok has aggressive anti-scraping measures. Fix:

• Reduce maxResults to 20-50
• Reduce videosPerProfile to 5-10
• Wait 15-30 minutes between runs
• The actor uses residential proxies automatically, but TikTok can still rate limit

"Engagement rate" or metrics seem wrong

Understanding the data:

• engagementRate = (likes + comments + shares) / views × 100
• avgViews = average views across recent videos
• Metrics are based on publicly visible data only

Demo data showing instead of real results

Cause: demoMode is still set to true. Fix: Set demoMode: false in your input.

Pricing

This actor uses pay-per-event billing:

Event	Description	Price
apify-actor-start	Base cost per run	$0.10
profile_scraped	Per creator profile	$0.05
video_scraped	Per video extracted	$0.002

Example costs:

• 50 creators with 12 videos each: $0.10 + (50 × $0.05) + (600 × $0.002) = $3.80
• 100 creators, no videos: $0.10 + (100 × $0.05) = $5.10

Use Cases

• Influencer Discovery: Find creators in your niche by engagement, not just follower count
• Competitive Analysis: Track competitor brand mentions and influencer partnerships
• Trend Research: Identify trending hashtags, sounds, and content formats
• Talent Scouting: Discover rising creators before they blow up
• Market Research: Analyze audience demographics and content preferences
• Brand Safety: Vet influencer content before partnerships

---

Built by John Rippy | Actor Arsenal