keywordstringrequired
Keyword
https://api.sandbase.ai/v1/api/tiktok/app-v3/user-search-resultReturns a list of user profiles matching specified keywords, with options to filter by account type, follower count, and preferences.
[
{
"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"
}
}
]Select an example to load its inputs and result into the playground.
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.
openai.count and offset.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.
| Name | Type | Required | Description |
|---|---|---|---|
keyword | string | Yes | Keyword |
count | integer | No | Number |
offset | integer | No | Offset |
user_search_follower_count | string | No | Sort by number of followers |
user_search_other_pref | string | No | Sort by other preferences |
user_search_profile_type | string | No | Sort by account type |
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
}
| Field | Meaning |
|---|---|
user_list[] | One matching account per item. Each item holds the account details under user_info. |
user_list[].user_info | Profile data for the matched account. |
user_list[].user_info.avatar_168x168 / user_list[].user_info.avatar_300x300 | Avatar 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_list | Direct image URLs for the small avatar, in HEIC and JPEG formats. |
user_list[].user_info.authority_status | Account authority flag. It is 0 in the sample response. |
has_more | Shows whether more results remain. It is 1 in the sample response. |
cursor | Position value for the next page. It is 20 in the sample response. |
input_keyword | The search keyword that the request used. |
status_code | Result status of the call. 0 in the sample response. |
count and offset. The sample response returns cursor as 20 and has_more as 1, so use the cursor value as the next offset.user_list[] fields, such as items, musics and challenges, are null for user search results.user_search_follower_count, user_search_profile_type and user_search_other_pref are strings and default to an empty string.$0.001 per successful call. Failed calls are not charged. It is included in the daily free quota of each organization.
Start building
Platform API endpoint with unified authentication and usage tracking.
# The quoted heredoc keeps Unicode and shell metacharacters unchanged.
result=$(curl --fail-with-body --silent \
-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" \
--data-binary @- <<'SANDBASE_JSON'
{
"count": 1,
"offset": 0,
"keyword": "openai",
"user_search_other_pref": "",
"user_search_profile_type": "",
"user_search_follower_count": ""
}
SANDBASE_JSON
)
printf '%s\n' "$result"Set your SandBase API key in your server environment. Requests use Bearer authentication.
export SANDBASE_API_KEY="YOUR_API_KEY"Keep your key on the server. Do not expose it in browser code.
keywordstringrequiredKeyword
countintegerNumber
Default: 20
offsetintegerOffset
Default: 0
user_search_follower_countstringSort by number of followers
Default: ""
user_search_other_prefstringSort by other preferences
Default: ""
user_search_profile_typestringSort by account type
Default: ""
Saved example response for this API; no live request is made when viewing it.
[
{
"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"
}
}
]Explore more
| API | Price | Response |
|---|---|---|
TikTok User Search ResultsThis API TikTok | $0.001 per call | JSON |
TikTok | $0.001 per call | JSON |
TikTok | $0.01 per call | JSON |
TikTok | $0.001 per call | JSON |
TikTok | $0.001 per call | JSON |
TikTok | $0.001 per call | JSON |
Questions
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.
$0.001 per call, billed from your SandBase balance. You are only charged for calls you make; there is no subscription.
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.
A JSON response returned in the same HTTP request (synchronous). The README on this page includes a sample response.
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.