SandBaseSandBase
Start building
Use in agentDocsDouyin models

Douyin modelsapi generation api

douyin/search/user-search-v2

Fetch a list of users from Douyin App based on search keywords. Supports filtering by fan count and user type.

Input
Idle

Example output — click Run to generate your own

API README

Fetch user search V2

Purpose:

  • Fetch a list of users from Douyin App based on search keywords.
  • Supports filtering by fan count and user type.

Notes:

  • Set cursor to 0.
  • Only user information is returned. No videos, music, or hashtags.

Parameters:

  • keyword: Search keyword, e.g., "AI"
  • cursor: Pagination cursor (0 for first page)

Request Body Example:

payload = {
    "keyword": "AI",
    "cursor": 0
}

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

  • cursor: Cursor for next page
  • has_more: Whether more data is available (1=Yes, 0=No)
  • user_list[]: List of users
    • user_info:
      • uid: User ID
      • nickname: Nickname
      • gender: Gender (0=Unknown, 1=Male, 2=Female)
      • unique_id: Douyin ID
      • sec_uid: Secured UID
      • signature: Personal bio
      • follower_count: Number of followers
      • avatar_thumb.url_list: List of thumbnail avatar URLs
      • avatar_medium.url_list: List of medium avatar URLs
      • avatar_larger.url_list: List of large avatar URLs
      • follow_status: Whether followed
      • live_status: Whether live
      • enterprise_verify_reason: Enterprise verification info (if any)
      • versatile_display: Display text (e.g., "Douyin ID: xxx")
  • extra:
    • now: Current server timestamp
    • logid: Request log ID
    • search_request_id: Search request 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.