Weibo

Get Weibo post

Get a Weibo post by id, short code or link, with its text, media, region, reposted post and counts.

GET/v1/weibo/posts/{postId}
x-api-keystringheader

API key (`sfk_...`)

Parameters
1
postIdstringrequiredpath

The post's id: its 16 digits (as in m.weibo.cn/detail/5365286204084354), its short code (the last part of weibo.com/1195230310/Rrookh8wG) or a whole post link.

min 1 chars · max 512 chars

Response fields
82

Endpoint-specific response payload.

datalookupStatus
string

`not_found` when no post has this id, or it was deleted.

one of: found, not_found

The post when `lookupStatus` is `found`; otherwise null.

datapostid
string

Post id (16 digits). Pass it as `postId` to the post and comments endpoints.

datapostshortCode
stringnullable

The short code in the post's weibo.com link.

dataposturl
string

Post page.

dataposttext
stringnullable

The post's text as plain text, with topics written `#name#`, mentions `@name` and emoji as `[name]`.

datapostisTextTruncated
boolean

True when this is a shortened copy of a long post: the post endpoint returns the whole text.

dataposttitle
stringnullable

The headline Weibo shows above some posts, when it has one.

datapostcreatedAt
stringnullable

When the post was published, ISO 8601 UTC.

dataposteditedAt
stringnullable

When the post was last edited, ISO 8601 UTC; null if never.

datapostregion
stringnullable

The region Weibo shows the post was published from, such as `湖南`.

datapostsource
stringnullable

The app or device the post was sent from, when shown.

Topics (hashtags) in the text, without the `#` marks.

dataposttopics[]
stringoptional

Screen names the text mentions, without the `@`.

datapostmentions[]
stringoptional

The pictures, in order.

datapostimages[]url
stringnullable

The full-size image.

datapostimages[]previewUrl
stringnullable

A smaller preview of the image.

datapostimages[]width
integernullable

Full-size width in pixels.

datapostimages[]height
integernullable

Full-size height in pixels.

The video, for a video post; otherwise null.

datapostvideourl
stringnullable

The best MP4 file offered. A signed link that expires: download it, do not store it.

datapostvideocoverUrl
stringnullable

The cover image.

datapostvideotitle
stringnullable

The video's title, when it has one.

datapostvideodurationSeconds
numbernullable

Length in seconds, when known.

datapostvideoplayCount
integernullable

Plays, read from the site's label (`63万次播放` reads 630000).

datapostvideoplayCountLabel
stringnullable

Plays as the site writes them, such as `63万次播放`.

Engagement counters. Weibo rounds large counts (`100万+`); those read as the number shown.

datapoststatsreposts
integernullable

Reposts.

datapoststatscomments
integernullable

Comments.

datapoststatslikes
integernullable

Likes.

Who posted it; null when Weibo hides the account.

datapostauthorid
string

Weibo account id, the same on every endpoint: pass it as `profileId` to the profile endpoints.

datapostauthordisplayName
stringnullable

Screen name.

datapostauthoravatarUrl
stringnullable

Profile picture.

datapostauthorurl
string

Profile page.

datapostauthorisVerified
booleannullable

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.

datapostrepostOfid
string

Post id (16 digits). Pass it as `postId` to the post and comments endpoints.

datapostrepostOfshortCode
stringnullable

The short code in the post's weibo.com link.

datapostrepostOfurl
string

Post page.

datapostrepostOftext
stringnullable

The post's text as plain text, with topics written `#name#`, mentions `@name` and emoji as `[name]`.

datapostrepostOfisTextTruncated
boolean

True when this is a shortened copy of a long post: the post endpoint returns the whole text.

datapostrepostOftitle
stringnullable

The headline Weibo shows above some posts, when it has one.

datapostrepostOfcreatedAt
stringnullable

When the post was published, ISO 8601 UTC.

datapostrepostOfeditedAt
stringnullable

When the post was last edited, ISO 8601 UTC; null if never.

datapostrepostOfregion
stringnullable

The region Weibo shows the post was published from, such as `湖南`.

datapostrepostOfsource
stringnullable

The app or device the post was sent from, when shown.

Topics (hashtags) in the text, without the `#` marks.

datapostrepostOftopics[]
stringoptional

Screen names the text mentions, without the `@`.

datapostrepostOfmentions[]
stringoptional

The pictures, in order.

datapostrepostOfimages[]url
stringnullable

The full-size image.

datapostrepostOfimages[]previewUrl
stringnullable

A smaller preview of the image.

datapostrepostOfimages[]width
integernullable

Full-size width in pixels.

datapostrepostOfimages[]height
integernullable

Full-size height in pixels.

The video, for a video post; otherwise null.

datapostrepostOfvideourl
stringnullable

The best MP4 file offered. A signed link that expires: download it, do not store it.

datapostrepostOfvideocoverUrl
stringnullable

The cover image.

datapostrepostOfvideotitle
stringnullable

The video's title, when it has one.

datapostrepostOfvideodurationSeconds
numbernullable

Length in seconds, when known.

datapostrepostOfvideoplayCount
integernullable

Plays, read from the site's label (`63万次播放` reads 630000).

datapostrepostOfvideoplayCountLabel
stringnullable

Plays as the site writes them, such as `63万次播放`.

Engagement counters. Weibo rounds large counts (`100万+`); those read as the number shown.

datapostrepostOfstatsreposts
integernullable

Reposts.

datapostrepostOfstatscomments
integernullable

Comments.

datapostrepostOfstatslikes
integernullable

Likes.

Who posted it; null when Weibo hides the account.

datapostrepostOfauthorid
string

Weibo account id, the same on every endpoint: pass it as `profileId` to the profile endpoints.

datapostrepostOfauthordisplayName
stringnullable

Screen name.

datapostrepostOfauthoravatarUrl
stringnullable

Profile picture.

datapostrepostOfauthorurl
string

Profile page.

datapostrepostOfauthorisVerified
booleannullable

True when Weibo verified the account.

Metadata describing the request and billing outcome.

metarequestId
string

Unique request identifier for tracing this API call.

min 1 chars

metacreditsCharged
integer

Credits charged for this request.

≥ 0

metaversion
string

Public API version that served the response.

one of: v1

metastale
booleanoptional

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

metafetchedAt
stringoptional

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/posts/5365286204084354" \
  -H "x-api-key: YOUR_API_KEY"

Responses

A Weibo post.