Search Users

GET/v1/tiktok/search/users1 credit

Searches TikTok accounts by keyword and returns the matching users, 10 per page.

01Query parameters

Name	Type	Description
queryrequired	string	The search term.
cursoroptional	integer	The `cursor` value of the previous page, to get the next one.
trimoptional	boolean	Accepted for compatibility; this endpoint always returns the same user objects.Default: `false`

02Request

curl "https://api.scrapesocial.ai/v1/tiktok/search/users?query=khaby" \
  -H "x-api-key: $SCRAPESOCIAL_KEY"

03Responses

Real answers from the API. Lists are shortened to 2 items.

GET /v1/tiktok/search/users?query=khaby

{
  "success": true,
  "credits_remaining": 4980,
  "credits_charged": 1,
  "challenge_list": null,
  "cursor": 10,
  "extra": {
    "api_debug_info": null,
    "fatal_item_ids": [],
    "logid": "20261026011032B94034339A484D44DC9B",
    "now": 1792948233000,
    "search_request_id": "",
    "server_stream_time": 695
  },
  "feedback_type": "user",
  "global_doodle_config": {
    "display_filter_bar": 1,
    "feedback_survey": null,
    "hide_results": false,
    "hit_dolphin": false,
    "hit_shark": false,
    "keyword": "khaby",
    "new_source": "",
    "search_channel": "tiktok_user",
    "tns_search_result": "Pass"
  },
  "has_more": 1,
  "input_keyword": "khaby",
  "log_pb": {
    "impr_id": "20261026011032B94034339A484D44DC9B"
  },
  "music_list": null,
  "qc": "",
  "rid": "20261026011032B94034339A484D44DC9B",
  "status_code": 0,
  "type": 1,
  "user_list": [
    {
      "challenges": null,
      "effects": null,
      "items": null,
      "mix_list": null,
      "musics": null,
      "position": null,
      "uniqid_position": null,
      "user_info": {
        "account_labels": null,
        "ad_cover_url": null,
        "advance_feature_item_order": null,
        "advanced_feature_info": null,
        "avatar_thumb": {
          "height": 720,
          "uri": "tos-maliva-avt-0068/08987e23b94057953fd4f1738694bf5f",
          "url_list": [
            "https://p19-common-sign.tiktokcdn.com/tos-maliva-avt-0068/08987e23b94057953fd4f1738694bf5f~tplv-tiktokx-cropcenter:100:100.webp?biz_tag=tiktok_user.user_cover&dr=14579&idc=my3&ps=13740610&refresh_token=df858af7&shcp=c1333099&shp=30310797&t=4d5b0474&x-expires=1793034000&x-signature=925raAbb8vgdchN6duAgrdYksYQ%3D",
            "https://p16-common-sign.tiktokcdn.com/tos-maliva-avt-0068/08987e23b94057953fd4f1738694bf5f~tplv-tiktokx-cropcenter:100:100.webp?biz_tag=tiktok_user.user_cover&dr=14579&idc=my3&ps=13740610&refresh_token=ab25539b&shcp=c1333099&shp=30310797&t=4d5b0474&x-expires=1793034000&x-signature=yAO8paSM%2BQGcSVufXcKynoWuOhw%3D"
          ],
          "url_prefix": null,
          "width": 720
        },
        "bold_fields": null,
        "can_message_follow_status_list": null,
        "can_set_geofencing": null,
        "cha_list": null,
        "cover_url": null,
        "custom_verify": "Popular creator",
        "enterprise_verify_reason": "",
        "events": null,
        "follow_status": 0,
        "follower_count": 163000000,
        "followers_detail": null,
        "geofencing": null,
        "homepage_bottom_toast": null,
        "item_list": null,
        "mutual_relation_avatars": null,
        "need_points": null,
        "nickname": "Khabane lame",
        "platform_sync_info": null,
        "relative_users": null,
        "room_id": 0,
        "room_id_str": "0",
        "search_highlight": null,
        "sec_uid": "MS4wLjABAAAAwAg0rSzO65WQfz4RzQgGv2Xdv108BgPXhRrrmNVIHQZ9PO8-flwwRtEppYTS0OjA",
        "shield_edit_field_info": null,
        "total_favorited": 2691101735,
        "type_label": null,
        "uid": "127905465618821121",
        "unique_id": "khaby.lame",
        "user_profile_guide": null,
        "user_tags": null,
        "white_cover_url": null
      }
    },
    {
      "challenges": null,
      "effects": null,
      "items": null,
      "mix_list": null,
      "musics": null,
      "position": null,
      "uniqid_position": null,
      "user_info": {
        "account_labels": null,
        "ad_cover_url": null,
        "advance_feature_item_order": null,
        "advanced_feature_info": null,
        "avatar_thumb": {
          "height": 720,
          "uri": "tos-maliva-avt-0068/ee31de49ddf64b45c5b2e3c55fbd0ea4",
          "url_list": [
            "https://p16-common-sign.tiktokcdn.com/tos-maliva-avt-0068/ee31de49ddf64b45c5b2e3c55fbd0ea4~tplv-tiktokx-cropcenter:100:100.webp?biz_tag=tiktok_user.user_cover&dr=14579&idc=my3&ps=13740610&refresh_token=7e675d31&shcp=c1333099&shp=30310797&t=4d5b0474&x-expires=1793034000&x-signature=h7Z%2FIAmi48ioSRAOiCGbisVnyNo%3D",
            "https://p19-common-sign.tiktokcdn.com/tos-maliva-avt-0068/ee31de49ddf64b45c5b2e3c55fbd0ea4~tplv-tiktokx-cropcenter:100:100.webp?biz_tag=tiktok_user.user_cover&dr=14579&idc=my3&ps=13740610&refresh_token=030cba08&shcp=c1333099&shp=30310797&t=4d5b0474&x-expires=1793034000&x-signature=cMJGDei633GgCKapEZ0NwXlQ7E4%3D"
          ],
          "url_prefix": null,
          "width": 720
        },
        "bold_fields": null,
        "can_message_follow_status_list": null,
        "can_set_geofencing": null,
        "cha_list": null,
        "cover_url": null,
        "custom_verify": "Verified account",
        "enterprise_verify_reason": "",
        "events": null,
        "follow_status": 0,
        "follower_count": 160300000,
        "followers_detail": null,
        "geofencing": null,
        "homepage_bottom_toast": null,
        "item_list": null,
        "mutual_relation_avatars": null,
        "need_points": null,
        "nickname": "charli d’amelio",
        "platform_sync_info": null,
        "relative_users": null,
        "room_id": 0,
        "room_id_str": "0",
        "search_highlight": null,
        "sec_uid": "MS4wLjABAAAA-VASjiXTh7wDDyXvjk10VFhMWUAoxr8bgfO1kAL1-9s",
        "shield_edit_field_info": null,
        "total_favorited": 12372225140,
        "type_label": null,
        "uid": "5831967",
        "unique_id": "charlidamelio",
        "user_profile_guide": null,
        "user_tags": null,
        "white_cover_url": null
      }
    }
  ]
}

Common to every endpoint

Any route can answer these: a missing or wrong key, no credits left, the platform not answering, or a failure on our side. None of them costs credits.

GET /v1/cosmos/profile?handle=design

{
  "success": false,
  "message": "Invalid API key"
}

04Notes

Users are in `user_list`, each with its profile in `user_info`. To page, send the response's `cursor` back as `cursor` (an offset: 10, 20, ...) while `has_more` is 1. No results is an empty list for 0 credits. The endpoint can answer a free 503 when it is temporarily unavailable; retry later.

05Errors & credits

Every error has success: false, a real HTTP status and costs no credits.

400missing_parameter
A required parameter is missing or invalid.
403private_account
The account is private or age-restricted.
404not_found
No such account.
503upstream_error
The platform did not answer; retry shortly.