Skip to content
All Weibo APIs
Accounts & creatorsWeiboUser · Profile

Weibo user profile

Read a public Weibo user's name, bio, verification, and follower, following, and post counts by UID.

POST/v1/weibo/users/profile

Chinese name: 微博用户资料 · 用户 · 资料 按 UID 读取微博公开用户的昵称、简介、认证信息和粉丝、关注、微博数。
weibo.users.profile@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"

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}$"
    }
  },
  "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/profile \
  -H "Authorization: Bearer $DATAXAPI_API_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{"uid":"1722594714"}'

Response example

200 · application/json
{
  "code": 200,
  "request_id": "req_example_weibo_users_profile",
  "message": "success",
  "data": {
    "item": {
      "idstr": "1722594714",
      "screen_name": "公开博主",
      "description": "公开简介",
      "followers_count": 1200000,
      "friends_count": 300,
      "statuses_count": 8000,
      "verified": true,
      "verified_reason": "知名博主"
    }
  },
  "page": {
    "next_cursor": null
  },
  "warnings": [],
  "meta": {
    "listing_id": "weibo.users.profile",
    "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": {
        "item": {
          "anyOf": [
            {
              "type": "object",
              "properties": {
                "idstr": {},
                "screen_name": {},
                "description": {},
                "location": {},
                "gender": {},
                "followers_count": {},
                "friends_count": {},
                "statuses_count": {},
                "verified": {},
                "verified_type": {},
                "verified_reason": {}
              },
              "additionalProperties": false
            },
            {
              "type": "null"
            }
          ]
        }
      },
      "required": [
        "item"
      ],
      "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.profile"
        },
        "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 when you have a UID and need the account's public profile, verification, and scale.

Not for

  • Do not use it for follower lists, DMs, or signed-in data.

Known limitations

  • Large follower counts can be display text such as "1.2万".
  • Counts are point-in-time public snapshots, not live or historical trends.

Billing

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

See all pricing →