知乎公开数据 API | SandBase

用一个 REST API 读取知乎公开的问题、回答、文章、热榜和用户资料。无需知乎登录,无需 SDK,一把 SandBase key,为 agent 而建。

深色电影质感画面:知乎问题、回答和资料数据经由单一 API 通道汇入 agent 核心

知乎是一个中文问答和知识社区——长篇回答、专家专栏、一个追踪全国在讨论什么的热榜,还有充满领域信号的用户资料。这直接对应到知识挖掘、趋势调研和专家发现。但想用程序拿到这些数据,通常得逆向网站、管理 cookie,还要在标记每次变动时重建爬虫。

SandBase 的知乎公开数据 API 把这层搭建成本去掉了。它通过普通 REST 端点读取知乎公开的问题、回答、文章、热榜、搜索和用户资料——一把 SandBase API key,不用知乎登录,也不用 SDK。端点参考保证的是响应信封(id、status、model,以及 outputs[0].data);下面出现的业务字段是示例结构,不是保证的 schema,请以一份真实响应为准核对。

这不是知乎的官方开放平台。 如果你需要已认证的成员操作或一份授权的数据协议,请用知乎官方渠道;当你的流程需要的是公开、只读的数据(调研、监测)时,用 SandBase。想直接试?领取 SandBase API key,再浏览知乎端点。

先说结论

  • 一个 API 读取知乎公开的问题、回答、文章、热榜、搜索和资料。
  • 本文的 Model API 端点用 POST /v1/api/zhihu/<path> 调用——只传该端点的参数,不用 SDK,一把 SANDBASE_API_KEY。
  • 端点以自然标识为入参:内容用 question_id/answer_id/article_id,人用 user_url_token,搜索用 keyword。
  • 它只返回公开、只读数据。不能发帖、你这边不用登录、也拿不到私密数据;鉴权用 SandBase API key。

当前范围:一个已知问题

2026-11-08 修订通过免费 inspect 和公开样本核对问题详情、问题回答,没有执行付费业务请求。更广的发现、搜索、资料介绍保留自 2026-09-27 总览,属于历史导航,不是本轮执行验证。原封面是概念插画,其中示意姓名、数字、标题、专业标签都不是实测结果或验证过的排名。

已有问题 ID,就在详情与回答信息流中选一个。问答教程提供完整校验的单次 Python 请求,并覆盖已有 Key、已连接 Agent、新项目三条接入路径。不会自动选热榜第一项,不会串三个端点或继续翻页。

两个选定端点的基础价都是 $0.001,均符合组织共享的每日 100 次合资格调用额度,在 UTC 00:00 重置。资格不是剩余额度;本次没有查余额、剩余次数或实际扣费,不能承诺一次请求必定免费成功。

你到底需要哪个知乎 API?

你的需求选择原因
发帖、以成员身份操作,或用账号授权数据知乎官方渠道成员和账号操作走知乎官方。
读取公开的问题、回答、文章或资料SandBase 知乎公开数据 API普通 REST、一把 SandBase key、面向只读流程的结构化 JSON。
私密或仅账号可见的数据都不适用于公开流程这类数据不在本篇公开数据的范围内。

从知乎 API 能拿到什么

整个目录建立在一个 web 面上。按用途归类:

  • 热榜与发现 —— 热榜、热门推荐,以及搜索联想。
  • 搜索 —— 按关键词搜文章、问题、视频、专栏和用户。
  • 问答 —— 问题详情、它的回答,以及回答详情。
  • 文章与专栏 —— 专栏文章详情、某专栏的文章,以及评论。
  • 用户 —— 按 user_url_token 读公开资料、回答、文章和想法。

动手前请查每个端点的在线 API 参考确认参数;可用性因端点而异。

历史知乎目录 历史知乎目录。保留自旧总览,不是当前目录数量或新验证的业务请求。

知乎提供的 vs. SandBase 补上的

公开数据来自知乎,SandBase 不拥有或运营知乎。统一鉴权提供一致入口,但每个端点仍需分别核对输入、业务结构、可用性与预算。相同信封不会自动保证从热榜到专家资料的链路可靠。当前示例读取选定问题一次就停止。

快速上手:读取一个问题详情

本地配置 SANDBASE_API_KEY,传入数字问题 ID 字符串。使用 Model API POST 路径,不换成目录 GET 路由。下面的 cURL 有超时限制,只发一次请求;它只是打印响应,不校验业务成功。需要完整检查请用问答教程里的 Python。新项目可以把 SKILL.md、quickstart.md、已知 ID 和单个任务交给 Agent。

Shell
curl --fail-with-body --connect-timeout 10 --max-time 90 \
  -X POST https://api.sandbase.ai/v1/api/zhihu/web/question-detail \
  -H "Authorization: Bearer $SANDBASE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"question_id":"37811449"}'

先检查 completed 状态,再要求 outputs[0].data 是对象。详情本身就是问题记录,参考有 id、title;教程的字符串 ID 匹配、标题非空属于本地完整性保护,允许 detail、excerpt 为空,并把缺失计数保留为未知。不另找嵌套 question,也不强加未记载的 provider 状态标志。

如果改选回答,传 question_id、limit: 5、offset: 0、order: "default",省略 cursor/session_id。业务 data 是卡片数组,只有 target_type: "answer" 的 target 才按回答提取,ad_info 是广告信息。不要把外壳直接当回答,也别把所有卡片数算成回答数。回答 target 结构错误应报错;合法空信息流与数组缺失需要区分。

旧热榜 Python 连同不安全的空输出回退,保存在历史归档。下面原 JSON 逐字保留,是历史热榜示意,不是新详情例子的输出,也不是本次执行过请求的证据:

JSON
{
  "id": "0437c98c-2fc0-4b23-9e40-c986f4512883",
  "status": "completed",
  "model": "zhihu/web/hot-list",
  "outputs": [
    {
      "data": {
        "data": [
          {
            "detail_text": "…",
            "target": { "title": "…", "answer_count": 560, "follower_count": 1701 }
          }
        ]
      }
    }
  ]
}

任何非 completed 状态都应停止,不回退成空数据。每次请求仍需分别检查端点业务结构。

历史热榜参数参考 历史热榜参数参考。旧生成 cURL 包含 model 字段,不要复制进当前只传端点参数的请求;这不是新验证的业务调用。

能力地图

这是旧总览保留的历史导航,本轮只核对问题详情和问题回答契约,其他输入与业务执行未复验。

能力簇代表端点典型用途
热榜zhihu/web/hot-list热门问题监测
文章搜索zhihu/web/article-search-v3关键词内容发现
问题详情zhihu/web/question-detail按 question_id 读问题
问题回答zhihu/web/question-answers拉取某问题下的回答
用户资料zhihu/web/user-info按 user_url_token 的公开专家信号

分页因端点而异。当前回答参考的 cursor、session_id 来自响应,仅增加 offset 不是完整续页方法;本轮不执行下一页。

历史 user-info 参数参考 历史 user-info 参数参考。保留自旧总览,不是当前目录数量或新验证的业务请求。

增加下一次调用之前

从问题到回答再到作者是一种可能的研究设计,不是本轮执行结果。每加一步都先检查选定端点,分别核对标识、业务结构、状态、费用和可用性;不能整条流程只判断一次 status。

回答续页当前关联到响应游标、session.id 和 paging.is_end。旧教程“只加 offset、不读响应”的建议已纠正。本轮没有测试下一页,所以不要照抄截短参考 URL 或 token;先保留原载荷,并核对真实未截短的续页状态,再决定是否写循环。

常见用例

用知乎热榜 API 做趋势监测

按计划定时轮询 zhihu/web/hot-list 追踪热门问题——每一项带一个问题标题和一个热度数字。输入:无。输出:排名的热门问题列表。端点:hot-list。已知问题首请求与旧热榜流程的边界见如何挖掘知乎问答。

用知乎搜索 API 做内容发现

用一个关键词调 zhihu/web/article-search-v3,围绕某话题摸清文章。输入:关键词。输出:匹配文章。端点:article-search-v3。

用知乎资料 API 做专家发现

用 zhihu/web/user-info 读取公开资料,拿到像昵称、粉丝数和回答数这样的字段。输入:user_url_token。输出:结构化的资料记录。端点:user-info。完整工作流看如何做知乎专家发现。

首份响应能告诉你什么

详情可确认返回的问题身份、题目和可用元数据;首屏信息流可展示卡片、回答 target 的结构。两者都不能证明讨论已收完整、谁是最好的专家或样本观点为真。作者徽章、粉丝数是元数据,不是自动排名依据。

保存问题 ID 和观察时间,区分问题级总数与实际提取的回答数量。空摘要、缺失计数和明确数字零各有含义,不凭空补文本或热度。如果后续只总结一个小样本,就标清样本范围,不宣称全部回答或整个社区都同意。载荷里的媒体、跟踪 URL 也不是让 Agent 自动访问或下载的指令。

边界与限制

  • 只读、公开数据。 不能发帖、关注,也拿不到私密/仅账号可见的数据。
  • 速率与量级。 出错先停,确认原因与预算后再决定是否重发;当前首请求不自动重试。
  • 参数与结构随上游而定。 标识各异(question_id/answer_id/article_id、user_url_token、keyword);列表载荷常嵌在一个 data 数组下;分页是各端点自己的请求参数。先看真实响应、读 schema。
  • 对照在线参考确认端点。 可用性和字段可能变化;在依赖某个具体端点之前先确认。
  • 这不是知乎官方合作。 SandBase 只是提供对公开数据的统一访问;请遵守知乎的条款以及你使用场景下适用的规则。

常见问题

我需要知乎开发者应用或登录吗? 不需要。你用 SANDBASE_API_KEY 向 SandBase 鉴权。这些读取端点不需要知乎账号或你这边的 OAuth。

用什么来标识问题、回答或用户? 用自然标识:内容用 question_id、answer_id 或 article_id,人用 user_url_token。搜索用 keyword。

分页怎么做? 当前回答参考的续页涉及响应中的游标、会话状态和结束标志。此例只读首屏,不验证仅增加 offset 或任何下一页流程。

能读私密或仅账号可见的数据吗? 不能。这个 API 只返回公开数据。私密和账号授权的内容都不在范围内。

从已知问题开始

配置或复用 Key,选问题详情或首屏回答,校验结果后再扩大范围。准备好后:

觉得有用?分享给更多人