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>'
{
  "extra": {
    "fatal_item_ids": [
      "<unknown>"
    ],
    "logid": "20250124204255DF10EF0B3DCDCC019D10",
    "now": 1737751376000
  },
  "followers": [
    {
      "accept_private_policy": false,
      "account_region": "",
      "apple_account": 0,
      "authority_status": 0,
      "avatar_168x168": {
        "height": 720,
        "uri": "tos-no1a-avt-0068c001-no/5e1cb895c26c2444bacc407a5b3d9ce3",
        "url_list": [
          "https://p16-pu-no.tiktokcdn-eu.com/tos-no1a-avt-0068c001-no/5e1cb895c26c2444bacc407a5b3d9ce3~tplv-tiktokx-cropcenter-q:168:168:q75.webp?dr=9604&idc=no1a&ps=87d6e48a&s=COMMON_RELATION_LIST&sc=avatar&shcp=65db1d19&shp=30310797&t=223449c4"
        ],
        "width": 720,
        "url_prefix": "<unknown>"
      },
      "avatar_300x300": {
        "height": 720,
        "uri": "tos-no1a-avt-0068c001-no/5e1cb895c26c2444bacc407a5b3d9ce3",
        "url_list": [
          "https://p16-pu-no.tiktokcdn-eu.com/tos-no1a-avt-0068c001-no/5e1cb895c26c2444bacc407a5b3d9ce3~tplv-tiktokx-cropcenter-q:300:300:q75.webp?dr=9605&idc=no1a&ps=87d6e48a&s=COMMON_RELATION_LIST&sc=avatar&shcp=65db1d19&shp=30310797&t=223449c4"
        ],
        "width": 720,
        "url_prefix": "<unknown>"
      },
      "avatar_larger": {
        "height": 720,
        "uri": "tos-no1a-avt-0068c001-no/5e1cb895c26c2444bacc407a5b3d9ce3",
        "url_list": [
          "https://p16-pu-no.tiktokcdn-eu.com/tos-no1a-avt-0068c001-no/5e1cb895c26c2444bacc407a5b3d9ce3~tplv-tiktokx-cropcenter-q:1080:1080:q75.webp?dr=9608&idc=no1a&ps=87d6e48a&s=COMMON_RELATION_LIST&sc=avatar&shcp=65db1d19&shp=30310797&t=223449c4"
        ],
        "width": 720,
        "url_prefix": "<unknown>"
      },
      "avatar_medium": {
        "height": 720,
        "uri": "tos-no1a-avt-0068c001-no/5e1cb895c26c2444bacc407a5b3d9ce3",
        "url_list": [
          "https://p16-pu-no.tiktokcdn-eu.com/tos-no1a-avt-0068c001-no/5e1cb895c26c2444bacc407a5b3d9ce3~tplv-tiktokx-cropcenter-q:720:720:q75.webp?dr=9607&idc=no1a&ps=87d6e48a&s=COMMON_RELATION_LIST&sc=avatar&shcp=65db1d19&shp=30310797&t=223449c4"
        ],
        "width": 720,
        "url_prefix": "<unknown>"
      },
      "avatar_thumb": {
        "height": 720,
        "uri": "tos-no1a-avt-0068c001-no/5e1cb895c26c2444bacc407a5b3d9ce3",
        "url_list": [
          "https://p16-pu-no.tiktokcdn-eu.com/tos-no1a-avt-0068c001-no/5e1cb895c26c2444bacc407a5b3d9ce3~tplv-tiktokx-cropcenter-q:100:100:q75.webp?dr=9606&idc=no1a&ps=87d6e48a&s=COMMON_RELATION_LIST&sc=avatar&shcp=65db1d19&shp=30310797&t=223449c4"
        ],
        "width": 720,
        "url_prefix": "<unknown>"
      },
      "avatar_uri": "tos-no1a-avt-0068c001-no/5e1cb895c26c2444bacc407a5b3d9ce3",
      "aweme_count": 0,
      "bind_phone": "",
      "can_message_follow_status_list": [
        2
      ],
      "comment_filter_status": 0,
      "comment_setting": 0,
      "commerce_user_level": 0,
      "cover_url": [
        "<unknown>"
      ],
      "create_time": 1737671784,
      "custom_verify": "",
      "cv_level": "",
      "download_prompt_ts": 0,
      "download_setting": 3,
      "duet_setting": 0,
      "enabled_filter_all_comments": false,
      "enterprise_verify_reason": "",
      "fake_data_info": {},
      "favoriting_count": 0,
      "fb_expire_time": 0,
      "follow_status": 0,
      "follower_count": 0,
      "follower_status": 0,
      "following_count": 5,
      "friends_status": 0,
      "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,
      "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,
      "language": "fr",
      "live_agreement": 0,
      "live_commerce": false,
      "live_verify": 0,
      "mention_status": 1,
      "need_recommend": 0,
      "nickname": "Jamal Voyage",
      "original_musician": {
        "digg_count": 0,
        "music_count": 0,
        "music_used_count": 0,
        "new_release_clip_ids": "<unknown>"
      },
      "prevent_download": false,
      "react_setting": 0,
      "region": "DZ",
      "reply_with_video_flag": 4,
      "room_id": 0,
      "sec_uid": "MS4wLjABAAAAUleysic3f_A1ewqwn-lVlTHezlxxDcEt7X1Py0ohks-CzQ6qjHcZIhb1gtVNL4fy",
      "secret": 0,
      "share_info": {
        "share_desc": "",
        "share_desc_info": "",
        "share_qrcode_url": {
          "height": 720,
          "uri": "",
          "url_list": [
            "<unknown>"
          ],
          "width": 720,
          "url_prefix": "<unknown>"
        },
        "share_title": "",
        "share_title_myself": "",
        "share_title_other": "",
        "share_url": "",
        "now_invitation_card_image_urls": "<unknown>"
      },
      "share_qrcode_uri": "",
      "shield_comment_notice": 0,
      "shield_digg_notice": 0,
      "shield_follow_notice": 0,
      "short_id": "0",
      "show_image_bubble": false,
      "signature": "",
      "special_account": {
        "special_account_list": "<unknown>"
      },
      "special_lock": 1,
      "status": 1,
      "stitch_setting": 0,
      "story_status": 0,
      "total_favorited": 0,
      "tw_expire_time": 0,
      "twitter_id": "",
      "twitter_name": "",
      "uid": "7463232156317287456",
      "unique_id": "jamal.voyage",
      "unique_id_modify_time": 1737751376,
      "user_canceled": false,
      "user_mode": 1,
      "user_now_pack_info": {},
      "user_period": 0,
      "user_rate": 1,
      "user_spark_info": {},
      "verification_type": 1,
      "verify_info": "",
      "video_icon": {
        "height": 720,
        "uri": "",
        "url_list": [
          "<unknown>"
        ],
        "width": 720,
        "url_prefix": "<unknown>"
      },
      "with_commerce_entry": false,
      "with_shop_entry": false,
      "youtube_channel_id": "",
      "youtube_channel_title": "",
      "youtube_expire_time": 0,
      "account_labels": "<unknown>",
      "ad_cover_url": "<unknown>",
      "advance_feature_item_order": "<unknown>",
      "advanced_feature_info": "<unknown>",
      "bold_fields": "<unknown>",
      "can_set_geofencing": "<unknown>",
      "cha_list": "<unknown>",
      "events": "<unknown>",
      "followers_detail": "<unknown>",
      "geofencing": "<unknown>",
      "homepage_bottom_toast": "<unknown>",
      "item_list": "<unknown>",
      "mutual_relation_avatars": "<unknown>",
      "need_points": "<unknown>",
      "platform_sync_info": "<unknown>",
      "relative_users": "<unknown>",
      "search_highlight": "<unknown>",
      "shield_edit_field_info": "<unknown>",
      "type_label": "<unknown>",
      "user_profile_guide": "<unknown>",
      "user_tags": "<unknown>",
      "white_cover_url": "<unknown>"
    }
  ],
  "has_more": true,
  "log_pb": {
    "impr_id": "20250124204255DF10EF0B3DCDCC019D10"
  },
  "max_time": 1737751376,
  "min_time": 1737751140,
  "myself_user_id": "7335035444315587617",
  "next_page_token": "eyJtYXhfY3Vyc29yIjoxNzM3NzUxMzY4LCJtaW5fY3Vyc29yIjoxNzM3NzUxMTQwfQ==",
  "offset": 0,
  "status_code": 0,
  "status_msg": "",
  "total": 4108517
}
💳 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

​
extra
object
required
​
followers
object[]
required
​
has_more
boolean
required
Example:

true

​
log_pb
object
required
​
max_time
integer
required
Example:

1737751376

​
min_time
integer
required
Example:

1737751140

​
myself_user_id
string
required
Example:

"7335035444315587617"

​
next_page_token
string
required
Example:

"eyJtYXhfY3Vyc29yIjoxNzM3NzUxMzY4LCJtaW5fY3Vyc29yIjoxNzM3NzUxMTQwfQ=="

​
offset
integer
required
Example:

0

​
status_code
integer
required
Example:

0

​
status_msg
string
required
Example:

""

​
total
integer
required
Example:

4108517