Weibo

Search Weibo profiles

Search Weibo accounts by name or keyword, with followers and verification.

GET/v1/weibo/search/profiles
x-api-keystringheader

API key (`sfk_...`)

Parameters
1
querystringrequiredquery

What to search for, in any language. Chinese text works as typed, for example `苹果`.

min 1 chars · max 100 chars

Response fields
28

Endpoint-specific response payload.

datalookupStatus
string

`empty` when no account matches.

one of: found, empty

dataquery
string

The query as searched.

Matching accounts from the first page of results, as Weibo shows them logged out: about 20. `page.truncated` says whether there are more.

dataprofiles[]id
string

Weibo account id (the `profileId` the profile endpoints take), as in weibo.com/u/{id}.

dataprofiles[]url
string

Profile page.

dataprofiles[]displayName
stringnullable

Screen name.

dataprofiles[]bio
stringnullable

Bio as plain text.

dataprofiles[]gender
stringnullable

Gender, when the account shows one.

one of: male, female, null

dataprofiles[]avatarUrl
stringnullable

Profile picture.

dataprofiles[]isVerified
booleannullable

True when Weibo verified the account.

dataprofiles[]verifiedLabel
stringnullable

What the verification says, such as `湖南卫视主持人`.

The account's counters.

dataprofiles[]statsposts
integernullable

Posts the account has.

dataprofiles[]statsfollowers
integernullable

Followers, read from the site's label: Weibo rounds large counts (`1.17亿` reads 117000000).

dataprofiles[]statsfollowersLabel
stringnullable

Followers as Weibo writes them, such as `1.17亿`.

dataprofiles[]statsfollowing
integernullable

Accounts it follows.

Pagination state. Weibo shows logged-out visitors the first page of a list, so there is never a next page.

datapagehasMore
boolean

Whether another page is available.

datapagenextCursor
stringnullable

Cursor to pass in the next request when more pages exist; null on the last page.

datapagetruncated
boolean

True when the list has more rows than Weibo shows logged out: it stops here before its end.

datapagetotal
integernullable

How many rows the list has in all, as Weibo counts them.

Metadata describing the request and billing outcome.

metarequestId
string

Unique request identifier for tracing this API call.

min 1 chars

metacreditsCharged
integer

Credits charged for this request.

≥ 0

metaversion
string

Public API version that served the response.

one of: v1

metastale
booleanoptional

Present, and `true`, only when the source couldn't be reached and this is the last good answer for the same request instead, up to 24 hours old. Absent on every live answer.

one of: true

metafetchedAt
stringoptional

When a stale answer (`stale: true`) was originally fetched (ISO 8601, UTC). Absent on every live answer.

Code example

curl "https://api.socialfetch.dev/v1/weibo/search/profiles?query=NASA" \
  -H "x-api-key: YOUR_API_KEY"

Responses

Weibo accounts that match a query.