Weibo User Search

API docs
https://api.sandbase.ai/v1/api/weibo/web-v2/user-search

Search Weibo users using keywords or profile attributes such as company, school, tags, gender, age range, and verification type.

Price
$0.001USD / call
Method
POST
Response
JSON
Parameters
0 required · 10 optional
100 free calls / dayFirst 100 calls per day free (shared per organization) · Resets at 00:00 UTC. Pay per call after that.

Playground

Input
Age bucket 18y/22y/29y/39y/40y (optional)
Auth type org_vip/per_vip/ord (optional)
Gender man/women (optional)
Nickname filter (optional)
Page number (default 1)
Search keyword (optional)
Region code from /fetch_city_list (optional)
School filter (optional)
Tag filter (optional)
Company filter (optional)
OutputExample
Responseoutputs · 102 B · 10 lines
[
  {
    "data": {
      "parsed_data": {
        "count": 0,
        "users": []
      }
    }
  }
]

Examples

Select an example to load its inputs and result into the playground.

API README

Weibo User Search API

Returns Weibo users that match a keyword or profile filters such as company, school, tag, gender, age bucket, region, and verification type. You must send at least one of query, region, auth, gender, age, nickname, tag, school, or work.

Use cases

  • Find verified organization accounts by sending auth as org_vip together with a tag or query.
  • Look for people who list a given company by sending work.
  • Look for people from a given school by sending school.
  • Build a list of users in one age bucket and gender by sending age and gender.

Request

curl -X POST "https://api.sandbase.ai/v1/api/weibo/web-v2/user-search" \
  -H "Authorization: Bearer $SANDBASE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{}'

The result is returned in outputs[0].data.

Parameters

NameTypeRequiredDescription
agestringNoAge bucket 18y/22y/29y/39y/40y (optional)
authstringNoAuth type org_vip/per_vip/ord (optional)
genderstringNoGender man/women (optional)
nicknamestringNoNickname filter (optional)
pageintegerNoPage number (default 1)
querystringNoSearch keyword (optional)
regionstringNoRegion code from /fetch_city_list (optional)
schoolstringNoSchool filter (optional)
tagstringNoTag filter (optional)
workstringNoCompany filter (optional)

Example response

Real response for the request above, trimmed: lists keep their first item and long strings are cut.

{
  "message": "Invalid query. Pass at least one of: query, region, auth, gender, age, nickname,…",
  "message_zh": "query 非法。请至少传入以下一项:query, region, auth, gender, age, nickname, tag, school, work…",
  "ok": 0,
  "param": "query"
}

Response fields

FieldMeaning
okStatus flag. 0 means the request failed, as in the response to an empty request.
messageEnglish error text. It says the query is invalid and lists the parameters you can send; at least one is required.
message_zhThe same error text in Chinese.
paramName of the parameter the error refers to. An empty request returns query, even though any one of the listed filters is enough.

Notes

Pricing

$0.001 per successful call. Failed calls are not charged. It is included in the daily free quota of each organization.

Explore more

Related APIs

All APIs
APIPriceResponse
Weibo$0.001 per callJSON
Weibo$0.001 per callJSON
Weibo$0.001 per callJSON
Weibo$0.001 per callJSON
Weibo$0.001 per callJSON
Weibo$0.001 per callJSON

Questions

FAQ

How do I use the Weibo User Search API?

Send a POST request to https://api.sandbase.ai/v1/api/weibo/web-v2/user-search with your SandBase API key in the Authorization header (Bearer) and the parameters as a JSON body. You can also try it in the Playground on this page without writing code.

How much does the Weibo User Search API cost?

$0.001 per call. Every organization gets 100 free calls per UTC day, shared across eligible SandBase APIs including this one; after that each call is billed at this price from your SandBase balance. There is no subscription.

What parameters does the Weibo User Search API accept?

No parameters are required. Optional: age (any), auth (any), gender (any), nickname (any), page (integer) and query (any) and 4 more. The Parameters table and the Playground on this page list every field.

What does the Weibo User Search API return?

A JSON response returned in the same HTTP request (synchronous). The README on this page includes a sample response.

Do I need a Weibo developer account or API key?

No. Weibo User Search runs through SandBase, so one SandBase API key covers this endpoint and every other API and model in the catalog. You do not need to apply for Weibo API access separately.