Weibo Account Search API
Find Weibo accounts by name and get their ids.
GET /v1/weibo/search/profiles1 credit Failed requests are free Found, empty and not-found answers are all charged
About this endpoint
GET /v1/weibo/search/profiles?query=NASA returns data.profiles from the first page of matches (about 20), each with id, url, displayName, bio, gender, avatarUrl, isVerified, verifiedLabel and stats (posts, followers as a number and as Weibo writes them, following).
Pass a match's id as profileId to the profile and posts endpoints. page.truncated says whether there are more matches; a search with none returns lookupStatus: empty.
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 Account Search API FAQ
How do I turn a screen name into an account id?
You often don't need to: the profile endpoints take a screen name as it is. To find accounts whose names you only half know, search here and take the id of the match.
How many accounts does it return?
The first page of matches, about 20. page.truncated says whether there are more.
Can I search in Chinese?
Yes. Names and keywords in Chinese work as typed, as do names in English such as NASA.
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
- ProfileGET /v1/weibo/profiles/{profileId}
- 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
- Hot searchGET /v1/weibo/trending