Weibo hub

Weibo Profile Posts API

Read an account's newest posts with their media and counts.

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

About this endpoint

GET /v1/weibo/profiles/1195230310/posts returns data.posts, the account's newest posts (about 10, pinned posts first), each with id, shortCode, url, text, createdAt, region, topics, mentions, images, video, repostOf, stats and author.

Long posts come shortened, with isTextTruncated: true: open the post by id for its whole text. page.truncated says whether the account has more posts than the list holds and page.total how many it has. Pass the account's id, profile link or screen name. An account with no posts, or an unknown id, returns lookupStatus: empty; a screen name nobody has returns lookupStatus: not_found, free.

Price

From $1.35 per 1,000 requests

1 credit per request. Failed requests are free.

Scale pack
$1.64 / 1,000
Growth pack
$2.36 / 1,000

The lowest rate is on annual plans; packs are pay as you go.

Example request

Send your API key in the x-api-key header. New accounts get 100 free credits, no card needed.

Request
cURL

Example response

A 200 response. Live responses have the same shape with current data.

Request
JSON

Weibo Profile Posts API FAQ

How many posts does it return?

The first page Weibo shows publicly, about 10 posts, newest first after any pinned ones. page.truncated says whether the account has more and page.total how many it has in all.

Why is some post text cut short?

Weibo shortens long posts in lists. isTextTruncated is true for those; pass the post id to the post endpoint for the whole text.

Does an empty list cost a credit?

Yes. It is a completed lookup: lookupStatus is empty and posts is empty. Use the profile endpoint to tell an account without posts from an id that does not exist.

How many credits does a request cost?

Pricing is documented on the operation in the API registry (shown on this page). Confirm on every response with meta.creditsCharged: that field is the billing source of truth.