Skip to content
DataXAPI
All Zhihu APIs
Accounts & creatorsZhihuUser · Profile

Zhihu user profile

Read a public Zhihu user's headline, badges, and follower, answer, and vote counts by url_token.

POST/v1/zhihu/users/profile

Chinese name: 知乎用户资料 · 用户 · 资料 按个人主页 url_token 读取知乎公开用户的介绍、认证和粉丝、回答、获赞数。
zhihu.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

url_tokenstringrequired

pattern: "^[A-Za-z0-9_-]{1,64}$" · minLength: 1 · maxLength: 256

Example: "ming-he-43-93"

Request JSON Schema
{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "type": "object",
  "properties": {
    "url_token": {
      "type": "string",
      "minLength": 1,
      "maxLength": 256,
      "pattern": "^[A-Za-z0-9_-]{1,64}$"
    }
  },
  "required": [
    "url_token"
  ],
  "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/zhihu/users/profile \
  -H "Authorization: Bearer $DATAXAPI_API_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{"url_token":"ming-he-43-93"}'

Response example

200 · application/json
{
  "code": 200,
  "request_id": "req_example_zhihu_users_profile",
  "message": "success",
  "data": {
    "item": {
      "id": "3b4ec4f4b0b1d8e4f0f2a1c9d8e7f6a5",
      "url_token": "ming-he-43-93",
      "name": "公开答主",
      "headline": "公开介绍",
      "follower_count": 12000,
      "answer_count": 300,
      "voteup_count": 45000
    }
  },
  "page": {
    "next_cursor": null
  },
  "warnings": [],
  "meta": {
    "listing_id": "zhihu.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": {
                "id": {},
                "url_token": {},
                "name": {},
                "headline": {},
                "description": {},
                "gender": {},
                "follower_count": {},
                "following_count": {},
                "answer_count": {},
                "articles_count": {},
                "voteup_count": {},
                "badge": {}
              },
              "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": "zhihu.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 the url_token after /people/ and need the writer's public background.

Not for

  • Do not use it for real-identity checks, sensitive profiling, or relationship monitoring.

Known limitations

  • Headlines and occupations are self-reported.
  • url_token can change; store the returned id for long-term tracking.
  • 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 →