Skip to content
All Weibo APIs
Posts & videosWeiboPost · Detail

Weibo post detail

Read one public Weibo post's full text, author, posting region, and repost, comment, and like counts by ID.

POST/v1/weibo/posts/detail

Chinese name: 微博详情 · 帖子 · 详情 按微博 ID 读取一条公开微博的全文、作者、发布地和转评赞计数。
weibo.posts.detail@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

post_idstringrequired

pattern: "^\\d{10,20}$" · minLength: 1 · maxLength: 256

Example: "5092682368025584"

is_get_long_textstringoptional

enum: "true" · default: "true"

Request JSON Schema
{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "type": "object",
  "properties": {
    "post_id": {
      "type": "string",
      "minLength": 1,
      "maxLength": 256,
      "pattern": "^\\d{10,20}$"
    },
    "is_get_long_text": {
      "default": "true",
      "type": "string",
      "enum": [
        "true"
      ]
    }
  },
  "required": [
    "post_id"
  ],
  "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/posts/detail \
  -H "Authorization: Bearer $DATAXAPI_API_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{"post_id":"5092682368025584"}'

Response example

200 · application/json
{
  "code": 200,
  "request_id": "req_example_weibo_posts_detail",
  "message": "success",
  "data": {
    "item": {
      "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.posts.detail",
    "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": {},
                "mid": {},
                "mblogid": {},
                "created_at": {},
                "text_raw": {},
                "source": {},
                "region_name": {},
                "reposts_count": {},
                "comments_count": {},
                "attitudes_count": {},
                "isLongText": {},
                "pic_num": {},
                "user": {}
              },
              "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.posts.detail"
        },
        "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 numeric Weibo post ID (mid) and need its public content and reach.

Not for

  • Do not use it for comments, repost lists, or follower-only posts.

Known limitations

  • Only the numeric post ID is accepted, not the short bid.
  • Long posts return the full text; images and videos return only basics such as counts.
  • 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 →