How to Scrape Tiktok Follower List Data
This tutorial shows how to use Tiktok Follower List Data API to scrape and crawl structured Tiktok data in real-time.
Map the full follower base of any TikTok creator through our API. Extract profile lists, engagement tiers, and growth signals to support better influencer vetting decisions.
Access Tiktok Data in 3 Steps
Start crawling Tiktok follower analytics data. Follow these steps to extract social media data in minutes.
1
Create Your Account
Go to our registration page and make an account. It's free, no credit card, and you get credits right away to play around with.
2
Verify Your Email Address
You'll get a verification email, click the link in it. Once that's done, you can grab your API token from the dashboard.
3
Make Your First API Call
Copy the code snippet below, swap in your API key, and run it. You'll get Tiktok data back as JSON within a few seconds.
Code Sample
Here's a JavaScript example to get you going. Swap out the token and you're good, works the same way in any language that can make HTTP requests. Start collecting follower analytics data via our REST API!
JavaScript Tiktok User Followers
| 1 | const root = 'https://ensembledata.com/apis' |
| 2 | const endpoint = '/tt/user/followers' |
| 3 | const params = { |
| 4 | "id": "6784819479778378757", |
| 5 | "secUid": "MS4wLjABAAAAQ45IcDZIqrknyl0FDjs7xDlcxlaRE7CcBx1ENxYkWK00UpeKTTlCQWKxq6t9QM6b", |
| 6 | "cursor": 0, |
| 7 | "page_token": "", |
| 8 | "token": "YOUR-TOKEN-HERE" |
| 9 | } |
| 10 | |
| 11 | const queryString = new URLSearchParams(params).toString(); |
| 12 | const url = `${root}${endpoint}?${queryString}`; |
| 13 | |
| 14 | await fetch(url) |
| 15 | .then(response => response.json()) |
| 16 | .then(data => console.log(data)) |
| 17 | .catch(error => console.error(error)); |
| 18 |
Parameters
id (string) The id of the user. REQUIRED
secUid (string) The secondary id of the user. REQUIRED
cursor (integer) Parameter to manually handle pagination. Each response contains a `nextCursor` which can be used to retrieve the next page of results by sending it as the next `cursor`. If the `nextCursor` is not present in the response, it means that there are no more results to retrieve.
page_token (string) Secondary cursor to manage pagination (initially empty). The `page_token` for next request is returned by the previous response as the `nextPageToken`. This works in the same way as the `cursor` parameter.
token (string) Private token assigned to each client to access the APIs. REQUIRED
Example Response
Explore the fields returned by this endpoint. Click a row to expand nested objects and arrays, hover a value to copy it, or use "Expand all" to see everything at once.
JSON
Tiktok User Followers
dataobject3 fields
nextCursornumber1668768146
followersarray1 item · schema from #0 1 item
advanced_feature_infonullnull
nicknamestring"nonnoTonino49"
shield_follow_noticenumber0
has_ordersbooleanfalse
mutual_relation_avatarsnullnull
uidstring"6919985905534190598"
sec_uidstring"MS4wLjABAAAAyj26Tb1gqsXtBfnbmautgiwBQrDbNgLo8dmcL7qMQsi3QbhJOcHttfKtgy…"
mention_statusnumber1
apple_accountnumber0
has_emailbooleanfalse
comment_settingnumber0
user_ratenumber1
unique_idstring"nonnotonino49"
need_recommendnumber0
has_youtube_tokenbooleanfalse
room_idnumber0
live_verifynumber0
share_infoobject9 fields
share_urlstring""
share_descstring""
share_qrcode_urlobject4 fields
uristring""
url_listarray0 items
empty
widthnumber720
heightnumber720
share_title_myselfstring""
share_desc_infostring""
share_weibo_descstring""
share_titlestring""
share_title_otherstring""
now_invitation_card_image_urlsnullnull
original_musicianobject3 fields
music_countnumber0
music_used_countnumber0
digg_countnumber0
create_timenumber1668768711
bold_fieldsnullnull
following_countnumber6
is_blockbooleanfalse
tw_expire_timenumber0
accept_private_policybooleanfalse
custom_verifystring""
enterprise_verify_reasonstring""
account_regionstring""
bind_phonestring""
video_iconobject4 fields
url_listarray0 items
empty
widthnumber720
heightnumber720
uristring""
follower_statusnumber0
avatar_largerobject4 fields
uristring"tos-maliva-avt-0068/92d6836daba5f31119f348c652688a7c"
url_listarray2 items · schema from #0 2 items
0string"h"
1string"t"
2string"t"
3string"p"
4string"s"
5string":"
6string"/"
7string"/"
8string"p"
9string"1"
10string"6"
11string"-"
12string"s"
13string"i"
14string"g"
15string"n"
16string"-"
17string"v"
18string"a"
19string"."
20string"t"
21string"i"
22string"k"
23string"t"
24string"o"
25string"k"
26string"c"
27string"d"
28string"n"
29string"."
30string"c"
31string"o"
32string"m"
33string"/"
34string"t"
35string"o"
36string"s"
37string"-"
38string"m"
39string"a"
40string"l"
41string"i"
42string"v"
43string"a"
44string"-"
45string"a"
46string"v"
47string"t"
48string"-"
49string"0"
50string"0"
51string"6"
52string"8"
53string"/"
54string"9"
55string"2"
56string"d"
57string"6"
58string"8"
59string"3"
60string"6"
61string"d"
62string"a"
63string"b"
64string"a"
65string"5"
66string"f"
67string"3"
68string"1"
69string"1"
70string"1"
71string"9"
72string"f"
73string"3"
74string"4"
75string"8"
76string"c"
77string"6"
78string"5"
79string"2"
80string"6"
81string"8"
82string"8"
83string"a"
84string"7"
85string"c"
86string"~"
87string"c"
88string"5"
89string"_"
90string"1"
91string"0"
92string"8"
93string"0"
94string"x"
95string"1"
96string"0"
97string"8"
98string"0"
99string"."
100string"w"
101string"e"
102string"b"
103string"p"
104string"?"
105string"x"
106string"-"
107string"e"
108string"x"
109string"p"
110string"i"
111string"r"
112string"e"
113string"s"
114string"="
115string"1"
116string"6"
117string"6"
118string"8"
119string"8"
120string"5"
121string"5"
122string"6"
123string"0"
124string"0"
125string"&"
126string"x"
127string"-"
128string"s"
129string"i"
130string"g"
131string"n"
132string"a"
133string"t"
134string"u"
135string"r"
136string"e"
137string"="
138string"m"
139string"s"
140string"k"
141string"5"
142string"H"
143string"t"
144string"M"
145string"P"
146string"J"
147string"t"
148string"c"
149string"W"
150string"r"
151string"3"
152string"2"
153string"6"
154string"T"
155string"c"
156string"c"
157string"u"
158string"4"
159string"8"
160string"x"
161string"s"
162string"u"
163string"%"
164string"2"
165string"F"
166string"8"
167string"%"
168string"3"
169string"D"
widthnumber720
heightnumber720
live_agreement_timenumber0
special_accountobject1 field
special_account_listnullnull
shield_comment_noticenumber0
platform_sync_infonullnull
live_commercebooleanfalse
stitch_settingnumber0
aweme_countnumber1
unique_id_modify_timenumber1668771500
twitter_idstring""
type_labelnullnull
comment_filter_statusnumber0
avatar_168x168object4 fields
uristring"tos-maliva-avt-0068/92d6836daba5f31119f348c652688a7c"
url_listarray2 items · schema from #0 2 items
0string"h"
1string"t"
2string"t"
3string"p"
4string"s"
5string":"
6string"/"
7string"/"
8string"p"
9string"1"
10string"6"
11string"-"
12string"s"
13string"i"
14string"g"
15string"n"
16string"-"
17string"v"
18string"a"
19string"."
20string"t"
21string"i"
22string"k"
23string"t"
24string"o"
25string"k"
26string"c"
27string"d"
28string"n"
29string"."
30string"c"
31string"o"
32string"m"
33string"/"
34string"t"
35string"o"
36string"s"
37string"-"
38string"m"
39string"a"
40string"l"
41string"i"
42string"v"
43string"a"
44string"-"
45string"a"
46string"v"
47string"t"
48string"-"
49string"0"
50string"0"
51string"6"
52string"8"
53string"/"
54string"9"
55string"2"
56string"d"
57string"6"
58string"8"
59string"3"
60string"6"
61string"d"
62string"a"
63string"b"
64string"a"
65string"5"
66string"f"
67string"3"
68string"1"
69string"1"
70string"1"
71string"9"
72string"f"
73string"3"
74string"4"
75string"8"
76string"c"
77string"6"
78string"5"
79string"2"
80string"6"
81string"8"
82string"8"
83string"a"
84string"7"
85string"c"
86string"~"
87string"c"
88string"5"
89string"_"
90string"1"
91string"6"
92string"8"
93string"x"
94string"1"
95string"6"
96string"8"
97string"."
98string"w"
99string"e"
100string"b"
101string"p"
102string"?"
103string"x"
104string"-"
105string"e"
106string"x"
107string"p"
108string"i"
109string"r"
110string"e"
111string"s"
112string"="
113string"1"
114string"6"
115string"6"
116string"8"
117string"8"
118string"5"
119string"5"
120string"6"
121string"0"
122string"0"
123string"&"
124string"x"
125string"-"
126string"s"
127string"i"
128string"g"
129string"n"
130string"a"
131string"t"
132string"u"
133string"r"
134string"e"
135string"="
136string"u"
137string"y"
138string"0"
139string"4"
140string"J"
141string"8"
142string"g"
143string"W"
144string"Q"
145string"7"
146string"s"
147string"J"
148string"I"
149string"0"
150string"p"
151string"d"
152string"X"
153string"q"
154string"b"
155string"r"
156string"O"
157string"A"
158string"U"
159string"L"
160string"A"
161string"W"
162string"c"
163string"%"
164string"3"
165string"D"
widthnumber720
heightnumber720
user_profile_guidenullnull
favoriting_countnumber5
verification_typenumber0
regionstring"IT"
cover_urlarray1 item · schema from #0 1 item
uristring"musically-maliva-obj/1612555907887110"
url_listarray1 item · schema from #0 1 item
0string"h"
1string"t"
2string"t"
3string"p"
4string"s"
5string":"
6string"/"
7string"/"
8string"p"
9string"1"
10string"6"
11string"-"
12string"a"
13string"m"
14string"d"
15string"-"
16string"v"
17string"a"
18string"."
19string"t"
20string"i"
21string"k"
22string"t"
23string"o"
24string"k"
25string"c"
26string"d"
27string"n"
28string"."
29string"c"
30string"o"
31string"m"
32string"/"
33string"o"
34string"b"
35string"j"
36string"/"
37string"m"
38string"u"
39string"s"
40string"i"
41string"c"
42string"a"
43string"l"
44string"l"
45string"y"
46string"-"
47string"m"
48string"a"
49string"l"
50string"i"
51string"v"
52string"a"
53string"-"
54string"o"
55string"b"
56string"j"
57string"/"
58string"1"
59string"6"
60string"1"
61string"2"
62string"5"
63string"5"
64string"5"
65string"9"
66string"0"
67string"7"
68string"8"
69string"8"
70string"7"
71string"1"
72string"1"
73string"0"
widthnumber720
heightnumber720
signaturestring"un nonno di 73 anni con la passione per la cucina"
with_fusion_shop_entrybooleanfalse
shield_digg_noticenumber0
twitter_namestring""
react_settingnumber0
share_qrcode_uristring""
has_twitter_tokenbooleanfalse
secretnumber0
account_labelsnullnull
user_tagsnullnull
fb_expire_timenumber0
statusnumber1
download_settingnumber0
user_periodnumber0
birthdaystring"1900-01-01"
need_pointsnullnull
can_message_follow_status_listnullnull
avatar_300x300object4 fields
url_listarray2 items · schema from #0 2 items
0string"h"
1string"t"
2string"t"
3string"p"
4string"s"
5string":"
6string"/"
7string"/"
8string"p"
9string"1"
10string"6"
11string"-"
12string"s"
13string"i"
14string"g"
15string"n"
16string"-"
17string"v"
18string"a"
19string"."
20string"t"
21string"i"
22string"k"
23string"t"
24string"o"
25string"k"
26string"c"
27string"d"
28string"n"
29string"."
30string"c"
31string"o"
32string"m"
33string"/"
34string"t"
35string"o"
36string"s"
37string"-"
38string"m"
39string"a"
40string"l"
41string"i"
42string"v"
43string"a"
44string"-"
45string"a"
46string"v"
47string"t"
48string"-"
49string"0"
50string"0"
51string"6"
52string"8"
53string"/"
54string"9"
55string"2"
56string"d"
57string"6"
58string"8"
59string"3"
60string"6"
61string"d"
62string"a"
63string"b"
64string"a"
65string"5"
66string"f"
67string"3"
68string"1"
69string"1"
70string"1"
71string"9"
72string"f"
73string"3"
74string"4"
75string"8"
76string"c"
77string"6"
78string"5"
79string"2"
80string"6"
81string"8"
82string"8"
83string"a"
84string"7"
85string"c"
86string"~"
87string"c"
88string"5"
89string"_"
90string"3"
91string"0"
92string"0"
93string"x"
94string"3"
95string"0"
96string"0"
97string"."
98string"w"
99string"e"
100string"b"
101string"p"
102string"?"
103string"x"
104string"-"
105string"e"
106string"x"
107string"p"
108string"i"
109string"r"
110string"e"
111string"s"
112string"="
113string"1"
114string"6"
115string"6"
116string"8"
117string"8"
118string"5"
119string"5"
120string"6"
121string"0"
122string"0"
123string"&"
124string"x"
125string"-"
126string"s"
127string"i"
128string"g"
129string"n"
130string"a"
131string"t"
132string"u"
133string"r"
134string"e"
135string"="
136string"R"
137string"5"
138string"b"
139string"a"
140string"E"
141string"T"
142string"B"
143string"l"
144string"l"
145string"r"
146string"P"
147string"7"
148string"6"
149string"%"
150string"2"
151string"F"
152string"Q"
153string"L"
154string"p"
155string"T"
156string"m"
157string"x"
158string"r"
159string"T"
160string"2"
161string"r"
162string"X"
163string"U"
164string"w"
165string"%"
166string"3"
167string"D"
widthnumber720
heightnumber720
uristring"tos-maliva-avt-0068/92d6836daba5f31119f348c652688a7c"
is_ad_fakebooleanfalse
avatar_uristring"tos-maliva-avt-0068/92d6836daba5f31119f348c652688a7c"
user_modenumber1
is_starbooleanfalse
has_facebook_tokenbooleanfalse
advance_feature_item_ordernullnull
duet_settingnumber0
cv_levelstring""
ad_cover_urlnullnull
shield_edit_field_infonullnull
avatar_mediumobject4 fields
url_listarray2 items · schema from #0 2 items
0string"h"
1string"t"
2string"t"
3string"p"
4string"s"
5string":"
6string"/"
7string"/"
8string"p"
9string"1"
10string"6"
11string"-"
12string"s"
13string"i"
14string"g"
15string"n"
16string"-"
17string"v"
18string"a"
19string"."
20string"t"
21string"i"
22string"k"
23string"t"
24string"o"
25string"k"
26string"c"
27string"d"
28string"n"
29string"."
30string"c"
31string"o"
32string"m"
33string"/"
34string"t"
35string"o"
36string"s"
37string"-"
38string"m"
39string"a"
40string"l"
41string"i"
42string"v"
43string"a"
44string"-"
45string"a"
46string"v"
47string"t"
48string"-"
49string"0"
50string"0"
51string"6"
52string"8"
53string"/"
54string"9"
55string"2"
56string"d"
57string"6"
58string"8"
59string"3"
60string"6"
61string"d"
62string"a"
63string"b"
64string"a"
65string"5"
66string"f"
67string"3"
68string"1"
69string"1"
70string"1"
71string"9"
72string"f"
73string"3"
74string"4"
75string"8"
76string"c"
77string"6"
78string"5"
79string"2"
80string"6"
81string"8"
82string"8"
83string"a"
84string"7"
85string"c"
86string"~"
87string"c"
88string"5"
89string"_"
90string"7"
91string"2"
92string"0"
93string"x"
94string"7"
95string"2"
96string"0"
97string"."
98string"w"
99string"e"
100string"b"
101string"p"
102string"?"
103string"x"
104string"-"
105string"e"
106string"x"
107string"p"
108string"i"
109string"r"
110string"e"
111string"s"
112string"="
113string"1"
114string"6"
115string"6"
116string"8"
117string"8"
118string"5"
119string"5"
120string"6"
121string"0"
122string"0"
123string"&"
124string"x"
125string"-"
126string"s"
127string"i"
128string"g"
129string"n"
130string"a"
131string"t"
132string"u"
133string"r"
134string"e"
135string"="
136string"C"
137string"I"
138string"5"
139string"A"
140string"4"
141string"k"
142string"5"
143string"q"
144string"F"
145string"9"
146string"L"
147string"i"
148string"q"
149string"z"
150string"A"
151string"0"
152string"d"
153string"l"
154string"w"
155string"3"
156string"f"
157string"y"
158string"0"
159string"U"
160string"U"
161string"Y"
162string"U"
163string"%"
164string"3"
165string"D"
widthnumber720
heightnumber720
uristring"tos-maliva-avt-0068/92d6836daba5f31119f348c652688a7c"
download_prompt_tsnumber0
relative_usersnullnull
eventsnullnull
youtube_channel_idstring""
homepage_bottom_toastnullnull
cha_listnullnull
gendernumber0
hide_searchbooleanfalse
ins_idstring""
youtube_channel_titlestring""
is_discipline_memberbooleanfalse
reflow_page_gidnumber0
languagestring"it"
has_insightsbooleanfalse
avatar_thumbobject4 fields
heightnumber720
uristring"tos-maliva-avt-0068/92d6836daba5f31119f348c652688a7c"
url_listarray2 items · schema from #0 2 items
0string"h"
1string"t"
2string"t"
3string"p"
4string"s"
5string":"
6string"/"
7string"/"
8string"p"
9string"1"
10string"6"
11string"-"
12string"s"
13string"i"
14string"g"
15string"n"
16string"-"
17string"v"
18string"a"
19string"."
20string"t"
21string"i"
22string"k"
23string"t"
24string"o"
25string"k"
26string"c"
27string"d"
28string"n"
29string"."
30string"c"
31string"o"
32string"m"
33string"/"
34string"t"
35string"o"
36string"s"
37string"-"
38string"m"
39string"a"
40string"l"
41string"i"
42string"v"
43string"a"
44string"-"
45string"a"
46string"v"
47string"t"
48string"-"
49string"0"
50string"0"
51string"6"
52string"8"
53string"/"
54string"9"
55string"2"
56string"d"
57string"6"
58string"8"
59string"3"
60string"6"
61string"d"
62string"a"
63string"b"
64string"a"
65string"5"
66string"f"
67string"3"
68string"1"
69string"1"
70string"1"
71string"9"
72string"f"
73string"3"
74string"4"
75string"8"
76string"c"
77string"6"
78string"5"
79string"2"
80string"6"
81string"8"
82string"8"
83string"a"
84string"7"
85string"c"
86string"~"
87string"c"
88string"5"
89string"_"
90string"1"
91string"0"
92string"0"
93string"x"
94string"1"
95string"0"
96string"0"
97string"."
98string"w"
99string"e"
100string"b"
101string"p"
102string"?"
103string"x"
104string"-"
105string"e"
106string"x"
107string"p"
108string"i"
109string"r"
110string"e"
111string"s"
112string"="
113string"1"
114string"6"
115string"6"
116string"8"
117string"8"
118string"5"
119string"5"
120string"6"
121string"0"
122string"0"
123string"&"
124string"x"
125string"-"
126string"s"
127string"i"
128string"g"
129string"n"
130string"a"
131string"t"
132string"u"
133string"r"
134string"e"
135string"="
136string"D"
137string"s"
138string"6"
139string"4"
140string"K"
141string"J"
142string"j"
143string"9"
144string"Z"
145string"8"
146string"b"
147string"E"
148string"w"
149string"E"
150string"i"
151string"B"
152string"k"
153string"9"
154string"q"
155string"I"
156string"2"
157string"A"
158string"e"
159string"A"
160string"I"
161string"w"
162string"s"
163string"%"
164string"3"
165string"D"
widthnumber720
follow_statusnumber0
authority_statusnumber0
with_shop_entrybooleanfalse
short_idstring"0"
verify_infostring""
live_agreementnumber0
item_listnullnull
special_locknumber1
youtube_expire_timenumber0
is_phone_bindedbooleanfalse
prevent_downloadbooleanfalse
geofencingarray0 items
empty
search_highlightnullnull
friends_statusnumber0
total_favoritednumber0
google_accountstring""
user_canceledbooleanfalse
can_set_geofencingnullnull
white_cover_urlnullnull
follower_countnumber0
followers_detailnullnull
commerce_user_levelnumber0
show_image_bubblebooleanfalse
with_commerce_entrybooleanfalse
reflow_page_uidnumber0
totalnumber5874939
Response Codes
Status codes this endpoint can return, so you can handle errors before they surprise you in production.
200SuccessSuccessful Response
422Client ErrorValidation Error
491Client ErrorToken not found
492Client ErrorEmail not verified
493Client ErrorSubscription expired
495Client ErrorAll daily units used
500Server ErrorSomething went wrong
API Pricing
2 units
Cost per successful call to this endpoint.
Example Cases
1
secUid does not exist Result: null
1 unit 2
secUid exists and has 40 followers Result: 40 followers
2 units 3
secUid exists and has more than 100 followers Result: 100 followers and cursor for next request
2 units Fetch Tiktok Data at Scale
Get a clear picture of any TikTok creator's audience including follower profiles, engagement tiers, and growth trends through our influencer data API.
Follower Lists
Retrieve the full public list of accounts following any TikTok creator.
Audience Data
Analyze follower profiles to understand a creator's audience makeup.
Overlap Analysis
Compare follower lists across creators to find shared audiences.