SearchZhihuSearch Result · Search

Zhihu content search

Search public Zhihu answers, articles, and videos by keyword, filtered by type and time range and sorted by votes or time.

POST/v1/zhihu/search/content

Chinese name: 知乎内容搜索 · 搜索结果 · 搜索按关键词搜索知乎公开回答、文章和视频，可限定类型、时间范围并按赞同或时间排序。
zhihu.search.content@v1

Price per call

¥0.02/ call

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

AvailableChecking live status →

Checking live status

Try it

Request JSON body

Security check

Loading the security check…

6-digit code

Checking live execution status…

Execution result

// Result

Request parameters

keywordstringrequired

minLength: 1 · maxLength: 100

Example: "咖啡机推荐"

verticalstringoptional

enum: "answer" | "article" | "zvideo"

Example: "answer"

sortstringoptional

enum: "upvoted_count" | "created_time"

Example: "upvoted_count"

time_intervalstringoptional

offsetintegeroptional

default: 0 · minimum: 0 · maximum: 200

limitintegeroptional

default: 20 · minimum: 1 · maximum: 20

Request JSON Schema

{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "type": "object",
  "properties": {
    "keyword": {
      "type": "string",
      "minLength": 1,
      "maxLength": 100
    },
    "vertical": {
      "type": "string",
      "enum": [
        "answer",
        "article",
        "zvideo"
      ]
    },
    "sort": {
      "type": "string",
      "enum": [
        "upvoted_count",
        "created_time"
      ]
    },
    "time_interval": {
      "type": "string",
      "enum": [
        "a_day",
        "a_week",
        "a_month",
        "three_months",
        "half_a_year",
        "a_year"
      ]
    },
    "offset": {
      "default": 0,
      "type": "integer",
      "minimum": 0,
      "maximum": 200
    },
    "limit": {
      "default": 20,
      "type": "integer",
      "minimum": 1,
      "maximum": 20
    }
  },
  "required": [
    "keyword"
  ],
  "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/search/content \
  -H "Authorization: Bearer $DATAXAPI_API_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{"keyword":"咖啡机推荐","vertical":"answer","sort":"upvoted_count"}'

import { ExactApiClient } from "@dataxapi/sdk";

const client = new ExactApiClient({
  baseUrl: "https://api.dataxapi.com",
  apiKey: process.env.DATAXAPI_API_KEY,
});

const result = await client.call("zhihu_search_content_v1", {
  "keyword": "咖啡机推荐",
  "vertical": "answer",
  "sort": "upvoted_count"
});
console.log(result.data);

import os
from dataxapi import ExactApiClient

client = ExactApiClient("https://api.dataxapi.com", os.environ["DATAXAPI_API_KEY"])

result = client.call("zhihu_search_content_v1", {
    "keyword": "咖啡机推荐",
    "vertical": "answer",
    "sort": "upvoted_count",
})
print(result["data"])

[mcp_servers.dataxapi]
url = "https://api.dataxapi.com/mcp"
bearer_token_env_var = "DATAXAPI_API_KEY"

Response example

200 · application/json

{
  "code": 200,
  "request_id": "req_example_zhihu_search_content",
  "message": "success",
  "data": {
    "items": [
      {
        "type": "search_result",
        "object": {
          "id": 2054145988235880000,
          "type": "answer",
          "question": {
            "id": 37811449,
            "title": "公开问题标题"
          },
          "author": {
            "id": "3b4ec4f4b0b1d8e4f0f2a1c9d8e7f6a5",
            "url_token": "ming-he-43-93",
            "name": "公开答主"
          },
          "excerpt": "公开回答摘要",
          "voteup_count": 1200,
          "comment_count": 88,
          "created_time": 1720000000,
          "updated_time": 1720500000
        },
        "highlight": {
          "title": "<em>咖啡机</em>推荐"
        }
      }
    ]
  },
  "page": {
    "next_cursor": null
  },
  "warnings": [],
  "meta": {
    "listing_id": "zhihu.search.content",
    "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": {
              "type": {},
              "object": {},
              "highlight": {}
            },
            "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": "zhihu.search.content"
        },
        "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 collect experiences, opinions, and discussion on Zhihu around a keyword.

Not for

Do not use it for user search, paid full text, or site-wide statistics.

Known limitations

Paging uses offset up to 200; adjacent pages can overlap.
Content is under object; paid or folded items may only have an excerpt.
Result order is set by the platform and does not explain ranking causality.
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 →