How to Scrape Tiktok Following List Data
This tutorial shows how to use Tiktok Following List Data API to scrape and crawl structured Tiktok data in real-time.
Find out exactly who any TikTok user follows with our followings API. Pull account lists, niche affinities, and network connections to sharpen your competitive intelligence.
Access Tiktok Data in 3 Steps
Start crawling Tiktok following list 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 following list data via our REST API!
JavaScript Tiktok User Followings
| 1 | const root = 'https://ensembledata.com/apis' |
| 2 | const endpoint = '/tt/user/followings' |
| 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 Followings
dataobject4 fields
nextCursornumber1664399904
nextPageTokenstring"eyJtYXhfY3Vyc29yIjoxNjk4NDkxMTYxLCJtaW5fY3Vyc29yIjoxNjY0Mzk5OTA0LCJmaWā¦"
followingsarray1 item Ā· schema from #0 1 item
accept_private_policybooleanfalse
account_labelsnullnull
account_regionstring""
ad_cover_urlnullnull
advance_feature_item_ordernullnull
advanced_feature_infonullnull
apple_accountnumber0
authority_statusnumber0
avatar_168x168object5 fields
heightnumber720
uristring"musically-maliva-obj/1661014199681029"
url_listarray3 items Ā· schema from #0 3 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"m"
35string"u"
36string"s"
37string"i"
38string"c"
39string"a"
40string"l"
41string"l"
42string"y"
43string"-"
44string"m"
45string"a"
46string"l"
47string"i"
48string"v"
49string"a"
50string"-"
51string"o"
52string"b"
53string"j"
54string"/"
55string"1"
56string"6"
57string"6"
58string"1"
59string"0"
60string"1"
61string"4"
62string"1"
63string"9"
64string"9"
65string"6"
66string"8"
67string"1"
68string"0"
69string"2"
70string"9"
71string"~"
72string"c"
73string"5"
74string"_"
75string"1"
76string"6"
77string"8"
78string"x"
79string"1"
80string"6"
81string"8"
82string"."
83string"w"
84string"e"
85string"b"
86string"p"
87string"?"
88string"x"
89string"-"
90string"e"
91string"x"
92string"p"
93string"i"
94string"r"
95string"e"
96string"s"
97string"="
98string"1"
99string"7"
100string"0"
101string"1"
102string"6"
103string"2"
104string"6"
105string"4"
106string"0"
107string"0"
108string"&"
109string"x"
110string"-"
111string"s"
112string"i"
113string"g"
114string"n"
115string"a"
116string"t"
117string"u"
118string"r"
119string"e"
120string"="
121string"A"
122string"i"
123string"h"
124string"C"
125string"a"
126string"U"
127string"3"
128string"v"
129string"G"
130string"I"
131string"4"
132string"J"
133string"2"
134string"%"
135string"2"
136string"F"
137string"t"
138string"q"
139string"%"
140string"2"
141string"B"
142string"6"
143string"Q"
144string"P"
145string"t"
146string"0"
147string"o"
148string"n"
149string"B"
150string"k"
151string"Y"
152string"%"
153string"3"
154string"D"
url_prefixnullnull
widthnumber720
avatar_300x300object5 fields
heightnumber720
uristring"musically-maliva-obj/1661014199681029"
url_listarray3 items Ā· schema from #0 3 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"m"
35string"u"
36string"s"
37string"i"
38string"c"
39string"a"
40string"l"
41string"l"
42string"y"
43string"-"
44string"m"
45string"a"
46string"l"
47string"i"
48string"v"
49string"a"
50string"-"
51string"o"
52string"b"
53string"j"
54string"/"
55string"1"
56string"6"
57string"6"
58string"1"
59string"0"
60string"1"
61string"4"
62string"1"
63string"9"
64string"9"
65string"6"
66string"8"
67string"1"
68string"0"
69string"2"
70string"9"
71string"~"
72string"c"
73string"5"
74string"_"
75string"3"
76string"0"
77string"0"
78string"x"
79string"3"
80string"0"
81string"0"
82string"."
83string"w"
84string"e"
85string"b"
86string"p"
87string"?"
88string"x"
89string"-"
90string"e"
91string"x"
92string"p"
93string"i"
94string"r"
95string"e"
96string"s"
97string"="
98string"1"
99string"7"
100string"0"
101string"1"
102string"6"
103string"2"
104string"6"
105string"4"
106string"0"
107string"0"
108string"&"
109string"x"
110string"-"
111string"s"
112string"i"
113string"g"
114string"n"
115string"a"
116string"t"
117string"u"
118string"r"
119string"e"
120string"="
121string"O"
122string"t"
123string"v"
124string"%"
125string"2"
126string"F"
127string"f"
128string"a"
129string"C"
130string"3"
131string"6"
132string"O"
133string"f"
134string"e"
135string"j"
136string"I"
137string"2"
138string"F"
139string"Q"
140string"j"
141string"9"
142string"q"
143string"b"
144string"T"
145string"h"
146string"P"
147string"r"
148string"t"
149string"A"
150string"%"
151string"3"
152string"D"
url_prefixnullnull
widthnumber720
avatar_largerobject5 fields
heightnumber720
uristring"musically-maliva-obj/1661014199681029"
url_listarray3 items Ā· schema from #0 3 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"m"
35string"u"
36string"s"
37string"i"
38string"c"
39string"a"
40string"l"
41string"l"
42string"y"
43string"-"
44string"m"
45string"a"
46string"l"
47string"i"
48string"v"
49string"a"
50string"-"
51string"o"
52string"b"
53string"j"
54string"/"
55string"1"
56string"6"
57string"6"
58string"1"
59string"0"
60string"1"
61string"4"
62string"1"
63string"9"
64string"9"
65string"6"
66string"8"
67string"1"
68string"0"
69string"2"
70string"9"
71string"~"
72string"c"
73string"5"
74string"_"
75string"1"
76string"0"
77string"8"
78string"0"
79string"x"
80string"1"
81string"0"
82string"8"
83string"0"
84string"."
85string"w"
86string"e"
87string"b"
88string"p"
89string"?"
90string"x"
91string"-"
92string"e"
93string"x"
94string"p"
95string"i"
96string"r"
97string"e"
98string"s"
99string"="
100string"1"
101string"7"
102string"0"
103string"1"
104string"6"
105string"2"
106string"6"
107string"4"
108string"0"
109string"0"
110string"&"
111string"x"
112string"-"
113string"s"
114string"i"
115string"g"
116string"n"
117string"a"
118string"t"
119string"u"
120string"r"
121string"e"
122string"="
123string"H"
124string"3"
125string"n"
126string"O"
127string"z"
128string"I"
129string"k"
130string"s"
131string"B"
132string"K"
133string"j"
134string"4"
135string"y"
136string"o"
137string"N"
138string"B"
139string"2"
140string"M"
141string"3"
142string"i"
143string"7"
144string"O"
145string"Q"
146string"Y"
147string"h"
148string"d"
149string"Q"
150string"%"
151string"3"
152string"D"
url_prefixnullnull
widthnumber720
avatar_mediumobject5 fields
heightnumber720
uristring"musically-maliva-obj/1661014199681029"
url_listarray3 items Ā· schema from #0 3 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"m"
35string"u"
36string"s"
37string"i"
38string"c"
39string"a"
40string"l"
41string"l"
42string"y"
43string"-"
44string"m"
45string"a"
46string"l"
47string"i"
48string"v"
49string"a"
50string"-"
51string"o"
52string"b"
53string"j"
54string"/"
55string"1"
56string"6"
57string"6"
58string"1"
59string"0"
60string"1"
61string"4"
62string"1"
63string"9"
64string"9"
65string"6"
66string"8"
67string"1"
68string"0"
69string"2"
70string"9"
71string"~"
72string"c"
73string"5"
74string"_"
75string"7"
76string"2"
77string"0"
78string"x"
79string"7"
80string"2"
81string"0"
82string"."
83string"w"
84string"e"
85string"b"
86string"p"
87string"?"
88string"x"
89string"-"
90string"e"
91string"x"
92string"p"
93string"i"
94string"r"
95string"e"
96string"s"
97string"="
98string"1"
99string"7"
100string"0"
101string"1"
102string"6"
103string"2"
104string"6"
105string"4"
106string"0"
107string"0"
108string"&"
109string"x"
110string"-"
111string"s"
112string"i"
113string"g"
114string"n"
115string"a"
116string"t"
117string"u"
118string"r"
119string"e"
120string"="
121string"%"
122string"2"
123string"B"
124string"I"
125string"U"
126string"F"
127string"w"
128string"x"
129string"n"
130string"p"
131string"Z"
132string"1"
133string"B"
134string"L"
135string"D"
136string"9"
137string"V"
138string"7"
139string"t"
140string"P"
141string"I"
142string"P"
143string"i"
144string"n"
145string"y"
146string"F"
147string"P"
148string"K"
149string"8"
150string"%"
151string"3"
152string"D"
url_prefixnullnull
widthnumber720
avatar_thumbobject5 fields
heightnumber720
uristring"musically-maliva-obj/1661014199681029"
url_listarray3 items Ā· schema from #0 3 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"m"
35string"u"
36string"s"
37string"i"
38string"c"
39string"a"
40string"l"
41string"l"
42string"y"
43string"-"
44string"m"
45string"a"
46string"l"
47string"i"
48string"v"
49string"a"
50string"-"
51string"o"
52string"b"
53string"j"
54string"/"
55string"1"
56string"6"
57string"6"
58string"1"
59string"0"
60string"1"
61string"4"
62string"1"
63string"9"
64string"9"
65string"6"
66string"8"
67string"1"
68string"0"
69string"2"
70string"9"
71string"~"
72string"c"
73string"5"
74string"_"
75string"1"
76string"0"
77string"0"
78string"x"
79string"1"
80string"0"
81string"0"
82string"."
83string"w"
84string"e"
85string"b"
86string"p"
87string"?"
88string"x"
89string"-"
90string"e"
91string"x"
92string"p"
93string"i"
94string"r"
95string"e"
96string"s"
97string"="
98string"1"
99string"7"
100string"0"
101string"1"
102string"6"
103string"2"
104string"6"
105string"4"
106string"0"
107string"0"
108string"&"
109string"x"
110string"-"
111string"s"
112string"i"
113string"g"
114string"n"
115string"a"
116string"t"
117string"u"
118string"r"
119string"e"
120string"="
121string"B"
122string"G"
123string"z"
124string"b"
125string"5"
126string"y"
127string"R"
128string"V"
129string"o"
130string"w"
131string"I"
132string"M"
133string"4"
134string"y"
135string"h"
136string"x"
137string"e"
138string"u"
139string"r"
140string"f"
141string"p"
142string"Y"
143string"c"
144string"w"
145string"Q"
146string"t"
147string"8"
148string"%"
149string"3"
150string"D"
url_prefixnullnull
widthnumber720
avatar_uristring"musically-maliva-obj/1661014199681029"
aweme_countnumber682
bind_phonestring""
bold_fieldsnullnull
can_message_follow_status_listnullnull
can_set_geofencingnullnull
cha_listnullnull
comment_filter_statusnumber0
comment_settingnumber0
commerce_user_levelnumber2
cover_urlarray1 item Ā· schema from #0 1 item
heightnumber720
uristring"tiktok-obj/1613727517271041"
url_listarray1 item Ā· schema from #0 1 item
0string"h"
1string"t"
2string"t"
3string"p"
4string"s"
5string":"
6string"/"
7string"/"
8string"p"
9string"7"
10string"7"
11string"-"
12string"s"
13string"g"
14string"."
15string"t"
16string"i"
17string"k"
18string"t"
19string"o"
20string"k"
21string"c"
22string"d"
23string"n"
24string"."
25string"c"
26string"o"
27string"m"
28string"/"
29string"o"
30string"b"
31string"j"
32string"/"
33string"t"
34string"i"
35string"k"
36string"t"
37string"o"
38string"k"
39string"-"
40string"o"
41string"b"
42string"j"
43string"/"
44string"1"
45string"6"
46string"1"
47string"3"
48string"7"
49string"2"
50string"7"
51string"5"
52string"1"
53string"7"
54string"2"
55string"7"
56string"1"
57string"0"
58string"4"
59string"1"
url_prefixnullnull
widthnumber720
create_timenumber1583896704
custom_verifystring""
cv_levelstring""
download_prompt_tsnumber0
download_settingnumber0
duet_settingnumber0
enterprise_verify_reasonstring"verified account"
eventsnullnull
favoriting_countnumber3829
fb_expire_timenumber0
follow_statusnumber0
follower_countnumber187788
follower_statusnumber0
followers_detailnullnull
following_countnumber241
friends_statusnumber0
geofencingnullnull
google_accountstring""
has_emailbooleanfalse
has_facebook_tokenbooleanfalse
has_insightsbooleanfalse
has_ordersbooleanfalse
has_twitter_tokenbooleanfalse
has_youtube_tokenbooleanfalse
hide_searchbooleanfalse
homepage_bottom_toastnullnull
ins_idstring""
is_ad_fakebooleanfalse
is_blockbooleanfalse
is_discipline_memberbooleanfalse
is_phone_bindedbooleanfalse
is_starbooleanfalse
item_listnullnull
languagestring"en"
live_agreementnumber0
live_commercebooleanfalse
live_verifynumber0
mention_statusnumber1
mutual_relation_avatarsnullnull
need_pointsnullnull
need_recommendnumber0
nicknamestring"Shopify"
original_musicianobject4 fields
digg_countnumber0
music_countnumber0
music_used_countnumber0
new_release_clip_idsnullnull
platform_sync_infonullnull
prevent_downloadbooleanfalse
react_settingnumber0
regionstring"CA"
relative_usersnullnull
room_idnumber0
search_highlightnullnull
sec_uidstring"MS4wLjABAAAAZRjOHN4L1BoRQGiUEl7fFGxBsv9uxbWQtmJ09jyAaYHyVgz6UiPa5Aaloyā¦"
secretnumber0
share_infoobject8 fields
now_invitation_card_image_urlsnullnull
share_descstring""
share_desc_infostring""
share_qrcode_urlobject5 fields
heightnumber720
uristring""
url_listarray0 items
empty
url_prefixnullnull
widthnumber720
share_titlestring""
share_title_myselfstring""
share_title_otherstring""
share_urlstring""
share_qrcode_uristring""
shield_comment_noticenumber0
shield_digg_noticenumber0
shield_edit_field_infonullnull
shield_follow_noticenumber0
short_idstring"0"
show_image_bubblebooleanfalse
signaturestring"The entrepreneurship company
š§š¼āš» Hit the link & start your biz todā¦"
special_accountobject1 field
special_account_listnullnull
special_locknumber1
statusnumber1
stitch_settingnumber0
total_favoritednumber1285876
tw_expire_timenumber0
twitter_idstring""
twitter_namestring""
type_labelnullnull
uidstring"6802777718535865350"
unique_idstring"shopify"
unique_id_modify_timenumber1701543359
user_canceledbooleanfalse
user_modenumber1
user_periodnumber0
user_profile_guidenullnull
user_ratenumber1
user_tagsnullnull
verification_typenumber1
verify_infostring""
video_iconobject5 fields
heightnumber720
uristring"tos-maliva-avt-0068/e87123fad574662c5a66cd211f4e0cfb"
url_listarray2 items Ā· schema from #0 2 items
0string"h"
1string"t"
2string"t"
3string"p"
4string"s"
5string":"
6string"/"
7string"/"
8string"p"
9string"7"
10string"7"
11string"-"
12string"s"
13string"i"
14string"g"
15string"n"
16string"-"
17string"v"
18string"a"
19string"-"
20string"l"
21string"i"
22string"t"
23string"e"
24string"."
25string"t"
26string"i"
27string"k"
28string"t"
29string"o"
30string"k"
31string"c"
32string"d"
33string"n"
34string"."
35string"c"
36string"o"
37string"m"
38string"/"
39string"o"
40string"b"
41string"j"
42string"/"
43string"t"
44string"o"
45string"s"
46string"-"
47string"m"
48string"a"
49string"l"
50string"i"
51string"v"
52string"a"
53string"-"
54string"a"
55string"v"
56string"t"
57string"-"
58string"0"
59string"0"
60string"6"
61string"8"
62string"/"
63string"e"
64string"8"
65string"7"
66string"1"
67string"2"
68string"3"
69string"f"
70string"a"
71string"d"
72string"5"
73string"7"
74string"4"
75string"6"
76string"6"
77string"2"
78string"c"
79string"5"
80string"a"
81string"6"
82string"6"
83string"c"
84string"d"
85string"2"
86string"1"
87string"1"
88string"f"
89string"4"
90string"e"
91string"0"
92string"c"
93string"f"
94string"b"
95string"?"
96string"x"
97string"-"
98string"e"
99string"x"
100string"p"
101string"i"
102string"r"
103string"e"
104string"s"
105string"="
106string"1"
107string"7"
108string"0"
109string"1"
110string"6"
111string"2"
112string"6"
113string"4"
114string"0"
115string"0"
116string"&"
117string"x"
118string"-"
119string"s"
120string"i"
121string"g"
122string"n"
123string"a"
124string"t"
125string"u"
126string"r"
127string"e"
128string"="
129string"r"
130string"Z"
131string"U"
132string"g"
133string"P"
134string"Y"
135string"3"
136string"r"
137string"Z"
138string"z"
139string"O"
140string"T"
141string"8"
142string"g"
143string"y"
144string"J"
145string"K"
146string"V"
147string"1"
148string"2"
149string"B"
150string"W"
151string"G"
152string"O"
153string"C"
154string"%"
155string"2"
156string"B"
157string"U"
158string"%"
159string"3"
160string"D"
url_prefixnullnull
widthnumber720
white_cover_urlnullnull
with_commerce_entrybooleanfalse
with_shop_entrybooleanfalse
youtube_channel_idstring""
youtube_channel_titlestring""
youtube_expire_timenumber0
totalnumber327
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 followings Result: 40 followings
2 units 3
secUid exists and has more than 100 followings Result: 100 followings and cursor for next request
2 units Fetch Tiktok Data at Scale
Scrape TikTok following lists at scale and map the networks behind any account, useful for agencies doing competitive research or audience profiling.
Following Lists
See the full public list of accounts any TikTok user follows.
Network Mapping
Map creator networks and niche affinities from following data.
Interest Signals
Reveal which brands and topics an account is genuinely into.