Followers

Scrapes followers of a TikTok account

GET /v1/scrape/tiktok/followers

Followers

cURL

curl --request GET \
  --url https://api.sociavault.com/v1/scrape/tiktok/followers \
  --header 'X-API-Key: <api-key>'

200

full

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

200

application/json

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