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

{
  "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
  }
]