TikTok Creator & Video Scraper - Profile Analytics, Hashtags & Engagement Metrics

Scrape TikTok profiles, videos, hashtags, and sounds. Extract follower counts, engagement metrics, video stats, and creator analytics for influencer research, competitive analysis, and trend discovery. Session cookies recommended for reliable access.

What's New

• Hashtag Scraping Now Works — scrapeType: "hashtag" with a hashtags input array is now fully implemented. Previously this mode was listed but unimplemented. You can now discover trending videos for any hashtag.
• Search Scraping Now Works — scrapeType: "search" with searchQueries is now fully implemented. Find creators and videos by keyword search.
• Session Cookies Support — Provide your TikTok cookies via sessionCookies for more reliable results. TikTok increasingly gates content behind login walls and CAPTCHAs.
• Login Wall + CAPTCHA Detection — The actor now detects TikTok login prompts and CAPTCHA challenges, logging clear warnings instead of silently returning empty results.

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 with engagement metrics (NOW WORKING)
• Search by Keyword - Discover creators and videos by search query (NOW WORKING)
• Sound/Music Search - Find videos using specific TikTok sounds
• Creator Search - Discover creators by keyword with follower thresholds
• Engagement Metrics - Average views, engagement rate, posting frequency
• Sorting Options - Sort by followers, likes, views, engagement, or recency
• Batch Processing - Scrape multiple creators, hashtags, or sounds in one run
• Session Cookie Auth - Provide TikTok cookies for authenticated, reliable scraping
• Login Wall Detection - Detects login prompts and CAPTCHAs with actionable warnings
• Anti-Detection - Residential proxies for reliable TikTok access
• Demo Mode - Test with sample data before going live

Who Should Use This Actor?

Influencer Marketing Agencies

Discover and vet TikTok creators for brand partnerships. Compare engagement rates, content quality, and audience fit across multiple creators before making recommendations.

Brand Marketing Teams

Research competitor brand mentions, influencer partnerships, and trending content in your industry. Track which creators are driving engagement in your niche.

Talent Management Companies

Scout rising creators before they blow up. Track engagement rate trends and content performance to identify high-potential talent early.

Content Strategists

Analyze trending hashtags, sounds, and content formats. Understand what drives engagement on TikTok to inform your content calendar.

Market Research Firms

Study creator demographics, content trends, and audience behavior across TikTok verticals. Build data-driven reports on TikTok market dynamics.

E-Commerce Brands

Find creators promoting products in your category. Analyze competitor TikTok strategies including product placement, affiliate content, and TikTok Shop activity.

Authentication (Recommended)

TikTok increasingly gates content behind login walls and serves CAPTCHAs to unauthenticated users. Providing session cookies improves reliability.

Why Use Cookies?

	Without Cookies	With Cookies
Success Rate	Moderate — login walls and CAPTCHAs	High — authenticated access
Data Quality	May miss gated content	Full profile and video data
CAPTCHA Risk	Frequent CAPTCHA challenges	Significantly reduced
Rate Limits	Aggressive throttling	Standard TikTok limits

How to Get Your TikTok Cookies

1. Install the Cookie-Editor browser extension (available for Chrome, Firefox, Edge)
2. Go to tiktok.com and log in to your account
3. Click the Cookie-Editor extension icon
4. Click Export (bottom-left) to copy all cookies as JSON
5. Paste the JSON array into the sessionCookies input field

Important notes:

• Use a secondary TikTok account, not your primary one
• Cookies expire periodically — re-export if you start seeing login walls or CAPTCHAs
• The actor does not store or share your cookies

Cookie Input Example

{
  "scrapeType": "profiles",
  "usernames": ["charlidamelio"],
  "sessionCookies": [
    { "name": "sessionid", "value": "abc123...", "domain": ".tiktok.com" },
    { "name": "tt_csrf_token", "value": "xyz...", "domain": ".tiktok.com" }
  ],
  "demoMode": false
}

Quick Start (Copy & Paste)

Simplest possible input — just change the usernames:

{
  "scrapeType": "profiles",
  "usernames": ["charlidamelio"]
}

That's it. The actor will scrape the profile with 12 recent videos.

Multiple Creator Profiles

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

Demo Mode (Free Test, No Real Scraping)

{
  "demoMode": true
}

Returns sample data so you can test your automation pipeline without any cost.

Find Videos by Hashtag (NEW - Now Working)

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

Previously the hashtag scrape type was listed but not implemented. It now fully works — pass one or more hashtags and the actor will discover trending videos for each.

Search for Creators (NEW - Now Working)

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

The search scrape type is now fully implemented. Find creators and videos matching any keyword query.

Input Parameters

Parameter	Type	Default	Description
scrapeType	string	profiles	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	true	Include recent videos with profile data
videosPerProfile	number	12	Videos per creator (max: 100)
maxResults	number	50	Maximum results (max: 500)
minFollowers	number	-	Minimum follower threshold
minViews	number	-	Minimum video views threshold
sortBy	string	followers	Sort: followers, likes, views, engagement, recent
sessionCookies	array	-	TikTok session cookies (JSON array from Cookie-Editor)
proxyConfiguration	object	Residential	Proxy settings (residential required for TikTok)
demoMode	boolean	false	Return sample data for testing
webhookUrl	string	-	Webhook URL for results delivery

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": "2026-01-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": "2026-01-28T10:30:00.000Z"
}

Engagement Rate Formula

engagementRate = (likes + comments + shares) / views x 100

Pricing (Pay-Per-Event)

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

Example costs:

• 10 creators with 12 videos each: $0.10 + (10 x $0.05) + (120 x $0.002) = $0.84
• 50 creators with 12 videos each: $0.10 + (50 x $0.05) + (600 x $0.002) = $3.80
• 100 creators, no videos: $0.10 + (100 x $0.05) = $5.10
• Demo mode: $0.00

Scrape Types

profiles — Scrape Creator Profiles

Provide usernames to scrape one or more TikTok creator profiles. Returns follower counts, engagement metrics, bio, and optionally recent videos.

hashtags — Find Videos by Hashtag (NEW)

Provide hashtags to discover trending videos for each hashtag. Returns video stats, engagement metrics, creator info, and content details. This mode was previously listed but not implemented — it is now fully functional.

search — Search for Creators/Videos (NEW)

Provide searchQueries to find creators and videos matching keyword searches. Supports minFollowers threshold to filter results. This mode is now fully implemented.

sounds — Find Videos by Sound

Provide sounds (TikTok sound/music IDs) to find videos using specific audio tracks.

Common Scenarios

Scenario 1: Influencer Discovery

{
  "scrapeType": "search",
  "searchQueries": ["skincare routine", "beauty tips"],
  "minFollowers": 50000,
  "sortBy": "engagement",
  "maxResults": 100,
  "includeVideos": true,
  "videosPerProfile": 5,
  "demoMode": false
}

Find high-engagement creators in your niche, sorted by engagement rate rather than follower count.

Scenario 2: Trending Content Research

{
  "scrapeType": "hashtags",
  "hashtags": ["fitnessmotivation", "homeworkout", "gymtok"],
  "maxResults": 200,
  "demoMode": false
}

Discover what content is trending for specific hashtags to inform your content strategy.

Scenario 3: Competitor Creator Analysis

{
  "scrapeType": "profiles",
  "usernames": ["competitor_brand_1", "competitor_brand_2", "competitor_brand_3"],
  "includeVideos": true,
  "videosPerProfile": 50,
  "demoMode": false
}

Deep-dive into competitor TikTok strategies by analyzing their content patterns and engagement.

Webhook & Automation Integration

Zapier / Make.com / n8n

1. Create a webhook trigger in your automation platform
2. Copy the webhook URL to webhookUrl
3. Route results to Google Sheets, CRM, Airtable, etc.

Popular automations:

• Creator data -> Google Sheets (influencer database)
• High-engagement creators -> Slack alert (talent scouting)
• Hashtag trends -> Airtable (content calendar research)
• Video metrics -> Email (weekly competitive report)

Apify Scheduled Runs

Schedule weekly runs to track creator growth and content trends over time.

FAQ

Q: Do I need a TikTok account?

A: Not required, but recommended. TikTok increasingly gates content behind login walls and CAPTCHAs. Providing session cookies from a TikTok account significantly improves success rates.

Q: Why do usernames need to be without the @ symbol?

A: Enter just the username (e.g., charlidamelio not @charlidamelio). The scraper adds the @ prefix automatically.

Q: How is engagement rate calculated?

A: engagementRate = (likes + comments + shares) / views x 100. This is calculated per video and averaged across recent videos for profile-level metrics.

Q: Can I scrape private accounts?

A: No. Only public TikTok profiles and videos can be scraped. Private accounts return limited data (username, follower count only).

Q: Why are residential proxies required?

A: TikTok has aggressive anti-bot measures. Residential proxies are the default and provide the most reliable access. Datacenter proxies are almost always blocked.

Q: Do hashtag and search modes actually work now?

A: Yes. Both scrapeType: "hashtags" and scrapeType: "search" are now fully implemented and functional. They were previously listed in the input schema but not wired up in the scraping logic.

Troubleshooting

"Login wall detected" or "CAPTCHA encountered"

TikTok is gating content behind authentication.

1. Add session cookies — Export cookies from Cookie-Editor and pass them via sessionCookies
2. Re-export cookies if they have expired
3. Check the logs — The actor logs exactly what it detected (login prompt, CAPTCHA challenge)

"No data returned" / Empty results

1. Make sure you set at least one of: usernames, hashtags, searchQueries, or sounds
2. Set demoMode to false (or remove it) — demo mode only returns sample data
3. Match your scrapeType to your input: use "profiles" with usernames, "hashtags" with hashtags, etc.
4. Try adding sessionCookies if TikTok is blocking unauthenticated access

"Profile not found"

• Enter usernames WITHOUT the @ symbol
• Check if the profile is public on TikTok
• Verify the username exists by visiting tiktok.com/@username

"Rate limited" or scraping stops partway

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

"Engagement metrics seem wrong"

• Engagement rate = (likes + comments + shares) / views x 100
• Average metrics are based on publicly visible recent videos only
• Some videos may have view counts that haven't fully updated

"Hashtag/search mode returns nothing"

• These modes are now implemented but still require TikTok to serve content
• Try adding sessionCookies for better results
• Use broader hashtags or search terms
• Reduce minFollowers threshold if filtering too aggressively

"Demo data showing"

• Set demoMode: false in your input

---

Support

• Actor Arsenal: Full Actor Catalog
• Developer: John Rippy

---

Built by John Rippy | Actor Arsenal