douyin/search/multi-search

Fetch multi-type search

Purpose:

• Fetch multiple types of search results (videos, users, music, hashtags, etc.) from Douyin App.

Notes:

• Set cursor to 0 and search_id to an empty string for the first request.
• Suitable for search aggregation pages, discovery modules, and recommendations.

Parameters:

• keyword: Search keyword, e.g., "Artificial Intelligence"
• cursor: Pagination cursor (0 for the first page, use the last response cursor for subsequent pages)
• sort_type: Sorting method
  • 0: Comprehensive
  • 1: Most likes
  • 2: Latest
• publish_time: Publish time filter
  • 0: Unlimited
  • 1: Last day
  • 7: Last week
  • 180: Last half year
• filter_duration: Video duration filter
  • 0: Unlimited
  • 0-1: Within 1 minute
  • 1-5: 1 to 5 minutes
  • 5-10000: More than 5 minutes
• content_type: Content type filter
  • 0: Unlimited
  • 1: Video
  • 2: Picture
  • 3: Article
• search_id: Search ID used for pagination

Request Body Example:

payload = {
    "keyword": "Artificial Intelligence",
    "cursor": 0,
    "sort_type": "0",
    "publish_time": "0",
    "filter_duration": "0",
    "content_type": "0",
    "search_id": ""
}

Response (common fields, actual response may contain more fields):

• cursor: Cursor for the next page

• has_more: Whether there are more results (1=Yes, 0=No)

• business_data[]: List of search result items

  • data_id: Data ID
  • type: Result type
    • 1: Video (aweme_info)
    • 2: User (user_info)
    • 4: Music (music_info)
    • 6: Hashtag (cha_info)
  • data: Content depending on type
    • if type = 1 (video):
      • aweme_info: Detailed video info
    • if type = 2 (user):
      • user_info: Detailed user info
    • if type = 4 (music):
      • music_info: Music details
    • if type = 6 (hashtag):
      • cha_info: Hashtag details

• extra:

  • now: Current server timestamp
  • logid: Request log ID

Imported from a validated TikHub OpenAPI document. Pricing must be reviewed before enabling.