TikTok User Search Results

API docs
https://api.sandbase.ai/v1/api/tiktok/app-v3/user-search-result

Returns a list of user profiles matching specified keywords, with options to filter by account type, follower count, and preferences.

Price
$0.001USD / call
Method
POST
Response
JSON
Parameters
1 required · 5 optional

Playground

Input
Keyword
Number
Offset
Sort by number of followers
Sort by other preferences
Sort by account type
OutputExample
Responseoutputs · 14.5 KB · 280 lines
[
  {
    "data": {
      "challenge_list": null,
      "cursor": 20,
      "extra": {
        "api_debug_info": null,
        "fatal_item_ids": [],
        "logid": "20261006123933C8D6FED758AA0FF03151",
        "now": 1791290374000,
        "search_request_id": "",
        "server_stream_time": 651
      },
      "feedback_type": "user",
      "global_doodle_config": {
        "ab_params": {
          "user_relation_ship": "1"
        },
        "display_filter_bar": 1,
        "feedback_survey": [
          {
            "feedback_type": "user",
            "long_stress_info": null,
            "multiple_choices": [
              {
                "key": "Dislike",
                "value": "Dislike"
              },
              {
                "key": "Profile not found",
                "value": "Profile not found"
              },
              "… 3 more items in the full response"
            ],
            "send_us_multiple_choices": null
          }
        ],
        "hide_results": false,
        "hit_dolphin": false,
        "hit_shark": true,
        "keyword": "openai",
        "new_source": "switch_tab",
        "search_channel": "musically_user",
        "tns_search_result": "Pass"
      },
      "has_more": 1,
      "input_keyword": "openai",
      "log_pb": {
        "impr_id": "20261006123933C8D6FED758AA0FF03151"
      },
      "music_list": null,
      "qc": "",
      "rid": "20261006123933C8D6FED758AA0FF03151",
      "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": {
            "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": {
              "data_size": 0,
              "height": 720,
              "uri": "tos-maliva-avt-0068/d29bf4d0c36077c6aace74b1dd3c8204",
              "url_list": [
                "https://p16-common-sign.tiktokcdn-eu.com/tos-maliva-avt-0068/d29bf4d0c36077c6aace74b1dd3c8204~tplv-tiktokx-cropcenter-q:168:168:q70.heic?dr=9604&refresh_token=8c20f906&x-expires=1791374400&x-signature=l%2FOdHhRCIrLKxddBahLrSkeEskk%3D&t=223449c4&ps=87d6e48a&shp=30310797&shcp=c1333099&idc=no1a&sc=avat…",
                "https://p19-common-sign.tiktokcdn-eu.com/tos-maliva-avt-0068/d29bf4d0c36077c6aace74b1dd3c8204~tplv-tiktokx-cropcenter-q:168:168:q70.heic?dr=9604&refresh_token=9b92f1ed&x-expires=1791374400&x-signature=9xWYsJHx%2FDEr2guAmhJzGGTjXwo%3D&t=223449c4&ps=87d6e48a&shp=30310797&shcp=c1333099&idc=no1a&sc=avat…",
                "… 1 more items in the full response"
              ],
              "url_prefix": null,
              "width": 720
            },
            "avatar_300x300": {
              "data_size": 0,
              "height": 720,
              "uri": "tos-maliva-avt-0068/d29bf4d0c36077c6aace74b1dd3c8204",
              "url_list": [
                "https://p16-common-sign.tiktokcdn-eu.com/tos-maliva-avt-0068/d29bf4d0c36077c6aace74b1dd3c8204~tplv-tiktokx-cropcenter-q:300:300:q70.heic?dr=9605&refresh_token=a5b49558&x-expires=1791374400&x-signature=v8fbVXqz66Foo%2FRO%2FtROSX5Tbec%3D&t=223449c4&ps=87d6e48a&shp=30310797&shcp=c1333099&idc=no1a&sc=av…",
                "https://p19-common-sign.tiktokcdn-eu.com/tos-maliva-avt-0068/d29bf4d0c36077c6aace74b1dd3c8204~tplv-tiktokx-cropcenter-q:300:300:q70.heic?dr=9605&refresh_token=509d4769&x-expires=1791374400&x-signature=iDRyY4UKTvsrCwJrOTE%2B0%2BMtVrI%3D&t=223449c4&ps=87d6e48a&shp=30310797&shcp=c1333099&idc=no1a&sc=av…",
                "… 1 more items in the full response"
              ],
              "url_prefix": null,
              "width": 720
            },
            "avatar_larger": {
              "data_size": 0,
              "height": 720,
              "uri": "tos-maliva-avt-0068/d29bf4d0c36077c6aace74b1dd3c8204",
              "url_list": [
                "https://p16-common-sign.tiktokcdn-eu.com/tos-maliva-avt-0068/d29bf4d0c36077c6aace74b1dd3c8204~tplv-tiktokx-cropcenter-q:1080:1080:q70.heic?dr=9608&refresh_token=cbfee717&x-expires=1791374400&x-signature=oRziK0t47DW8HkUf%2FgthvowkT%2Bg%3D&t=223449c4&ps=87d6e48a&shp=30310797&shcp=c1333099&idc=no1a&sc=…",
                "https://p19-common-sign.tiktokcdn-eu.com/tos-maliva-avt-0068/d29bf4d0c36077c6aace74b1dd3c8204~tplv-tiktokx-cropcenter-q:1080:1080:q70.heic?dr=9608&refresh_token=9356ca65&x-expires=1791374400&x-signature=srx8O1gKPAld5%2BH%2BT7TF%2F3L8glY%3D&t=223449c4&ps=87d6e48a&shp=30310797&shcp=c1333099&idc=no1a&s…",
                "… 1 more items in the full response"
              ],
              "url_prefix": null,
              "width": 720
            },
            "avatar_medium": {
              "data_size": 0,
              "height": 720,
              "uri": "tos-maliva-avt-0068/d29bf4d0c36077c6aace74b1dd3c8204",
              "url_list": [
                "https://p16-common-sign.tiktokcdn-eu.com/tos-maliva-avt-0068/d29bf4d0c36077c6aace74b1dd3c8204~tplv-tiktokx-cropcenter-q:720:720:q70.heic?dr=9607&refresh_token=764e3a81&x-expires=1791374400&x-signature=ik%2Fv2v%2FCK99hwsjAtV9X6JrI2Ls%3D&t=223449c4&ps=87d6e48a&shp=30310797&shcp=c1333099&idc=no1a&sc=av…",
                "https://p19-common-sign.tiktokcdn-eu.com/tos-maliva-avt-0068/d29bf4d0c36077c6aace74b1dd3c8204~tplv-tiktokx-cropcenter-q:720:720:q70.heic?dr=9607&refresh_token=1f885c72&x-expires=1791374400&x-signature=8Wuuqfsheknfy%2BwrQkHWvILzukw%3D&t=223449c4&ps=87d6e48a&shp=30310797&shcp=c1333099&idc=no1a&sc=avat…",
                "… 1 more items in the full response"
              ],
              "url_prefix": null,
              "width": 720
            },
            "avatar_thumb": {
              "data_size": 0,
              "height": 720,
              "uri": "tos-maliva-avt-0068/d29bf4d0c36077c6aace74b1dd3c8204",
              "url_list": [
                "https://p16-common-sign.tiktokcdn-eu.com/tos-maliva-avt-0068/d29bf4d0c36077c6aace74b1dd3c8204~tplv-tiktokx-cropcenter-q:100:100:q70.heic?biz_tag=musically_user.user_cover&dr=9606&idc=no1a&ps=87d6e48a&refresh_token=f6ce598b&s=SEARCH&sc=avatar&shcp=c1333099&shp=30310797&t=223449c4&x-expires=1791374400…",
                "https://p19-common-sign.tiktokcdn-eu.com/tos-maliva-avt-0068/d29bf4d0c36077c6aace74b1dd3c8204~tplv-tiktokx-cropcenter-q:100:100:q70.heic?biz_tag=musically_user.user_cover&dr=9606&idc=no1a&ps=87d6e48a&refresh_token=127f6337&s=SEARCH&sc=avatar&shcp=c1333099&shp=30310797&t=223449c4&x-expires=1791374400…",
                "… 1 more items in the full response"
              ],
              "url_prefix": null,
              "width": 720
            },
            "avatar_uri": "tos-maliva-avt-0068/d29bf4d0c36077c6aace74b1dd3c8204",
            "aweme_count": 542,
            "block_status": 0,
            "bold_fields": null,
            "can_message_follow_status_list": [
              2
            ],
            "can_set_geofencing": null,
            "cha_list": null,
            "comment_filter_status": 0,
            "comment_setting": 0,
            "commerce_user_level": 2,
            "cover_url": null,
            "custom_verify": "",
            "cv_level": "",
            "download_prompt_ts": 0,
            "enable_direct_message": true,
            "enabled_filter_all_comments": false,
            "enterprise_verify_reason": "verified account",
            "events": null,
            "fake_data_info": {},
            "fb_expire_time": 0,
            "follow_status": 0,
            "follower_count": 1044159,
            "follower_status": 0,
            "followers_detail": null,
            "following_count": 2,
            "friends_status": 0,
            "geofencing": null,
            "hide_search": false,
            "homepage_bottom_toast": null,
            "…": "60 more fields in the full response"
          }
        },
        {
          "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": {
              "data_size": 0,
              "height": 720,
              "uri": "tos-maliva-avt-0068/6b496d6f58e4c8f0bd673b794f72074b",
              "url_list": [
                "https://p16-common-sign.tiktokcdn-eu.com/tos-maliva-avt-0068/6b496d6f58e4c8f0bd673b794f72074b~tplv-tiktokx-cropcenter-q:168:168:q70.heic?dr=9604&refresh_token=89d93521&x-expires=1791374400&x-signature=XrAH25dS8Huo4gFritsf4ywlhgQ%3D&t=223449c4&ps=87d6e48a&shp=30310797&shcp=c1333099&idc=no1a&sc=avatar…",
                "https://p19-common-sign.tiktokcdn-eu.com/tos-maliva-avt-0068/6b496d6f58e4c8f0bd673b794f72074b~tplv-tiktokx-cropcenter-q:168:168:q70.heic?dr=9604&refresh_token=8266df74&x-expires=1791374400&x-signature=TYdMKFeVTlzkudUIRZFoH1qYsII%3D&t=223449c4&ps=87d6e48a&shp=30310797&shcp=c1333099&idc=no1a&sc=avatar…",
                "… 1 more items in the full response"
              ],
              "url_prefix": null,
              "width": 720
            },
            "avatar_300x300": {
              "data_size": 0,
              "height": 720,
              "uri": "tos-maliva-avt-0068/6b496d6f58e4c8f0bd673b794f72074b",
              "url_list": [
                "https://p16-common-sign.tiktokcdn-eu.com/tos-maliva-avt-0068/6b496d6f58e4c8f0bd673b794f72074b~tplv-tiktokx-cropcenter-q:300:300:q70.heic?dr=9605&refresh_token=fe86c46c&x-expires=1791374400&x-signature=2Ts3ff7zqb64n9QrQVeFEWK%2F9ic%3D&t=223449c4&ps=87d6e48a&shp=30310797&shcp=c1333099&idc=no1a&sc=avat…",
                "https://p19-common-sign.tiktokcdn-eu.com/tos-maliva-avt-0068/6b496d6f58e4c8f0bd673b794f72074b~tplv-tiktokx-cropcenter-q:300:300:q70.heic?dr=9605&refresh_token=5e209323&x-expires=1791374400&x-signature=esBJ55e%2FLVsqV77w42TzSp6yAIY%3D&t=223449c4&ps=87d6e48a&shp=30310797&shcp=c1333099&idc=no1a&sc=avat…",
                "… 1 more items in the full response"
              ],
              "url_prefix": null,
              "width": 720
            },
            "avatar_larger": {
              "data_size": 0,
              "height": 720,
              "uri": "tos-maliva-avt-0068/6b496d6f58e4c8f0bd673b794f72074b",
              "url_list": [
                "https://p16-common-sign.tiktokcdn-eu.com/tos-maliva-avt-0068/6b496d6f58e4c8f0bd673b794f72074b~tplv-tiktokx-cropcenter-q:1080:1080:q70.heic?dr=9608&refresh_token=27f933c3&x-expires=1791374400&x-signature=31pplwMXart0g%2FDi4J8kPMiDCGE%3D&t=223449c4&ps=87d6e48a&shp=30310797&shcp=c1333099&idc=no1a&sc=av…",
                "https://p19-common-sign.tiktokcdn-eu.com/tos-maliva-avt-0068/6b496d6f58e4c8f0bd673b794f72074b~tplv-tiktokx-cropcenter-q:1080:1080:q70.heic?dr=9608&refresh_token=3dc04754&x-expires=1791374400&x-signature=8FX60Acs%2BLDk1mOHm4pAp0rRgeY%3D&t=223449c4&ps=87d6e48a&shp=30310797&shcp=c1333099&idc=no1a&sc=av…",
                "… 1 more items in the full response"
              ],
              "url_prefix": null,
              "width": 720
            },
            "avatar_medium": {
              "data_size": 0,
              "height": 720,
              "uri": "tos-maliva-avt-0068/6b496d6f58e4c8f0bd673b794f72074b",
              "url_list": [
                "https://p16-common-sign.tiktokcdn-eu.com/tos-maliva-avt-0068/6b496d6f58e4c8f0bd673b794f72074b~tplv-tiktokx-cropcenter-q:720:720:q70.heic?dr=9607&refresh_token=be2866ee&x-expires=1791374400&x-signature=U%2FdHbs9viSVdvYxV6ewuz8pjW5s%3D&t=223449c4&ps=87d6e48a&shp=30310797&shcp=c1333099&idc=no1a&sc=avat…",
                "https://p19-common-sign.tiktokcdn-eu.com/tos-maliva-avt-0068/6b496d6f58e4c8f0bd673b794f72074b~tplv-tiktokx-cropcenter-q:720:720:q70.heic?dr=9607&refresh_token=0ddb3a41&x-expires=1791374400&x-signature=%2Fj7%2FmrUZw8%2FgaToAzVHUEX1L52Q%3D&t=223449c4&ps=87d6e48a&shp=30310797&shcp=c1333099&idc=no1a&sc=…",
                "… 1 more items in the full response"
              ],
              "url_prefix": null,
              "width": 720
            },
            "avatar_thumb": {
              "data_size": 0,
              "height": 720,
              "uri": "tos-maliva-avt-0068/6b496d6f58e4c8f0bd673b794f72074b",
              "url_list": [
                "https://p16-common-sign.tiktokcdn-eu.com/tos-maliva-avt-0068/6b496d6f58e4c8f0bd673b794f72074b~tplv-tiktokx-cropcenter-q:100:100:q70.heic?biz_tag=musically_user.user_cover&dr=9606&idc=no1a&ps=87d6e48a&refresh_token=11c6e146&s=SEARCH&sc=avatar&shcp=c1333099&shp=30310797&t=223449c4&x-expires=1791374400…",
                "https://p19-common-sign.tiktokcdn-eu.com/tos-maliva-avt-0068/6b496d6f58e4c8f0bd673b794f72074b~tplv-tiktokx-cropcenter-q:100:100:q70.heic?biz_tag=musically_user.user_cover&dr=9606&idc=no1a&ps=87d6e48a&refresh_token=6debe296&s=SEARCH&sc=avatar&shcp=c1333099&shp=30310797&t=223449c4&x-expires=1791374400…",
                "… 1 more items in the full response"
              ],
              "url_prefix": null,
              "width": 720
            },
            "avatar_uri": "tos-maliva-avt-0068/6b496d6f58e4c8f0bd673b794f72074b",
            "aweme_count": 847,
            "block_status": 0,
            "bold_fields": null,
            "can_message_follow_status_list": [
              2
            ],
            "can_set_geofencing": null,
            "cha_list": null,
            "comment_filter_status": 0,
            "comment_setting": 0,
            "commerce_user_level": 2,
            "cover_url": null,
            "custom_verify": "",
            "cv_level": "",
            "download_prompt_ts": 0,
            "enable_direct_message": true,
            "enabled_filter_all_comments": false,
            "enterprise_verify_reason": "verified account",
            "events": null,
            "fake_data_info": {},
            "fb_expire_time": 0,
            "follow_status": 0,
            "follower_count": 3967619,
            "follower_status": 0,
            "followers_detail": null,
            "following_count": 1,
            "friends_status": 0,
            "geofencing": null,
            "hide_search": false,
            "homepage_bottom_toast": null,
            "…": "60 more fields in the full response"
          }
        },
        "… 18 more items in the full response"
      ],
      "version": "v2"
    }
  }
]

Examples

Select an example to load its inputs and result into the playground.

API README

TikTok User Search Results API

Returns a list of TikTok user profiles that match a search keyword. The only required input is keyword, and you can add paging and filter parameters.

Use cases

  • Find TikTok accounts that match a brand name such as openai.
  • Collect avatar image URLs for accounts that match a search term.
  • Page through all accounts that match a keyword with count and offset.
  • Narrow a creator search with the follower count and profile type filters.

Request

curl -X POST "https://api.sandbase.ai/v1/api/tiktok/app-v3/user-search-result" \
  -H "Authorization: Bearer $SANDBASE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"keyword": "openai"}'

The result is returned in outputs[0].data.

Parameters

NameTypeRequiredDescription
keywordstringYesKeyword
countintegerNoNumber
offsetintegerNoOffset
user_search_follower_countstringNoSort by number of followers
user_search_other_prefstringNoSort by other preferences
user_search_profile_typestringNoSort by account type

Example response

Real response for the request above, trimmed: lists keep their first item and long strings are cut.

{
  "challenge_list": null,
  "cursor": 20,
  "extra": {
    "api_debug_info": null,
    "fatal_item_ids": [],
    "logid": "20261103074408EF1DF108C79A43821A2A",
    "now": 1793691849000,
    "search_request_id": "",
    "server_stream_time": 612
  },
  "feedback_type": "user",
  "global_doodle_config": {
    "ab_params": {
      "user_relation_ship": "1"
    },
    "display_filter_bar": 1,
    "feedback_survey": [
      {
        "feedback_type": "user",
        "long_stress_info": null,
        "multiple_choices": [
          {
            "key": "Dislike",
            "value": "Dislike"
          }
        ],
        "send_us_multiple_choices": null
      }
    ],
    "hide_results": false,
    "hit_dolphin": false,
    "hit_shark": false,
    "keyword": "openai",
    "new_source": "switch_tab",
    "search_channel": "musically_user",
    "tns_search_result": "Pass"
  },
  "has_more": 1,
  "input_keyword": "openai",
  "log_pb": {
    "impr_id": "20261103074408EF1DF108C79A43821A2A"
  },
  "music_list": null,
  "qc": "",
  "rid": "20261103074408EF1DF108C79A43821A2A",
  "status_code": 0
}

Response fields

FieldMeaning
user_list[]One matching account per item. Each item holds the account details under user_info.
user_list[].user_infoProfile data for the matched account.
user_list[].user_info.avatar_168x168 / user_list[].user_info.avatar_300x300Avatar images at two sizes. Each has a uri, width, height and a url_list with several image links.
user_list[].user_info.avatar_168x168.url_listDirect image URLs for the small avatar, in HEIC and JPEG formats.
user_list[].user_info.authority_statusAccount authority flag. It is 0 in the sample response.
has_moreShows whether more results remain. It is 1 in the sample response.
cursorPosition value for the next page. It is 20 in the sample response.
input_keywordThe search keyword that the request used.
status_codeResult status of the call. 0 in the sample response.

Notes

  • Page through results with count and offset. The sample response returns cursor as 20 and has_more as 1, so use the cursor value as the next offset.
  • Several user_list[] fields, such as items, musics and challenges, are null for user search results.
  • The filter parameters user_search_follower_count, user_search_profile_type and user_search_other_pref are strings and default to an empty string.
  • To get more details on a matched account, call TikTok User Profile Details.

Pricing

$0.001 per successful call. Failed calls are not charged. It is included in the daily free quota of each organization.

Explore more

Related APIs

All APIs
APIPriceResponse
TikTok$0.001 per callJSON
TikTok$0.001 per callJSON
TikTok$0.01 per callJSON
TikTok$0.001 per callJSON
TikTok$0.001 per callJSON
TikTok$0.001 per callJSON

Questions

FAQ

How do I use the TikTok User Search Results API?

Send a POST request to https://api.sandbase.ai/v1/api/tiktok/app-v3/user-search-result with your SandBase API key in the Authorization header (Bearer) and the parameters as a JSON body. You can also try it in the Playground on this page without writing code.

How much does the TikTok User Search Results API cost?

$0.001 per call, billed from your SandBase balance. You are only charged for calls you make; there is no subscription.

What parameters does the TikTok User Search Results API accept?

Required: keyword (string). Optional: count (integer), offset (integer), user_search_follower_count (string), user_search_other_pref (string) and user_search_profile_type (string). The Parameters table and the Playground on this page list every field.

What does the TikTok User Search Results API return?

A JSON response returned in the same HTTP request (synchronous). The README on this page includes a sample response.

Do I need a TikTok developer account or API key?

No. TikTok User Search Results runs through SandBase, so one SandBase API key covers this endpoint and every other API and model in the catalog. You do not need to apply for TikTok API access separately.