SandBaseSandBase
Start building
Use in agentDocsDouyin models

Douyin modelsapi generation api

douyin/search/live-search-v1

Fetch live stream search results from Douyin App. Returns information about live rooms including streamer profile, cover image, viewer count, and stream URLs.

Input
Idle

Example output — click Run to generate your own

API README

Fetch live search V1

Purpose:

  • Fetch live stream search results from Douyin App.
  • Returns information about live rooms including streamer profile, cover image, viewer count, and stream URLs.

Notes:

  • Only live streaming content is returned.
  • Set cursor to 0 and search_id to an empty string for the first request.
  • Use the last response's cursor and search_id for pagination.

Parameters:

  • keyword: Search keyword, e.g., "games"
  • cursor: Pagination cursor (0 for first request)
  • 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
  • content_type: Content type (fixed for live stream)
  • search_id: Search ID for pagination

Request Body Example:

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

  • cursor: Cursor for next page
  • has_more: Whether there are more results (1=Yes, 0=No)
  • data[]: List of live stream rooms
    • type: Result type (fixed to 1)
    • lives:
      • aweme_id: Related content ID
      • group_id: Group ID
      • author:
        • uid: Streamer's user ID
        • nickname: Streamer's nickname
        • short_id: Streamer's short ID
        • avatar_thumb.url_list: Thumbnail avatar URLs
        • avatar_medium.url_list: Medium avatar URLs
        • avatar_larger.url_list: Large avatar URLs
        • room_id: Room ID
        • room_cover.url_list: Room cover image URLs
      • video:
        • tags[]: Live tags (e.g., "Gaming", "Chatting")
          • title: Tag title
          • url.url_list: Tag icon URLs
      • rawdata: Raw live room data (as JSON string)
        • title: Live title
        • user_count: Current viewer count
        • stream_url: Stream URLs
          • flv_pull_url: FLV stream URLs by resolution
          • hls_pull_url: HLS stream URL (optional)
        • cover.url_list: Room cover image
        • size: Resolution (e.g., 1920x1080)
        • stats.total_user: Viewer count
  • extra:
    • now: Current server timestamp
    • logid: Request log ID
    • search_request_id: Unique search session ID

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/experience-searchFetch experience (knowledge/tutorial) content search results from Douyin App. Retrieves video results related to knowledge sharing, tutorials, or tips based on the input keyword.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.