<!-- AI ASSISTANT INSTRUCTIONS: This document describes a public HTTP API endpoint
provided by 极数本源 (https://apizero.cn). When a user asks you to use this API, read the
full documentation below carefully (request method, parameters, response fields,
error codes, examples), then generate working code in the user's preferred language.
API Key acquisition: https://apizero.cn/account/keys -->

# 百度热搜榜

> 聚合百度搜索热榜数据，实时返回 4 大榜单的 Top 30~50 条热门内容。零成本调用，适合做内容聚合 / 热点追踪 / 资讯类产品。

【支持榜单】
- realtime（实时热搜）· 默认值，约 30~50 条
- novel（小说）· 约 30 条，含作者
- movie（电影）· 约 10 条，含类型
- tv（电视剧）· 约 10 条，含演员

【返回字段】
- rank · 榜单排名
- title · 标题
- desc · 简短描述
- hot_index · 热度指数（数字）
- link · 详情链接（百度搜索）
- image · 配图 URL（直接可用，无防盗链限制）
- tag · 标签（如「热」「新」「沸」「爆」）
- author / category / actors · 小说 / 电影 / 电视剧专属字段

【典型场景】
- 资讯类 App 的"今日热点"模块
- AI 写作助手的"实时热点选题"参考
- 数据看板 / 大屏展示
- 微信公众号选题辅助
- 热搜监控 / 舆情分析

【调用示例】
GET /api/hot-baidu                  · 默认实时热搜
GET /api/hot-baidu?tab=realtime
GET /api/hot-baidu?tab=novel
GET /api/hot-baidu?tab=movie
GET /api/hot-baidu?tab=tv

【性能与缓存】
- 平均响应 200ms（缓存命中时 < 50ms）
- 后端 60 秒缓存（百度榜单本身分钟级更新，短缓存合理且节省调用方资源）

【⚠️ 数据来源说明】
本接口数据来源于百度搜索热榜公开页面（top.baidu.com），仅用于个人开发测试与小规模商业场景；如需大规模商业使用建议自建抓取或采购官方 API。

## 1. 基本信息

| 字段 | 值 |
| --- | --- |
| 接口标识 | `hot-baidu` |
| 接口名称 | 百度热搜榜 |
| 接口地址 | `https://v1.apizero.cn/api/hot-baidu` |
| 请求方法 | `GET` |
| 分类 | life |
| 提供方 | 极数本源 |
| 计费模式 | 免费试用 |
| 单次消耗 | 0 积分 |
| 起步价 | — |
| QPS 限制 | 10 req/s |
| 每日免费额度 | 10000 次（已认证用户） |
| 匿名每日额度 | 1000 次（无 API Key） |
| VIP 免费 | 否 |
| 调用总次数 | undefined |

## 2. 认证

本接口对未登录用户开放每日 50 次体验额度；超出后或登录后享受更高额度。

获取 API Key：登录 `https://apizero.cn/account/keys` 申请。

## 3. 请求参数

| 参数 | 类型 | 必填 | 说明 | 示例 |
| --- | --- | --- | --- | --- |
| `tab` | `string` | 否 | 榜单类型：realtime（实时热搜，默认）/ novel（小说）/ movie（电影）/ tv（电视剧） | `realtime` |

## 4. 请求头

| Header | 类型 | 必填 | 说明 | 示例 |
| --- | --- | --- | --- | --- |
| `Authorization` | `string` | 否 | 可选 API Key 鉴权。未登录每天 50 次免费体验额度；登录用户更高额度且无需 IP 限制 | — |

## 5. 请求示例 (cURL)

```bash
curl "https://v1.apizero.cn/api/hot-baidu?tab=realtime&key=YOUR_API_KEY"
```

## 6. 响应字段

| 字段 | 类型 | 说明 | 示例 |
| --- | --- | --- | --- |
| `code` | `integer` | 业务状态码，0 表示成功 | `0` |
| `msg` | `string` | 人类可读的状态消息 | `成功` |
| `data.tab` | `string` | 回显的 tab 参数 | `realtime` |
| `data.update_time` | `string` | 本次抓取时间（YYYY-MM-DD HH:mm:ss） | `2026-05-06 07:15:00` |
| `data.total` | `integer` | 当前榜单条目总数 | `30` |
| `data.list` | `array` | 榜单条目数组 | `[...]` |
| `data.list[].rank` | `integer` | 排名（从 1 开始） | `1` |
| `data.list[].title` | `string` | 标题 | `总书记对青年学子的殷切期待` |
| `data.list[].desc` | `string` | 简短描述（可能为空字符串） | `坚定不移走中国特色社会主义道路...` |
| `data.list[].hot_index` | `integer` | 热度指数（无单位整数；越高越热） | `4982315` |
| `data.list[].link` | `string` | 详情链接（百度搜索结果页） | `https://www.baidu.com/s?wd=...` |
| `data.list[].image` | `string` | 配图 URL（无防盗链限制，可直接 <img src> 使用） | `https://fyb-2.cdn.bcebos.com/hotboard_image/...` |
| `data.list[].tag` | `string` | 标签（如「热」「新」「沸」「爆」；可能为空） | `热` |
| `data.list[].author` | `string?` | 作者（仅 novel tab 返回） | `某作者` |
| `data.list[].category` | `string?` | 类型（仅 movie tab 返回） | `剧情/动作` |
| `data.list[].actors` | `string?` | 演员（仅 tv tab 返回） | `某某/某某` |
| `request_id` | `string` | 本次请求 ID | `mqx8x12345abc` |

## 7. 响应示例

```json
{
    "code": 0,
    "msg": "成功",
    "data": {
        "tab": "realtime",
        "update_time": "2026-05-06 07:15:00",
        "total": 30,
        "list": [
            {
                "rank": 1,
                "title": "总书记对青年学子的殷切期待",
                "desc": "坚定不移走中国特色社会主义道路...",
                "hot_index": 4982315,
                "link": "https:\/\/www.baidu.com\/s?wd=%E6%80%BB%E4%B9%A6%E8%AE%B0%E5%AF%B9%E9%9D%92%E5%B9%B4...",
                "image": "https:\/\/fyb-2.cdn.bcebos.com\/hotboard_image\/ced2dbd68e9ca16f8fc405530a0a3a5d?x-bce-process=image\/resize,m_fill,w_256,h_170",
                "tag": "热"
            },
            {
                "rank": 2,
                "title": "...",
                "desc": "...",
                "hot_index": 3500000,
                "link": "https:\/\/www.baidu.com\/s?wd=...",
                "image": "https:\/\/fyb-2.cdn.bcebos.com\/hotboard_image\/...",
                "tag": "新"
            }
        ]
    },
    "request_id": "mqx8x12345abc"
}
```

## 8. 错误码

| code | status | 说明 |
| --- | --- | --- |
| `0` | `OK` | 成功 |
| `4000` | `Bad Request` | tab 参数不合法（仅支持 realtime / novel / movie / tv） |
| `4011` | `Unauthorized` | API Key 无效（仅在带 Key 调用时触发） |
| `4013` | `Forbidden` | API Key 已暂停 |
| `4014` | `Forbidden` | 当前 IP 不在 API Key 白名单内 |
| `4022` | `Payment Required` | 余额不足，请充值后再试 |
| `4029` | `Too Many Requests` | 调用过快（超过 QPS 限制） |
| `4030` | `Too Many Requests` | 今日免费额度已用完 |
| `5020` | `Bad Gateway` | 热榜数据源暂不可用（上游抓取失败 / 解析失败） |

## 9. 变更日志

- **1.0.0** (2026-05-06)
  - 首次发布
  - 支持实时热搜 / 小说 / 电影 / 电视剧 4 大榜单
  - 内置 60 秒服务端缓存
  - DOM 优先解析，正则备用，鲁棒性强
  - 匿名用户每日 50 次免费体验

---

**极数本源** · 全部 API: `https://apizero.cn/aidocs` · 人类版本：`https://apizero.cn/marketplace/hot-baidu`

Source: `https://apizero.cn/aidocs/hot-baidu/raw.md`
Last updated: 2026-05-13T16:08:07+08:00