知乎热搜 API 文档

接口说明

知乎热搜 API 是一个实时获取知乎热搜榜单数据的接口，数据每 3 分钟缓存更新一次。接口支持多设备模拟请求和 IP 轮询，返回 JSON 格式的热搜列表数据，包含热搜排名、标题及对应搜索链接。

本接口为免费接口，但需要提供有效的访问密钥进行鉴权。

调用地址

https://openapi.xunjinlu.fun/api/rebang/zhihurs.php

请求方式

GET

鉴权方式

本接口仅支持 Query 参数 鉴权方式，即通过 URL 查询字符串传递密钥参数。

请求参数

参数说明

• key：您的接口访问密钥，用于身份验证和计费统计。每个密钥对应独立的调用配额与积分余额。请妥善保管密钥，避免泄露。

请求示例

浏览器直接访问

https://openapi.xunjinlu.fun/api/rebang/zhihurs.php?key=sk_xxxxxxxxxxxxxxxx

cURL 示例

curl -X GET "https://openapi.xunjinlu.fun/api/rebang/zhihurs.php?key=sk_xxxxxxxxxxxxxxxx"

PHP 示例

// 初始化 cURL
$ch = curl_init();

// 设置请求 URL（请将 key 替换为您的实际密钥）
$url = "https://openapi.xunjinlu.fun/api/rebang/zhihurs.php?key=sk_xxxxxxxxxxxxxxxx";
curl_setopt($ch, CURLOPT_URL, $url);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);

// 执行请求
$response = curl_exec($ch);

// 检查是否有错误
if (curl_errno($ch)) {
    echo "请求失败: " . curl_error($ch);
} else {
    // 解析 JSON 响应
    $data = json_decode($response, true);
    if ($data && $data["code"] == 200) {
        echo "热搜总数: " . $data["data"]["total"] . "\n";
        foreach ($data["data"]["list"] as $item) {
            echo "排名 " . $item["rank"] . ": " . $item["title"] . "\n";
        }
    } else {
        echo "接口返回错误: " . $data["msg"];
    }
}

// 关闭 cURL
curl_close($ch);

Python 示例

import requests

# 设置请求参数（请将 key 替换为您的实际密钥）
params = {
    "key": "sk_xxxxxxxxxxxxxxxx"
}

# 发送 GET 请求
response = requests.get(
    "https://openapi.xunjinlu.fun/api/rebang/zhihurs.php",
    params=params
)

# 解析响应
data = response.json()
if data["code"] == 200:
    print(f"热搜总数: {data['data']['total']}")
    for item in data["data"]["list"]:
        print(f"排名 {item['rank']}: {item['title']}")
else:
    print(f"接口返回错误: {data['msg']}")

JavaScript (Fetch) 示例

// 请将 key 替换为您的实际密钥
const url = "https://openapi.xunjinlu.fun/api/rebang/zhihurs.php?key=sk_xxxxxxxxxxxxxxxx";

fetch(url)
    .then(response => response.json())
    .then(data => {
        if (data.code === 200) {
            console.log(`热搜总数: ${data.data.total}`);
            data.data.list.forEach(item => {
                console.log(`排名 ${item.rank}: ${item.title}`);
            });
        } else {
            console.error(`接口返回错误: ${data.msg}`);
        }
    })
    .catch(error => {
        console.error("请求失败:", error);
    });

成功响应示例

{
    "code": 200,
    "msg": "success",
    "data": {
        "update_time": "2026-05-02 19:45:30",
        "total": 23,
        "list": [
            {
                "rank": 1,
                "title": "国际不打小孩日",
                "url": "https://www.zhihu.com/search?q=%E5%9B%BD%E9%99%85%E4%B8%8D%E6%89%93%E5%B0%8F%E5%AD%A9%E6%97%A5"
            },
            {
                "rank": 2,
                "title": "暴雨大暴雨要来了",
                "url": "https://www.zhihu.com/search?q=%E6%9A%B4%E9%9B%A8%E5%A4%A7%E6%9A%B4%E9%9B%A8%E8%A6%81%E6%9D%A5%E4%BA%86"
            },
            {
                "rank": 3,
                "title": "伊朗局势",
                "url": "https://www.zhihu.com/search?q=%E4%BC%8A%E6%9C%97%E5%B1%80%E5%8A%BF"
            },
            {
                "rank": 4,
                "title": "以色列宣布袭击伊朗",
                "url": "https://www.zhihu.com/search?q=%E4%BB%A5%E8%89%B2%E5%88%97%E5%AE%A3%E5%B8%83%E8%A2%AD%E5%87%BB%E4%BC%8A%E6%9C%97"
            },
            {
                "rank": 5,
                "title": "美以袭击伊朗",
                "url": "https://www.zhihu.com/search?q=%E7%BE%8E%E4%BB%A5%E8%A2%AD%E5%87%BB%E4%BC%8A%E6%9C%97"
            }
        ]
    },
    "api_info": {
        "developer": "尋鯨錄",
        "blog": "https://www.xunjinlu.fun",
        "api_platform": "https://api.xunjinlu.fun"
    }
}

响应字段说明

顶层响应字段

data 对象字段

list 数组元素字段

api_info 对象字段

错误响应示例

当请求出现异常时，接口将返回如下格式的错误响应：

{
    "code": 0,
    "msg": "未提供调用密钥",
    "errcode": 11001
}

业务错误码说明

调用限制

• 请求方式：仅支持 GET 请求
• 鉴权方式：仅支持 Query 参数鉴权
• 密钥要求：必须提供有效的访问密钥
• 计费模式：免费（但仍需密钥鉴权）
• 数据缓存：3 分钟

常见问题

1. 如何获取访问密钥？

访问密钥需要通过 API 平台申请获取。请访问 API 平台官网进行注册和申请。

2. 接口返回 errcode 11001 怎么办？

表示请求中未提供 key 参数。请检查您的请求 URL 中是否包含 ?key=您的密钥。

3. 接口返回 errcode 11002 怎么办？

表示提供的密钥错误或无效。请确认密钥是否正确，注意区分大小写，并检查密钥是否已过期。

4. 接口返回 errcode 11005 怎么办？

表示您的请求频率超过了限制。请降低请求频率，避免短时间内大量调用。

5. 数据多久更新一次？

数据每 3 分钟缓存更新一次，即两次请求间隔建议不少于 3 分钟以获取最新数据。

6. 返回的 URL 是编码的吗？

是的，返回的知乎搜索链接采用 URL 编码格式，可直接在浏览器中打开使用。

更新日志

相关链接

• API 平台官网：https://api.xunjinlu.fun
• 开发者博客：https://www.xunjinlu.fun