# 百度热搜获取 接口文档

> 获取今日百度热搜

- 接口 ID：12
- 请求方式：GET/POST
- 接口地址：https://api.mangox.asia/api/hotdu/
- 示例地址：https://api.mangox.asia/api/hotdu?token=您的密钥
- 累计请求：2 次
- 费用：免费开放，无调用次数限制
- 文档地址：https://api.mangox.asia/doc?id=12
- 来源：MGO-API（https://api.mangox.asia）

## 接口速览

- 请求方式：GET/POST
- 请求参数：共 2 个，其中必填 1 个
- 返回格式：JSON
- 状态：运行正常

## 请求参数

| 参数名 | 类型 | 必填 | 说明 |
| --- | --- | --- | --- |
| `token` | string | 必填 | 登录获取用户密钥 |
| `提示：` | 提示 | 可选 | 本接口每分钟限制10次请求 |

## 返回示例

```json
{
    "success": true,
    "data": {
        "cards": [
            {
                "component": "tabTextList",
                "content": [
                    {
                        "content": [
                            {
                                "isTop": true,
                                "url": "https://m.baidu.com/s?word=%E5%9B%A0%E4%B8%BA%E5%9B%BD+%E6%89%80%E4%BB%A5%E6%BD%AE&sa=fyb_news",
                                "word": "因为国 所以潮"
                            },
                            {
                                "isTop": false,
                                "index": 1,
                                "url": "https://m.baidu.com/s?word=%E6%9C%AC%E6%83%B3%E8%A7%81%E4%B8%96%E9%9D%A2+%E6%B2%A1%E6%83%B3%E5%88%B0%E8%87%AA%E5%B7%B1%E5%B0%B1%E6%98%AF%E4%B8%96%E9%9D%A2&sa=fyb_news",
                                "word": "本想见世面 没想到自己就是世面",
                                "hotTag": "3",
                                "newHotTag": {
                                    "dark": {
                                        "height": "51",
                                        "label_image": "https://b.bdstatic.com/searchbox/image/gcp/20250115/3050076711.png",
                                        "width": "51"
                                    },
                                    "day": {
                                        "height": "51",
                                        "label_image": "https://b.bdstatic.com/searchbox/image/gcp/20250115/3050076711.png",
                                        "width": "51"
                                    },
                                    "night": {
                                        "height": "51",
                                        "label_image": "https://b.bdstatic.com/searchbox/image/gcp/20250115/2856595153.png",
                                        "width": "51"
                                    }
                                },
                                "newHotName": "热"
                            }
                        ]
                    }
                ]
            }
        ],
        "currentBoard": {
            "header": {
                "bgImg": "https://gips0.baidu.com/it/u=1094683221,2956708427&fm=3028&app=3028&f=JPEG&fmt=auto&q=75&size=f1242_512",
                "d25BgImg": "https://b.bdstatic.com/searchbox/image/gcp/20250609/1099538042.jpg",
                "d25StickyBgImg": "https://b.bdstatic.com/searchbox/image/gcp/20250609/1640625937.jpg",
                "titleImg": "https://b.bdstatic.com/searchbox/image/gcp/20241217/1495922617.png",
                "gradientColor": [
                    "rgba(255, 80, 73, 1)",
                    "rgba(242, 242, 245, .01)"
                ]
            },
            "rule": {
                "bgImg": "https://gips0.baidu.com/it/u=2248281710,2169737799&fm=3028&app=3028&f=PNG&fmt=auto&q=100&size=f1242_240",
                "content": [
                    {
                        "type": "title",
                        "text": "一、榜单介绍"
                    },
                    {
                        "type": "text",
                        "text": "百度热搜热点榜以数亿用户海量的真实数据为基础，通过专业的数据挖掘方法，计算各热点事件的热搜指数，综合反映热点事件在百度平台的热度。"
                    }
                ]
            },
            "text": "热搜榜"
        },
        "logid": "3736662013",
        "tabBoard": [
            {
                "text": "首页",
                "typeName": "homepage"
            },
            {
                "text": "热搜榜",
                "typeName": "realtime"
            }
        ],
        "userInfo": {
            "isLogin": 0
        }
    },
    "error": {
        "code": 0,
        "message": "api response ok"
    }
}
```

## 状态码说明

| 状态码 | 说明 |
| --- | --- |
| 200 | 解析成功 |
| 400 | 参数错误 |
| 403 | 无效密钥 |
| 404 | 源站缺失 |
| 408 | 请求超时 |
| 410 | 解析失败 |
| 422 | 解析错误 |

## 常见问题

### 如何调用 百度热搜获取 接口？

使用 GET/POST 方式请求 https://api.mangox.asia/api/hotdu/，按需携带「请求参数」中的字段即可获取返回数据。若接口需要密钥，请在本页「快速开始」处点击「填充 Token」，输入后示例地址与代码中的「您的密钥」会自动替换为你的 token，直接复制即可使用。

### 百度热搜获取 接口支持哪些请求方式？

目前支持 GET/POST 请求方式，请求地址为 https://api.mangox.asia/api/hotdu/。接口同时兼容 cURL、Python requests、Java HttpClient、JavaScript fetch 等常见客户端。

### 百度热搜获取 接口是免费的吗？

是的，该接口由 MGO-API 免费开放，无需付费即可调用，也不限制调用次数（合理使用即可）。

### 调用 百度热搜获取 接口返回错误怎么办？

请对照「状态码说明」排查：400 参数错误（检查参数名与类型）、403 无效密钥（检查 token 是否正确）、404 源站缺失（源站资源不存在）、408 请求超时（稍后重试或降低并发）、410 解析失败（源站内容已失效）、422 解析错误（源站返回格式异常）。若持续报错，可联系站长协助处理。

### 接口提示「无效密钥 / 403」该如何处理？

请确认 token 参数是否正确、是否已过期。可在本页「快速开始」中点击「填充 Token」，输入你的密钥后，示例地址与代码里所有「您的密钥」占位内容都会自动替换，直接复制即可使用。

### 接口响应很慢或者超时（408）怎么办？

可先重试一次；若仍超时，可能是源站临时波动。建议客户端设置 10 秒以上超时，并避免高频并发请求，稍后再试通常即可恢复。

### 如何导出这份接口文档？

在页面顶部点击「导出文档」按钮，在弹出的窗口中选择 Markdown（.md）、Word（.doc）或纯文本（.txt）格式，导出文件会附带站点域名、原文档地址与导出时间，方便离线查阅或写进项目文档。也可以在地址后追加 &format=json 获取结构化 JSON，或追加 &format=md 获取 Markdown 纯文本，便于 AI 与程序抓取。

### 遇到问题如何联系站长？

节假日白天可联系站长 QQ：2201040041（其他时段留言即可，看到会尽快回复）。

---

## 导出信息

| 项目 | 内容 |
| --- | --- |
| 域名地址 | `api.mangox.asia` |
| 站点地址 | https://api.mangox.asia |
| 原文档地址 | https://api.mangox.asia/doc?id=12 |
| 导出时间 | 2026-10-14 12:06:25 |

© 2022-2026 MGO-API · MangoClub · MangoCMPT
节假日白天可联系站长 QQ：2201040041