Skip to main content
GET
/
v1
/
scrape
/
tiktok
/
following
Following
curl --request GET \
  --url https://api.sociavault.com/v1/scrape/tiktok/following \
  --header 'X-API-Key: <api-key>'
{
  "success": true,
  "data": {
    "success": true,
    "extra": {
      "fatal_item_ids": {},
      "logid": "2026020818240892EB5C0C655460834DAD",
      "now": 1770575049000
    },
    "followings": {
      "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-maliva-avt-0068/ba32b40a8c022fbb727c156f8a5a140c",
          "url_list": {
            "0": "https://p16-common-sign.tiktokcdn-eu.com/tos-maliva-avt-0068/ba32b40a8c022fbb727c156f8a5a140c~tplv-tiktokx-cropcenter-q:168:168:q70.heic?dr=9604&idc=no1a&ps=87d6e48a&refresh_token=6af99020&s=COMMON_RELATION_LIST&sc=avatar&shcp=65db1d19&shp=30310797&t=223449c4&x-expires=1770660000&x-signature=tFh1hjjgR3shaUpMvxkZvodeauM%3D",
            "1": "https://p19-common-sign.tiktokcdn-eu.com/tos-maliva-avt-0068/ba32b40a8c022fbb727c156f8a5a140c~tplv-tiktokx-cropcenter-q:168:168:q70.heic?dr=9604&idc=no1a&ps=87d6e48a&refresh_token=ec068d1b&s=COMMON_RELATION_LIST&sc=avatar&shcp=65db1d19&shp=30310797&t=223449c4&x-expires=1770660000&x-signature=Xw%2ByWZqY5HjMq2DnZb1V6brydFc%3D",
            "2": "https://p16-common-sign.tiktokcdn-eu.com/tos-maliva-avt-0068/ba32b40a8c022fbb727c156f8a5a140c~tplv-tiktokx-cropcenter-q:168:168:q70.webp?dr=9604&idc=no1a&ps=87d6e48a&refresh_token=ffbbecf3&s=COMMON_RELATION_LIST&sc=avatar&shcp=65db1d19&shp=30310797&t=223449c4&x-expires=1770660000&x-signature=zKq4if%2FdFOfqkfeIvtbjW5mWOME%3D"
          },
          "url_prefix": null,
          "width": 720
        },
        "avatar_300x300": {
          "height": 720,
          "uri": "tos-maliva-avt-0068/ba32b40a8c022fbb727c156f8a5a140c",
          "url_list": {
            "0": "https://p16-common-sign.tiktokcdn-eu.com/tos-maliva-avt-0068/ba32b40a8c022fbb727c156f8a5a140c~tplv-tiktokx-cropcenter-q:300:300:q70.heic?dr=9605&idc=no1a&ps=87d6e48a&refresh_token=432f5620&s=COMMON_RELATION_LIST&sc=avatar&shcp=65db1d19&shp=30310797&t=223449c4&x-expires=1770660000&x-signature=2%2FgZ9nOVFFzzGy6tLJHJUm0J86U%3D",
            "1": "https://p19-common-sign.tiktokcdn-eu.com/tos-maliva-avt-0068/ba32b40a8c022fbb727c156f8a5a140c~tplv-tiktokx-cropcenter-q:300:300:q70.heic?dr=9605&idc=no1a&ps=87d6e48a&refresh_token=a2f3c869&s=COMMON_RELATION_LIST&sc=avatar&shcp=65db1d19&shp=30310797&t=223449c4&x-expires=1770660000&x-signature=hi5muNd5bcHKAR5GadNufZl5GyQ%3D",
            "2": "https://p16-common-sign.tiktokcdn-eu.com/tos-maliva-avt-0068/ba32b40a8c022fbb727c156f8a5a140c~tplv-tiktokx-cropcenter-q:300:300:q70.webp?dr=9605&idc=no1a&ps=87d6e48a&refresh_token=d5434ba3&s=COMMON_RELATION_LIST&sc=avatar&shcp=65db1d19&shp=30310797&t=223449c4&x-expires=1770660000&x-signature=arFR3G3u7F6H%2FjEdLLKg38Ni%2BK8%3D"
          },
          "url_prefix": null,
          "width": 720
        },
        "avatar_larger": {
          "height": 720,
          "uri": "tos-maliva-avt-0068/ba32b40a8c022fbb727c156f8a5a140c",
          "url_list": {
            "0": "https://p16-common-sign.tiktokcdn-eu.com/tos-maliva-avt-0068/ba32b40a8c022fbb727c156f8a5a140c~tplv-tiktokx-cropcenter-q:1080:1080:q70.heic?dr=9608&idc=no1a&ps=87d6e48a&refresh_token=1ad6a8c0&s=COMMON_RELATION_LIST&sc=avatar&shcp=65db1d19&shp=30310797&t=223449c4&x-expires=1770660000&x-signature=CiTPOLq3i2wUVNZRr64JwsTOvcs%3D",
            "1": "https://p19-common-sign.tiktokcdn-eu.com/tos-maliva-avt-0068/ba32b40a8c022fbb727c156f8a5a140c~tplv-tiktokx-cropcenter-q:1080:1080:q70.heic?dr=9608&idc=no1a&ps=87d6e48a&refresh_token=abd3c08a&s=COMMON_RELATION_LIST&sc=avatar&shcp=65db1d19&shp=30310797&t=223449c4&x-expires=1770660000&x-signature=f0KU0%2Fk7W5WXLsn%2FmQdUk9jKHPU%3D",
            "2": "https://p16-common-sign.tiktokcdn-eu.com/tos-maliva-avt-0068/ba32b40a8c022fbb727c156f8a5a140c~tplv-tiktokx-cropcenter-q:1080:1080:q70.webp?dr=9608&idc=no1a&ps=87d6e48a&refresh_token=24c14081&s=COMMON_RELATION_LIST&sc=avatar&shcp=65db1d19&shp=30310797&t=223449c4&x-expires=1770660000&x-signature=sKeNU9d%2ByshRpcxUejfa40hi20w%3D"
          },
          "url_prefix": null,
          "width": 720
        },
        "avatar_medium": {
          "height": 720,
          "uri": "tos-maliva-avt-0068/ba32b40a8c022fbb727c156f8a5a140c",
          "url_list": {
            "0": "https://p16-common-sign.tiktokcdn-eu.com/tos-maliva-avt-0068/ba32b40a8c022fbb727c156f8a5a140c~tplv-tiktokx-cropcenter-q:720:720:q70.heic?dr=9607&idc=no1a&ps=87d6e48a&refresh_token=63b82e84&s=COMMON_RELATION_LIST&sc=avatar&shcp=65db1d19&shp=30310797&t=223449c4&x-expires=1770660000&x-signature=WwxYB2bMzVAJjXMeD%2FdxCdALbxg%3D",
            "1": "https://p19-common-sign.tiktokcdn-eu.com/tos-maliva-avt-0068/ba32b40a8c022fbb727c156f8a5a140c~tplv-tiktokx-cropcenter-q:720:720:q70.heic?dr=9607&idc=no1a&ps=87d6e48a&refresh_token=6181ddd9&s=COMMON_RELATION_LIST&sc=avatar&shcp=65db1d19&shp=30310797&t=223449c4&x-expires=1770660000&x-signature=I%2FEH5NEJt5XpL6tI5X%2FORJyBw9E%3D",
            "2": "https://p16-common-sign.tiktokcdn-eu.com/tos-maliva-avt-0068/ba32b40a8c022fbb727c156f8a5a140c~tplv-tiktokx-cropcenter-q:720:720:q70.webp?dr=9607&idc=no1a&ps=87d6e48a&refresh_token=c879569e&s=COMMON_RELATION_LIST&sc=avatar&shcp=65db1d19&shp=30310797&t=223449c4&x-expires=1770660000&x-signature=vS9WNsFWhk1ORNYPEgqJTF0gLH0%3D"
          },
          "url_prefix": null,
          "width": 720
        },
        "avatar_thumb": {
          "height": 720,
          "uri": "tos-maliva-avt-0068/ba32b40a8c022fbb727c156f8a5a140c",
          "url_list": {
            "0": "https://p16-common-sign.tiktokcdn-eu.com/tos-maliva-avt-0068/ba32b40a8c022fbb727c156f8a5a140c~tplv-tiktokx-cropcenter-q:100:100:q70.heic?dr=9606&idc=no1a&ps=87d6e48a&refresh_token=a3527369&s=COMMON_RELATION_LIST&sc=avatar&shcp=65db1d19&shp=30310797&t=223449c4&x-expires=1770660000&x-signature=0Sa0%2BGWctktp9QtNlhzydsFXjQ0%3D",
            "1": "https://p19-common-sign.tiktokcdn-eu.com/tos-maliva-avt-0068/ba32b40a8c022fbb727c156f8a5a140c~tplv-tiktokx-cropcenter-q:100:100:q70.heic?dr=9606&idc=no1a&ps=87d6e48a&refresh_token=8ae81a54&s=COMMON_RELATION_LIST&sc=avatar&shcp=65db1d19&shp=30310797&t=223449c4&x-expires=1770660000&x-signature=rqa4m2Pj6P2we3pKkGSy1IyqROA%3D",
            "2": "https://p16-common-sign.tiktokcdn-eu.com/tos-maliva-avt-0068/ba32b40a8c022fbb727c156f8a5a140c~tplv-tiktokx-cropcenter-q:100:100:q70.webp?dr=9606&idc=no1a&ps=87d6e48a&refresh_token=8690cc3b&s=COMMON_RELATION_LIST&sc=avatar&shcp=65db1d19&shp=30310797&t=223449c4&x-expires=1770660000&x-signature=VEIb0QGl7YVBR1vzvyTtJh2hey8%3D"
          },
          "url_prefix": null,
          "width": 720
        },
        "avatar_uri": "tos-maliva-avt-0068/ba32b40a8c022fbb727c156f8a5a140c",
        "aweme_count": 192,
        "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": 1546820065,
        "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": 76423,
        "fb_expire_time": 0,
        "follow_status": 0,
        "follower_count": 132309,
        "follower_status": 0,
        "followers_detail": null,
        "following_count": 969,
        "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": true,
        "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": "lizlanden",
        "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": "US",
        "relative_users": null,
        "reply_with_video_flag": 4,
        "room_id": 0,
        "search_highlight": null,
        "sec_uid": "MS4wLjABAAAAU-sIzbOwfvGSQ1bezj3DfFFszSz4mqutWSpNG6cptGdDWWWmWHzEg8HQTU-kQxzW",
        "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": "Tim Tebow\nlizlanden.co@gmail.com",
        "special_account": {
          "special_account_list": null
        },
        "special_lock": 1,
        "status": 1,
        "stitch_setting": 0,
        "total_favorited": 2675327,
        "tw_expire_time": 0,
        "twitter_id": "",
        "twitter_name": "",
        "type_label": null,
        "uid": "6620791754290315269",
        "unique_id": "glizzzerd",
        "unique_id_modify_time": 1770575049,
        "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": "2026020818240892EB5C0C655460834DAD"
    },
    "max_time": 1770575049,
    "min_time": 1734470383,
    "myself_user_id": "0",
    "next_page_token": "eyJtYXhfY3Vyc29yIjoxNzY5MTE0MjUzLCJtaW5fY3Vyc29yIjoxNzM0NDcwMzgzfQ==",
    "offset": 0,
    "rec_has_more": true,
    "status_code": 0,
    "status_msg": "",
    "total": 90
  },
  "credits_used": 1,
  "endpoint": "tiktok/following"
}
💳 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
required

TikTok handle

Example:

"stoolpresidente"

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