Weibo API
Fetch public Weibo data — profiles with their followers and following, profile posts, individual posts, videos, keyword search, and the hot-search board.
24 endpoints
Endpoints
Each endpoint links to its request parameters, response schema, and code examples.
Posts
8 endpoints- Get post details (v1)GETGet a public Weibo post by numeric ID. Video posts include available stream URLs and duration.
/v1/weibo/posts/detail1 cr - List comment replies (v2)GETList replies to a Weibo comment.
/v2/weibo/posts/comments/replies2 cr - List post comments (v2)GETList comments for a Weibo post.
/v2/weibo/posts/comments2 cr - List post comments (v1)GETList the first page of comments for a Weibo post. total_number may exceed the returned comments; next_cursor_hint is not a supported pagination cursor.
/v1/weibo/posts/comments1 cr - List post likers (v1)GETList accounts that liked a Weibo post. attitude_type is the platform's numeric reaction code.
/v1/weibo/posts/likes1 cr - List post reposts (v2)GETList public reposts for a Weibo post.
/v2/weibo/posts/reposts2 cr Get post (v2)DeprecatedGETDeprecated: use /v1/weibo/posts/detail instead. Get a public Weibo post by ID./v2/weibo/posts/detail2 crList post likes (v2)DeprecatedGETDeprecated: use /v1/weibo/posts/likes instead. List public likes for a Weibo post./v2/weibo/posts/likes2 cr
Profiles
5 endpoints- Get profile (v1)GETGet a public Weibo profile and its follower, following, and post counts.
/v1/weibo/profiles/info1 cr - List profile followers (v2)GETReturns followers for required uid; some large accounts do not expose followers.
/v2/weibo/profiles/fans2 cr - List profile following (v2)GETReturns accounts followed by required uid; some large accounts do not expose this list.
/v2/weibo/profiles/following2 cr - List profile posts (v2)GETList posts published by a Weibo profile.
/v2/weibo/profiles/posts2 cr Get profile (v2)DeprecatedGETDeprecated: use /v1/weibo/profiles/info instead. Get a public Weibo profile by user ID./v2/weibo/profiles/info2 cr
Search
6 endpoints- Search posts (v2)GETSearch public Weibo posts by keyword.
/v2/weibo/search/posts2 cr - Search profiles (v2)GETSearch public Weibo profiles by keyword.
/v2/weibo/search/users2 cr - Search profiles (v1)GETSearch Weibo profiles by keyword. The response is a single set of suggested matches.
/v1/weibo/search/users1 cr - Search topics (v1)GETSearch Weibo topics by keyword. An empty page means there are no more results.
/v1/weibo/search/topics1 cr - Search videos (v2)GETSearch public Weibo videos by keyword.
/v2/weibo/search/videos2 cr Search topics (v2)DeprecatedGETDeprecated: use /v1/weibo/search/topics instead. Search public Weibo topics by keyword./v2/weibo/search/topics2 cr
Trends
2 endpoints- Get hot search board (v1)GETGet the current Weibo hot-search board. Use kind to distinguish ranked entries from pinned and paid placements.
/v1/weibo/trends/hot-search1 cr List hot search trends (v2)DeprecatedGETDeprecated: use /v1/weibo/trends/hot-search instead. Returns the current public hot-search ranking. No query fields are required./v2/weibo/trends/hot-search3 cr
Videos
3 endpoints- Get video (v2)GETGet a public Weibo video by ID.
/v2/weibo/videos/detail2 cr - List profile videos (v1)GETList videos posted by a Weibo profile. Send next_cursor as cursor to continue the list.
/v1/weibo/videos/user1 cr List profile videos (v2)DeprecatedGETDeprecated: use /v1/weibo/videos/user instead. List public videos posted by a Weibo profile./v2/weibo/videos/user2 cr
What you can build
- Research public profiles and their posts.
- Explore topics and engagement around public content.
Make your first request
Replace the placeholders with your input values. The endpoint reference explains each input and the returned fields.
curl -X GET "https://api.toolzerhub.com/v2/weibo/search/posts?q=<q>" -H "x-api-key: $TOOLZERHUB_API_KEY"Need a key? Create an account, then review credits and responses and errors.