TikTok Profile Scraper

Fast, lightweight Apify Actor that scrapes TikTok profile stats — followers, hearts, video counts, bio, avatar, verified flag — for a list of usernames or profile URLs. HTTP-only: no browser, fast runs, low cost.

Who is it for?

Analysts, marketers, and researchers who need bulk TikTok profile metrics without paying for heavyweight multi-mode suites or waiting on headless-browser boots.

Features

• Profile metadata per username: nickname, bio, avatar URL, verified/private flags, followers, following, hearts, videos count, secUid, userId
• HTTP-only: fetches the public profile page and parses embedded JSON — no browser overhead (256 MB memory)
• Transparent failures: every input item produces exactly one dataset record; unreachable profiles are reported with error (blocked, not_found, network_error) instead of silently disappearing
• Apify Proxy support: configure residential proxies for reliability

Quick start (Apify Console)

1. Click Run — the default input scrapes @tiktok.
2. Find results in the Storage → Dataset tab.

Input example:

{
    "usernames": ["@tiktok", "https://www.tiktok.com/@charlidamelio"],
    "maxRetries": 3,
    "proxyConfiguration": { "useApifyProxy": true }
}

Field	Type	Required	Description
usernames	array of strings	yes	Usernames (@user or user) or full profile URLs
maxRetries	integer	no	Network-error retries per profile (default 3)
proxyConfiguration	object	no	Apify Proxy settings

Output

One dataset record per input item:

{
    "username": "tiktok",
    "nickname": "TikTok",
    "bio": "Make Your Day",
    "avatarUrl": "https://p16-sign-va.tiktokcdn.com/...",
    "verified": true,
    "isPrivate": false,
    "followers": 1000,
    "followings": 45,
    "hearts": 3000000000,
    "videos": 42,
    "secUid": "...",
    "userId": "...",
    "url": "https://www.tiktok.com/@tiktok",
    "scrapedAt": "2026-08-25T12:00:00.000Z",
    "error": null
}

A run summary (requested / succeeded / failed) is stored in the key-value store under key summary.

Limits & honest notes

• Proxy: TikTok rate-limits datacenter IPs aggressively. Small runs may succeed on default proxy; enable the RESIDENTIAL group for reliability. This Actor does not solve CAPTCHAs, forge signatures, or harvest cookies.
• Error semantics: blocked = anti-bot challenge served; not_found = account doesn't exist; parse_drift = TikTok changed its page structure (Actor update needed).
• Scale: designed for tens to low hundreds of profiles per run (concurrency 3).
• Legal: this Actor accesses only publicly viewable data. Scraped profiles constitute personal data in many jurisdictions (GDPR) — ensure your use complies with applicable law and TikTok's Terms of Service, which restrict automated collection. You are responsible for how you use the output.

Troubleshooting

• Many blocked errors → switch proxyConfiguration.apifyProxyGroups to ["RESIDENTIAL"]
• parse_drift on every profile → TikTok changed its page format; check for an Actor update

Run it

Open the Actor on Apify Store and click Run — or use the CLI:

$apify call <your-username>/tiktok-profile-scraper --input '{"usernames":["@tiktok"]}'