douyin/search/user-search

Fetch user search

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 and search_id to an empty string for the first request.
• Only user information is returned. No videos, music, or hashtags.

Parameters:

• keyword: Search keyword, e.g., "AI"
• cursor: Pagination cursor (0 for first page)
• douyin_user_fans: Fan count filter
  • Empty: No limit
  • "0_1k": Below 1000 fans
  • "1k_1w": 1,000 to 10,000 fans
  • "1w_10w": 10,000 to 100,000 fans
  • "10w_100w": 100,000 to 1,000,000 fans
  • "100w_": Above 1,000,000 fans
• douyin_user_type: User type filter
  • Empty: No limit
  • "common_user": Regular user
  • "enterprise_user": Enterprise-verified user
  • "personal_user": Personal-verified user
• search_id: Search session ID for pagination

Request Body Example:

payload = {
    "keyword": "AI",
    "cursor": 0,
    "douyin_user_fans": "",
    "douyin_user_type": "",
    "search_id": ""
}

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.