douyin/search/video-search-v1

Fetch video search V1

Purpose:

• Fetch video content search results from Douyin App based on a keyword.
• This API is focused on video search results only.

Notes:

• Set cursor to 0 and search_id to an empty string for the first request.
• Each returned video includes rich details: author, video info, music, statistics, etc.
• Also returns a set of suggested keywords (guide_search_words) for user guidance.

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(obtained from the last response)
• backtrace: Backtrace identifier used for pagination(obtained from the last response)

Request Body Example:

payload = {
    "keyword": "Artificial Intelligence",
    "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):

• status_code: Response status code (0 = success)

• cursor: Cursor for the next page

• has_more: Whether more data is available (1=Yes, 0=No)

• data[]: List of video search results

  • type: Result type (usually 1)
  • aweme_info: Detailed video information
    • Basic info:
      • aweme_id: Video ID
      • desc: Description
      • create_time: Publish timestamp
    • Author (author):
      • uid: User ID
      • nickname: Nickname
      • is_verified: Whether verified
      • region: Region
      • avatar_thumb.url_list: Thumbnail avatars
      • follower_count: Follower count
      • enterprise_verify_reason: Enterprise verification reason
    • Music (music):
      • id_str: Music ID
      • title: Music title
      • author: Music creator
      • play_url.url_list: Music play URLs
    • Video (video):
      • play_addr.url_list: Play URLs
      • cover.url_list: Cover images
      • dynamic_cover.url_list: Dynamic covers
      • origin_cover.url_list: Original covers
      • ratio: Resolution, e.g., "720p"
      • duration: Video duration (ms)
      • bit_rate[]: Multiple resolution sources
        • gear_name: Gear name
        • bit_rate: Bit rate
        • play_addr.url_list: Play URLs
    • Statistics (statistics):
      • comment_count: Number of comments
      • digg_count: Number of likes
      • share_count: Number of shares
      • play_count: Number of plays
    • Status (status):
      • is_delete: Whether deleted
      • is_private: Whether private
      • allow_share: Whether sharing is allowed
      • allow_comment: Whether commenting is allowed
    • Other fields:
      • share_url: External share link
      • user_digged: Whether liked (0=No, 1=Yes)

• guide_search_words[]: Suggested keywords

  • id: Suggestion ID
  • word: Suggested keyword
  • type: Suggestion type (usually recom)
  • query_id: Suggestion query ID

• extra:

  • now: Current server timestamp
  • logid: Log ID

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