Weibo API Docs & Endpoint Directory
JustOneAPI provides third-party Weibo data APIs for topic research, social listening, and account content analysis. Start with the keyword, post ID, MID, or UID you already have.
Choose a Weibo data endpoint by task
- Find posts about a topic: Keyword Search V2 requires
q,startDay,endDay,startHour, andendHour. Continue withpagewhile keeping the same search conditions. - Look up a known post: Post Details V1 takes
id. - Read a discussion: Post Comments V1 takes
mid; Comment Replies V1 takescommentId. Both support optionalmaxIdpagination, with each request flow retaining its own cursor. - Research an account: use its
uidwith User Profile V3 or User Published Posts V1. Check the endpoint's continuation parameters before requesting another page. - Discover current topics: Hot Search V1 retrieves the current Weibo hot-search ranking.
Connect search, post details and comments
Follow the existing Python tutorial for time-based search, post details and comments. It explains ID/MID handling, comment cursors, deduplication, and saving bounded results as JSON.
The detail endpoint's id and the comment endpoint's mid are different request parameters; do not assume they are interchangeable. Keep search pages and comment cursors separate. A bounded search or comment sample does not establish complete coverage of a topic or discussion.
Authentication and request scope
Read the API usage guide for authentication. Endpoint permissions, pricing, and available trial allowance are shown in the Dashboard. This directory covers reading data; it does not provide posting, liking, or account-login endpoints.
Available APIs
| Endpoint | Method | Description |
|---|---|---|
| Keyword Search (V2) | GET | Searches Weibo posts by keyword within a required day-and-hour time range, with page-based pagination, hot or time sorting, and filters for pictures, video, mu… |
| Post Details (V1) | GET | Retrieves details for a Weibo post identified by its post ID. Use it to look up a known post for content review, archiving, or related engagement analysis. |
| User Profile (V3) | GET | Retrieves a Weibo user profile identified by UID. Use it to look up a known account for creator research, profile review, or subsequent retrieval of that user'… |
| User Fans (V1) | GET | Retrieves a page of fan accounts that follow a Weibo user identified by UID. Use it to browse the account's follower audience or continue through its fan list. |
| User Followers (V1) | GET | Retrieves a page of accounts followed by a Weibo user identified by UID. Use it to examine the account's outgoing follow network or continue through its follow… |
| User Published Posts (V1) | GET | Retrieves posts published by a Weibo user identified by UID, using page numbers and a required sinceId cursor after the first page. Use it to browse an account… |
| User Video List (V1) | GET | Retrieves a Weibo user's video waterfall feed by UID, with an optional cursor from a prior response. Use it to browse videos published by a known account or co… |
| TV Video Details (V1) | GET | Retrieves Weibo TV video details for a colon-delimited object ID (OID). Use it to look up a known TV video for content review, cataloging, or downstream proces… |
| Hot Search (V1) | GET | Retrieves the current Weibo hot-search ranking. Use it to identify trending topics for newsroom monitoring, content planning, or timely topic discovery. |
| Post Comments (V1) | GET | Retrieves comments for a Weibo post identified by MID, with optional maxId cursor pagination and time or hot sorting. Use it to review audience discussion, con… |
| Comment Replies (V1) | GET | Retrieves replies under a Weibo top-level comment identified by commentId, with optional maxId cursor pagination. Use it to follow a comment thread for discuss… |
| Search User Published Posts (V1) | GET | Searches posts published by a specific Weibo user, using a keyword, optional date range, and page-based pagination. Use it to find historical posts from a know… |