Weibo API
Thirty-one endpoints for the Weibo hot-search board, user profiles, posts, comments, videos and search — each one a single POST returning structured JSON. Real-time Chinese social and public-opinion data that no Western social API covers. No Weibo app, no login, no scraping stack to keep alive.
50 free credits on signup. No card, no Weibo app, no login.
{ "data": { "user": { "uid": "7277477906", "nickname": "喝多的学姐", "description": null, "followers_count": 436357, "following_count": 341, "statuses_count": 20985, "avatar": "https://tvax2.sinaimg.cn/crop.0.0.1080.1080.1024/007WvyrUly1i6hjoob2z4j30u00u0gmj.jpg", "verified": true, "verified_reason": "娱乐博主 微博原创视频博主", "gender": "f", "location": "其他", "profile_url": "/u/7277477906" } }, "response_time": 1441, "credits_used": 1, "credits_remaining": 6999}A real captured response from this endpoint. Sign up to run your own.
What is the Scavio Weibo API?
The Scavio Weibo API is a REST API that returns public Weibo data as structured JSON. You POST to one of 31 endpoints with your API key — the live hot-search board, a user id or handle, a post id, or a search query — and get back trending topics, profiles, posts, comments, videos and search results. No Weibo app, no OAuth, and no login, and every call costs 1 credit.
- 31
- endpoints, all live in production
- 1
- credit per call, flat across every endpoint
- 0
- Weibo apps or logins required
Start with these four
They cover most of what people build. The full thirty-one are below.
Hot-search board
POST /api/v1/weibo/hot-searchThe live Weibo hot-search board — every trending term with its rank, hot value and label. Real-time Chinese public-opinion data in one call, which no Western social API can give you.
User profiles
POST /api/v1/weibo/user/infoNickname, follower / following / post counts, verification and reason, gender and location, by numeric uid or custom handle.
Posts & comments
POST /api/v1/weibo/postFull post detail with repost, comment and like counts, plus the comment threads underneath — every commenter profile included.
Keyword search
POST /api/v1/weibo/search/realtimeNewest posts for any keyword, with the author, source device, media and engagement — the fastest read on what China is saying right now.
All 31 Weibo endpoints
Every route is a POST, returns JSON, and takes the same API key. Each successful call costs 1 credit — no per-endpoint surcharge.
| Endpoint | Returns | Credits |
|---|---|---|
Hot-search board/api/v1/weibo/hot-search | The live hot-search board — each trending term with its rank, hot value and label (e.g. 大促, sponsored) | 1 |
Hot-search index/api/v1/weibo/hot-search/index | The top pinned hot-search entries in board order | 1 |
User info/api/v1/weibo/user/info | Profile by uid or handle — nickname, follower / following / post counts, verified flag and reason, gender, location, avatar | 1 |
User info detail/api/v1/weibo/user/info-detail | Extended profile fields for a user beyond the core info block | 1 |
User posts/api/v1/weibo/user/posts | A user's timeline — post id, mblogid, text, creation time, region, repost / comment / like counts, images and video | 1 |
User original posts/api/v1/weibo/user/original-posts | The same timeline shape filtered to original (non-repost) posts only | 1 |
User fans/api/v1/weibo/user/fans | A user's followers — uid, nickname, verified flag, avatar, counts | 1 |
User following/api/v1/weibo/user/following | Accounts a user follows, in the same user shape as fans | 1 |
User videos/api/v1/weibo/user/videos | A user's published videos — title, cover, duration, engagement | 1 |
User video collections/api/v1/weibo/user/video-collections | A user's video collection folders with their collection ids | 1 |
Video collection/api/v1/weibo/user/video-collection | The videos inside one collection folder by collection id | 1 |
Search user posts/api/v1/weibo/user/search-posts | Search within a single user's posts by keyword, time range and media filters | 1 |
Recommend timeline/api/v1/weibo/user/recommend-timeline | The recommended home timeline of posts | 1 |
Post detail/api/v1/weibo/post | One post by id — text, creation time, region, repost / comment / like counts, image list, video, and the author block | 1 |
Post comments/api/v1/weibo/post/comments | Top-level comments — id, text, like and reply counts, floor number, and the full commenter profile | 1 |
Post sub-comments/api/v1/weibo/post/sub-comments | The replies nested under a post's comments | 1 |
Post likes/api/v1/weibo/post/likes | The accounts that liked a post | 1 |
Post reposts/api/v1/weibo/post/reposts | The reposts of a post, with each reposter and their added text | 1 |
Advanced search/api/v1/weibo/search/advanced | Keyword search with type, media-type and custom time-range filters | 1 |
Realtime search/api/v1/weibo/search/realtime | Newest posts for a keyword — text, created time, post url, source device, media and engagement counts | 1 |
Video search/api/v1/weibo/search/videos | Videos matching a keyword, hot or all mode | 1 |
User search/api/v1/weibo/search/users | Users matching a keyword — uid, nickname, follower count, verified flag, plus optional region / gender / age filters | 1 |
Topic search/api/v1/weibo/search/topics | Topics (# hashtags #) matching a keyword | 1 |
Image search/api/v1/weibo/search/pics | Image posts matching a keyword | 1 |
Similar search/api/v1/weibo/search/similar | Related search terms and accounts for a keyword | 1 |
AI search/api/v1/weibo/search/ai | An AI-assisted answer for a natural-language query | 1 |
Hot timeline ranking/api/v1/weibo/rankings/hot-timeline | Trending posts over an hour or day window | 1 |
Entertainment ranking/api/v1/weibo/rankings/entertainment | The entertainment ranking board | 1 |
Life ranking/api/v1/weibo/rankings/life | The lifestyle ranking board | 1 |
Social ranking/api/v1/weibo/rankings/social | The social ranking board | 1 |
Channel feed/api/v1/weibo/channel-feed | Popular content within a named channel (e.g. 热门) | 1 |
50 free credits on signup covers 50 calls across any mix of endpoints. See plans
Read the Weibo hot-search board in one call
POST an empty body and get back the live trending board — every term with its rank, hot value and label. The response on the right is a real capture, field names and all.
from scavio import ScavioClient
client = ScavioClient(api_key="sk_live_your_key")
board = client.weibo.hot_search()["data"]["trending"]
for entry in board[:10]:
label = f" [{entry['label']}]" if entry["label"] else ""
print(entry["rank"], entry["word"], entry["hot"], label){
"data": {
"trending": [
{ "word": "披荆斩棘淘汰", "note": "披荆斩棘淘汰", "hot": 98962, "rank": 0, "category": null, "label": null },
{ "word": "桃酥是没有一滴水的", "note": "桃酥是没有一滴水的", "hot": 68803, "rank": 1, "category": null, "label": null },
{ "word": "孙天宇空降上海京东MALL", "note": "孙天宇空降上海京东MALL", "hot": 68098, "rank": 2, "category": null, "label": "大促" }
]
},
"response_time": 1120,
"credits_used": 1,
"credits_remaining": 6999
}Why not build it yourself?
Weibo has no open API for public data, and its developer platform is effectively closed to overseas developers. That leaves you maintaining a scraper — or calling one endpoint.
Rolling your own
- No public Weibo API to register for; the official platform is closed to most developers
- Chinese-language pages and shifting markup to parse and re-parse as they change
- Hot-search, rankings, comments and search each need separate custom extraction
- A stack to host, monitor and repair every time the site shifts
Scavio Weibo API
- One API key, issued at signup — no Weibo app, no review, no waiting
- The hot-search board, any profile, post, comment thread or search by a single POST
- Native Chinese text, correctly encoded, in a stable JSON shape
- Same key and JSON envelope as 30 other Scavio platforms, at 1 credit a call
Scavio returns publicly available data only, and never authenticates as a Weibo user.
What developers build with it
Real-time trend and public-opinion monitoring
Poll the hot-search board and the ranking boards on a schedule and store each snapshot. You get an hour-by-hour record of what is trending across China — the single hardest social signal to source from the West — as clean, rankable JSON.
hot-search + rankings/*Brand and product listening
Run realtime and advanced search for your brand, product or a competitor's name, then diff results over time. Every post carries the author, source device, media and engagement counts, ready to feed a dashboard or an alerting job.
search/realtime + search/advancedKOL and creator research
Resolve a handle to follower, following and post counts and verification status, then walk the account's posts and video collections. Build an influencer database with real reach numbers instead of screenshots.
user/info + user/posts + user/videosComment mining and sentiment
Pull a post's detail and its comment threads, then feed the Chinese text to an LLM for themes, complaints or purchase intent. You get structured author and like data per comment, not a wall of HTML.
post + post/commentsTopic and hashtag tracking
Search topics and images for a campaign hashtag and follow a channel feed to see how a conversation spreads. Useful for launch tracking, event coverage and market entry research.
search/topics + channel-feedAgent tools and RAG pipelines
Point an agent at the remote MCP server and Weibo becomes a callable tool alongside every other Scavio platform — same key, same JSON envelope, no per-platform glue.
MCP + RESTHow to get Weibo data as JSON
- 1
Get an API key
Sign up for a Scavio account and copy your key from the dashboard. You get 50 credits free on signup, with no card required.
- 2
POST to a Weibo endpoint
The hot-search and ranking boards take an empty body — POST {} to https://api.scavio.dev/api/v1/weibo/hot-search with an Authorization: Bearer header. User endpoints take a uid or handle, post endpoints take a post id, and search endpoints take a query. Every Weibo route is a POST.
- 3
Read the JSON
The response wraps the data under a data key and adds response_time, credits_used and credits_remaining. Text fields come back as native Chinese; timestamps are in Beijing time (+0800).
Weibo API FAQ
What is the Scavio Weibo API?
+
It is a REST API that returns public Weibo (Sina Weibo) data as structured JSON. Thirty-one POST endpoints cover the live hot-search board and ranking boards, user profiles and their posts, followers and following, videos and video collections, single post detail, comments and sub-comments, likes and reposts, and eight kinds of search. You authenticate with a Scavio API key and never handle Weibo credentials. Weibo is the largest Chinese microblogging platform, so this is real-time China-market social data most Western APIs do not cover.
Can I get the Weibo hot-search / trending board?
+
Yes — that is the headline endpoint. The hot-search endpoint returns the live board with each trending term, its rank, its hot value and any label (for example a 大促 promotion tag or a sponsored marker). There is also a hot-search index for the top pinned entries, plus entertainment, life, social and hot-timeline ranking boards. Poll them on a schedule to build an hour-by-hour record of what is trending across China.
What data can I get from a Weibo user or post?
+
For a user: nickname, follower / following / post counts, verified flag and verification reason, gender, location and avatar, plus their timeline of posts, their original posts only, their followers, their following, and their videos and video collections. For a post: the text, creation time, posting region, repost / comment / like counts, the image list and any video, the author block, and separately the top-level comments, the nested sub-comments, the accounts that liked it and the accounts that reposted it.
Do I need a Weibo account, app, or login?
+
No. There is no Weibo open API for this kind of public data, and Weibo's own developer platform is effectively closed to overseas developers. Scavio needs none of that: sign up, take the key, POST an id, handle or query. You never register a Weibo app or store a login.
How much does a Weibo request cost?
+
Every Weibo endpoint costs 1 credit per successful call — a flat rate across all 31 routes, including the hot-search board and every search. New accounts get 50 free credits on signup, one time, with no card required. Paid plans start at $30 per month for 7,000 credits, so a Weibo call is a fraction of a cent.
Is the returned text in Chinese?
+
Yes. Post text, nicknames, hot-search terms and comments are returned as native Chinese exactly as they appear on Weibo, correctly encoded as UTF-8 (emoji and all). Timestamps are in Beijing time (+0800). If you need translation or romanization, run the text through your own model or translation step after you receive it.
How do I search Weibo posts?
+
Use realtime search for the newest posts on a keyword — you get the text, creation time, post url, source device, media and engagement counts per result. Use advanced search when you need type, media-type or a custom time-range filter. There are also dedicated endpoints for searching videos, users, topics and images, plus a similar-terms endpoint and an AI-assisted search. All take a query string and cost 1 credit.
Can it read private accounts or protected posts?
+
No. Only data Weibo makes publicly available is returned. Protected accounts, private posts and anything behind a login are not accessible, and you are not charged when a request cannot be fulfilled. The API never authenticates as a user.
Does a user timeline return the full post history?
+
The user-posts and user-original-posts endpoints return a page of recent posts and accept a page number and a since_id cursor, so you can walk further back page by page rather than getting the entire archive in one call. For deep history, paginate; for the latest activity and its engagement, a single call is enough.
Do post comments include every reply?
+
The post-comments endpoint returns the top-level comments on a post, with each commenter's full profile and the comment's like and reply counts and floor number. Nested replies come from the separate sub-comments endpoint, and both paginate with a max_id cursor. Combine them to reconstruct a thread; call comments alone for the most visible reactions.
Which languages and tools are supported?
+
Official Python (pip install scavio) and JavaScript/TypeScript (npm i scavio) SDKs, a remote MCP server at mcp.scavio.dev for AI agents, and an n8n community node. Any language can call the REST endpoints directly with an HTTP client.
Is scraping Weibo data legal?
+
Scavio returns publicly available data and does not access private content or authenticate as a user. You remain responsible for how you use the data, including compliance with Weibo's terms and with privacy law such as GDPR and China's PIPL where personal data is involved. Talk to your own counsel for your specific use case.
Explore more of Scavio
TikTok API
Profiles, videos, comments and search as JSON.
Kuaishou API
Chinese short-video profiles, videos and search.
Instagram API
Profiles, posts, reels, stories and comments as JSON.
X (Twitter) API
Profiles, tweets, replies and search from X.
Pricing
Credit packs and plans, with no per-platform surcharge.
MCP server
Every platform as a callable tool for your agents.
Start pulling Weibo data today
50 free credits on signup, no card. Your first request can be a POST with an empty body to the hot-search board.