List Weibo profile posts
List a Weibo account's newest posts, about 10, with text, images, video and counts.
Headers
Get your API keyAPI key (`sfk_...`)
The account's id (the digits in a profile link such as weibo.com/u/1195230310), a whole profile link, or its screen name (handle) such as `何炅`, with or without `@`. A screen name is looked up first; an unknown one answers `not_found` free of charge.
min 1 chars · max 512 chars
Endpoint-specific response payload.
`empty` when Weibo shows no posts for this id: the account has none it shows logged out, or no account has this id (the profile endpoint tells the two apart). `not_found` when no account has this screen name, which is not charged.
one of: found, empty, not_found
The account's newest posts, as Weibo shows them logged out: up to 10, pinned posts first. `page.truncated` says whether it has 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/profiles/1195230310/posts" \
-H "x-api-key: YOUR_API_KEY"Responses
A Weibo account's newest posts.