🎵 TikTok Profile & Video Scraper

Scrape TikTok profiles and videos at scale. Extract follower counts, engagement stats, video metadata, and more — all without needing a TikTok account or API key.

What It Does

This actor scrapes publicly available data from TikTok:

Profile Data

Field	Description
username	TikTok handle
nickname	Display name
followers	Follower count
following	Following count
likes	Total likes received
bio	Profile bio text
verified	Verified badge status
videoCount	Number of videos

Video Data

Field	Description
id	Video ID
description	Video caption/description
author	Author username
likes	Like count
comments	Comment count
shares	Share count
plays	View/play count
createTime	Video publish date (ISO 8601)
videoUrl	Direct URL to the video
musicTitle	Name of the sound/music used
hashtags	List of hashtags

Input

{
    "profiles": ["charlidamelio", "khaby.lame"],
    "videoUrls": ["https://www.tiktok.com/@user/video/1234567890"],
    "maxVideosPerProfile": 12,
    "scrapeVideosFromProfiles": true,
    "proxyConfig": {
        "useApifyProxy": true,
        "apifyProxyGroups": ["RESIDENTIAL"]
    }
}

Parameter	Type	Default	Description
profiles	string[]	[]	TikTok usernames (without @)
videoUrls	string[]	[]	Direct TikTok video URLs
maxVideosPerProfile	number	12	Max videos to extract per profile
scrapeVideosFromProfiles	boolean	true	Also extract videos when scraping profiles
proxyConfig	object	Residential	Proxy settings (residential recommended)

Usage Tips

• Use residential proxies — TikTok aggressively blocks datacenter IPs
• Start with a small number of profiles to test
• Video counts above ~30 per profile may require scrolling (slower)
• Some profiles may be geo-restricted

Output Example

Profile

{
    "type": "profile",
    "username": "charlidamelio",
    "nickname": "Charli D'Amelio",
    "followers": 155000000,
    "following": 1200,
    "likes": 11500000000,
    "bio": "don't you dare",
    "verified": true,
    "videoCount": 2400
}

Video

{
    "type": "video",
    "id": "7299999999999999999",
    "description": "this trend is so fun #fyp #dance",
    "author": "charlidamelio",
    "likes": 2500000,
    "comments": 45000,
    "shares": 12000,
    "plays": 50000000,
    "createTime": "2024-01-15T18:30:00.000Z",
    "videoUrl": "https://www.tiktok.com/@charlidamelio/video/7299999999999999999",
    "musicTitle": "original sound - Charli D'Amelio",
    "hashtags": ["fyp", "dance"]
}

Cost & Performance

• ~1-3 seconds per profile/video page
• Uses Playwright (browser-based) for reliable data extraction
• Residential proxy usage affects cost — budget accordingly
• Each profile scrape counts as 1 + N results (profile + videos)

Limitations

• TikTok frequently changes its page structure; updates may be needed
• Private accounts cannot be scraped
• Very high-volume scraping may trigger CAPTCHAs
• Video download URLs are not included (they expire quickly)

License

Apache 2.0