Coding with AI?
Connect your agent to our MCP and let it integrate any endpoint for you in one shot.
TikTok User Followers
Get a user’s followers, newest first, by username, numeric user ID, or profile URL. Returns the username, display name, user ID, bio, follower and following counts, total likes, video count, verification status, region, join date, and linked Instagram, X/Twitter, and YouTube accounts for each follower, 100 per page.
Endpoint
GET /v1/tiktok/user/followers
Price: $0.006 per page Free tier: 50 requests/month
Parameters
Provide exactly one of username, user_id, or url.
| Parameter | Required | Description |
|---|---|---|
username |
One required | TikTok username, with or without leading @ (max 100 characters). |
user_id |
One required | Numeric TikTok user ID, as returned by Search Users or User Profile. |
url |
One required | TikTok profile URL, e.g. https://www.tiktok.com/@tiktok (max 500 characters). |
pages |
No | Number of pages to fetch, 1-1000 (default: 1). Each page returns up to 100 followers. |
Response Fields
| Field | Type | Description |
|---|---|---|
followers |
array | Array of follower profiles, newest first |
followers[].username |
string | TikTok username (unique ID) |
followers[].nickname |
string | Display name |
followers[].user_id |
string | TikTok user ID |
followers[].sec_uid |
string | TikTok secondary user ID (secUid) |
followers[].bio |
string | Profile bio / signature |
followers[].verified |
boolean | Whether the user is verified |
followers[].is_private |
boolean | Whether the account is private |
followers[].followers |
integer | Number of followers |
followers[].following |
integer | Number of accounts followed |
followers[].likes |
integer | Total likes received |
followers[].video_count |
integer | Number of videos posted |
followers[].videos_liked |
integer | Number of videos the user has liked |
followers[].avatar |
string | URL to profile picture |
followers[].region |
string | 2-letter region code of the account |
followers[].language |
string | Account language code |
followers[].date_joined |
string | Date and time the account was created |
followers[].date_joined_timestamp |
integer/null | Unix timestamp of the account creation date |
followers[].instagram_username |
string | Linked Instagram username, or empty string |
followers[].twitter_id |
string | Linked X/Twitter account ID, or empty string |
followers[].twitter_username |
string | Linked X/Twitter username, or empty string |
followers[].youtube_channel_id |
string | Linked YouTube channel ID, or empty string |
followers[].youtube_channel_title |
string | Linked YouTube channel name, or empty string |
followers[].url |
string | Link to the profile |
username |
string | The requested username (empty when looked up by user_id) |
user_id |
string | The user’s numeric ID |
total |
integer | The user’s total follower count |
pages |
integer | Number of pages returned |
count |
integer | Number of results returned |
A private account hides its followers list and returns a 403 with code: "limited_account".
Example Request
cURL
curl "https://apidirect.io/v1/tiktok/user/followers?username=tiktok&pages=2" \
-H "X-API-Key: YOUR_API_KEY"
Python
import requests
response = requests.get(
"https://apidirect.io/v1/tiktok/user/followers",
headers={"X-API-Key": "YOUR_API_KEY"},
params={
"username": "tiktok",
"pages": 2
}
)
print(response.json())
Example Response
{
"followers": [
{
"username": "sasuke_xp51",
"nickname": "sasuke",
"user_id": "7694873557775795208",
"sec_uid": "MS4wLjABAAAAy5zt1DSVO2SBG4_L3zBwLNblfaiILoOJeio3WU...",
"bio": "",
"verified": false,
"is_private": false,
"followers": 2,
"following": 5,
"likes": 0,
"video_count": 0,
"videos_liked": 191,
"avatar": "https://p19-common-sign.tiktokcdn.com/.../avatar.jpeg",
"region": "TH",
"language": "th",
"date_joined": "2026-10-10 03:19:47",
"date_joined_timestamp": 1791602387,
"instagram_username": "",
"twitter_id": "",
"twitter_username": "",
"youtube_channel_id": "",
"youtube_channel_title": "",
"url": "https://www.tiktok.com/@sasuke_xp51"
}
],
"username": "tiktok",
"user_id": "107955",
"total": 96206555,
"pages": 2,
"count": 200
}