Weibo Profile API
Look up any public Weibo account by id or screen name and get its profile and counts.
GET /v1/weibo/profiles/{profileId}1 credit Failed requests are free Found, empty and not-found answers are charged, except a screen name no account has, which is free
About this endpoint
GET /v1/weibo/profiles/1195230310 returns data.profile with id, url, displayName, bio, gender, avatarUrl, bannerUrl, isVerified, verifiedType and verifiedLabel, memberLevel and stats (posts, followers, following).
Followers come twice: stats.followersLabel as Weibo writes them (1.17亿) and stats.followers as a number (117000000). The id is the digits in a profile link such as weibo.com/u/1195230310; the whole link works too, and so does the screen name (/v1/weibo/profiles/何炅). An unknown or hidden account returns lookupStatus: not_found with profile: null; a screen name nobody has is not charged.
Price
From $1.35 per 1,000 requests
1 credit per request. Failed requests are free.
- Scale pack
- $1.64 / 1,000
- Growth pack
- $2.36 / 1,000
The lowest rate is on annual plans; packs are pay as you go.
Example request
Send your API key in the x-api-key header. New accounts get 100 free credits, no card needed.
Example response
A 200 response. Live responses have the same shape with current data.
Weibo Profile API FAQ
Which id do I pass?
The digits in the account's profile link (weibo.com/u/1195230310), the whole link, or its screen name (handle) such as 何炅, with or without @. An id is the fastest: a screen name is looked up first.
Why does the follower count look rounded?
Weibo rounds large follower counts, such as 1.17亿. followersLabel keeps that label and followers gives it as a number (117000000), so it is exact only up to the rounding Weibo shows.
What happens with an id that does not exist?
The request completes with lookupStatus: not_found and profile: null, and it is billed like any completed lookup. A screen name nobody uses also answers not_found, and that one is free.
How many credits does a request cost?
Pricing is documented on the operation in the API registry (shown on this page). Confirm on every response with meta.creditsCharged: that field is the billing source of truth.
Other Weibo endpoints
- Profile postsGET /v1/weibo/profiles/{profileId}/posts
- PostGET /v1/weibo/posts/{postId}
- Post commentsGET /v1/weibo/posts/{postId}/comments
- Comment repliesGET /v1/weibo/comments/{commentId}/replies
- Search postsGET /v1/weibo/search/posts
- Search accountsGET /v1/weibo/search/profiles
- Hot searchGET /v1/weibo/trending