Pricing

Rating

Developer

Actor stats

Categories

Share

TikTok User Followers API

This API provides a list of followers for a given TikTok user. It retrieves follower information, including details like username, ID, and profile picture.

Since TikTok doesn't provide a comprehensive and publicly available API for follower data, this API acts as an unofficial solution to access this information.

The TikTok User Followers API supports the following features:

• Follower List Retrieval: Retrieve a list of a user's followers.

Related TikTok APIs

For other TikTok data needs, explore these related APIs:

Bugs, Fixes, Updates, and Changelog

This API is actively maintained. Report any issues or feature requests by creating an issue in the repository (if applicable).

Input Parameters

The API accepts a JSON payload with the following parameters:

Compute Unit Consumption

This API is designed for efficient scraping. Performance may vary depending on network conditions and TikTok's rate limiting.

How to Use the TikTok User Followers API

1. Retrieve Followers using Username

{
"username":"nickiminai"
}

2. Retrieve Followers using URL

{
"url":"[https://www.tiktok.com/@someuser](https://www.google.com/search?q=https://www.tiktok.com/%40someuser)"
}

2. Retrieve Followers using User ID

{
"userId":"6714563164218679553"
}

During the Run

The API will provide status messages during execution. These messages will indicate the progress of the follower retrieval process.

If invalid input is provided, the API will stop and return an error message.

Note: During trial, number of results will be limited to 10 results.

Output

The API returns a JSON array containing the list of followers. Each follower object will contain information such as their username, user ID, profile picture URL, and potentially other relevant details. The exact structure of the follower object may vary.

Example Output:

Only UserId:

[
{
"sec_uid":"MS4wLjABAAAATFbl0lBqRW9sxQQIdCoORUCt13odopf8FA9brDDALygTCe-S4I1ayPvShGD5pvFS"
"uid":"7026400295186596870"
}
]

Full information:

[
{
"accept_private_policy":false,
"account_labels":null,
"account_region":"",
"ad_cover_url":null,
"advance_feature_item_order":null,
"advanced_feature_info":null,
"apple_account":0,
"authority_status":0,
"avatar_168x168":{
"height":720,
"uri":"tos-maliva-avt-0068/3f0889ea29ffae56fbb8ee22f2fc32dd",
"url_list":[
"https://p16-amd-va.tiktokcdn.com/tos-maliva-avt-0068/3f0889ea29ffae56fbb8ee22f2fc32dd~tplv-tiktokx-cropcenter-q:168:168:q70.heic?dr=9604\u0026idc=no1a\u0026ps=87d6e48a\u0026s=COMMON_RELATION_LIST\u0026sc=avatar\u0026shcp=65db1d19\u0026shp=30310797\u0026t=223449c4"
],
"url_prefix":null,
"width":720
},
"avatar_300x300":{
"height":720,
"uri":"tos-maliva-avt-0068/3f0889ea29ffae56fbb8ee22f2fc32dd",
"url_list":[
"https://p16-amd-va.tiktokcdn.com/tos-maliva-avt-0068/3f0889ea29ffae56fbb8ee22f2fc32dd~tplv-tiktokx-cropcenter-q:300:300:q70.heic?dr=9605\u0026idc=no1a\u0026ps=87d6e48a\u0026s=COMMON_RELATION_LIST\u0026sc=avatar\u0026shcp=65db1d19\u0026shp=30310797\u0026t=223449c4"
],
"url_prefix":null,
"width":720
},
"avatar_larger":{
"height":720,
"uri":"tos-maliva-avt-0068/3f0889ea29ffae56fbb8ee22f2fc32dd",
"url_list":[
"https://p16-amd-va.tiktokcdn.com/tos-maliva-avt-0068/3f0889ea29ffae56fbb8ee22f2fc32dd~tplv-tiktokx-cropcenter-q:1080:1080:q70.heic?dr=9608\u0026idc=no1a\u0026ps=87d6e48a\u0026s=COMMON_RELATION_LIST\u0026sc=avatar\u0026shcp=65db1d19\u0026shp=30310797\u0026t=223449c4"
],
"url_prefix":null,
"width":720
},
"avatar_medium":{
"height":720,
"uri":"tos-maliva-avt-0068/3f0889ea29ffae56fbb8ee22f2fc32dd",
"url_list":[
"https://p16-amd-va.tiktokcdn.com/tos-maliva-avt-0068/3f0889ea29ffae56fbb8ee22f2fc32dd~tplv-tiktokx-cropcenter-q:720:720:q70.heic?dr=9607\u0026idc=no1a\u0026ps=87d6e48a\u0026s=COMMON_RELATION_LIST\u0026sc=avatar\u0026shcp=65db1d19\u0026shp=30310797\u0026t=223449c4"
],
"url_prefix":null,
"width":720
},
"avatar_thumb":{
"height":720,
"uri":"tos-maliva-avt-0068/3f0889ea29ffae56fbb8ee22f2fc32dd",
"url_list":[
"https://p16-amd-va.tiktokcdn.com/tos-maliva-avt-0068/3f0889ea29ffae56fbb8ee22f2fc32dd~tplv-tiktokx-cropcenter-q:100:100:q70.heic?dr=9606\u0026idc=no1a\u0026ps=87d6e48a\u0026s=COMMON_RELATION_LIST\u0026sc=avatar\u0026shcp=65db1d19\u0026shp=30310797\u0026t=223449c4"
],
"url_prefix":null,
"width":720
},
"avatar_uri":"tos-maliva-avt-0068/3f0889ea29ffae56fbb8ee22f2fc32dd",
"aweme_count":0,
"bind_phone":"",
"bold_fields":null,
"can_message_follow_status_list":[
2
],
"can_set_geofencing":null,
"cha_list":null,
"comment_filter_status":0,
"comment_setting":0,
"commerce_user_level":0,
"cover_url":[],
"create_time":1740407006,
"custom_verify":"",
"cv_level":"",
"download_prompt_ts":0,
"download_setting":0,
"duet_setting":0,
"enabled_filter_all_comments":false,
"enterprise_verify_reason":"",
"events":null,
"fake_data_info":{},
"favoriting_count":0,
"fb_expire_time":0,
"follow_status":0,
"follower_count":0,
"follower_status":0,
"followers_detail":null,
"following_count":57,
"friends_status":0,
"geofencing":null,
"google_account":"",
"has_email":false,
"has_facebook_token":false,
"has_insights":false,
"has_orders":false,
"has_twitter_token":false,
"has_youtube_token":false,
"hide_search":false,
"homepage_bottom_toast":null,
"ins_id":"",
"is_ad_fake":false,
"is_block":false,
"is_discipline_member":false,
"is_mute":0,
"is_mute_lives":0,
"is_mute_non_story_post":0,
"is_mute_story":0,
"is_phone_binded":false,
"is_star":false,
"item_list":null,
"language":"en",
"live_agreement":0,
"live_commerce":false,
"live_verify":0,
"mention_status":1,
"mutual_relation_avatars":null,
"need_points":null,
"need_recommend":0,
"nickname":"iamfiras07",
"original_musician":{
"digg_count":0,
"music_count":0,
"music_used_count":0,
"new_release_clip_ids":null
},
"platform_sync_info":null,
"prevent_download":false,
"react_setting":0,
"region":"LY",
"relative_users":null,
"reply_with_video_flag":4,
"room_id":0,
"search_highlight":null,
"sec_uid":"MS4wLjABAAAAIdku9zVZVrkEOvQahQiMfE9AHJ_uTbTuyBM3BLl6TL06qGgPyQp6DKm8hdKEkvYR",
"secret":0,
"share_info":{
"now_invitation_card_image_urls":null,
"share_desc":"",
"share_desc_info":"",
"share_qrcode_url":{
"height":720,
"uri":"",
"url_list":[],
"url_prefix":null,
"width":720
},
"share_title":"",
"share_title_myself":"",
"share_title_other":"",
"share_url":""
},
"share_qrcode_uri":"",
"shield_comment_notice":0,
"shield_digg_notice":0,
"shield_edit_field_info":null,
"shield_follow_notice":0,
"short_id":"0",
"show_image_bubble":false,
"signature":"",
"special_account":{
"special_account_list":null
},
"special_lock":1,
"status":1,
"stitch_setting":0,
"story_status":0,
"total_favorited":0,
"tw_expire_time":0,
"twitter_id":"",
"twitter_name":"",
"type_label":null,
"uid":"7474990421404992518",
"unique_id":"iamfiras007",
"unique_id_modify_time":1740407102,
"user_canceled":false,
"user_mode":1,
"user_now_pack_info":{},
"user_period":0,
"user_profile_guide":null,
"user_rate":1,
"user_spark_info":{},
"user_tags":null,
"verification_type":1,
"verify_info":"",
"video_icon":{
"height":720,
"uri":"",
"url_list":[],
"url_prefix":null,
"width":720
},
"white_cover_url":null,
"with_commerce_entry":false,
"with_shop_entry":false,
"youtube_channel_id":"",
"youtube_channel_title":"",
"youtube_expire_time":0
}
]