获取用户搜索/Fetch user search

[中文]

用途:

• 获取抖音 App 中根据关键词搜索到的用户列表。
• 支持通过粉丝数量、用户类型进行筛选查询。

备注:

• 初次请求 cursor 传 0，search_id 传空字符串。
• 返回的数据仅包含「用户信息」，不包括视频、话题、音乐等内容。

参数:

• keyword: 搜索关键词，如 "人工智能"
• cursor: 翻页游标（首次请求传0）
• douyin_user_fans: 粉丝数量筛选
  • 为空: 不限
  • "0_1k": 1000以下
  • "1k_1w": 1000到1万
  • "1w_10w": 1万到10万
  • "10w_100w": 10万到100万
  • "100w_": 100万以上
• douyin_user_type: 用户类型筛选
  • 为空: 不限
  • "common_user": 普通用户
  • "enterprise_user": 企业认证用户
  • "personal_user": 个人认证用户
• search_id: 搜索ID（翻页使用）

请求体示例：

payload = {
    "keyword": "人工智能",
    "cursor": 0,
    "douyin_user_fans": "",
    "douyin_user_type": "",
    "search_id": ""
}

返回（部分常用字段，实际返回字段更多，一切以实际响应为准）:

• cursor: 下一页游标
• has_more: 是否还有更多数据（1=有，0=无）
• user_list[]: 用户列表
  • user_info:
    • uid: 用户ID
    • nickname: 用户昵称
    • gender: 性别（0=未知，1=男，2=女）
    • unique_id: 抖音号
    • sec_uid: 安全UID
    • signature: 个性签名
    • follower_count: 粉丝数量
    • avatar_thumb.url_list: 小头像地址
    • avatar_medium.url_list: 中头像地址
    • avatar_larger.url_list: 大头像地址
    • follow_status: 是否已关注
    • live_status: 是否正在直播（0=否，1=是）
    • enterprise_verify_reason: 企业认证信息（若有）
    • versatile_display: 抖音号展示文案（例如"抖音号：xxx"）
• extra:
  • now: 当前服务器时间戳
  • logid: 请求日志ID
  • search_request_id: 搜索请求ID

[English]

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.