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