Weibo

Get Weibo profile

Get a Weibo account by id, link or screen name, with its bio, verification, followers, following and post count.

GET/v1/weibo/profiles/{profileId}
x-api-keystringheader

API key (`sfk_...`)

Parameters
1
profileIdstringrequiredpath

The account's id (the digits in a profile link such as weibo.com/u/1195230310), a whole profile link, or its screen name (handle) such as `何炅`, with or without `@`. A screen name is looked up first; an unknown one answers `not_found` free of charge.

min 1 chars · max 512 chars

Response fields
25

Endpoint-specific response payload.

datalookupStatus
string

`not_found` when no account has this id or screen name, or Weibo no longer shows it. An unknown screen name is not charged.

one of: found, not_found

The account when `lookupStatus` is `found`; otherwise null.

dataprofileid
string

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

dataprofileurl
string

Profile page.

dataprofiledisplayName
stringnullable

Screen name.

dataprofilebio
stringnullable

Bio as plain text.

dataprofilegender
stringnullable

Gender, when the account shows one.

one of: male, female, null

dataprofileavatarUrl
stringnullable

Profile picture.

dataprofileisVerified
booleannullable

True when Weibo verified the account.

dataprofileverifiedLabel
stringnullable

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

The account's counters.

dataprofilestatsposts
integernullable

Posts the account has.

dataprofilestatsfollowers
integernullable

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

dataprofilestatsfollowersLabel
stringnullable

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

dataprofilestatsfollowing
integernullable

Accounts it follows.

dataprofilebannerUrl
stringnullable

The profile's cover image.

dataprofileverifiedType
integernullable

Weibo's verification kind: 0 for a person, 1 to 7 for organisations and media, -1 when not verified.

dataprofilememberLevel
integernullable

The account's Weibo membership level, 0 when none.

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/profiles/1195230310" \
  -H "x-api-key: YOUR_API_KEY"

Responses

A Weibo account's profile.