TikTok Followers Scraper API: Extract Complete Follower Lists
Need to export TikTok followers from any profile? This guide shows you how to scrape follower data for audience analysis, competitive research, and lead generation.
Why Scrape TikTok Followers?
Understanding who follows a creator or brand reveals valuable insights:
- Audience Analysis - Profile your target audience demographics
- Influencer Vetting - Verify follower authenticity before partnerships
- Competitor Research - Analyze who follows your competitors
- Lead Generation - Build prospect lists from engaged audiences
- Lookalike Audiences - Find similar accounts to target
What Follower Data Can You Extract?
For each follower, you receive:
| Field | Description |
|---|---|
unique_id | TikTok handle |
nickname | Display name |
uid | Numeric user ID |
sec_uid | Secure user ID (use for profile lookups) |
signature | Bio / profile description |
follower_count | Their follower count |
following_count | Accounts they follow |
total_favorited | Total likes received across all videos |
aweme_count | Number of videos posted |
favoriting_count | Number of videos they've liked |
avatar_larger.url_list["0"] | Profile picture (high-res) |
region | 2-letter country code |
verification_type | 1 = verified |
create_time | Account creation Unix timestamp |
Using the Followers API
Extract followers from any public TikTok profile:
const response = await fetch('https://api.sociavault.com/v1/scrape/tiktok/followers?handle=stoolpresidente', {
headers: {
'x-api-key': 'YOUR_API_KEY'
}
});
const data = await response.json();
Parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
handle | string | No* | TikTok handle |
user_id | string | No* | User ID — use for faster response times |
min_time | integer | No | Pagination cursor from previous response |
trim | boolean | No | Set to true for a trimmed response |
*Provide either
handleoruser_id.
Sample Response
Note: Followers are returned as an object with numeric keys (
"0","1", etc.), not an array. UseObject.values()to iterate.
{
"success": true,
"data": {
"followers": {
"0": {
"unique_id": "lleeson01",
"nickname": "Lleeson",
"uid": "6810678927758476294",
"sec_uid": "MS4wLjABAAAAqww8izv...",
"signature": "",
"follower_count": 266,
"following_count": 2499,
"total_favorited": 0,
"aweme_count": 0,
"favoriting_count": 239116,
"region": "GB",
"verification_type": 1,
"create_time": 1591245126,
"avatar_medium": {
"url_list": {
"0": "https://p16-common-sign.tiktokcdn-eu.com/..."
}
}
}
},
"total": 4567709,
"has_more": true,
"min_time": 1770573007
},
"credits_used": 1
}
Use Cases
Influencer Authenticity Check
Analyze follower quality to detect fake followers:
const followers = Object.values(data.data.followers);
const realFollowers = followers.filter(f =>
f.follower_count > 10 && // Has some followers
f.signature.length > 0 && // Has a bio
f.aweme_count > 0 // Has posted videos
);
const authenticityScore = (realFollowers.length / followers.length) * 100;
console.log(`Authenticity: ${authenticityScore.toFixed(1)}%`);
Finding Active Followers
Identify followers who are likely influencers themselves:
const influencerFollowers = followers.filter(f =>
f.follower_count >= 10000 && f.verification_type === 1
);
Audience Demographics Analysis
Group followers by characteristics:
const creatorFollowers = followers.filter(f => f.aweme_count >= 10);
const regularUsers = followers.filter(f => f.aweme_count < 10);
// Group by region
const byRegion = {};
for (const f of followers) {
byRegion[f.region] = (byRegion[f.region] || 0) + 1;
}
console.log('Followers by region:', byRegion);
Pagination — Fetch All Followers
async function getAllFollowers(handle) {
let allFollowers = [];
let minTime = undefined;
while (true) {
const url = new URL('https://api.sociavault.com/v1/scrape/tiktok/followers');
url.searchParams.set('handle', handle);
if (minTime) url.searchParams.set('min_time', minTime);
url.searchParams.set('trim', 'true');
const res = await fetch(url, { headers: { 'x-api-key': 'YOUR_API_KEY' } });
const result = await res.json();
const followers = Object.values(result.data.followers);
allFollowers.push(...followers);
console.log(`Fetched ${allFollowers.length} / ${result.data.total} followers`);
if (!result.data.has_more) break;
minTime = result.data.min_time;
}
return allFollowers;
}
Also Scrape Following Lists
Get accounts that a user follows:
const following = await fetch('https://api.sociavault.com/v1/scrape/tiktok/following?handle=stoolpresidente', {
headers: {
'x-api-key': 'YOUR_API_KEY'
}
});
const result = await following.json();
const followedAccounts = Object.values(result.data.followings);
| Parameter | Type | Required | Description |
|---|---|---|---|
handle | string | Yes | TikTok handle |
min_time | integer | No | Pagination cursor from previous response |
trim | boolean | No | Set to true for a trimmed response |
This reveals:
- Competitors they follow
- Industry connections
- Content interests
- Potential collaboration partners
## Related TikTok Endpoints
- [TikTok Profile Scraper](/blog/tiktok-profile-scraper-api) - Get profile statistics
- [TikTok Demographics](/blog/tiktok-demographics-api) - Audience age/gender breakdown
- [TikTok Videos Scraper](/blog/tiktok-videos-scraper-api) - Extract all videos
- [TikTok Search Users](/blog/tiktok-search-users-api) - Find users by keyword
## Frequently Asked Questions
### Can I scrape all followers from large accounts?
Yes, the API supports pagination for accounts with millions of followers. However, scraping very large accounts (10M+) may take time due to TikTok's pagination limits.
### How accurate is the follower data?
SociaVault fetches real-time follower data. Counts and lists reflect the current state of the account.
### Can I detect fake followers?
Yes, analyzing follower quality metrics (followers/following ratio, bio presence, profile photos) helps identify suspicious accounts.
### Is it legal to scrape TikTok followers?
Scraping publicly available data is generally permitted. SociaVault accesses the same data visible to any TikTok user. Always use data ethically and in compliance with applicable laws.
### Can I export followers to CSV?
The API returns JSON data that you can easily convert to CSV, Excel, or any format needed for your workflow.
## Get Started
[Sign up free](https://sociavault.com/signup) and start extracting TikTok follower data today.
API documentation: [/docs/api-reference/tiktok/followers](https://docs.sociavault.com/api-reference/tiktok/followers)
Found this helpful?
Share it with others who might benefit
Ready to Try SociaVault?
Start extracting social media data with our powerful API. No credit card required.