TikTok API
User Followers
Get a list of followers for a TikTok user.
POST
$0.01/call/v1/tiktok/user-followersUsage
const res = await fetch('https://api.yepapi.com/v1/tiktok/user-followers', {
method: 'POST',
headers: {
'x-api-key': 'YOUR_API_KEY',
'Content-Type': 'application/json',
},
body: JSON.stringify({ user_id: '6842123456789012345' }),
});
const { data } = await res.json();
console.log(data);curl -X POST https://api.yepapi.com/v1/tiktok/user-followers \
-H "x-api-key: YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{"user_id": "6842123456789012345"}'Request Body
| Parameter | Type | Required | Description | Default |
|---|---|---|---|---|
user_id | string | Yes | TikTok user ID (numeric) | — |
cursor | string | No | Pagination cursor from previous response | — |
count | number | No | Number of results to return | 20 |
Response
{
"ok": true,
"data": {
"has_more": true,
"cursor": "50",
"followers": [
{
"user_id": "6891234567890123456",
"unique_id": "foodlover99",
"nickname": "Food Lover",
"avatar": "https://p16-sign.tiktokcdn.com/...",
"signature": "I love cooking!",
"follower_count": 1200,
"is_verified": false
}
]
}
}Response Fields
| Field | Type | Description |
|---|---|---|
ok | boolean | Whether the request succeeded |
data.has_more | boolean | Whether more results are available |
data.cursor | string | Cursor for fetching the next page |
data.followers | object[] | Array of follower user objects |
data.followers[].user_id | string | Follower's unique numeric identifier |
data.followers[].unique_id | string | Follower's unique handle |
data.followers[].nickname | string | Follower's display name |
data.followers[].avatar | string | Profile picture URL |
data.followers[].signature | string | Bio text |
data.followers[].follower_count | number | Number of followers this user has |
data.followers[].is_verified | boolean | Whether the user is verified |
Use the cursor value from the response to paginate through results.