Skip to main content
GET
/
v1
/
scrape
/
tiktok
/
search
/
users
Search Users
curl --request GET \
  --url https://api.sociavault.com/v1/scrape/tiktok/search/users \
  --header 'X-API-Key: <api-key>'
{
  "success": true,
  "data": {
    "success": true,
    "challenge_list": null,
    "cursor": 30,
    "extra": {
      "api_debug_info": null,
      "fatal_item_ids": {},
      "logid": "20260208184749D67D1C5BB3C78587C708",
      "now": 1770576470000,
      "search_request_id": "",
      "server_stream_time": 519
    },
    "feedback_type": "user",
    "global_doodle_config": {
      "ab_params": {
        "user_relation_ship": "1"
      },
      "display_filter_bar": 1,
      "feedback_survey": {
        "0": {
          "feedback_type": "user",
          "long_stress_info": null,
          "multiple_choices": {
            "0": {
              "key": "Dislike",
              "value": "Dislike"
            },
            "1": {
              "key": "Profile not found",
              "value": "Profile not found"
            },
            "2": {
              "key": "Unmatched posts",
              "value": "Unmatched posts"
            },
            "3": {
              "key": "Inappropriate content",
              "value": "Inappropriate content"
            },
            "4": {
              "key": "Others",
              "value": "Others"
            }
          },
          "send_us_multiple_choices": null
        }
      },
      "hide_results": false,
      "hit_dolphin": false,
      "hit_shark": false,
      "keyword": "taylorswift",
      "new_source": "switch_tab",
      "search_channel": "musically_user",
      "tns_search_result": "Pass"
    },
    "has_more": 1,
    "input_keyword": "taylorswift",
    "log_pb": {
      "impr_id": "20260208184749D67D1C5BB3C78587C708"
    },
    "music_list": null,
    "qc": "",
    "rid": "20260208184749D67D1C5BB3C78587C708",
    "status_code": 0,
    "type": 1,
    "user_list": {
      "0": {
        "challenges": null,
        "effects": null,
        "items": null,
        "mix_list": null,
        "musics": null,
        "position": null,
        "uniqid_position": null,
        "user_info": {
          "accept_private_policy": false,
          "account_labels": null,
          "ad_cover_url": null,
          "advance_feature_item_order": null,
          "advanced_feature_info": null,
          "authority_status": 0,
          "avatar_168x168": {
            "height": 720,
            "uri": "tos-useast8-avt-0068-tx2/701431b0215286dd09f201e25b483662",
            "url_list": {
              "0": "https://p19-common-sign.tiktokcdn-us.com/tos-useast8-avt-0068-tx2/701431b0215286dd09f201e25b483662~tplv-tiktokx-cropcenter-q:168:168:q70.heic?dr=8833&idc=useast8&ps=87d6e48a&refresh_token=c2c5b604&s=SEARCH&sc=avatar&shcp=c1333099&shp=30310797&t=223449c4&x-expires=1770660000&x-signature=XQp0D7ngaHF%2FcQdPEZ1zLiiqdvE%3D",
              "1": "https://p16-common-sign.tiktokcdn-us.com/tos-useast8-avt-0068-tx2/701431b0215286dd09f201e25b483662~tplv-tiktokx-cropcenter-q:168:168:q70.heic?dr=8833&idc=useast8&ps=87d6e48a&refresh_token=8fbe0fa1&s=SEARCH&sc=avatar&shcp=c1333099&shp=30310797&t=223449c4&x-expires=1770660000&x-signature=JB8Ww1K2LfdV9WbBELdK6yNASk4%3D",
              "2": "https://p19-common-sign.tiktokcdn-us.com/tos-useast8-avt-0068-tx2/701431b0215286dd09f201e25b483662~tplv-tiktokx-cropcenter-q:168:168:q70.jpeg?dr=8833&idc=useast8&ps=87d6e48a&refresh_token=d1524738&s=SEARCH&sc=avatar&shcp=c1333099&shp=30310797&t=223449c4&x-expires=1770660000&x-signature=oBTZvsKj2eTerfTbNh%2Bx2FE4vOo%3D"
            },
            "url_prefix": null,
            "width": 720
          },
          "avatar_300x300": {
            "height": 720,
            "uri": "tos-useast8-avt-0068-tx2/701431b0215286dd09f201e25b483662",
            "url_list": {
              "0": "https://p19-common-sign.tiktokcdn-us.com/tos-useast8-avt-0068-tx2/701431b0215286dd09f201e25b483662~tplv-tiktokx-cropcenter-q:300:300:q70.heic?dr=8834&idc=useast8&ps=87d6e48a&refresh_token=27a9e067&s=SEARCH&sc=avatar&shcp=c1333099&shp=30310797&t=223449c4&x-expires=1770660000&x-signature=CZDp9I5KbkRfNlLGYmVu5vFZvTU%3D",
              "1": "https://p16-common-sign.tiktokcdn-us.com/tos-useast8-avt-0068-tx2/701431b0215286dd09f201e25b483662~tplv-tiktokx-cropcenter-q:300:300:q70.heic?dr=8834&idc=useast8&ps=87d6e48a&refresh_token=bcc9ec50&s=SEARCH&sc=avatar&shcp=c1333099&shp=30310797&t=223449c4&x-expires=1770660000&x-signature=0%2BI95zjaRJo8CMO%2FvxBU4aHRkt8%3D",
              "2": "https://p19-common-sign.tiktokcdn-us.com/tos-useast8-avt-0068-tx2/701431b0215286dd09f201e25b483662~tplv-tiktokx-cropcenter-q:300:300:q70.jpeg?dr=8834&idc=useast8&ps=87d6e48a&refresh_token=7e942f8a&s=SEARCH&sc=avatar&shcp=c1333099&shp=30310797&t=223449c4&x-expires=1770660000&x-signature=R%2F1jJCkA%2BtcviC01pZjG93M7Unc%3D"
            },
            "url_prefix": null,
            "width": 720
          },
          "avatar_larger": {
            "height": 720,
            "uri": "tos-useast8-avt-0068-tx2/701431b0215286dd09f201e25b483662",
            "url_list": {
              "0": "https://p19-common-sign.tiktokcdn-us.com/tos-useast8-avt-0068-tx2/701431b0215286dd09f201e25b483662~tplv-tiktokx-cropcenter-q:1080:1080:q70.heic?dr=8837&idc=useast8&ps=87d6e48a&refresh_token=d30432d0&s=SEARCH&sc=avatar&shcp=c1333099&shp=30310797&t=223449c4&x-expires=1770660000&x-signature=OIbxfyEuPUBGZdbgwXwZCqugUyQ%3D",
              "1": "https://p16-common-sign.tiktokcdn-us.com/tos-useast8-avt-0068-tx2/701431b0215286dd09f201e25b483662~tplv-tiktokx-cropcenter-q:1080:1080:q70.heic?dr=8837&idc=useast8&ps=87d6e48a&refresh_token=c5314c36&s=SEARCH&sc=avatar&shcp=c1333099&shp=30310797&t=223449c4&x-expires=1770660000&x-signature=%2F2iEN21390NUjDfvccWbLpCER8s%3D",
              "2": "https://p19-common-sign.tiktokcdn-us.com/tos-useast8-avt-0068-tx2/701431b0215286dd09f201e25b483662~tplv-tiktokx-cropcenter-q:1080:1080:q70.jpeg?dr=8837&idc=useast8&ps=87d6e48a&refresh_token=7e4f8246&s=SEARCH&sc=avatar&shcp=c1333099&shp=30310797&t=223449c4&x-expires=1770660000&x-signature=kcDG6zjV99HWkU7ukXGTKB%2FbUMI%3D"
            },
            "url_prefix": null,
            "width": 720
          },
          "avatar_medium": {
            "height": 720,
            "uri": "tos-useast8-avt-0068-tx2/701431b0215286dd09f201e25b483662",
            "url_list": {
              "0": "https://p19-common-sign.tiktokcdn-us.com/tos-useast8-avt-0068-tx2/701431b0215286dd09f201e25b483662~tplv-tiktokx-cropcenter-q:720:720:q70.heic?dr=8836&idc=useast8&ps=87d6e48a&refresh_token=3ad8b0f4&s=SEARCH&sc=avatar&shcp=c1333099&shp=30310797&t=223449c4&x-expires=1770660000&x-signature=sMHbb83Nwwc6Wu089cfFDTiibe4%3D",
              "1": "https://p16-common-sign.tiktokcdn-us.com/tos-useast8-avt-0068-tx2/701431b0215286dd09f201e25b483662~tplv-tiktokx-cropcenter-q:720:720:q70.heic?dr=8836&idc=useast8&ps=87d6e48a&refresh_token=dd16c4e4&s=SEARCH&sc=avatar&shcp=c1333099&shp=30310797&t=223449c4&x-expires=1770660000&x-signature=z9iR9MnQU2ksLcJeBGlmTHA82Wg%3D",
              "2": "https://p19-common-sign.tiktokcdn-us.com/tos-useast8-avt-0068-tx2/701431b0215286dd09f201e25b483662~tplv-tiktokx-cropcenter-q:720:720:q70.jpeg?dr=8836&idc=useast8&ps=87d6e48a&refresh_token=d98f5bc1&s=SEARCH&sc=avatar&shcp=c1333099&shp=30310797&t=223449c4&x-expires=1770660000&x-signature=2ih1oZw7rmSQbIDxbV4aB8yz2nM%3D"
            },
            "url_prefix": null,
            "width": 720
          },
          "avatar_thumb": {
            "height": 720,
            "uri": "tos-useast8-avt-0068-tx2/701431b0215286dd09f201e25b483662",
            "url_list": {
              "0": "https://p19-common-sign.tiktokcdn-us.com/tos-useast8-avt-0068-tx2/701431b0215286dd09f201e25b483662~tplv-tiktokx-cropcenter-q:100:100:q70.heic?biz_tag=musically_user.user_cover&dr=8835&idc=useast8&ps=87d6e48a&refresh_token=c69c26f9&s=SEARCH&sc=avatar&shcp=c1333099&shp=30310797&t=223449c4&x-expires=1770660000&x-signature=XHaAqARleuJKJMkoP5ypluiFjKc%3D",
              "1": "https://p16-common-sign.tiktokcdn-us.com/tos-useast8-avt-0068-tx2/701431b0215286dd09f201e25b483662~tplv-tiktokx-cropcenter-q:100:100:q70.heic?biz_tag=musically_user.user_cover&dr=8835&idc=useast8&ps=87d6e48a&refresh_token=e8a02047&s=SEARCH&sc=avatar&shcp=c1333099&shp=30310797&t=223449c4&x-expires=1770660000&x-signature=qBrZ4DRMtvDkulUKon9zFkkbSE8%3D",
              "2": "https://p19-common-sign.tiktokcdn-us.com/tos-useast8-avt-0068-tx2/701431b0215286dd09f201e25b483662~tplv-tiktokx-cropcenter-q:100:100:q70.jpeg?biz_tag=musically_user.user_cover&dr=8835&idc=useast8&ps=87d6e48a&refresh_token=bd57613e&s=SEARCH&sc=avatar&shcp=c1333099&shp=30310797&t=223449c4&x-expires=1770660000&x-signature=%2BQZcKoZGX22XK%2Froz%2Bt5eLQXSM4%3D"
            },
            "url_prefix": null,
            "width": 720
          },
          "avatar_uri": "tos-useast8-avt-0068-tx2/701431b0215286dd09f201e25b483662",
          "aweme_count": 81,
          "block_status": 0,
          "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": null,
          "custom_verify": "Verified account",
          "cv_level": "2",
          "download_prompt_ts": 0,
          "enable_direct_message": false,
          "enabled_filter_all_comments": false,
          "enterprise_verify_reason": "",
          "events": null,
          "fake_data_info": {},
          "fb_expire_time": 0,
          "follow_status": 0,
          "follower_count": 33302213,
          "follower_status": 0,
          "followers_detail": null,
          "following_count": 0,
          "friends_status": 0,
          "geofencing": null,
          "hide_search": false,
          "homepage_bottom_toast": null,
          "ins_id": "taylorswift",
          "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_private_account": 0,
          "is_star": false,
          "item_list": null,
          "live_agreement": 0,
          "live_commerce": false,
          "live_verify": 0,
          "mention_status": 1,
          "mutual_relation_avatars": null,
          "name_field": "unique_id",
          "need_points": null,
          "need_recommend": 0,
          "nickname": "Taylor Swift",
          "original_musician": {
            "digg_count": 0,
            "music_count": 7910,
            "music_used_count": 0,
            "new_release_clip_ids": null
          },
          "platform_sync_info": null,
          "prevent_download": false,
          "relative_users": null,
          "reply_with_video_flag": 4,
          "room_id": 0,
          "room_id_str": "0",
          "search_highlight": null,
          "search_user_desc": "Taylor Swift",
          "search_user_name": "taylorswift",
          "sec_uid": "MS4wLjABAAAAqB08cUbXaDWqbD6MCga2RbGTuhfO2EsHayBYx08NDrN7IE3jQuRDNNN6YwyfH6_6",
          "secret": 0,
          "shield_comment_notice": 0,
          "shield_digg_notice": 0,
          "shield_edit_field_info": null,
          "shield_follow_notice": 0,
          "short_id": "0",
          "show_image_bubble": false,
          "special_account": {
            "special_account_list": null
          },
          "special_lock": 1,
          "status": 1,
          "stitch_setting": 0,
          "total_favorited": 267837265,
          "type_label": null,
          "uid": "6881290705605477381",
          "unique_id": "taylorswift",
          "user_canceled": false,
          "user_mode": 1,
          "user_period": 0,
          "user_profile_guide": null,
          "user_rate": 1,
          "user_spark_info": {},
          "user_tags": null,
          "verification_type": 0,
          "verify_info": "",
          "video_icon": {
            "height": 720,
            "uri": "",
            "url_list": {},
            "url_prefix": null,
            "width": 720
          },
          "white_cover_url": null,
          "with_commerce_entry": false
        }
      }
    }
  },
  "credits_used": 1,
  "endpoint": "tiktok/search/users"
}
💳 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

query
string
required

Search query for users

cursor
integer

Cursor to get more users. Get 'cursor' from previous response.

Example:

10

trim
boolean

Set to true to get a trimmed response

Response

Successful response