TikTok Creator & Profile Scraper

Give it a list of TikTok handles. Get back exact follower counts, engagement, business and TikTok Shop status, bio links and contact e-mails — one HTTP request per creator, no browser.

@gymshark    6,605,687 followers · mega · 315,606 avg likes/video
             verified · business account · TikTok Shop seller
             Sports, Fitness & Outdoors · gym.sh/shoptiktok

---

What you get per creator

Group	Fields
Audience	Exact followers, following, likes, videos, friends, plus avgLikesPerVideo and a followerTier (nano → mega)
Status	verified, isPrivate, isOrganization
Commerce	isBusinessAccount, isTikTokShopSeller, businessCategory
Contact	bioLink, bioLinkDomain, bioEmails, and Instagram / YouTube / X / Snapchat handles named in the bio
Identity	handle, nickname, bio, avatarUrl, language, userId, secUid
Age	accountCreatedAt, accountAgeDays

Pass video URLs in the same list and they resolve through TikTok's public oEmbed endpoint to title, author and thumbnail — billed at a fifth of the profile rate, since a video lookup moves 1 KB against a profile's 357 KB.

---

Why the counts are exact

TikTok's page state carries follower counts twice. The legacy stats object stores them as 32-bit integers and rounds them; statsV2 carries the same numbers as strings.

The difference is not cosmetic. Khaby Lame's 2.66 billion likes come back from the legacy field as −1,638,295,034 — an overflow in TikTok's own JSON that turns any derived average negative. This Actor reads statsV2:

	Legacy field	This Actor
@khaby.lame followers	162,600,000	162,619,759
@khaby.lame likes	−1,638,295,034	2,656,672,262

---

Who this is for

• Influencer marketing — screen a creator list by tier, engagement and category, then pull the booking e-mail straight out of the bio. withContactEmailOnly: true turns a broad list into an outreach list in one pass.
• Brand and competitor monitoring — track a set of creators or brand accounts weekly and diff follower counts and video output.
• E-commerce prospecting — isTikTokShopSeller and businessCategory identify accounts actually selling on the platform.
• Lead enrichment — bioLinkDomain gives the creator's company domain, ready to join against firmographic data.

---

Input

{
  "profiles": ["@gymshark", "duolingo", "https://www.tiktok.com/@nasa"],
  "minFollowers": 10000,
  "withContactEmailOnly": true
}

Handles with or without @, profile URLs, video URLs and vm.tiktok.com short links all work, and duplicates collapse.

Option	Default	Notes
minFollowers	0	Filtered creators are neither written nor charged — the cheapest way to screen a big list
businessAccountsOnly	false	Only accounts with a commerce category
withContactEmailOnly	false	Only creators with a reachable e-mail in the bio
maxConcurrency	10	TikTok is rate-sensitive; raise gradually and watch for 403s
proxyConfiguration	residential	See below

---

About proxies — read this first

TikTok blocks datacenter IP ranges aggressively. The Actor defaults to the Apify residential proxy because that is what reliably works. Residential bandwidth is the dominant cost of running this, and it is the reason a creator costs $0.01 rather than a tenth of a cent.

It is worth trying a small run without a proxy first: some ranges are served normally, and if yours is one of them the Actor runs far cheaper. If you see HTTP_403 or NO_STATE_BLOB in errorCode, that range is blocked — switch residential back on. The run log says so explicitly and counts how many targets were affected.

---

Output

{
  "handle": "gymshark",
  "nickname": "Gymshark",
  "followers": 6605687, "likes": 138866619, "videos": 440,
  "avgLikesPerVideo": 315606, "followerTier": "mega",
  "verified": true, "isBusinessAccount": true, "isTikTokShopSeller": true,
  "businessCategory": "Sports, Fitness & Outdoors",
  "bioLink": "https://gym.sh/shoptiktok", "bioLinkDomain": "gym.sh",
  "bioEmails": [], "bioHandles": { "instagram": null, "youtube": null },
  "accountCreatedAt": "2018-03-23T09:23:00.000Z", "accountAgeDays": 3064,
  "recordType": "creator"
}

Three ready-made dataset views ship with it — Creators, Outreach list and Commerce signals. Set flattenOutput: true for CSV.

Failed targets still produce a row with success: false and an errorCode, so your output stays aligned with your input.

---

Honest limits

• Blocking is the main risk, not parsing. With a residential proxy this is reliable; without one it depends entirely on your IP range.
• No video lists per creator. TikTok's profile page state contains the creator, not their posts — those load through a signed API this Actor deliberately does not touch. Pass video URLs explicitly if you need per-video data.
• No follower demographics or fake-follower scoring. Those require panel data no public endpoint exposes. avgLikesPerVideo is a reach proxy, not an audited engagement rate.
• bioEmails finds what creators publish. Many put nothing, or an address only shown in-app. Empty is a real answer, not a miss.
• Private accounts return their profile fields with isPrivate: true; counts may be withheld by TikTok.

---

Pricing

Event	Price	When
Actor start	$0.005	Once per run
Creator profile scraped	$0.01	Per profile returned, after your filters
Video scraped	$0.002	Per video URL resolved

$10 per 1,000 creators. Filters run before billing, and failures are never charged.

---

Tips

• Screen before you enrich. minFollowers: 10000 on a 50,000-handle list drops the unusable half without billing you for it.
• Schedule weekly and diff on handle. Follower deltas and new video counts are the growth signal; a creator's avgLikesPerVideo falling while followers rise is the classic fading-account pattern.
• Chain bioLinkDomain into a company-data Actor to attach firmographics to each creator's business.