Weibo

Search Weibo posts

Search Weibo posts by keyword, popular or newest first, from the first page of results.

GET/v1/weibo/search/posts
x-api-keystringheader

API key (`sfk_...`)

Parameters
2
querystringrequiredquery

What to search for, in any language. Chinese text works as typed, for example `苹果`.

min 1 chars · max 100 chars

sortstringoptionalquery

`top` (the default) is Weibo's own mix, popular posts first; `recent` is the real-time feed, newest first.

one of: top, recent

Response fields
89

Endpoint-specific response payload.

datalookupStatus
string

`empty` when the search has no results.

one of: found, empty

dataquery
string

The query as searched.

datasort
string

`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.

dataposts[]id
string

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

dataposts[]shortCode
stringnullable

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

dataposts[]url
string

Post page.

dataposts[]text
stringnullable

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

dataposts[]isTextTruncated
boolean

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

dataposts[]title
stringnullable

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

dataposts[]createdAt
stringnullable

When the post was published, ISO 8601 UTC.

dataposts[]editedAt
stringnullable

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

dataposts[]region
stringnullable

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

dataposts[]source
stringnullable

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

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

dataposts[]topics[]
stringoptional

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

dataposts[]mentions[]
stringoptional

The pictures, in order.

dataposts[]images[]url
stringnullable

The full-size image.

dataposts[]images[]previewUrl
stringnullable

A smaller preview of the image.

dataposts[]images[]width
integernullable

Full-size width in pixels.

dataposts[]images[]height
integernullable

Full-size height in pixels.

The video, for a video post; otherwise null.

dataposts[]videourl
stringnullable

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

dataposts[]videocoverUrl
stringnullable

The cover image.

dataposts[]videotitle
stringnullable

The video's title, when it has one.

dataposts[]videodurationSeconds
numbernullable

Length in seconds, when known.

dataposts[]videoplayCount
integernullable

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

dataposts[]videoplayCountLabel
stringnullable

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

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

dataposts[]statsreposts
integernullable

Reposts.

dataposts[]statscomments
integernullable

Comments.

dataposts[]statslikes
integernullable

Likes.

Who posted it; null when Weibo hides the account.

dataposts[]authorid
string

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

dataposts[]authordisplayName
stringnullable

Screen name.

dataposts[]authoravatarUrl
stringnullable

Profile picture.

dataposts[]authorurl
string

Profile page.

dataposts[]authorisVerified
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.

dataposts[]repostOfid
string

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

dataposts[]repostOfshortCode
stringnullable

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

dataposts[]repostOfurl
string

Post page.

dataposts[]repostOftext
stringnullable

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

dataposts[]repostOfisTextTruncated
boolean

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

dataposts[]repostOftitle
stringnullable

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

dataposts[]repostOfcreatedAt
stringnullable

When the post was published, ISO 8601 UTC.

dataposts[]repostOfeditedAt
stringnullable

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

dataposts[]repostOfregion
stringnullable

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

dataposts[]repostOfsource
stringnullable

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

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

dataposts[]repostOftopics[]
stringoptional

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

dataposts[]repostOfmentions[]
stringoptional

The pictures, in order.

dataposts[]repostOfimages[]url
stringnullable

The full-size image.

dataposts[]repostOfimages[]previewUrl
stringnullable

A smaller preview of the image.

dataposts[]repostOfimages[]width
integernullable

Full-size width in pixels.

dataposts[]repostOfimages[]height
integernullable

Full-size height in pixels.

The video, for a video post; otherwise null.

dataposts[]repostOfvideourl
stringnullable

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

dataposts[]repostOfvideocoverUrl
stringnullable

The cover image.

dataposts[]repostOfvideotitle
stringnullable

The video's title, when it has one.

dataposts[]repostOfvideodurationSeconds
numbernullable

Length in seconds, when known.

dataposts[]repostOfvideoplayCount
integernullable

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

dataposts[]repostOfvideoplayCountLabel
stringnullable

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

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

dataposts[]repostOfstatsreposts
integernullable

Reposts.

dataposts[]repostOfstatscomments
integernullable

Comments.

dataposts[]repostOfstatslikes
integernullable

Likes.

Who posted it; null when Weibo hides the account.

dataposts[]repostOfauthorid
string

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

dataposts[]repostOfauthordisplayName
stringnullable

Screen name.

dataposts[]repostOfauthoravatarUrl
stringnullable

Profile picture.

dataposts[]repostOfauthorurl
string

Profile page.

dataposts[]repostOfauthorisVerified
booleannullable

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.

datapagehasMore
boolean

Whether another page is available.

datapagenextCursor
stringnullable

Cursor to pass in the next request when more pages exist; null on the last page.

datapagetruncated
boolean

True when the list has more rows than Weibo shows logged out: it stops here before its end.

datapagetotal
integernullable

How many rows the list has in all, as Weibo counts them.

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/search/posts?query=苹果" \
  -H "x-api-key: YOUR_API_KEY"

Responses

Weibo posts that match a query.