Skip to main content
GET
/
v1
/
scrape
/
tiktok
/
followers
Followers
curl --request GET \
  --url https://api.sociavault.com/v1/scrape/tiktok/followers \
  --header 'X-API-Key: <api-key>'
{
  "success": true,
  "data": {
    "success": true,
    "extra": {
      "fatal_item_ids": {},
      "logid": "20260208184005D6E4B83687F58A8A764B",
      "now": 1770576005000
    },
    "followers": {
      "0": {
        "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-no1a-avt-0068c001-no/b5ddadd9a94317e4c3642277f5077230",
          "url_list": {
            "0": "https://p16-common-sign.tiktokcdn-eu.com/tos-no1a-avt-0068c001-no/b5ddadd9a94317e4c3642277f5077230~tplv-tiktokx-cropcenter-q:168:168:q70.heic?dr=9604&idc=no1a&ps=87d6e48a&refresh_token=820322da&s=COMMON_RELATION_LIST&sc=avatar&shcp=65db1d19&shp=30310797&t=223449c4&x-expires=1770660000&x-signature=uENeCJysPkqMEV2ZIPY89CeCgV4%3D",
            "1": "https://p19-common-sign.tiktokcdn-eu.com/tos-no1a-avt-0068c001-no/b5ddadd9a94317e4c3642277f5077230~tplv-tiktokx-cropcenter-q:168:168:q70.heic?dr=9604&idc=no1a&ps=87d6e48a&refresh_token=cda25646&s=COMMON_RELATION_LIST&sc=avatar&shcp=65db1d19&shp=30310797&t=223449c4&x-expires=1770660000&x-signature=rCgX6LFj1oS%2BySGVkEbVQy40AJw%3D",
            "2": "https://p16-common-sign.tiktokcdn-eu.com/tos-no1a-avt-0068c001-no/b5ddadd9a94317e4c3642277f5077230~tplv-tiktokx-cropcenter-q:168:168:q70.webp?dr=9604&idc=no1a&ps=87d6e48a&refresh_token=718f164d&s=COMMON_RELATION_LIST&sc=avatar&shcp=65db1d19&shp=30310797&t=223449c4&x-expires=1770660000&x-signature=NKcekqSimfWY56Znm2sTi5trQQc%3D"
          },
          "url_prefix": null,
          "width": 720
        },
        "avatar_300x300": {
          "height": 720,
          "uri": "tos-no1a-avt-0068c001-no/b5ddadd9a94317e4c3642277f5077230",
          "url_list": {
            "0": "https://p16-common-sign.tiktokcdn-eu.com/tos-no1a-avt-0068c001-no/b5ddadd9a94317e4c3642277f5077230~tplv-tiktokx-cropcenter-q:300:300:q70.heic?dr=9605&idc=no1a&ps=87d6e48a&refresh_token=36c6b556&s=COMMON_RELATION_LIST&sc=avatar&shcp=65db1d19&shp=30310797&t=223449c4&x-expires=1770660000&x-signature=lXjMWxzTm%2FDNVngQDg8loz62pDY%3D",
            "1": "https://p19-common-sign.tiktokcdn-eu.com/tos-no1a-avt-0068c001-no/b5ddadd9a94317e4c3642277f5077230~tplv-tiktokx-cropcenter-q:300:300:q70.heic?dr=9605&idc=no1a&ps=87d6e48a&refresh_token=b15d075d&s=COMMON_RELATION_LIST&sc=avatar&shcp=65db1d19&shp=30310797&t=223449c4&x-expires=1770660000&x-signature=IG0N33tZcESB9qz4ElLFmmtTGdc%3D",
            "2": "https://p16-common-sign.tiktokcdn-eu.com/tos-no1a-avt-0068c001-no/b5ddadd9a94317e4c3642277f5077230~tplv-tiktokx-cropcenter-q:300:300:q70.webp?dr=9605&idc=no1a&ps=87d6e48a&refresh_token=8937b0a2&s=COMMON_RELATION_LIST&sc=avatar&shcp=65db1d19&shp=30310797&t=223449c4&x-expires=1770660000&x-signature=iw2URTYlZ9hUFzovTLQmxOF78Cs%3D"
          },
          "url_prefix": null,
          "width": 720
        },
        "avatar_larger": {
          "height": 720,
          "uri": "tos-no1a-avt-0068c001-no/b5ddadd9a94317e4c3642277f5077230",
          "url_list": {
            "0": "https://p16-common-sign.tiktokcdn-eu.com/tos-no1a-avt-0068c001-no/b5ddadd9a94317e4c3642277f5077230~tplv-tiktokx-cropcenter-q:1080:1080:q70.heic?dr=9608&idc=no1a&ps=87d6e48a&refresh_token=4cca3d45&s=COMMON_RELATION_LIST&sc=avatar&shcp=65db1d19&shp=30310797&t=223449c4&x-expires=1770660000&x-signature=pspDxqnSmVRu%2FzZPKS7RR0KsS1I%3D",
            "1": "https://p19-common-sign.tiktokcdn-eu.com/tos-no1a-avt-0068c001-no/b5ddadd9a94317e4c3642277f5077230~tplv-tiktokx-cropcenter-q:1080:1080:q70.heic?dr=9608&idc=no1a&ps=87d6e48a&refresh_token=d23f30ea&s=COMMON_RELATION_LIST&sc=avatar&shcp=65db1d19&shp=30310797&t=223449c4&x-expires=1770660000&x-signature=AFI0m%2FGSp%2BIb3UnsxmMzDJ0%2FVy8%3D",
            "2": "https://p16-common-sign.tiktokcdn-eu.com/tos-no1a-avt-0068c001-no/b5ddadd9a94317e4c3642277f5077230~tplv-tiktokx-cropcenter-q:1080:1080:q70.webp?dr=9608&idc=no1a&ps=87d6e48a&refresh_token=58fb1d30&s=COMMON_RELATION_LIST&sc=avatar&shcp=65db1d19&shp=30310797&t=223449c4&x-expires=1770660000&x-signature=MAdtIqi%2BNkMIV4QU9BmWuS1%2F3cY%3D"
          },
          "url_prefix": null,
          "width": 720
        },
        "avatar_medium": {
          "height": 720,
          "uri": "tos-no1a-avt-0068c001-no/b5ddadd9a94317e4c3642277f5077230",
          "url_list": {
            "0": "https://p16-common-sign.tiktokcdn-eu.com/tos-no1a-avt-0068c001-no/b5ddadd9a94317e4c3642277f5077230~tplv-tiktokx-cropcenter-q:720:720:q70.heic?dr=9607&idc=no1a&ps=87d6e48a&refresh_token=cae341c9&s=COMMON_RELATION_LIST&sc=avatar&shcp=65db1d19&shp=30310797&t=223449c4&x-expires=1770660000&x-signature=hq%2FAjW0K6KONPsF4iA%2BxPOcrfPQ%3D",
            "1": "https://p19-common-sign.tiktokcdn-eu.com/tos-no1a-avt-0068c001-no/b5ddadd9a94317e4c3642277f5077230~tplv-tiktokx-cropcenter-q:720:720:q70.heic?dr=9607&idc=no1a&ps=87d6e48a&refresh_token=547f36d2&s=COMMON_RELATION_LIST&sc=avatar&shcp=65db1d19&shp=30310797&t=223449c4&x-expires=1770660000&x-signature=9Ug7uBsiL0EgX3dQNukQYlTasaM%3D",
            "2": "https://p16-common-sign.tiktokcdn-eu.com/tos-no1a-avt-0068c001-no/b5ddadd9a94317e4c3642277f5077230~tplv-tiktokx-cropcenter-q:720:720:q70.webp?dr=9607&idc=no1a&ps=87d6e48a&refresh_token=eea80cd3&s=COMMON_RELATION_LIST&sc=avatar&shcp=65db1d19&shp=30310797&t=223449c4&x-expires=1770660000&x-signature=mfl%2FAQIc2KdHso0WI4RdRGJMBM4%3D"
          },
          "url_prefix": null,
          "width": 720
        },
        "avatar_thumb": {
          "height": 720,
          "uri": "tos-no1a-avt-0068c001-no/b5ddadd9a94317e4c3642277f5077230",
          "url_list": {
            "0": "https://p16-common-sign.tiktokcdn-eu.com/tos-no1a-avt-0068c001-no/b5ddadd9a94317e4c3642277f5077230~tplv-tiktokx-cropcenter-q:100:100:q70.heic?dr=9606&idc=no1a&ps=87d6e48a&refresh_token=80ffcf4d&s=COMMON_RELATION_LIST&sc=avatar&shcp=65db1d19&shp=30310797&t=223449c4&x-expires=1770660000&x-signature=X3HR13vFNnLKiFTpOnLtOs122lU%3D",
            "1": "https://p19-common-sign.tiktokcdn-eu.com/tos-no1a-avt-0068c001-no/b5ddadd9a94317e4c3642277f5077230~tplv-tiktokx-cropcenter-q:100:100:q70.heic?dr=9606&idc=no1a&ps=87d6e48a&refresh_token=99b13bc7&s=COMMON_RELATION_LIST&sc=avatar&shcp=65db1d19&shp=30310797&t=223449c4&x-expires=1770660000&x-signature=tV7yknpiAICugq5DXqBMusKe7Ws%3D",
            "2": "https://p16-common-sign.tiktokcdn-eu.com/tos-no1a-avt-0068c001-no/b5ddadd9a94317e4c3642277f5077230~tplv-tiktokx-cropcenter-q:100:100:q70.webp?dr=9606&idc=no1a&ps=87d6e48a&refresh_token=25d84808&s=COMMON_RELATION_LIST&sc=avatar&shcp=65db1d19&shp=30310797&t=223449c4&x-expires=1770660000&x-signature=BIXpbJOjELmsZrTUT1C%2BIQlESek%3D"
          },
          "url_prefix": null,
          "width": 720
        },
        "avatar_uri": "tos-no1a-avt-0068c001-no/b5ddadd9a94317e4c3642277f5077230",
        "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": 1591245126,
        "custom_verify": "",
        "cv_level": "",
        "download_prompt_ts": 0,
        "download_setting": 3,
        "duet_setting": 1,
        "enabled_filter_all_comments": false,
        "enterprise_verify_reason": "",
        "events": null,
        "fake_data_info": {},
        "favoriting_count": 239116,
        "fb_expire_time": 0,
        "follow_status": 0,
        "follower_count": 266,
        "follower_status": 0,
        "followers_detail": null,
        "following_count": 2499,
        "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": "Lleeson",
        "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": "GB",
        "relative_users": null,
        "reply_with_video_flag": 4,
        "room_id": 0,
        "search_highlight": null,
        "sec_uid": "MS4wLjABAAAAqww8izvea3-i9c81zoclj3WL1E3tC3l4Y3RI3Z9b68Vdj09DUguJ5DhuVEJbIFCZ",
        "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": 1,
        "total_favorited": 0,
        "tw_expire_time": 0,
        "twitter_id": "",
        "twitter_name": "",
        "type_label": null,
        "uid": "6810678927758476294",
        "unique_id": "lleeson01",
        "unique_id_modify_time": 1770576005,
        "user_canceled": false,
        "user_mode": 1,
        "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
      }
    },
    "has_more": true,
    "log_pb": {
      "impr_id": "20260208184005D6E4B83687F58A8A764B"
    },
    "max_time": 1770576005,
    "min_time": 1770573007,
    "myself_user_id": "0",
    "next_page_token": "eyJtYXhfY3Vyc29yIjoxNzcwNTc1OTQyLCJtaW5fY3Vyc29yIjoxNzcwNTczMDA3fQ==",
    "offset": 0,
    "status_code": 0,
    "status_msg": "",
    "total": 4567709
  },
  "credits_used": 1,
  "endpoint": "tiktok/followers"
}
💳 1 credit per request

Authorizations

​
X-API-Key
string
header
required

API key for authentication. Format: sk_live_xxxxxxxxxxxxx

Get your API key from the Dashboard.

Query Parameters

​
handle
string

TikTok handle

Example:

"stoolpresidente"

​
user_id
string

User id. Use this for faster response times.

Example:

"6659752019493208069"

​
min_time
integer

Used to paginate. Get 'min_time' from previous response.

Example:

1605663376

​
trim
boolean

Set to true to get a trimmed response

Response

Successful response

Key Response Fields:

  • data.followers[].unique_id: Follower's TikTok username
  • data.followers[].nickname: Follower's display name
  • data.followers[].uid: Follower's numeric ID
  • data.followers[].sec_uid: Follower's secure user ID (use for profile lookups)
  • data.followers[].signature: Follower's bio
  • data.followers[].follower_count: Follower's own follower count
  • data.followers[].following_count: Follower's following count
  • data.followers[].total_favorited: Total likes received across all videos
  • data.followers[].aweme_count: Number of videos posted
  • data.followers[].favoriting_count: Number of videos they've liked
  • data.followers[].avatar_larger.url_list[0]: Profile picture (high-res)
  • data.followers[].avatar_medium.url_list[0]: Profile picture (medium)
  • data.followers[].region: 2-letter country code
  • data.followers[].verification_type: Verification status (1 = verified)
  • data.followers[].create_time: Account creation Unix timestamp
  • data.total: Total number of followers
  • data.has_more: Whether more results are available
  • data.min_time: Pagination cursor — pass as min_time parameter to get the next page