douyin/search/video-search-v2

Fetch video search V2

Purpose:

• Fetch video search results from Douyin App using V2 API version.
• Compared to V1, returns more detailed information including author details, multi-resolution video sources, and hashtags.

Notes:

• Set cursor to 0 and search_id to an empty string for the first request.
• The response contains rich video data, suitable for display, content scraping, or intelligent analysis.

Parameters:

• keyword: Search keyword, e.g., "robot"
• 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": "robot",
    "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):

• business_data[]: List of returned data items

  • data_id: Data ID (string, e.g., "0")
  • type: Data type (1=Video)
  • data:
    • type: Same as above (1)
    • aweme_info: Detailed video information
      • Basic Info:
        • aweme_id: Video ID
        • desc: Video description
        • create_time: Creation timestamp
      • Author Info (author):
        • uid: Unique User ID
        • short_id: Short ID
        • nickname: Nickname
        • signature: Bio
        • follower_count: Follower count
        • is_verified: Whether verified
        • region: Region, e.g., "CN"
        • avatar_thumb.url_list: Thumbnail avatar URLs
        • avatar_medium.url_list: Medium avatar URLs
        • avatar_larger.url_list: Large avatar URLs
        • enterprise_verify_reason: Enterprise verification info
      • Music (music):
        • id_str: Music ID
        • title: Music title
        • author: Music creator nickname
        • play_url.url_list: List of play URLs
      • Video (video):
        • play_addr.url_list: Play URLs (supports HD)
        • cover.url_list: Cover images
        • dynamic_cover.url_list: Dynamic covers
        • origin_cover.url_list: Original covers
        • duration: Duration (milliseconds)
        • ratio: Resolution (e.g., "720p")
        • bit_rate[]: Multiple bitrates
          • gear_name: Gear name
          • bit_rate: Bitrate (bps)
          • play_addr.url_list: Play URLs
      • Hashtags (cha_list[]):
        • cha_name: Hashtag name (e.g., "#UnitreeRobot")
        • cid: Hashtag ID
        • share_url: Hashtag share link
      • Statistics (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 (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: Video external share link
        • user_digged: Whether the user has liked (0=No, 1=Yes)

• cursor: Cursor for next page

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

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