> **For coding agents and LLMs:** This is one Social Fetch marketing page (markdown export). For API orientation start with [`/llms.txt`](https://www.socialfetch.dev/llms.txt); for auth and crawl rules use [`/agents.txt`](https://www.socialfetch.dev/agents.txt); for every operation use [`/llms-endpoints.txt`](https://www.socialfetch.dev/llms-endpoints.txt).

## This page

- **On-site (HTML):** <https://www.socialfetch.dev/platforms/weibo>
- **Markdown (.mdx) URL:** <https://www.socialfetch.dev/platforms/weibo.mdx>

---

# Weibo API. China's microblog as JSON.

Look up any public Weibo account, read its newest posts, open a post with its comments and replies, search posts and accounts, and follow the hot-search list. Every response uses the same envelope.

- Accounts + posts
- Hot search
- 1 credit per request

Weibo is China's largest public microblog. `GET /v1/weibo/profiles/{profileId}` returns an account: screen name, bio, gender, verification and what it says, cover image, and its posts, followers and following. Followers come as Weibo shows them (`1.17亿`) and as a number (117000000). `/v1/weibo/profiles/{profileId}/posts` lists the account's newest posts, about 10, pinned posts first.

`GET /v1/weibo/posts/{postId}` opens one post with its full text, topics, mentions, images or video, the region it was published from, the post it reposts, and its reposts, comments and likes; `/comments` returns its top comments, about 20, and `/v1/weibo/comments/{commentId}/replies` the replies to one of them. `/v1/weibo/search/posts` searches posts, popular or newest first, `/v1/weibo/search/profiles` searches accounts, and `/v1/weibo/trending` returns the real-time hot-search list, about 50 topics with their heat.

Every answer is JSON in the `{ data, meta }` envelope, with `data.lookupStatus` on every route but the hot-search list. Lists hold the first page Weibo shows publicly and say with `page.truncated` and `page.total` when there is more. Chinese text comes back exactly as written, and a Chinese search query works as typed.

## What you can get

- Account profile with bio, verification, cover image, posts, following, and followers as shown and as a number.
- An account's newest posts, about 10, with text, images, video and counts.
- Single posts with full text, topics, mentions, images or video, region, the reposted post and counts.
- A post's top comments, about 20, and the replies to any comment.
- Post search (popular or newest first) and account search.
- The real-time hot-search list: about 50 topics with rank and heat.

## Weibo endpoints

| Endpoint | Request | Credits | Docs |
| --- | --- | --- | --- |
| Profile | GET /v1/weibo/profiles/{profileId} | 1 credit Failed requests are free Found, empty and not-found answers are charged, except a screen name no account has, which is free | [docs](https://www.socialfetch.dev/docs/api/v1/weibo/profiles/profileid/get) |
| Profile posts | GET /v1/weibo/profiles/{profileId}/posts | 1 credit Failed requests are free Found, empty and not-found answers are charged, except a screen name no account has, which is free | [docs](https://www.socialfetch.dev/docs/api/v1/weibo/profiles/profileid/posts/get) |
| Post | GET /v1/weibo/posts/{postId} | 1 credit Failed requests are free Found, empty and not-found answers are all charged | [docs](https://www.socialfetch.dev/docs/api/v1/weibo/posts/postid/get) |
| Post comments | GET /v1/weibo/posts/{postId}/comments | 1 credit Failed requests are free Found, empty and not-found answers are all charged | [docs](https://www.socialfetch.dev/docs/api/v1/weibo/posts/postid/comments/get) |
| Comment replies | GET /v1/weibo/comments/{commentId}/replies | 1 credit Failed requests are free Found, empty and not-found answers are all charged | [docs](https://www.socialfetch.dev/docs/api/v1/weibo/comments/commentid/replies/get) |
| Search posts | GET /v1/weibo/search/posts | 1 credit Failed requests are free Found, empty and not-found answers are all charged | [docs](https://www.socialfetch.dev/docs/api/v1/weibo/search/posts/get) |
| Search accounts | GET /v1/weibo/search/profiles | 1 credit Failed requests are free Found, empty and not-found answers are all charged | [docs](https://www.socialfetch.dev/docs/api/v1/weibo/search/profiles/get) |
| Hot search | GET /v1/weibo/trending | 1 credit Failed requests are free Found, empty and not-found answers are all charged | [docs](https://www.socialfetch.dev/docs/api/v1/weibo/trending/get) |

## How to start

1. **Create an API key.** Sign up at Social Fetch and copy a key (`sfk_…`). New accounts get 100 free credits, enough to try every route.
2. **Pick the account, post or search.** Use an account's screen name or the digits of its profile link (weibo.com/u/1195230310), a post's 16-digit id or its short code (weibo.com/1195230310/Rrookh8wG), or any whole link. Searches take Chinese or English text. Send `x-api-key` on every request.
3. **Branch on the answer.** Check `data.lookupStatus` before you store a row, read `page.truncated` on lists, and bill from `meta.creditsCharged`.

## Pricing

Each Weibo route charges a flat credit amount per completed request, shown on every endpoint page. Credits never expire on pay-as-you-go packs, and `meta.creditsCharged` on every response is the billing source of truth.

## Compared with the official API

Social Fetch gives every Weibo route one JSON shape: ISO 8601 UTC timestamps, counts read from Weibo's own labels (`1.17亿` reads 117000000, `63万次播放` reads 630000) with the label kept beside them, topics and mentions pulled out of the text, and typed `lookupStatus` responses. You do not need a Weibo account, an app registration or a user session.

## FAQ

### What Weibo data can I get from the API?

Account profiles, an account's newest posts, single posts with text, media, region and counts, a post's top comments and the replies to a comment, post and account search, and the real-time hot-search list.

### How do I name an account or a post?

For an account, use the digits in its profile link (weibo.com/u/1195230310), the whole link or its screen name, such as 何炅. For a post, use its 16-digit id, its short code (the last part of weibo.com/1195230310/Rrookh8wG) or its whole link.

### Why does the follower count look rounded?

Weibo rounds large follower counts, such as 1.17亿 (117 million). stats.followersLabel keeps the label as Weibo writes it and stats.followers gives it as a number. Very large repost, comment and like counts are rounded the same way.

### Can I get every post, comment or search result?

No. Each list holds the first page Weibo shows publicly: about 10 newest posts, about 20 comments or replies, and the first page of search results. page.truncated says whether the list goes on and page.total how many rows it has in all.

### Does Chinese text come back intact?

Yes. Posts, comments, names and topics come back exactly as written, with emoji written as [name]. Search queries in Chinese work as typed, for example 苹果.

### What is the hot-search list?

Weibo's real-time ranking of the topics people search most (微博热搜), updated every minute. The route returns about 50 ranked topics with their heat score and badge, and marks the rows Weibo pins or promotes. Pass a topic's query to the post search to read the posts behind it.

### Can I store the image and video links?

Video links are signed and expire, so download the files if you need them. The post and profile page urls stay valid.

### How much does the Weibo API cost?

Every Weibo route charges a flat amount per completed request, shown on each endpoint page. A found, empty or not-found answer is a completed request and costs that amount; invalid requests and errors are free. Check meta.creditsCharged on every response. New accounts start with 100 free credits.

## Related

- [Weibo Profile API](https://www.socialfetch.dev/platforms/weibo/profiles-profileid): Bio, verification and followers (`GET /v1/weibo/profiles/{profileId}`).
- [Weibo Profile Posts API](https://www.socialfetch.dev/platforms/weibo/profiles-profileid-posts): An account's newest posts (`GET /v1/weibo/profiles/{profileId}/posts`).
- [Weibo Post API](https://www.socialfetch.dev/platforms/weibo/posts-postid): One post with media, region and counts (`GET /v1/weibo/posts/{postId}`).
- [Weibo Post Comments API](https://www.socialfetch.dev/platforms/weibo/posts-postid-comments): A post's top comments (`GET /v1/weibo/posts/{postId}/comments`).
- [Weibo Comment Replies API](https://www.socialfetch.dev/platforms/weibo/comments-commentid-replies): Replies to a comment (`GET /v1/weibo/comments/{commentId}/replies`).
- [Weibo Post Search API](https://www.socialfetch.dev/platforms/weibo/search-posts): Posts by keyword, popular or newest first (`GET /v1/weibo/search/posts`).
- [Weibo Account Search API](https://www.socialfetch.dev/platforms/weibo/search-profiles): Accounts by name or keyword (`GET /v1/weibo/search/profiles`).
- [Weibo Hot Search API](https://www.socialfetch.dev/platforms/weibo/trending): The real-time hot-search list with heat (`GET /v1/weibo/trending`).
- [Hosted MCP](https://www.socialfetch.dev/mcp): Call Weibo tools from Cursor or Claude with the same credit metering as REST.
