Douyin General Search (V2) API

Look up Douyin general search results using a query keyword and optional parameters for sorting and content filtering.

Use cases

• Retrieve mixed search cards matching specific keywords on Douyin.
• Filter Douyin search items by post date, video length, or sort order.
• Paginate through general search rankings using session tokens.

Request

curl -X POST "https://api.sandbase.ai/v1/api/douyin/search/general-search-v2" \
  -H "Authorization: Bearer $SANDBASE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{}'

Parameters

Example response

Real response for the request above, trimmed to the main fields. User names and long IDs are masked.

{
  "business_data": [
    {
      "card_id": "douyin.doctype_aweme_image",
      "data_id": "0",
      "type": 1,
      "data": {
        "card_id": "douyin.doctype_aweme_image",
        "card_type": 1,
        "doc_type": 303,
        "provider_doc_id": 7621594405576706417,
        "provider_doc_id_str": "7621594405576706417",
        "type": 1
      },
      "log": {
        "search_result_id": "7621594405576706417"
      }
    }
  ]
}

Notes

• Set cursor to 0 for initial requests and pass the returned value for subsequent pages.
• Pass search_id and backtrace from previous responses to maintain pagination state.

Related APIs

• Douyin Challenge Search: Returns Douyin challenge and hashtag search results matching a query.
• Douyin Hashtag Challenge Search (V2): Returns Douyin hashtag and challenge search results matching a query keyword.
• Douyin Hashtag Suggestions: Returns a list of suggested Douyin hashtags and challenges matching a query keyword, including challenge IDs and view counts.