Douyin General Search

API docs
https://api.sandbase.ai/v1/api/douyin/search/general-search-v1

Search 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.

Price
$0.01USD / call
Method
POST
Response
JSON
Parameters
0 required · 8 optional
100 free calls / dayFirst 100 calls per day free (shared per organization) · Resets at 00:00 UTC. Pay per call after that.

Playground

Input
Backtrace identifier (empty for first request, obtained from previous response for pagination)
Content type filter
Pagination cursor (0 for the first page, use the last response cursor for subsequent pages)
Video duration filter
Search keyword, e.g., "cat"
Publish time filter
Search ID (empty for first request, obtained from previous response for pagination)
Sorting method
OutputReady

Your output will appear here

Complete the inputs, then click Run.

API README

Douyin General Search API

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.

Use cases

  • Collect the top Douyin posts for a keyword such as a pet breed or product name.
  • Find creators who post about a topic by reading publish_username and author_user_id.
  • Track new posts that mention a brand by filtering on publish time and reading the caption text.
  • Build a list of post IDs for a topic and fetch each one in full with another API.

Request

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.

Parameters

NameTypeRequiredDescription
backtracestringNoBacktrace identifier (empty for first request, obtained from previous response for pagination)
content_typestringNoContent type filter
cursorintegerNoPagination cursor (0 for the first page, use the last response cursor for subsequent pages)
filter_durationstringNoVideo duration filter
keywordstringNoSearch keyword, e.g., "cat"
publish_timestringNoPublish time filter
search_idstringNoSearch ID (empty for first request, obtained from previous response for pagination)
sort_typestringNoSorting method

Example response

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
}

Response fields

FieldMeaning
data[].impression_server_log.doc_titleCaption 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_idID of the result as a string. All three hold the same value for a given item.
data[].impression_server_log.publish_usernameDisplay name of the author who posted the result.
data[].impression_server_log.publish_timePublish time of the result as a Unix timestamp in seconds.
data[].aweme_info.author_user_idNumeric 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_typeType 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_countLike 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_timeID of that comment and its creation time as a Unix timestamp in seconds.
data[].log_data.search_idID of this search. Send it back as search_id to get the next page.

Notes

  • For the first page, send only 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.
  • Results mix videos and image posts. Check card_id or doc_type to tell them apart.
  • Pass a result ID to Douyin Video Detail to load one item. For another search layout, try Douyin General Search (V2).

Pricing

$0.01 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
Douyin$0.01 per callJSON
Douyin$0.01 per callJSON
Douyin$0.01 per callJSON
Douyin$0.01 per callJSON
Douyin$0.01 per callJSON
Douyin$0.01 per callJSON

Questions

FAQ

How do I use the Douyin General Search API?

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.

How much does the Douyin General Search API cost?

$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.

What parameters does the Douyin General Search API accept?

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.

What does the Douyin General Search 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 Douyin developer account or API key?

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.