Back to catalog

Tikhub · Social

获取用户搜索/Fetch user search

[中文] ### 用途: - 获取抖音 App 中根据关键词搜索到的用户列表。 - 支持通过粉丝数量、用户类型进行筛选查询。 ### 备注: - 初次请求 cursor 传 0,searchid 传空字符串。 - 返回的数据仅包含「用户信息」,不包括视频、话题、音乐等内容。 ### 参数: - keyword: 搜索关键词,如 "人工智能" - cursor: 翻页游标(首次请求传0) - douyinuserfans: 粉丝数量筛选 - 为空: 不限 - "01k": 1000以下 - "1k1w": 1000到1万 - "1w10w": 1万到10万 - "10w100w": 10万到100万 - "100w": 100万以上 - douyinusertype: 用户类型筛选 - 为空: 不限 - "commonuser": 普通用户 - "enterpriseuser": 企业认证用户 - "personaluser": 个人认证用户 - searchid: 搜索ID(翻页使用) ### 请求体示例: ### 返回(部分常用字段,实际返回字段更多,一切以实际响应为准): - cursor: 下一页游标 - hasmore: 是否还有更多数据(1=有,0=无) - userlist[]: 用户列表 - userinfo: - uid: 用户ID - nickname: 用户昵称 - gender: 性别(0=未知,1=男,2=女) - uniqueid: 抖音号 - secuid: 安全UID - signature: 个性签名 - followercount: 粉丝数量 - avatarthumb.urllist: 小头像地址 - avatarmedium.urllist: 中头像地址 - avatarlarger.urllist: 大头像地址 - followstatus: 是否已关注 - livestatus: 是否正在直播(0=否,1=是) - enterpriseverifyreason: 企业认证信息(若有) - versatiledisplay: 抖音号展示文案(例如"抖音号:xxx") - extra: - now: 当前服务器时间戳 - logid: 请求日志ID - searchrequestid: 搜索请求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 searchid 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) - douyinuserfans: Fan count filter - Empty: No limit - "01k": Below 1000 fans - "1k1w": 1,000 to 10,000 fans - "1w10w": 10,000 to 100,000 fans - "10w100w": 100,000 to 1,000,000 fans - "100w": Above 1,000,000 fans - douyinusertype: User type filter - Empty: No limit - "commonuser": Regular user - "enterpriseuser": Enterprise-verified user - "personaluser": Personal-verified user - search_id: Searc

Private Gateway connection

Data below comes from the configured private Gateway. Provider activation remains governed by its evidence and policy gates.

unverifiedRequest shape unavailableUnverified
Published API evidence
Public metadata only. Response bodies, credentials, and internal review notes are never displayed.

No verification date is claimed. No response capture is claimed.

Request parameters

  • cursor body · optional

    偏移游标,用于翻页,从上一次请求返回的响应中获取 / Offset cursor for pagination, obtained from the last response

  • douyin_user_fans body · optional

    粉丝数过滤:空=不限 0_1k=1千以下 1k_5k=1千到5千 5k_10k=5千到1万 10k_100k=1万到10万 100k_1M=10万到100万 1M_=100万以上 / Fans filter: empty=No limit, 0_1k=Under 1k, etc.

  • douyin_user_type body · optional

    用户类型过滤:空=不限 300=创作者 900=小店 700=音乐人 800=明星 / User type filter: empty=No limit, 300=Creator, 900=Shop, 700=Musician, 800=Celebrity

  • keyword body · optional

    关键词 / Keyword

  • search_id body · optional

    搜索ID,用于翻页,从上一次请求返回的响应中获取 / Search ID for pagination, obtained from the last response

Sign in to run this operation, inspect live eligibility, and see governed execution and audit evidence. Sign in.