Skip to content
All Weibo APIs
CommentsWeiboComment · List

Weibo post comments

Page through public top-level comments with like and reply counts on a Weibo post.

POST/v1/weibo/posts/comments

Chinese name: 微博评论 · 评论 · 列表 按微博 ID 分页读取公开微博的一级评论和点赞、回复数。
weibo.posts.comments@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: "5283919831764022"

countintegeroptional

default: 20 · minimum: 1 · maximum: 20

cursorstringoptional

minLength: 1

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}$"
    },
    "count": {
      "default": 20,
      "type": "integer",
      "minimum": 1,
      "maximum": 20
    },
    "cursor": {
      "type": "string",
      "minLength": 1
    }
  },
  "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/comments \
  -H "Authorization: Bearer $DATAXAPI_API_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{"post_id":"5283919831764022"}'

Response example

200 · application/json
{
  "code": 200,
  "request_id": "req_example_weibo_posts_comments",
  "message": "success",
  "data": {
    "items": [
      {
        "idstr": "5283574244704555",
        "created_at": "Wed Mar 12 09:00:00 +0800 2025",
        "text_raw": "公开评论",
        "like_counts": 56,
        "total_number": 4,
        "rootidstr": "5283574244704555",
        "source": "来自上海",
        "user": {
          "idstr": "7277477906",
          "screen_name": "公开用户"
        }
      }
    ]
  },
  "page": {
    "next_cursor": "cursor_example"
  },
  "warnings": [],
  "meta": {
    "listing_id": "weibo.posts.comments",
    "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": {},
              "created_at": {},
              "text_raw": {},
              "like_counts": {},
              "total_number": {},
              "rootidstr": {},
              "source": {},
              "user": {}
            },
            "additionalProperties": false
          }
        }
      },
      "required": [
        "items"
      ],
      "additionalProperties": false
    },
    "page": {
      "type": "object",
      "properties": {
        "next_cursor": {
          "anyOf": [
            {
              "type": "string"
            },
            {
              "type": "null"
            }
          ]
        }
      },
      "required": [
        "next_cursor"
      ],
      "additionalProperties": false
    },
    "warnings": {
      "type": "array",
      "items": {
        "type": "string"
      }
    },
    "meta": {
      "type": "object",
      "properties": {
        "listing_id": {
          "type": "string",
          "const": "weibo.posts.comments"
        },
        "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 read public comments for opinion or sentiment work.

Not for

  • Do not use it for nested replies, repost lists, or exhaustive archives.

Known limitations

  • Each page asks for at most 20 comments in platform order.
  • Only the returned DataXAPI cursor can continue the same query.
  • Deleted, private, or restricted content is absent.
  • 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 →