keywordstringrequired
Keyword
https://api.sandbase.ai/v1/api/tiktok/app-v3/general-search-resultSearch TikTok by keyword across videos and users (Top tab). Returns videos with descriptions, authors and play, like, comment and share counts, with sort and publish-time filters.
[
{
"data": {
"ad_info": {},
"backtrace": "ad_cursor%3D2%3Bcurrent_page%3D1",
"components": null,
"cursor": 10,
"data": [
{
"aweme_info": {
"added_sound_music_info": {
"album": "",
"allow_offline_music_to_detail_page": false,
"artists": "… 0 items in the full response",
"audition_duration": 8,
"author": "Shaalaye Shaalaytu",
"author_deleted": false,
"author_position": null,
"avatar_medium": "…",
"avatar_thumb": "…",
"binded_challenge_id": 0,
"can_be_stitched": true,
"can_not_reuse": false,
"collect_stat": 0,
"commercial_right_type": 2,
"cover_large": "…",
"cover_medium": "…",
"cover_thumb": "…",
"create_time": 1791140539,
"dmv_auto_show": false,
"duration": 8,
"duration_high_precision": "…",
"external_song_info": "… 0 items in the full response",
"extra": "{\"amplitude_peak\":0,\"beats\":{},\"can_read\":true,\"can_reuse\":true,\"erase_type\":0,\"erase_uid\":0,\"extract_item_id\":7692889952505335053,\"from_user_id\":0,\"full_song_beat_info\":{},\"full_song_beats\":{},\"has_e…",
"has_commerce_right": true,
"has_commerce_right_strict": true,
"…": "43 more fields in the full response"
},
"ai_remix_info": {
"has_entrance": false
},
"aigc_info": {
"aigc_label_type": 0,
"created_by_ai": false
},
"anchors": null,
"anchors_extras": "",
"animated_image_info": {
"effect": 0,
"type": 0
},
"author": {
"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": "…",
"avatar_300x300": "…",
"avatar_larger": "…",
"avatar_medium": "…",
"avatar_thumb": "…",
"avatar_uri": "tos-useast5-avt-0068-tx/6b38490674b02cb0dfe82f15cddaf594",
"aweme_count": 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": "",
"cv_level": "",
"download_prompt_ts": 1750625881,
"enabled_filter_all_comments": false,
"…": "69 more fields in the full response"
},
"author_user_id": 7276602929624483000,
"aweme_acl": {
"download_general": "…",
"download_mask_panel": "…",
"platform_list": null,
"press_action_list": null,
"share_action_list": null,
"share_general": "…",
"share_list_status": 0
},
"aweme_id": "7692889952505335053",
"aweme_type": 0,
"banners": [
"…"
],
"behind_the_song_music_ids": null,
"behind_the_song_video_music_ids": null,
"bodydance_score": 0,
"bottom_products": null,
"branded_content_accounts": null,
"cc_template_info": {
"author_name": "",
"clip_count": 0,
"desc": "",
"duration_milliseconds": 0,
"related_music_id": "",
"template_id": ""
},
"cha_list": [
"…"
],
"challenge_position": null,
"cmt_swt": false,
"collect_stat": 0,
"comment_at_tako_info": {
"show_tako_account": 0
},
"comment_config": {
"comment_panel_show_tab_config": "…",
"comment_top_bar_component": "… 1 items in the full response",
"emoji_recommend_list": "… 11 items in the full response",
"long_press_recommend_list": null,
"preload": "…",
"quick_comment": "…",
"quick_comment_emoji_recommend_list": null,
"social_quick_comment": "…"
},
"comment_topbar_info": null,
"…": "116 more fields in the full response"
},
"card_profile": {},
"doc_id": 7692889952505335000,
"doc_type": 183,
"feedback_type": "video",
"preload_img": {
"urls": [
"https://p19-common-sign.tiktokcdn-us.com/tos-useast5-avt-0068-tx/6b38490674b02cb0dfe82f15cddaf594~tplv-tiktokx-cropcenter:100:100.webp?biz_tag=musically_general.video_user_cover&dr=9640&idc=useast8&ps…",
"… 1 more items in the full response"
]
},
"provider_doc_id_str": "7692889952505335053",
"search_aweme_info": {
"has_creation_intention": false
},
"type": 1
},
"… 1 more items in the full response"
],
"extra": {
"dc": "useast8",
"logid": "202610050952570A9009CD8E66AE752B82",
"now": 1791193977858,
"search_id": "202610050952570A9009CD8E66AE752B82",
"search_request_id": "",
"server_stream_time": 787
},
"global_doodle_config": {
"ab_params": {
"user_relation_ship": "1"
},
"can_pull_refresh": true,
"disable_reorder": 0,
"display_filter_bar": 1,
"ecom_api_version": "",
"ecom_search_info": {
"query_addr_intent": {
"query_addr_intent": false,
"query_addr_intent_creator": false,
"query_addr_intent_shop": false
}
},
"enable_multi_search": false,
"feedback_survey": [
{
"feedback_type": "activity_banner",
"long_stress_info": null,
"multiple_choices": [
"…",
"… 4 more items in the full response"
],
"send_us_multiple_choices": null
},
"… 18 more items in the full response"
],
"has_ecom_intent": true,
"hide_results": false,
"hit_dolphin": false,
"hit_shark": false,
"keyword": "faith sweatshirt",
"new_source": "recom_search",
"original_ecom_intent": 3,
"prefetch_degrade_level": 1,
"search_channel": "musically_general",
"search_intent": {},
"show_video_research_tab_list": false,
"tns_search_result": "Pass"
},
"has_more": false,
"headers": [],
"log_pb": {
"impr_id": "202610050952570A9009CD8E66AE752B82"
},
"prefer_layout": "double_column",
"qc": "",
"result_status": 4,
"status_code": 0,
"version": "v1"
}
}
]Select an example to load its inputs and result into the playground.
Searches TikTok's Top tab for a keyword and returns a mixed list of results, including user cards with sample videos and videos with play, like, comment and share counts. It needs one input, keyword. You can also sort by relevance or likes and filter by publish time.
openai.sort_type of 1 for most likes.publish_time to 7 or 30.aigc_info flags.curl -X POST "https://api.sandbase.ai/v1/api/tiktok/app-v3/general-search-result" \
-H "Authorization: Bearer $SANDBASE_API_KEY" \
-H "Content-Type: application/json" \
-d '{"keyword": "openai", "count": 5}'
The result is returned in outputs[0].data.
| Name | Type | Required | Description |
|---|---|---|---|
keyword | string | Yes | Keyword |
count | integer | No | Number |
offset | integer | No | Offset |
publish_time | integer | No | 0-Unlimited, 1-Last day, 7-Last week, 30-Last month, 90-Last three months, 180-Last half year |
sort_type | integer | No | 0-Relatedness, 1-Most likes |
Real response for the request above, trimmed: lists keep their first item and long strings are cut.
{
"ad_info": {},
"backtrace": "ad_cursor%3D16%3Bcurrent_page%3D1",
"components": null,
"cursor": 10,
"data": [
{
"card_profile": {
"category_tag_list": [
1
]
},
"card_title": "Users",
"doc_id": 1,
"doc_type": 180,
"feedback_type": "user",
"has_top_user": 0,
"preload_img": {
"urls": [
"https://p16-common-sign.tiktokcdn-us.com/tos-useast5-avt-0068-tx/d29bf4d0c36077c…"
]
},
"provider_doc_id_str": "1",
"type": 4,
"user_list": [
{
"challenges": null,
"effects": null,
"horizontal_data": {
"backtrace": "{\"cache_key\":\"loadmore_v1:202611030743526A582DF2CDFA6E018899|user_video_subcard|…",
"card_list": null,
"common_data": {
"horizontal_has_more": true
}
},
"items": [
{
"added_sound_music_info": {
"album": "",
"allow_offline_music_to_detail_page": false,
"artists": [],
"audition_duration": 64,
"author": "OpenAI",
"author_deleted": false,
"author_position": null,
"avatar_medium": {
"height": 720,
"uri": "tos-useast5-avt-0068-tx/d29bf4d0c36077c6aace74b1dd3c8204",
"url_list": [
"https://p19-common-sign.tiktokcdn-us.com/tos-useast5-avt-0068-tx/d29bf4d0c36077c…"
],
"url_prefix": null,
"width": 720
}
},
"ai_remix_info": {
"has_entrance": false
},
"aigc_info": {
"aigc_label_type": 0,
"created_by_ai": false
},
"anchors": null,
"anchors_extras": "",
"animated_image_info": {
"effect": 0,
"type": 0
},
"author": {
"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-useast5-avt-0068-tx/d29bf4d0c36077c6aace74b1dd3c8204",
"url_list": [
"https://p16-common-sign.tiktokcdn-us.com/tos-useast5-avt-0068-tx/d29bf4d0c36077c…"
],
"url_prefix": null,
"width": 720
},
"avatar_300x300": {
"height": 720,
"uri": "tos-useast5-avt-0068-tx/d29bf4d0c36077c6aace74b1dd3c8204",
"url_list": [
"https://p16-common-sign.tiktokcdn-us.com/tos-useast5-avt-0068-tx/d29bf4d0c36077c…"
],
"url_prefix": null,
"width": 720
}
},
"author_user_id": 7256178298626032683
}
],
"mix_cursor": 3,
"mix_has_more": 0,
"mix_list": [
{
"create_time": 1733529383,
"extra": "{}",
"ids": null,
"mix_id": "7445448327224724267",
"mix_name": "12 Days of OpenAI",
"mix_type": 1,
"name": "12 Days of OpenAI",
"status": {
"status": 1
}
}
],
"musics": null
}
],
"view_more": true
}
],
"extra": {
"dc": "useast8",
"logid": "202611030743526A582DF2CDFA6E018899",
"now": 1793691833542,
"search_id": "202611030743526A582DF2CDFA6E018899",
"search_request_id": "",
"server_stream_time": 925
},
"global_doodle_config": {
"ab_params": {
"user_relation_ship": "1"
},
"can_pull_refresh": true,
"disable_reorder": 0,
"display_filter_bar": 1,
"ecom_api_version": "",
"ecom_search_info": {
"query_addr_intent": {
"query_addr_intent": false,
"query_addr_intent_creator": false,
"query_addr_intent_shop": false
}
},
"enable_multi_search": false,
"feedback_survey": [
{
"feedback_type": "activity_banner",
"long_stress_info": null,
"multiple_choices": [
{
"key": "Unrelated content",
"value": "Unrelated content"
}
],
"send_us_multiple_choices": null
}
],
"has_ecom_intent": false,
"hide_results": false,
"hit_dolphin": false,
"hit_shark": false
},
"has_more": true,
"headers": [],
"log_pb": {
"impr_id": "202611030743526A582DF2CDFA6E018899"
},
"prefer_layout": "double_column",
"qc": ""
}
| Field | Meaning |
|---|---|
cursor | Cursor value for the returned page. The request used count 5 and the response returned 10. |
data[].card_title / data[].feedback_type | Label of the result block. A user block has card_title set to Users and feedback_type set to user. |
data[].user_list[].items[].author | Profile of the account that posted the video. It includes avatar images in several sizes, such as avatar_168x168 and avatar_300x300, each with a url_list. |
data[].user_list[].items[].author_user_id | Numeric ID of the account that posted the video. |
data[].user_list[].items[].aigc_info.created_by_ai | Boolean flag. It is true when the video is labelled as AI-generated. aigc_label_type holds the label code. |
data[].user_list[].items[].added_sound_music_info.author / album | Name of the sound's author and its album. Either can be an empty string. |
data[].user_list[].mix_list[].mix_id / mix_name | ID and title of a playlist (mix) that belongs to the matched user, such as 12 Days of OpenAI. |
data[].user_list[].mix_list[].create_time | Unix timestamp in seconds for when the mix was created. |
data[].user_list[].horizontal_data.common_data.horizontal_has_more | Boolean flag. It is true when the user card has more horizontal items to load. |
data[].preload_img.urls | Image URLs for previewing the result card. |
count and offset to page through results. sort_type takes 0 (relevance) or 1 (most likes). publish_time takes 0, 1, 7, 30, 90 or 180.data[].card_title or data[].feedback_type before you read a result.$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/general-search-result" \
-H "Authorization: Bearer $SANDBASE_API_KEY" \
-H "Content-Type: application/json" \
--data-binary @- <<'SANDBASE_JSON'
{
"count": 20,
"offset": 0,
"keyword": "faith sweatshirt",
"sort_type": 0,
"publish_time": 1
}
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
publish_timeinteger0-Unlimited, 1-Last day, 7-Last week, 30-Last month, 90-Last three months, 180-Last half year
Default: 0
sort_typeinteger0-Relatedness, 1-Most likes
Default: 0
Saved example response for this API; no live request is made when viewing it.
[
{
"data": {
"ad_info": {},
"backtrace": "ad_cursor%3D2%3Bcurrent_page%3D1",
"components": null,
"cursor": 10,
"data": [
{
"aweme_info": {
"added_sound_music_info": {
"album": "",
"allow_offline_music_to_detail_page": false,
"artists": "… 0 items in the full response",
"audition_duration": 8,
"author": "Shaalaye Shaalaytu",
"author_deleted": false,
"author_position": null,
"avatar_medium": "…",
"avatar_thumb": "…",
"binded_challenge_id": 0,
"can_be_stitched": true,
"can_not_reuse": false,
"collect_stat": 0,
"commercial_right_type": 2,
"cover_large": "…",
"cover_medium": "…",
"cover_thumb": "…",
"create_time": 1791140539,
"dmv_auto_show": false,
"duration": 8,
"duration_high_precision": "…",
"external_song_info": "… 0 items in the full response",
"extra": "{\"amplitude_peak\":0,\"beats\":{},\"can_read\":true,\"can_reuse\":true,\"erase_type\":0,\"erase_uid\":0,\"extract_item_id\":7692889952505335053,\"from_user_id\":0,\"full_song_beat_info\":{},\"full_song_beats\":{},\"has_e…",
"has_commerce_right": true,
"has_commerce_right_strict": true,
"…": "43 more fields in the full response"
},
"ai_remix_info": {
"has_entrance": false
},
"aigc_info": {
"aigc_label_type": 0,
"created_by_ai": false
},
"anchors": null,
"anchors_extras": "",
"animated_image_info": {
"effect": 0,
"type": 0
},
"author": {
"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": "…",
"avatar_300x300": "…",
"avatar_larger": "…",
"avatar_medium": "…",
"avatar_thumb": "…",
"avatar_uri": "tos-useast5-avt-0068-tx/6b38490674b02cb0dfe82f15cddaf594",
"aweme_count": 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": "",
"cv_level": "",
"download_prompt_ts": 1750625881,
"enabled_filter_all_comments": false,
"…": "69 more fields in the full response"
},
"author_user_id": 7276602929624483000,
"aweme_acl": {
"download_general": "…",
"download_mask_panel": "…",
"platform_list": null,
"press_action_list": null,
"share_action_list": null,
"share_general": "…",
"share_list_status": 0
},
"aweme_id": "7692889952505335053",
"aweme_type": 0,
"banners": [
"…"
],
"behind_the_song_music_ids": null,
"behind_the_song_video_music_ids": null,
"bodydance_score": 0,
"bottom_products": null,
"branded_content_accounts": null,
"cc_template_info": {
"author_name": "",
"clip_count": 0,
"desc": "",
"duration_milliseconds": 0,
"related_music_id": "",
"template_id": ""
},
"cha_list": [
"…"
],
"challenge_position": null,
"cmt_swt": false,
"collect_stat": 0,
"comment_at_tako_info": {
"show_tako_account": 0
},
"comment_config": {
"comment_panel_show_tab_config": "…",
"comment_top_bar_component": "… 1 items in the full response",
"emoji_recommend_list": "… 11 items in the full response",
"long_press_recommend_list": null,
"preload": "…",
"quick_comment": "…",
"quick_comment_emoji_recommend_list": null,
"social_quick_comment": "…"
},
"comment_topbar_info": null,
"…": "116 more fields in the full response"
},
"card_profile": {},
"doc_id": 7692889952505335000,
"doc_type": 183,
"feedback_type": "video",
"preload_img": {
"urls": [
"https://p19-common-sign.tiktokcdn-us.com/tos-useast5-avt-0068-tx/6b38490674b02cb0dfe82f15cddaf594~tplv-tiktokx-cropcenter:100:100.webp?biz_tag=musically_general.video_user_cover&dr=9640&idc=useast8&ps…",
"… 1 more items in the full response"
]
},
"provider_doc_id_str": "7692889952505335053",
"search_aweme_info": {
"has_creation_intention": false
},
"type": 1
},
"… 1 more items in the full response"
],
"extra": {
"dc": "useast8",
"logid": "202610050952570A9009CD8E66AE752B82",
"now": 1791193977858,
"search_id": "202610050952570A9009CD8E66AE752B82",
"search_request_id": "",
"server_stream_time": 787
},
"global_doodle_config": {
"ab_params": {
"user_relation_ship": "1"
},
"can_pull_refresh": true,
"disable_reorder": 0,
"display_filter_bar": 1,
"ecom_api_version": "",
"ecom_search_info": {
"query_addr_intent": {
"query_addr_intent": false,
"query_addr_intent_creator": false,
"query_addr_intent_shop": false
}
},
"enable_multi_search": false,
"feedback_survey": [
{
"feedback_type": "activity_banner",
"long_stress_info": null,
"multiple_choices": [
"…",
"… 4 more items in the full response"
],
"send_us_multiple_choices": null
},
"… 18 more items in the full response"
],
"has_ecom_intent": true,
"hide_results": false,
"hit_dolphin": false,
"hit_shark": false,
"keyword": "faith sweatshirt",
"new_source": "recom_search",
"original_ecom_intent": 3,
"prefetch_degrade_level": 1,
"search_channel": "musically_general",
"search_intent": {},
"show_video_research_tab_list": false,
"tns_search_result": "Pass"
},
"has_more": false,
"headers": [],
"log_pb": {
"impr_id": "202610050952570A9009CD8E66AE752B82"
},
"prefer_layout": "double_column",
"qc": "",
"result_status": 4,
"status_code": 0,
"version": "v1"
}
}
]Explore more
| API | Price | Response |
|---|---|---|
TikTok SearchThis 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/general-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. Every organization gets 100 free calls per UTC day, shared across eligible SandBase APIs including this one; after that each call is billed at this price from your SandBase balance. There is no subscription.
Required: keyword (string). Optional: count (integer), offset (integer), publish_time (integer) and sort_type (integer). 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 Search 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.