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: | 🎹️ Fast TikTok API | 📹️ TikTok Trend API | 🔍️ TikTok Search API | |:-------------------------------------------------------------------------|:------------------------------------------------------------------------|:------------------------------------------------------------------------------| | 🧛️ TikTok User API | 🧛️ TikTok User Info API | #️ TikTok Hashtag API | | 🛍️ TikTok Shop API | 👤️ TikTok Followers API | ⚡️ TikTok Scraper (pay-per-result) | | 💬 TikTok Comment API | 🎶 TikTok Music API | 🎶 TikTok Music Trend API | | 🐦 Twitter - X.com Scraper | | | ## 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: | FIELD | Type | | Description | | | |----------------------------------|----------|:----|----------------------------------------------------------|-----|-----| | username (default: nickiminai) | String | | 👨 Scrape by username. Ex: nike | | | | userId | String | | 🔢 Scrape by uid. Ex: 6714563164218679553 | | | | url | String | | 🔗 Scrape by URL. Ex: https://www.tiktok.com/@nickiminai | | | | idsOnly | boolean | | Only retrieve TikTok user's ID. See output for example | | | | limit | integer | | 💯 Number of followers | | | ## 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 json { "username": "nickiminai" } ### 2. Retrieve Followers using URL json { "url": "[https://www.tiktok.com/@someuser](https://www.google.com/search?q=https://www.tiktok.com/%40someuser)" } ### 2. Retrieve Followers using User ID json { "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: json [ { "sec_uid": "MS4wLjABAAAATFbl0lBqRW9sxQQIdCoORUCt13odopf8FA9brDDALygTCe-S4I1ayPvShGD5pvFS" "uid": "7026400295186596870" } ] Full information: json [ { "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 } ]