Explore our Marketplace to buy and sell APIs, services, and social media solutions. Connect with a vibrant community of developers, businesses, and creators!

用户搜索/User search

GET

https://api.tikhub.io/api/v1/weibo/web_v2/fetch_user_search

Weibo-Web-V2-API

Last modified:2026-05-16 02:39:13

OperationId:fetch_user_search_api_v1_weibo_web_v2_fetch_user_search_get

[中文]

用途:

搜索微博用户，支持多种筛选条件。

参数:

query: 搜索关键词（可选）

page: 页码（默认1）

region: 地区编码，从/fetch_city_list获取（可选）

auth: 认证类型 org_vip/per_vip/ord（可选）

gender: 性别 man/women（可选）

age: 年龄段 18y/22y/29y/39y/40y（可选）

nickname: 昵称筛选（可选）

tag: 标签筛选（可选）

school: 学校筛选（可选）

work: 公司筛选（可选）

用户列表，包含uid、昵称、头像、粉丝数、主页链接

注意:

筛选参数过多可能导致无结果

[English]

Purpose:

Search Weibo users with multiple filter options.

Parameters:

query: Search keyword (optional)

page: Page number (default 1)

region: Region code from /fetch_city_list (optional)

auth: Auth type org_vip/per_vip/ord (optional)

gender: Gender man/women (optional)

age: Age bucket 18y/22y/29y/39y/40y (optional)

nickname: Nickname filter (optional)

tag: Tag filter (optional)

school: School filter (optional)

work: Company filter (optional)

Return:

User list with uid, nickname, avatar, fans count, profile URL

Note:

Too many filters may result in no results

[示例/Example]

query = "yu7"
page = 1

Request

Authorization

Bearer Token

Provide your bearer token in the

Authorization

header when making requests to protected resources.

Example:

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

Query Params

Responses

🟢200OK

application/json

Successful Response

Bodyapplication/json

🟠422Unprocessable Entity

Request Example

Shell

JavaScript

Java

Swift

curl --location 'https://api.tikhub.io/api/v1/weibo/web_v2/fetch_user_search?query=yu7&page=1&region=custom%3A11%3A1&auth=org_vip&gender=man&age=22y&nickname=%E5%BC%A0%E4%B8%89&tag=%E6%91%84%E5%BD%B1&school=%E6%B8%85%E5%8D%8E%E5%A4%A7%E5%AD%A6&work=%E5%AD%97%E8%8A%82%E8%B7%B3%E5%8A%A8' \
--header 'Authorization: Bearer <token>'

Response Example

200 - Example 1

{
    "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
}

Modified at 2026-05-16 02:39:13

实时搜索/Weibo Realtime Search

用户搜索/User search

[中文]#

用途:#

参数:#

返回:#

注意:#

[English]#

Purpose:#

Parameters:#

Return:#

Note:#

[示例/Example]#