douyin/search/discuss-search

Fetch discussion search

Purpose:

• Fetch discussion/Q&A search results from Douyin App.
• Supports filtering by keyword, sort type, publish time, content type, etc.

Notes:

• This API focuses on discussion and Q&A content, not including other content types.
• Set cursor to 0 and search_id to an empty string for the first request.
• The response includes video details, author info, playback info, statistics, hashtags, etc.

Parameters:

• keyword: Search keyword, e.g., "study abroad"
• cursor: Pagination cursor (0 for 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": "study abroad",
    "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):

• data: List of search result items
  • type: Result type (usually 1)
  • aweme_info: Video information
    • aweme_id: Video ID
    • desc: Description
    • author:
      • uid: User ID
      • nickname: User nickname
      • is_verified: Verified user or not
      • region: User region
      • avatar_thumb.url_list: Thumbnail avatar URLs
      • avatar_medium.url_list: Medium avatar URLs
      • avatar_larger.url_list: Large avatar URLs
    • video:
      • play_addr.url_list: Video playback URLs
      • cover.url_list: Video cover URLs
      • dynamic_cover.url_list: Dynamic cover URLs
      • origin_cover.url_list: Original cover URLs
      • width: Width in pixels
      • height: Height in pixels
      • ratio: Resolution ratio (e.g., 540p)
      • duration: Duration in milliseconds
      • download_addr.url_list: Download URLs with watermark
    • 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 collections
    • cha_list:
      • cha_name: Hashtag name
      • share_url: Hashtag share link
    • music:
      • id_str: Music ID
      • title: Music title
      • author: Music creator name
      • play_url.url_list: List of music playback URLs
    • status:
      • is_delete: Whether deleted
      • is_private: Whether private
      • allow_share: Allow sharing
      • allow_comment: Allow commenting
    • share_url: External video share link

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