Skip to content

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, and endHour. Continue with page while 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 takes commentId. Both support optional maxId pagination, with each request flow retaining its own cursor.
  • Research an account: use its uid with 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 ​

EndpointMethodDescription
Keyword Search (V2)GETSearches 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)GETRetrieves 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)GETRetrieves 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)GETRetrieves 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)GETRetrieves 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)GETRetrieves 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)GETRetrieves 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)GETRetrieves 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)GETRetrieves the current Weibo hot-search ranking. Use it to identify trending topics for newsroom monitoring, content planning, or timely topic discovery.
Post Comments (V1)GETRetrieves 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)GETRetrieves 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)GETSearches 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…