backtracestring
Backtrace identifier (empty for first request, obtained from previous response for pagination)
Default: ""
https://api.sandbase.ai/v1/api/douyin/search/general-search-v1Search Douyin (Chinese TikTok) from the app's general search tab and get videos with descriptions, authors and play, like, comment and share counts. Filter by sort, publish time, duration and content type.
Your output will appear here
Complete the inputs, then click Run.
Returns Douyin search results for a keyword from the app's general search tab. Each result is a video or image post with its caption, author and an ID. The only input needed is keyword.
publish_username and author_user_id.curl -X POST "https://api.sandbase.ai/v1/api/douyin/search/general-search-v1" \
-H "Authorization: Bearer $SANDBASE_API_KEY" \
-H "Content-Type: application/json" \
-d '{"keyword": "猫咪"}'
The result is returned in outputs[0].data.
| Name | Type | Required | Description |
|---|---|---|---|
backtrace | string | No | Backtrace identifier (empty for first request, obtained from previous response for pagination) |
content_type | string | No | Content type filter |
cursor | integer | No | Pagination cursor (0 for the first page, use the last response cursor for subsequent pages) |
filter_duration | string | No | Video duration filter |
keyword | string | No | Search keyword, e.g., "cat" |
publish_time | string | No | Publish time filter |
search_id | string | No | Search ID (empty for first request, obtained from previous response for pagination) |
sort_type | string | No | Sorting method |
Real response for the request above, trimmed: lists keep their first item and long strings are cut.
{
"ad_info": {},
"backtrace": "QcYdxJw7yf6duzkWgjcv9m6lNSZ4EWGHlekiwBFcWNm/eLx9nrk3/Ud/xt7uVeZWofx64xqtZ7DyvuOe…",
"cursor": 20,
"data": [
{
"aweme_info": {
"activity_video_type": -1,
"ai_follow_images": null,
"ai_search_struct": {
"show_ai_entrance": true
},
"anchors": null,
"authentication_token": "MS4wLjAA…",
"author": {
"accept_private_policy": false,
"account_cert_info": "{}",
"account_region": "",
"ad_cover_url": null,
"allow_story_normal_like": false,
"apple_account": 0,
"authority_status": 0,
"avatar_168x168": {
"height": 720,
"uri": "168x168/aweme-avatar/tos-cn-i-0813c000-ce_oEKA8FFsbIDrpkAAXWAwfoEqqkQM9fwEeA9hKE",
"url_list": [
"https://p3.douyinpic.com/img/aweme-avatar/tos-cn-i-0813c000-ce_oEKA8FFsbIDrpkAAX…"
],
"width": 720
}
},
"author_mask_tag": 0,
"author_user_id": 99421008169
},
"aweme_list": null,
"card_id": "douyin.doctype_aweme_video",
"card_info": {
"search_autoplay_business": "153_dy"
},
"card_style_type": 1,
"card_type": 1,
"card_type_id": {
"card_name": "153|1|double",
"doc_type": 153,
"performance_infos": {
"153": 1,
"double_column": 1,
"is_native": 1,
"search_card_count": 1,
"video_has_lynx_anchor": 0
}
},
"card_type_name": "",
"comment_list": [
{
"aweme_id": "7697482617494657147",
"cid": "7697483159202726665",
"create_time": 1792209959,
"decorated_emoji_info": null,
"digg_count": 6,
"enter_from": "others_homepage",
"group_id": 7697482617494657147,
"image_list": null
}
],
"data": {
"card_tags": null,
"common_tab_config": null,
"hotspot_tab_config": null,
"recom_extra_info": {
"suggest_words_config": 3,
"suggest_words_params": {
"doc_type": "153",
"item_id": "7697482617494657147",
"product_id": ""
}
}
},
"debug_data": {
"filter_debug_info_list": null
},
"debug_diff_info": {}
}
],
"extra": {
"fatal_item_ids": [],
"logid": "202611031532171EB06BE851C10A585E5E",
"now": 1793691138684,
"scenes": null,
"search_request_id": "",
"start_ms": 1793691137274
},
"global_doodle_config": {
"activity_tag": null,
"comment_config": {
"disable_comment_bar": true
},
"display_music_anchor": 2,
"double_column_button_style": 2,
"double_column_layout_type": 3,
"ecom_intent": "intent_not_ecom",
"extra_server_client_params": "{\"last_strong_style_card_idx\":0}",
"is_double_column_left": 0,
"keyword": "猫咪",
"search_pop_info": [],
"srp_algo_for_wind_vane": "{\"bp_personal_strategy_level\":0,\"cate_lv1\":[20063,20041],\"ecom_bp_buy_intent\":0,…",
"user_guide": {
"inflow_second": 0,
"inflow_stop": 7,
"resp_second": 5,
"show_inflow_guide": true,
"show_resp_guide": true
}
},
"guide_search_words": [
{
"attached_text": null,
"id": "6594507188880807176",
"query_id": "6537523068217103624",
"type": "recom",
"word": "图片"
}
],
"guide_search_words_extra": {},
"has_more": 1,
"log_pb": {
"impr_id": "202611031532171EB06BE851C10A585E5E",
"search_source": "homepage_recom_search",
"stab_extra": {
"traffic_identification": "normal"
}
},
"maokai_extra": {},
"new_framework_single_column_card_count": 0
}
| Field | Meaning |
|---|---|
data[].impression_server_log.doc_title | Caption text of the result. Long captions can include line breaks and hashtags. |
data[].impression_server_log.gid / data[].provider_doc_id_str / data[].log_data.search_result_id | ID of the result as a string. All three hold the same value for a given item. |
data[].impression_server_log.publish_username | Display name of the author who posted the result. |
data[].impression_server_log.publish_time | Publish time of the result as a Unix timestamp in seconds. |
data[].aweme_info.author_user_id | Numeric ID of the author. |
data[].aweme_info.author.avatar_168x168.url_list[] | Image URLs for the author's 168x168 avatar, in WebP and JPEG formats. |
data[].card_id / data[].doc_type | Type of the result. douyin.doctype_aweme_video with doc_type 153 is a video, and douyin.doctype_aweme_image with doc_type 303 is an image post. |
data[].comment_list[].digg_count | Like count of a comment shown with the result. The comment_list can be missing on some items. |
data[].comment_list[].cid / data[].comment_list[].create_time | ID of that comment and its creation time as a Unix timestamp in seconds. |
data[].log_data.search_id | ID of this search. Send it back as search_id to get the next page. |
keyword. For the next page, send the top-level cursor and backtrace from the previous response, plus search_id.sort_type, content_type, publish_time and filter_duration are strings. The default "0" applies no filter.card_id or doc_type to tell them apart.$0.01 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/douyin/search/general-search-v1" \
-H "Authorization: Bearer $SANDBASE_API_KEY" \
-H "Content-Type: application/json" \
--data-binary @- <<'SANDBASE_JSON'
{
"cursor": 0,
"keyword": "猫咪",
"backtrace": "",
"search_id": "",
"sort_type": "0",
"content_type": "0",
"publish_time": "0",
"filter_duration": "0"
}
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.
backtracestringBacktrace identifier (empty for first request, obtained from previous response for pagination)
Default: ""
content_typestringContent type filter
Default: "0"
cursorintegerPagination cursor (0 for the first page, use the last response cursor for subsequent pages)
Default: 0
filter_durationstringVideo duration filter
Default: "0"
keywordstringSearch keyword, e.g., "cat"
Default: "猫咪"
publish_timestringPublish time filter
Default: "0"
search_idstringSearch ID (empty for first request, obtained from previous response for pagination)
Default: ""
sort_typestringSorting method
Default: "0"
Saved example response for this API; no live request is made when viewing it.
No saved response has been published. Run the API in Playground to inspect its response.
Explore more
| API | Price | Response |
|---|---|---|
Douyin General SearchThis API Douyin | $0.01 per call | JSON |
Douyin | $0.01 per call | JSON |
Douyin | $0.01 per call | JSON |
Douyin | $0.01 per call | JSON |
Douyin | $0.01 per call | JSON |
Douyin | $0.01 per call | JSON |
Questions
Send a POST request to https://api.sandbase.ai/v1/api/douyin/search/general-search-v1 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.01 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.
No parameters are required. Optional: backtrace (string), content_type (string), cursor (integer), filter_duration (string), keyword (string) and publish_time (string) and 2 more. 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. Douyin General 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 Douyin API access separately.