知乎数据开放平台 API 技能

通过知乎官方开放平台（developer.zhihu.com）提供的 REST API，实现知乎搜索、全网搜索、知乎直答 AI 对话、知乎热榜获取等功能。

API 端点

鉴权方式

所有接口统一使用 Bearer 鉴权，需在请求头中携带：

Authorization: Bearer <your_access_secret>
X-Request-Timestamp: <unix_seconds>
Content-Type: application/json

• Authorization：Bearer Token，填入 Access Secret
• X-Request-Timestamp：秒级 Unix 时间戳
• Content-Type：固定值 application/json

Access Secret 获取

在知乎开放平台个人中心（https://developer.zhihu.com/profile）查看并获取 Access Secret。

接口详情

1. 知乎搜索

站内内容搜索，返回知乎上的问题、回答、文章。

请求参数（Query）：

Python 调用示例：

import requests, time

API_KEY = "<your_access_secret>"

def zhihu_search(query: str, count: int = 5):
    """知乎站内搜索"""
    url = "https://developer.zhihu.com/api/v1/content/zhihu_search"
    headers = {
        "Authorization": f"Bearer {API_KEY}",
        "X-Request-Timestamp": str(int(time.time())),
        "Content-Type": "application/json",
    }
    params = {"Query": query, "Count": min(count, 10)}
    r = requests.get(url, params=params, headers=headers, timeout=15)
    r.raise_for_status()
    data = r.json()
    if data.get("Code") != 0:
        raise Exception(f"API Error: {data.get('Message')}")
    return data["Data"]

响应字段（Item）：

2. 全网搜索

全网内容搜索，支持按站点域名、发布时间等条件过滤。

请求参数（Query）：

Filter 高级语法：

• host=="example.com" — 按站点域名过滤
• publish_time>=1778494631 — 按发布时间过滤（秒级时间戳）
• 支持逻辑符：AND、OR，可用 () 控制优先级
• 注意：host=="zhihu.com" 不支持，站内搜索请用 zhihu_search

Python 调用示例：

def global_search(query: str, count: int = 10, filter: str = "", search_db: str = "all"):
    """全网搜索"""
    url = "https://developer.zhihu.com/api/v1/content/global_search"
    headers = {
        "Authorization": f"Bearer {API_KEY}",
        "X-Request-Timestamp": str(int(time.time())),
        "Content-Type": "application/json",
    }
    params = {"Query": query, "Count": min(count, 20)}
    if filter:
        params["Filter"] = filter
    if search_db:
        params["SearchDB"] = search_db
    r = requests.get(url, params=params, headers=headers, timeout=15)
    r.raise_for_status()
    data = r.json()
    if data.get("Code") != 0:
        raise Exception(f"API Error: {data.get('Message')}")
    return data["Data"]

3. 知乎直答（AI 对话）

调用知乎直答 AI 模型进行对话问答，OpenAI SDK 兼容格式。

支持模型：

请求体（JSON）：

{
  "model": "zhida-thinking-1p5",
  "messages": [
    {"role": "system", "content": "你是一个有帮助的助手"},
    {"role": "user", "content": "你好"}
  ],
  "stream": false
}

Python 调用示例：

def zhida_chat(messages: list, model: str = "zhida-fast-1p5", stream: bool = False):
    """知乎直答 AI 对话"""
    url = "https://developer.zhihu.com/v1/chat/completions"
    headers = {
        "Authorization": f"Bearer {API_KEY}",
        "X-Request-Timestamp": str(int(time.time())),
        "Content-Type": "application/json",
    }
    body = {"model": model, "messages": messages, "stream": stream}
    if stream:
        r = requests.post(url, json=body, headers=headers, timeout=60, stream=True)
        r.raise_for_status()
        for line in r.iter_lines(decode_unicode=True):
            if line and not line.startswith(":") and line != "data: [DONE]":
                print(line)
    else:
        r = requests.post(url, json=body, headers=headers, timeout=60)
        r.raise_for_status()
        return r.json()

响应字段（非流式）：

注意： zhida-agent 模型仅支持单轮 messages（仅 user），不支持 system/assistant 上下文。zhida-fast-1p5 和 zhida-thinking-1p5 支持多轮上下文。

4. 知乎热榜

获取当前知乎热榜内容列表。

请求参数（Query）：

Python 调用示例：

def zhihu_hot_list(limit: int = 10):
    """获取知乎热榜"""
    url = "https://developer.zhihu.com/api/v1/content/hot_list"
    headers = {
        "Authorization": f"Bearer {API_KEY}",
        "X-Request-Timestamp": str(int(time.time())),
        "Content-Type": "application/json",
    }
    params = {"Limit": min(limit, 30)}
    r = requests.get(url, params=params, headers=headers, timeout=15)
    r.raise_for_status()
    data = r.json()
    if data.get("Code") != 0:
        raise Exception(f"API Error: {data.get('Message')}")
    return data["Data"]

响应字段（Item）：

错误码

使用注意

1. Access Secret 为敏感信息，Skill 中使用时通过环境变量或配置管理，不要硬编码在公开代码中
2. X-Request-Timestamp 必须传当前秒级 Unix 时间戳
3. 所有请求需设置 Content-Type: application/json
4. 知乎搜索单次最多返回 10 条，全网搜索最多 20 条，热榜最多 30 条
5. 全网搜索的 host 过滤不支持 zhihu.com 及其子域名，站内搜索请直接使用 zhihu_search