Skip to content
All Weibo APIs
Accounts & creatorsWeiboUser Post · List

Weibo user posts

Read a Weibo account's public posts with repost, comment, and like counts by UID and page.

POST/v1/weibo/users/posts

Chinese name: 微博用户微博 · 用户帖子 · 列表 按 UID 和页码读取微博博主的公开微博及转评赞计数。
weibo.users.posts@v1

Price per call

¥0.02/ call

Nonempty complete results are charged; empty, partial, and failed results are not.

Current statusAvailableChecking live status
Checking live status

Try it

Sign in and run one real call. The result and charge appear right here.

Security check

Loading the security check…

Checking live execution status…

Execution result

// Result

Request parameters

uidstringrequired

pattern: "^\\d{5,12}$" · minLength: 1 · maxLength: 256

Example: "1722594714"

pageintegeroptional

default: 1 · minimum: 1 · maximum: 50

Example: 1

Request JSON Schema
{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "type": "object",
  "properties": {
    "uid": {
      "type": "string",
      "minLength": 1,
      "maxLength": 256,
      "pattern": "^\\d{5,12}$"
    },
    "page": {
      "default": 1,
      "type": "integer",
      "minimum": 1,
      "maximum": 50
    }
  },
  "required": [
    "uid"
  ],
  "additionalProperties": false
}

Code samples

Install the SDK with npm i @dataxapi/sdk or pip install dataxapi, and put your API key in the DATAXAPI_API_KEY environment variable.

curl -X POST https://api.dataxapi.com/v1/weibo/users/posts \
  -H "Authorization: Bearer $DATAXAPI_API_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{"uid":"1722594714","page":1}'

Response example

200 · application/json
{
  "code": 200,
  "request_id": "req_example_weibo_users_posts",
  "message": "success",
  "data": {
    "items": [
      {
        "idstr": "5092682368025584",
        "mid": "5092682368025584",
        "mblogid": "OtjRk5Xyz",
        "created_at": "Tue Oct 15 10:00:00 +0800 2024",
        "text_raw": "公开微博正文",
        "source": "微博网页版",
        "region_name": "发布于 北京",
        "reposts_count": 120,
        "comments_count": 340,
        "attitudes_count": 2800,
        "isLongText": false,
        "pic_num": 1,
        "user": {
          "idstr": "1722594714",
          "screen_name": "公开博主",
          "verified": true
        }
      }
    ]
  },
  "page": {
    "next_cursor": null
  },
  "warnings": [],
  "meta": {
    "listing_id": "weibo.users.posts",
    "version": "v1",
    "catalog_release_id": "catalog-production-2026-09-19.b069be57",
    "price_book_version": "pricebook-production-2026-09-19.4487e352",
    "result_status": "complete",
    "charged_amount": "0.02",
    "balance_after": "49.98",
    "currency": "CNY"
  }
}
Response fields
codenumber
const: 200
request_idstring
messagestring
const: "success"
dataobject
pageobject
warningsarray
metaobject
Response JSON Schema
{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "type": "object",
  "properties": {
    "code": {
      "type": "number",
      "const": 200
    },
    "request_id": {
      "type": "string"
    },
    "message": {
      "type": "string",
      "const": "success"
    },
    "data": {
      "type": "object",
      "properties": {
        "items": {
          "type": "array",
          "items": {
            "type": "object",
            "properties": {
              "idstr": {},
              "mid": {},
              "mblogid": {},
              "created_at": {},
              "text_raw": {},
              "source": {},
              "region_name": {},
              "reposts_count": {},
              "comments_count": {},
              "attitudes_count": {},
              "isLongText": {},
              "pic_num": {},
              "user": {}
            },
            "additionalProperties": false
          }
        }
      },
      "required": [
        "items"
      ],
      "additionalProperties": false
    },
    "page": {
      "type": "object",
      "properties": {
        "next_cursor": {
          "type": "null"
        }
      },
      "required": [
        "next_cursor"
      ],
      "additionalProperties": false
    },
    "warnings": {
      "type": "array",
      "items": {
        "type": "string"
      }
    },
    "meta": {
      "type": "object",
      "properties": {
        "listing_id": {
          "type": "string",
          "const": "weibo.users.posts"
        },
        "version": {
          "type": "string",
          "const": "v1"
        },
        "catalog_release_id": {
          "type": "string",
          "minLength": 1
        },
        "price_book_version": {
          "type": "string",
          "minLength": 1
        },
        "result_status": {
          "type": "string",
          "enum": [
            "complete",
            "empty",
            "partial"
          ]
        },
        "charged_amount": {
          "type": "string"
        },
        "balance_after": {
          "type": "string"
        },
        "currency": {
          "type": "string",
          "const": "CNY"
        }
      },
      "required": [
        "listing_id",
        "version",
        "catalog_release_id",
        "price_book_version",
        "result_status",
        "charged_amount",
        "balance_after",
        "currency"
      ],
      "additionalProperties": false
    }
  },
  "required": [
    "code",
    "request_id",
    "message",
    "data",
    "page",
    "warnings",
    "meta"
  ],
  "additionalProperties": false
}

Usage notes

Good for

  • Use it to review what an account posts publicly and how it spreads.

Not for

  • Do not use it for follower-only, deleted, or private posts.

Known limitations

  • Pages hold about 10 posts, reposts included; long posts may be truncated.
  • Page-number paging can repeat or skip items between pages.
  • Counts are point-in-time public snapshots, not live or historical trends.
  • Nested objects such as the author are returned as upstream sends them, minus tokens, account-binding flags, privacy settings, and tracking fields; avatar and media links inside them may expire.

Billing

¥0.02 per call. Nonempty complete results are charged; empty, partial, and failed results are not.

See all pricing →