Answers
How can I get a TikTok account's follower count through an API?
Short answer
Call TikTok account profile (/v1/tiktok/users/get) with the handle. It returns followers, following, total likes, video count, bio and verification for $0.002 a profile, and the creator does not have to log in to anything. Refreshing 200 accounts once a week for a month is 800 calls, $1.60.
You keep a sheet of 200 TikTok creators you might work with, and the follower column is three months stale. TikTok's official route to a follower count needs each creator to sign in to your app and grant a stats scope, which is fine for creators who use your product and useless for a prospect list. For public accounts, the handle is enough.
What one call returns
TikTok account profile takes username, with or without the @.
| Field | Meaning |
|---|---|
followers |
Follower count |
following |
Accounts it follows |
likes |
Total likes across all its videos |
posts |
Number of videos |
bio, verified, avatar_url, url |
Profile details |
With view=full you also get the numeric user ID and the verification reason under ext.
Cost
| Job | Calls | Cost |
|---|---|---|
| One account | 1 | $0.002 |
| 200 accounts, once | 200 | $0.40 |
| 200 accounts, weekly for 4 weeks | 800 | $1.60 |
Try it
curl -s -G "https://api.okdata.online/v1/tiktok/users/get" \
-H "Authorization: Bearer $OKDATA_API_KEY" \
-d username=khaby.lame \
-d fields=username,name,followers,following,likes,posts,verified
For the weekly refresh, loop over the handles in your sheet, write followers, likes and posts with the date, and compare against last week. A creator whose followers jump while likes stay flat is worth a closer look.
Gotchas
- Use the handle from the profile URL (
tiktok.com/@handle), not the display name. If a creator renames their handle, the old one returnsnot_found, which is not charged. - Follower counts inside video and comment objects are empty on purpose; only this endpoint carries them.
- There is no list of who follows an account and no follower history. Store your own snapshots if you need growth.
- Keys are rate limited. In big loops, read the
X-RateLimit-Remainingheader, and on a 429 wait for the seconds inRetry-After; rejected calls cost nothing.
Other routes
- TikTok Display API: the right choice when creators connect their own accounts to your product. It needs their consent per account, and in exchange you get data straight from TikTok.
- TikTok Research API: free with date and region filters, for approved non-profit academic researchers only.
- By hand: for five accounts, open the profiles.
Finding new creators rather than refreshing known ones is a different job; creator discovery shows how search and profiles combine.
Updated