DEV Community

tokinsight
tokinsight

Posted on • Edited on

How to Scrape TikTok User Follower and Following Data via TokInsight Free API

#tiktok #webscraping #datascience #api

πŸš€ Overview

TokInsight is a powerful TikTok API platform that provides comprehensive data insights and original data for TikTok content creators, marketers, and businesses. Our platform offers real-time access to TikTok's vast data ecosystem through a robust REST API. Including :

  • Profile, Device, Video, Music, Comment, Hashtag, Collection(Mix), Trending, Search, Live, Shop, Place, Effect, etc.
  • All apis are mobile versions

πŸ“ž Contact

✨ User Follower and Following API Overview

/tok/v1/user_following/

  • Get user's following list if it's public.

User follower

resp:

{
  "log_pb": {
    "impr_id": "20250713012626085***********"
  },
  "status_code": 3002060,
  "status_msg": "Profile user is hiding following list"
}
Enter fullscreen mode Exit fullscreen mode

it's unpublic.

another uid resp: you can get each followings about the user:

  • the following account info including: uid, sec_uid, unique_id, signature, room_id, seller_id, etc... 
{
    "extra": {
      "fatal_item_ids": [],
      "logid": "2025071217471***********"
    },
    "followings": [
      {
        "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-alisg-avt-0068/5ed6f2a03aeeed9ddc453ea24b068975",
          "url_list": [
            "https://p9-sg.tiktokcdn.com/tos-alisg-avt-0068/5ed6f2a03aeeed9ddc453ea24b068975~tplv-tiktokx-cropcenter-q:168:168:q70.webp?dr=18262&idc=maliva&ps=87d6e48a&s=COMMON_RELATION_LIST&sc=avatar&shcp=65db1d19&shp=30310797&t=223449c4"
          ],
          "url_prefix": null,
          "width": 720
        },
        "avatar_300x300": {
          "height": 720,
          "uri": "tos-alisg-avt-0068/5ed6f2a03aeeed9ddc453ea24b068975",
          "url_list": [
            "https://p16-sign-sg.tiktokcdn.com/tos-alisg-avt-0068/5ed6f2a03aeeed9ddc453ea24b068975~tplv-tiktokx-cropcenter-q:300:300:q70.webp?dr=10793&idc=maliva&ps=87d6e48a&refresh_token=6a8764f0&s=COMMON_RELATION_LIST&sc=avatar&shcp=65db1d19&shp=30310797&t=223449c4&x-expires=1752397200&x-signature=zRJDf4rQ%2Bxot9tYRtW0sWWQkT%2FI%3D"
          ],
          "url_prefix": null,
          "width": 720
        },
        "avatar_larger": {
          "height": 720,
          "uri": "tos-alisg-avt-0068/5ed6f2a03aeeed9ddc453ea24b068975",
          "url_list": [
            "https://p9-sg.tiktokcdn.com/tos-alisg-avt-0068/5ed6f2a03aeeed9ddc453ea24b068975~tplv-tiktokx-cropcenter-q:1080:1080:q70.webp?dr=18261&idc=maliva&ps=87d6e48a&s=COMMON_RELATION_LIST&sc=avatar&shcp=65db1d19&shp=30310797&t=223449c4"
          ],
          "url_prefix": null,
          "width": 720
        },
        "avatar_medium": {
          "height": 720,
          "uri": "tos-alisg-avt-0068/5ed6f2a03aeeed9ddc453ea24b068975",
          "url_list": [
            "https://p16-sign-sg.tiktokcdn.com/tos-alisg-avt-0068/5ed6f2a03aeeed9ddc453ea24b068975~tplv-tiktokx-cropcenter-q:720:720:q70.webp?dr=10795&idc=maliva&ps=87d6e48a&refresh_token=13614df8&s=COMMON_RELATION_LIST&sc=avatar&shcp=65db1d19&shp=30310797&t=223449c4&x-expires=1752397200&x-signature=9FGRmjUt97FDjnFQNNRBBe8o4uA%3D"
          ],
          "url_prefix": null,
          "width": 720
        },
        "avatar_thumb": {
          "height": 720,
          "uri": "tos-alisg-avt-0068/5ed6f2a03aeeed9ddc453ea24b068975",
          "url_list": [
            "https://p16-sign-sg.tiktokcdn.com/tos-alisg-avt-0068/5ed6f2a03aeeed9ddc453ea24b068975~tplv-tiktokx-cropcenter-q:100:100:q70.webp?dr=10794&idc=maliva&ps=87d6e48a&refresh_token=370a8255&s=COMMON_RELATION_LIST&sc=avatar&shcp=65db1d19&shp=30310797&t=223449c4&x-expires=1752397200&x-signature=PZyLF%2BBzFu8yhLac9jriczPHIyA%3D"
          ],
          "url_prefix": null,
          "width": 720
        },
        "avatar_uri": "tos-alisg-avt-0068/5ed6f2a03aeeed9ddc453ea24b068975",
        "aweme_count": 471,
        "bind_phone": "",
        "bold_fields": null,
        "can_message_follow_status_list": null,
        "can_set_geofencing": null,
        "cha_list": null,
        "comment_filter_status": 0,
        "comment_setting": 0,
        "commerce_user_level": 0,
        "cover_url": [],
        "create_time": 1535490792,
        "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": 76439,
        "fb_expire_time": 0,
        "follow_status": 0,
        "follower_count": 173119,
        "follower_status": 0,
        "followers_detail": null,
        "following_count": 836,
        "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": "vi",
        "live_agreement": 0,
        "live_commerce": false,
        "live_verify": 0,
        "mention_status": 1,
        "mutual_relation_avatars": null,
        "need_points": null,
        "need_recommend": 0,
        "nickname": "HoΓ ng Hippie",
        "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": "VN",
        "relative_users": null,
        "reply_with_video_flag": 4,
        "room_id": 0,
        "search_highlight": null,
        "sec_uid": "MS4wLjABAAAALs2AkCPZvTPqJoYs0rIupYY6CLIWgKSCTIosMU8ovvSmCF8iU9Wq-Y2g92Dz_S65",
        "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": "Sα»‘ng khỏe,sα»‘ng Δ‘αΊΉp, thuαΊ­n tα»± nhiΓͺn",
        "special_account": {
          "special_account_list": null
        },
        "special_lock": 1,
        "status": 1,
        "stitch_setting": 0,
        "total_favorited": 3080439,
        "tw_expire_time": 0,
        "twitter_id": "",
        "twitter_name": "",
        "type_label": null,
        "uid": "6594396064023003138",
        "unique_id": "hoanghippie444",
        "unique_id_modify_time": 1752313635,
        "user_canceled": false,
        "user_mode": 1,
        "user_period": 0,
        "user_profile_guide": null,
        "user_rate": 1,
        "user_spark_info": {},
        "user_tags": null,
        "verification_type": 0,
        "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
      }
      ...
    ],
    "has_more": false,
    "log_pb": {
      "impr_id": "2025071217471***********"
    },
    "max_time": 1752313635,
    "min_time": 1735205190,
    "myself_user_id": "0",
    "next_page_token": "eyJtYXhfY3Vyc29yIjoxNzQ5MTEyNDMwLCJtaW5fY3Vyc29yIjoxNzM1MjA1MTkwfQ==",
    "offset": 0,
    "rec_has_more": false,
    "status_code": 0,
    "status_msg": "",
    "total": 12
  }
Enter fullscreen mode Exit fullscreen mode

/tok/v1/user_follower/

  • Get user's followers list if it's public.

example: input uid, offset and count

curl --request GET \
    --url 'https://tokinsight1.p.rapidapi.com/tok/v1/user_follower/?uid=7154462326077277189&count=20&offset=0' \
    --header 'x-proxy-server: http://user:pass@host:port' \
    --header 'x-rapidapi-host: tokinsight1.p.rapidapi.com' \
    --header 'x-rapidapi-key: your_rapidapi_key'
Enter fullscreen mode Exit fullscreen mode

another uid resp: you can get each following about the user:

  • the followers account: uid, sec_uid, unique_id, signature, room_id, seller_id, etc... 
{
  "extra": {
    "fatal_item_ids": [],
    "logid": "202507130134************"
  },
  "followers": [
    {
      "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/6ae7a7ff92565320bebf350cd095457b",
        "url_list": [
          "https://p16-amd-va.tiktokcdn.com/tos-maliva-avt-0068/6ae7a7ff92565320bebf350cd095457b~tplv-tiktokx-cropcenter-q:168:168:q70.heic?dr=18262&idc=maliva&ps=87d6e48a&s=COMMON_RELATION_LIST&sc=avatar&shcp=65db1d19&shp=30310797&t=223449c4",
          "https://p16-amd-va.tiktokcdn.com/tos-maliva-avt-0068/6ae7a7ff92565320bebf350cd095457b~tplv-tiktokx-cropcenter-q:168:168:q70.webp?dr=18262&idc=maliva&ps=87d6e48a&s=COMMON_RELATION_LIST&sc=avatar&shcp=65db1d19&shp=30310797&t=223449c4"
        ],
        "url_prefix": null,
        "width": 720
      },
      "avatar_300x300": {
        "height": 720,
        "uri": "tos-maliva-avt-0068/6ae7a7ff92565320bebf350cd095457b",
        "url_list": [
          "https://p16-sign-va.tiktokcdn.com/tos-maliva-avt-0068/6ae7a7ff92565320bebf350cd095457b~tplv-tiktokx-cropcenter-q:300:300:q70.heic?dr=10793&idc=maliva&ps=87d6e48a&refresh_token=ef6926ea&s=COMMON_RELATION_LIST&sc=avatar&shcp=65db1d19&shp=30310797&t=223449c4&x-expires=1752426000&x-signature=yDYZsN0tViqStYt3tQnFnQRHU3c%3D",
          "https://p16-sign-va.tiktokcdn.com/tos-maliva-avt-0068/6ae7a7ff92565320bebf350cd095457b~tplv-tiktokx-cropcenter-q:300:300:q70.webp?dr=10793&idc=maliva&ps=87d6e48a&refresh_token=01ef9fe2&s=COMMON_RELATION_LIST&sc=avatar&shcp=65db1d19&shp=30310797&t=223449c4&x-expires=1752426000&x-signature=ypszfaZLXity9Wgun%2FLAmbXo240%3D"
        ],
        "url_prefix": null,
        "width": 720
      },
      "avatar_larger": {
        "height": 720,
        "uri": "tos-maliva-avt-0068/6ae7a7ff92565320bebf350cd095457b",
        "url_list": [
          "https://p16-amd-va.tiktokcdn.com/tos-maliva-avt-0068/6ae7a7ff92565320bebf350cd095457b~tplv-tiktokx-cropcenter-q:1080:1080:q70.heic?dr=18261&idc=maliva&ps=87d6e48a&s=COMMON_RELATION_LIST&sc=avatar&shcp=65db1d19&shp=30310797&t=223449c4",
          "https://p16-amd-va.tiktokcdn.com/tos-maliva-avt-0068/6ae7a7ff92565320bebf350cd095457b~tplv-tiktokx-cropcenter-q:1080:1080:q70.webp?dr=18261&idc=maliva&ps=87d6e48a&s=COMMON_RELATION_LIST&sc=avatar&shcp=65db1d19&shp=30310797&t=223449c4"
        ],
        "url_prefix": null,
        "width": 720
      },
      "avatar_medium": {
        "height": 720,
        "uri": "tos-maliva-avt-0068/6ae7a7ff92565320bebf350cd095457b",
        "url_list": [
          "https://p16-sign-va.tiktokcdn.com/tos-maliva-avt-0068/6ae7a7ff92565320bebf350cd095457b~tplv-tiktokx-cropcenter-q:720:720:q70.heic?dr=10795&idc=maliva&ps=87d6e48a&refresh_token=af404453&s=COMMON_RELATION_LIST&sc=avatar&shcp=65db1d19&shp=30310797&t=223449c4&x-expires=1752426000&x-signature=TjqTdPZ4mrLuZYgKR7ebCnLkk6k%3D",
          "https://p16-sign-va.tiktokcdn.com/tos-maliva-avt-0068/6ae7a7ff92565320bebf350cd095457b~tplv-tiktokx-cropcenter-q:720:720:q70.webp?dr=10795&idc=maliva&ps=87d6e48a&refresh_token=2ee5e923&s=COMMON_RELATION_LIST&sc=avatar&shcp=65db1d19&shp=30310797&t=223449c4&x-expires=1752426000&x-signature=KpZSALcULNzQPYHSPnmoV2PGcP8%3D"
        ],
        "url_prefix": null,
        "width": 720
      },
      "avatar_thumb": {
        "height": 720,
        "uri": "tos-maliva-avt-0068/6ae7a7ff92565320bebf350cd095457b",
        "url_list": [
          "https://p16-sign-va.tiktokcdn.com/tos-maliva-avt-0068/6ae7a7ff92565320bebf350cd095457b~tplv-tiktokx-cropcenter-q:100:100:q70.heic?dr=10794&idc=maliva&ps=87d6e48a&refresh_token=5d721cea&s=COMMON_RELATION_LIST&sc=avatar&shcp=65db1d19&shp=30310797&t=223449c4&x-expires=1752426000&x-signature=dOFA4q%2B%2FuLcZGh9UAVAkxWSnug0%3D",
          "https://p16-sign-va.tiktokcdn.com/tos-maliva-avt-0068/6ae7a7ff92565320bebf350cd095457b~tplv-tiktokx-cropcenter-q:100:100:q70.webp?dr=10794&idc=maliva&ps=87d6e48a&refresh_token=107bec29&s=COMMON_RELATION_LIST&sc=avatar&shcp=65db1d19&shp=30310797&t=223449c4&x-expires=1752426000&x-signature=oeuLvla22jQI4Ngat7ruXGRtAOQ%3D"
        ],
        "url_prefix": null,
        "width": 720
      },
      "avatar_uri": "tos-maliva-avt-0068/6ae7a7ff92565320bebf350cd095457b",
      "aweme_count": 0,
      "bind_phone": "",
      "bold_fields": null,
      "can_message_follow_status_list": null,
      "can_set_geofencing": null,
      "cha_list": null,
      "comment_filter_status": 0,
      "comment_setting": 0,
      "commerce_user_level": 0,
      "cover_url": [],
      "create_time": 1744033073,
      "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": 3327,
      "fb_expire_time": 0,
      "follow_status": 0,
      "follower_count": 9,
      "follower_status": 0,
      "followers_detail": null,
      "following_count": 1370,
      "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": "es",
      "live_agreement": 0,
      "live_commerce": false,
      "live_verify": 0,
      "mention_status": 1,
      "mutual_relation_avatars": null,
      "need_points": null,
      "need_recommend": 0,
      "nickname": "Guillermolimon",
      "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": "MX",
      "relative_users": null,
      "reply_with_video_flag": 4,
      "room_id": 0,
      "search_highlight": null,
      "sec_uid": "MS4wLjABAAAApa-f-TREVYf0-8oD-pjWznPd89dhGzQ9u6VUppjZncUU6ytai9XDIIfbTI51dTrq",
      "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,
      "total_favorited": 0,
      "tw_expire_time": 0,
      "twitter_id": "",
      "twitter_name": "",
      "type_label": null,
      "uid": "7483241924627825682",
      "unique_id": "guillermolimon607",
      "unique_id_modify_time": 1752341658,
      "user_canceled": false,
      "user_mode": 1,
      "user_period": 0,
      "user_profile_guide": null,
      "user_rate": 1,
      "user_spark_info": {},
      "user_tags": null,
      "verification_type": 0,
      "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
    },
    ...
  ],
  "has_more": true,
  "log_pb": {
    "impr_id": "202507130134************"
  },
  "max_time": 1752341658,
  "min_time": 1752341545,
  "myself_user_id": "0",
  "next_page_token": "eyJtYXhfY3Vyc29yIjoxNzUyMzQxNTg5LCJtaW5fY3Vyc29yIjoxNzUyMzQxNTQ1fQ==",
  "offset": 0,
  "status_code": 0,
  "status_msg": "",
  "total": 2814965
}
Enter fullscreen mode Exit fullscreen mode

Top comments (0)