douyin/search/general-search-v2

Fetch general search V2

Purpose:

• Fetch search results from Douyin App's general search tab (not standalone video search).
• This API may be less stable than V1, serving as a backup.
• Supports filtering by keyword, sort type, publish time, video duration, and content type.
• Supports pagination through cursor, search_id, and backtrace.

Notes:

• Set cursor to 0, search_id and backtrace to empty strings for the first request.
• For pagination, obtain cursor, search_id, and backtrace values from the previous response.
• The response contains rich information including video details, author info, music, hashtags, playback info, and interaction metrics.

Parameters:

• keyword: Search keyword, e.g., "cat"
• 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 (empty for first request, obtained from previous response for pagination)
• backtrace: Backtrace identifier (empty for first request, obtained from previous response for pagination)

Request Body Example:

payload = {
    "keyword": "cat",
    "cursor": 0,
    "sort_type": "0",
    "publish_time": "0",
    "filter_duration": "0",
    "content_type": "0",
    "search_id": "",
    "backtrace": ""
}

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

• data: List of search result items
• type: Result type (usually 1)
• aweme_info: Video detailed information
• aweme_id: Video ID
• desc: Video description
• author:
  • uid: Author's user ID
  • nickname: Author's nickname
  • is_verified: Whether the author is verified
  • region: Author's region
  • avatar_thumb.url_list: List of thumbnail avatar URLs
  • avatar_medium.url_list: List of medium size avatar URLs
  • avatar_larger.url_list: List of large size avatar URLs
• music:
  • id_str: Music ID
  • title: Music title
  • author: Music creator's name
  • play_url.url_list: List of music play URLs
• cha_list:
  • cha_name: Hashtag name
  • share_url: Hashtag share URL
• video:
  • play_addr.url_list: List of video play URLs
  • cover.url_list: List of cover image URLs
  • dynamic_cover.url_list: List of dynamic cover URLs
  • origin_cover.url_list: List of original cover URLs
  • width: Video width (pixels)
  • height: Video height (pixels)
  • ratio: Resolution ratio (e.g., 540p)
  • duration: Duration in milliseconds
  • download_addr.url_list: List of video download URLs
• statistics:
  • comment_count: Number of comments
  • digg_count: Number of likes
  • share_count: Number of shares
  • play_count: Number of plays
  • collect_count: Number of collects
• status:
  • is_delete: Whether the video is deleted
  • is_private: Whether the video is private
  • allow_share: Whether sharing is allowed
  • allow_comment: Whether commenting is allowed
• share_url: External share link

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