Weibo User Search

2.07 credits/call
ae_weibo_user_search

## Purpose Search Weibo user accounts by keyword or advanced filters. ## Inputs All parameters are optional. - `query`: Search keyword. Supplying it selects the "All" search mode; omitting it applies only advanced filters. - `page`: Integer page number; defaults to `1`. - `region`: Region code rather than a place name, for example `custom:11:1`. - `auth`: Account verification type: `org_vip` (organization), `per_vip` (individual), or `ord` (ordinary account). - `gender`: `man` or `women`. - `age`: Age-bucket code: `18y`, `22y`, `29y`, `39y`, or `40y`. - `nickname`, `tag`, `school`, `work`: Filters for nickname, tag, school, and company, respectively. ## Results and limitations Returns response data containing matching user accounts, documented as including user ID (`uid`), nickname, avatar, follower count, and profile URL. Individual record structure is not fixed by the documented response schema. Restrictive filter combinations may produce no matches. This searches users, not posts. ## Example `{"query":"yu7","page":1}`

Social
2.07 credits/call

Pricing

2.07 credits/call
ConditionCharge
Each call2.07 credits/call

2.07 credits/call Charges are per query. A successful query is billed even if it returns no results.

Parameters

Optional parameters use the platform defaults when omitted.

ParameterTypeRequiredDescriptionDefault
agestring | nullNo年龄段 18y/22y/29y/39y/40y / Age bucket—
tagstring | nullNo标签筛选/Tag filter—
authstring | nullNo认证类型 org_vip(机构)/per_vip(个人)/ord(普通)/Auth type—
pageintegerNo页码/Page1
workstring | nullNo公司筛选/Company filter—
querystring | nullNo搜索关键词/Query(提供则视为“全部”搜索;留空则仅应用高级筛选参数)—
genderstring | nullNo性别 man / women / Gender—
regionstring | nullNo地区编码,从 /city_list 获取/Region code from /city_list—
schoolstring | nullNo学校筛选/School filter—
nicknamestring | nullNo昵称筛选/Nickname filter—

Invocation example

Copy the request and explore its response example.

POST/agent-api/v1/tool/executeX-Api-Key
Request coderequest.sh
curl --request POST \
  --url 'https://agentearth.ai/agent-api/v1/tool/execute?tool_name=ae_weibo_user_search' \
  --header "X-Api-Key: $AGENTEARTH_API_KEY" \
  --header 'Content-Type: application/json' \
  --data-raw '{
  "params": {
    "page": 1,
    "query": "胡雪琼"
  }
}'
Response exampleresponse.json
JSONPartial content
{
  "code": 200,
  "data": {
    "parsed_data": {
      "count": 20,
      "users": [
        {
          "avatar": "https://tvax2.sinaimg.cn/crop.13.0.724.724.180/69deaa7bly8fokin98uk0j20ku0k4myu.jpg?KID=imgbed,tva&Expires=1793978451&ssig=k7CXgzy8AB",
          "fans": 404,
          "name": "胡雪琼",
          "profile_url": "https://weibo.com/u/1776200315",
          "uid": "1776200315"
        }
      ]
    }
  },
  "docs": "https://api.tikhub.io/#/Weibo-Web-V2-API/fetch_user_search_api_v1_weibo_web_v2_fetch_user_search_get",
  "message": "Request successful. This request will incur a charge."
}

This example shows part of the response. Copied content is valid JSON.