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:2025-12-13 05:20:20

OperationId:fetch_user_search_api_v1_weibo_web_v2_fetch_user_search_get

参数说明/Parameters

通用说明：所有可选参数若留空或不传，均表示“不限”，不会参与筛选；服务端使用 exclude_none 移除空参数。

query (可选/optional): 搜索关键词/Query string（若提供，则自动应用“全部”搜索逻辑；未提供时仅根据高级筛选项检索）

page (可选/optional, 默认1): 页码/Page number（留空默认1）

region (可选/optional): 地区筛选（留空=不限），取值来自接口 /city_list 的编码，格式为 custom:省代码:市代码，例如 custom:11:1

auth (可选/optional): 认证类型/Auth type（留空=不限）

org_vip: 机构认证

per_vip: 个人认证

ord: 普通用户

gender (可选/optional): 性别/Gender（留空=不限）

man: 男

women: 女

age (可选/optional): 年龄段/Age bucket（留空=不限）

18y: 18岁以下

22y: 19-22岁

29y: 23-29岁

39y: 30-39岁

40y: 40岁以上

高级筛选/Advanced filters（均为可选，留空不生效）：

nickname: 昵称/Nickname

tag: 标签/Tag

school: 学校/School

work: 公司/Company

返回数据结构/Response schema

{
  "code": 200,
  "data": {
    "parsed_data": {
      "users": [
        {
          "uid": "2574779202",
          "name": "orangeyu729386",
          "avatar": "https://...jpg",
          "fans": 268,
          "profile_url": "https://weibo.com/u/2574779202"
        }
      ],
      "count": 1
    }
  }
}

备注/Notes

region 编码请通过 /fetch_city_list 获取（支持省市映射）。

提供参数过多时，可能导致无法返回结果，请适当减少筛选项。

Request

Authorization

Bearer Token

Provide your bearer token in the

Authorization

header when making requests to protected resources.

Example:

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

Query Params

Request Code Samples

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location --request GET 'https://api.tikhub.io/api/v1/weibo/web_v2/fetch_user_search?query=yu7&page=1&region=custom:11:1&auth=org_vip&gender=man&age=22y&nickname=张三&tag=摄影&school=清华大学&work=字节跳动' \
--header 'Authorization: Bearer <token>'

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

Modified at 2025-12-13 05:20:20

实时搜索/Weibo Realtime Search