Search Weibo posts
Search Weibo posts by keyword, popular or newest first, from the first page of results.
Headers
Get your API keyAPI key (`sfk_...`)
What to search for, in any language. Chinese text works as typed, for example `苹果`.
min 1 chars · max 100 chars
`top` (the default) is Weibo's own mix, popular posts first; `recent` is the real-time feed, newest first.
one of: top, recent
Endpoint-specific response payload.
`empty` when the search has no results.
one of: found, empty
The query as searched.
`top` (the default) is Weibo's own mix, popular posts first; `recent` is the real-time feed, newest first.
one of: top, recent
Matching posts from the first page of results, as Weibo shows them logged out: about 10 to 20. Long posts are shortened (`isTextTruncated`). `page.truncated` says whether there are more.
Post id (16 digits). Pass it as `postId` to the post and comments endpoints.
The short code in the post's weibo.com link.
Post page.
The post's text as plain text, with topics written `#name#`, mentions `@name` and emoji as `[name]`.
True when this is a shortened copy of a long post: the post endpoint returns the whole text.
The headline Weibo shows above some posts, when it has one.
When the post was published, ISO 8601 UTC.
When the post was last edited, ISO 8601 UTC; null if never.
The region Weibo shows the post was published from, such as `湖南`.
The app or device the post was sent from, when shown.
Topics (hashtags) in the text, without the `#` marks.
Screen names the text mentions, without the `@`.
The pictures, in order.
The full-size image.
A smaller preview of the image.
Full-size width in pixels.
Full-size height in pixels.
The video, for a video post; otherwise null.
The best MP4 file offered. A signed link that expires: download it, do not store it.
The cover image.
The video's title, when it has one.
Length in seconds, when known.
Plays, read from the site's label (`63万次播放` reads 630000).
Plays as the site writes them, such as `63万次播放`.
Engagement counters. Weibo rounds large counts (`100万+`); those read as the number shown.
Reposts.
Comments.
Likes.
Who posted it; null when Weibo hides the account.
Weibo account id, the same on every endpoint: pass it as `profileId` to the profile endpoints.
Screen name.
Profile picture.
Profile page.
True when Weibo verified the account.
For a repost, the post it shares; null for an original post or when the shared post was deleted.
Post id (16 digits). Pass it as `postId` to the post and comments endpoints.
The short code in the post's weibo.com link.
Post page.
The post's text as plain text, with topics written `#name#`, mentions `@name` and emoji as `[name]`.
True when this is a shortened copy of a long post: the post endpoint returns the whole text.
The headline Weibo shows above some posts, when it has one.
When the post was published, ISO 8601 UTC.
When the post was last edited, ISO 8601 UTC; null if never.
The region Weibo shows the post was published from, such as `湖南`.
The app or device the post was sent from, when shown.
Topics (hashtags) in the text, without the `#` marks.
Screen names the text mentions, without the `@`.
The pictures, in order.
The full-size image.
A smaller preview of the image.
Full-size width in pixels.
Full-size height in pixels.
The video, for a video post; otherwise null.
The best MP4 file offered. A signed link that expires: download it, do not store it.
The cover image.
The video's title, when it has one.
Length in seconds, when known.
Plays, read from the site's label (`63万次播放` reads 630000).
Plays as the site writes them, such as `63万次播放`.
Engagement counters. Weibo rounds large counts (`100万+`); those read as the number shown.
Reposts.
Comments.
Likes.
Who posted it; null when Weibo hides the account.
Weibo account id, the same on every endpoint: pass it as `profileId` to the profile endpoints.
Screen name.
Profile picture.
Profile page.
True when Weibo verified the account.
Pagination state. Weibo shows logged-out visitors the first page of a list, so there is never a next page.
Whether another page is available.
Cursor to pass in the next request when more pages exist; null on the last page.
True when the list has more rows than Weibo shows logged out: it stops here before its end.
How many rows the list has in all, as Weibo counts them.
Metadata describing the request and billing outcome.
Unique request identifier for tracing this API call.
min 1 chars
Credits charged for this request.
≥ 0
Public API version that served the response.
one of: v1
Present, and `true`, only when the source couldn't be reached and this is the last good answer for the same request instead, up to 24 hours old. Absent on every live answer.
one of: true
When a stale answer (`stale: true`) was originally fetched (ISO 8601, UTC). Absent on every live answer.
Code example
curl "https://api.socialfetch.dev/v1/weibo/search/posts?query=苹果" \
-H "x-api-key: YOUR_API_KEY"Responses
Weibo posts that match a query.