[中文]

用途:

获取抖音 App 中根据关键词搜索到的用户列表。

不支持粉丝数量、用户类型筛选查询。

备注:

初次请求 cursor 传 0。

返回的数据仅包含「用户信息」，不包括视频、话题、音乐等内容。

参数:

keyword: 搜索关键词，如 "人工智能"

cursor: 翻页游标（首次请求传0）

请求体示例：

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

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

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.

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

Request

Authorization

Bearer Token

Provide your bearer token in the

Authorization

header when making requests to protected resources.

Example:

Authorization: Bearer ********************

Body Params application/json

keyword

string

Keyword

optional

关键词 / Keyword

Default:

猫咪

cursor

integer

Cursor

optional

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

Default:

Example

{
    "keyword": "猫咪",
    "cursor": 0
}

Request samples

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

Responses

🟢200OK

application/json

Successful Response

Body

code

integer

Code

optional

HTTP status code | HTTP状态码

Default:

200

router

string

Router

optional

The endpoint that generated this response | 生成此响应的端点

Default:

params

Params

optional

The parameters used in the request | 请求中使用的参数

Default:

{}

data

Data

optional

The response data | 响应数据

Any of

null

Example

{
    "code": 200,
    "router": "",
    "params": {},
    "data": null
}

🟠422Parameter Error

获取用户搜索 V2/Fetch user search V2

[中文]#

用途:#

备注:#

参数:#

请求体示例：#

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

[English]#

Purpose:#

Notes:#

Parameters:#

Request Body Example:#

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

Request

Request samples

Responses

[中文]

用途:

备注:

参数:

请求体示例：

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

[English]

Purpose:

Notes:

Parameters:

Request Body Example:

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