[中文]

用途:

获取指定关键词的用户搜索结果，单次可以获取 20 条数据。

支持按粉丝数和用户类型进行筛选。

备注:

初次请求时 offset 传入 0，search_id 传空字符串。

翻页查询时使用上次响应返回的 cursor 和 search_id。

参数:

keyword: 搜索关键词，例如 "游戏"

offset: 偏移量（首次请求传 0，后续使用返回的 cursor 值）

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（首次请求传空，翻页时从上次响应中获取）

例如: search_id = "2024083107320448E367ECDCCC6B71F7F3"

JSON Path-1 : $.extra.logid

JSON Path-2 : $.log_pb.impr_id

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

status_code: 状态码（0表示成功）

type: 结果类型

cursor: 翻页游标，用于获取下一页数据

has_more: 是否还有更多数据（1=有，0=无）

user_list[]: 用户数据列表，每个用户包含：

user_info: 用户基本信息

uid: 用户ID

short_id: 短ID（抖音号）

unique_id: 唯一标识符（自定义抖音号）

nickname: 昵称

signature: 个性签名

sec_uid: 加密用户ID

avatar_thumb.url_list: 缩略头像URL列表

avatar_medium.url_list: 中等头像URL列表

avatar_larger.url_list: 大头像URL列表

follower_count: 粉丝数

total_favorited: 获赞总数

follow_status: 关注状态

enterprise_verify_reason: 企业认证信息

custom_verify: 个人认证信息

room_id: 直播间ID（0表示未开播）

user_tags[]: 用户标签

type: 标签类型

description: 标签描述

type_label[]: 类型标签列表

relative_users: 相关用户

challenge_list[]: 相关话题列表

music_list[]: 相关音乐列表

extra: 额外信息

logid: 日志ID，可用作下次搜索的 search_id

now: 服务器时间戳

log_pb: 日志追踪信息

impr_id: 展示ID，可用作下次搜索的 search_id

[English]

Purpose:

Get user search results of specified keywords, can get 20 pieces of data at a time.

Supports filtering by follower count and user type.

Notes:

Set offset to 0 and search_id to an empty string for the first request.

For pagination, use the cursor and search_id from the last response.

Parameters:

keyword: Search keyword, e.g., "game"

offset: Offset (0 for the first request, use returned cursor value for subsequent requests)

douyin_user_fans: Follower count filter

Leave blank: Unlimited

"0_1k": Below 1000

"1k_1w": 1000-10,000

"1w_10w": 10,000-100,000

"10w_100w": 100,000-1 million

"100w_": More than 1 million

douyin_user_type: User type filter

Leave blank: Unlimited

"common_user": Ordinary user

"enterprise_user": Enterprise certification

"personal_user": Personal certification

search_id: Search ID (empty for first request, obtained from last response for pagination)

For example: search_id = "2024083107320448E367ECDCCC6B71F7F3"

JSON Path-1 : $.extra.logid

JSON Path-2 : $.log_pb.impr_id

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

status_code: Status code (0 means success)

type: Result type

cursor: Pagination cursor for next page

has_more: Whether more results exist (1=Yes, 0=No)

user_list[]: List of user data, each user contains:

user_info: User basic information

uid: User ID

short_id: Short ID (Douyin ID)

unique_id: Unique identifier (custom Douyin ID)

nickname: Nickname

signature: Bio/signature

sec_uid: Encrypted user ID

avatar_thumb.url_list: Thumbnail avatar URL list

avatar_medium.url_list: Medium avatar URL list

avatar_larger.url_list: Large avatar URL list

follower_count: Follower count

total_favorited: Total likes received

follow_status: Follow status

enterprise_verify_reason: Enterprise verification info

custom_verify: Personal verification info

room_id: Live room ID (0 means not streaming)

user_tags[]: User tags

type: Tag type

description: Tag description

type_label[]: Type label list

relative_users: Related users

challenge_list[]: Related challenge/hashtag list

music_list[]: Related music list

extra: Extra information

logid: Log ID, can be used as search_id for next search

now: Server timestamp

log_pb: Log tracking information

impr_id: Impression ID, can be used as search_id for next search

[示例/Example]：

payload = {
    "keyword": "游戏",
    "offset": 0,
    "douyin_user_fans": "",
    "douyin_user_type": "",
    "search_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/jsonRequired

Example

{
    "keyword": "猫咪",
    "offset": 0,
    "douyin_user_fans": "",
    "douyin_user_type": "",
    "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

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

[中文]#

用途:#

备注:#

参数:#

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

[English]#

Purpose:#

Notes:#

Parameters:#

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

[示例/Example]：#