[中文]

用途:

获取抖音 App 中用户搜索的结果 V4版本（最新版本）。

专门用于搜索用户/账号,返回符合关键词的用户列表。

使用新的分页机制,支持通过 cursor、offset 和 page 参数进行翻页。

备注:

这是用户搜索的最新版本,推荐优先使用此接口。

初次请求时 cursor、offset 和 page 均传 0,search_id 传空字符串。

翻页时从上一次响应中获取 cursor、offset 和 search_id,page 每次加 1。

返回数据结构包含 config (业务配置) 和 data (业务数据) 两部分。

返回的用户信息包括基本资料、粉丝数、作品数、认证状态等。

参数:

keyword: 搜索关键词,如 "美食博主"

cursor: 游标,用于翻页 (首次请求传 0)

offset: 偏移量,用于翻页 (首次请求传 0)

page: 页码,用于翻页 (首次请求传 0,之后每次加 1)

search_id: 搜索ID,用于翻页 (首次请求传空字符串,翻页时使用上次响应的 search_id)

请求体示例:

payload = {
    "keyword": "美食博主",
    "cursor": 0,
    "offset": 0,
    "page": 0,
    "search_id": ""
}

返回(部分常用字段,实际返回字段更多,一切以实际响应为准):

config: 业务配置信息

cursor: 下一页的游标

has_more: 是否还有更多数据 (1=有, 0=无)

search_id: 搜索ID (用于翻页)

data[]: 用户搜索结果列表

type: 结果类型 (通常为用户类型)

user_info: 用户基本信息

uid: 用户ID

sec_uid: 加密用户ID

short_id: 短ID (抖音号)

unique_id: 唯一标识 (自定义抖音号)

nickname: 用户昵称

signature: 个人签名

avatar_thumb: 头像缩略图

avatar_medium: 中等尺寸头像

avatar_larger: 高清头像

gender: 性别 (0=未知, 1=男, 2=女)

region: 地区

verification_type: 认证类型 (0=未认证, 1=个人认证, 2=企业认证)

custom_verify: 自定义认证信息

enterprise_verify_reason: 企业认证说明

follower_count: 粉丝数

total_favorited: 获赞总数

aweme_count: 作品数量

favoriting_count: 关注数

mplatform_followers_count: 跨平台粉丝数

is_blocking: 是否被当前用户拉黑

is_blocked_v2: 是否被拉黑 V2

user_tags: 用户标签列表

white_cover_url: 白底封面图

[English]

Purpose:

Fetch user search results from Douyin App V4 (latest version).

Specifically designed for searching users/accounts, returns a list of users matching the keyword.

Uses new pagination mechanism supporting cursor, offset, and page parameters.

Notes:

This is the latest version of user search, recommended for priority use.

For the first request, set cursor, offset, and page to 0, search_id to empty string.

For pagination, obtain cursor, offset, and search_id from the previous response, increment page by 1.

Response structure contains config (business configuration) and data (business data).

Returned user information includes basic profile, follower count, video count, verification status, etc.

Parameters:

keyword: Search keyword, e.g., "food blogger"

cursor: Cursor for pagination (0 for first request)

offset: Offset for pagination (0 for first request)

page: Page number for pagination (0 for first request, increment by 1 for each subsequent request)

search_id: Search ID for pagination (empty string for first request, use value from previous response)

Request Body Example:

payload = {
    "keyword": "food blogger",
    "cursor": 0,
    "offset": 0,
    "page": 0,
    "search_id": ""
}

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

config: Business configuration

cursor: Next page cursor

has_more: Whether there are more results (1=yes, 0=no)

search_id: Search ID for pagination

data[]: User search results list

type: Result type (usually user type)

user_info: User basic information

uid: User ID

sec_uid: Encrypted user ID

short_id: Short ID (Douyin ID)

unique_id: Unique identifier (custom Douyin ID)

nickname: User nickname

signature: Personal signature

avatar_thumb: Avatar thumbnail

avatar_medium: Medium size avatar

avatar_larger: Large size avatar

gender: Gender (0=unknown, 1=male, 2=female)

region: Region

verification_type: Verification type (0=none, 1=personal, 2=enterprise)

custom_verify: Custom verification info

enterprise_verify_reason: Enterprise verification description

follower_count: Follower count

total_favorited: Total likes received

aweme_count: Video count

favoriting_count: Following count

mplatform_followers_count: Cross-platform follower count

is_blocking: Whether blocked by current user

is_blocked_v2: Whether blocked V2

user_tags: User tags list

white_cover_url: White background cover image

Request

Authorization

Bearer Token

Provide your bearer token in the

Authorization

header when making requests to protected resources.

Example:

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

Body Params application/jsonRequired

Example

{
    "keyword": "猫咪",
    "cursor": 0,
    "offset": 0,
    "page": 0,
    "search_id": ""
}

Request Code Samples

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

Responses

🟢200OK

application/json

Successful Response

Body

Example

{
    "code": 200,
    "request_id": "string",
    "message": "Request successful. This request will incur a charge.",
    "message_zh": "请求成功，本次请求将被计费。",
    "support": "Discord: https://discord.gg/aMEAS8Xsvz",
    "time": "string",
    "time_stamp": 0,
    "time_zone": "America/Los_Angeles",
    "docs": "string",
    "cache_message": "string",
    "cache_message_zh": "string",
    "cache_url": "string",
    "router": "",
    "params": {},
    "data": null
}

🟠422Parameter Error

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

[中文]#

用途:#

备注:#

参数:#

请求体示例:#

返回(部分常用字段,实际返回字段更多,一切以实际响应为准):#

[English]#

Purpose:#

Notes:#

Parameters:#

Request Body Example:#

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