Douyin modelsapi generation api

douyin/search/experience-search

Fetch experience (knowledge/tutorial) content search results from Douyin App. Retrieves video results related to knowledge sharing, tutorials, or tips based on the input keyword.

Input
Idle

Example output — click Run to generate your own

API README

Fetch experience search

Purpose:

  • Fetch experience (knowledge/tutorial) content search results from Douyin App.
  • Retrieves video results related to knowledge sharing, tutorials, or tips based on the input keyword.

Notes:

  • This API focuses on experience-related videos and does not include other content types.
  • Set cursor to 0 and search_id to an empty string for the first request; for pagination, use the previous cursor and search_id.
  • The response includes rich information such as video details, author profile, background music, hashtags, video URLs, and engagement statistics.

Parameters:

  • keyword: Search keyword, e.g., "gaming guide"
  • cursor: Pagination cursor (0 for first page)
  • 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 (usually fixed to video)
  • search_id: Search ID for pagination

Request Body Example:

payload = {
    "keyword": "gaming guide",
    "cursor": 0,
    "sort_type": 0,
    "publish_time": 0,
    "filter_duration": 0,
    "content_type": 1,
    "search_id": ""
}

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

  • business_data: List of business data blocks
    • data_id: Data block ID
    • type: Data type (e.g., 999 for content list)
    • data:
      • height: Display height
      • aweme_list: List of videos
        • aweme_id: Video ID
        • desc: Video description
        • create_time: Creation timestamp
        • author: Author profile
          • uid: User ID
          • nickname: User nickname
          • avatar_thumb.url_list: Thumbnail avatar URLs
          • is_verified: Whether the author is verified
          • follower_count: Number of followers
        • music: Background music information
          • id_str: Music ID
          • title: Music title
          • author: Music author's name
        • cha_list: Associated hashtags
          • cha_name: Hashtag name
        • video: Video playback info
          • play_addr.url_list: List of video play URLs
          • cover.url_list: List of video cover image URLs
          • width: Video width
          • height: Video height
          • duration: Video duration in milliseconds
        • statistics: Video engagement data
          • digg_count: Number of likes
          • comment_count: Number of comments
          • share_count: Number of shares
          • play_count: Number of plays
        • status: Video status information
          • is_delete: Whether the video was deleted
          • is_private: Whether the video is private
        • share_url: External share link of the video

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

Related Models

douyin/search/challenge-search-v1Fetch hashtag/challenge search results from Douyin App. Returns related hashtag topics including name, view count, participants, and cover images.douyin/search/challenge-search-v2Fetch hashtag/challenge search results from Douyin App using V2 API. Supports searching by keyword and returns detailed challenge information, including name, cover image, view count, and participant count.douyin/search/challenge-suggestFetch hashtag/challenge suggestions from Douyin App based on the input keyword. Returns a list of related hashtags including name and view count.douyin/search/discuss-searchFetch discussion/Q&A search results from Douyin App. Supports filtering by keyword, sort type, publish time, content type, etc.douyin/search/general-search-v1Fetch search results from Douyin App's general search tab (not standalone video search). Supports filtering by keyword, sort type, publish time, video duration, and content type. Supports pagination through `cursor`, `search_id`, and `backtrace`.douyin/search/general-search-v2Fetch 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`.douyin/search/image-searchFetch image-based search results from Douyin App. Mainly returns posts containing image collections.douyin/search/image-search-v3Fetch image-text content search results from Douyin App. Returns posts with multiple images (aweme_type=68), suitable for gallery-style applications.