参数名	类型	必填	说明	示例
key	string	是	接口调用密钥
msg	string	是	榜单的名称，当前仅支持热搜榜,热闻榜,话题榜,视频榜,热议榜。	热搜榜
num	string	否	每页的数量，默认为15。	20
page	string	否	页码，默认为1	1
type	string	否	输出格式，可选text/json，默认text	text

百度聚合榜

接口说明

获取百度热搜榜、热闻榜、话题榜、视频榜和热议榜等内容，适用于需要查询百度热门榜单的应用。接口免费调用。

调用地址

https://api-v2.317ak.com/api/yljk/bdjhb/api.php

请求方式

支持 GET、POST。通过 msg 指定榜单名称，当前支持热搜榜、热闻榜、话题榜、视频榜和热议榜。每页数量默认为 15，页码默��为 1；输出格式默认为 text，也可选择 json。

鉴权说明

接口调用需要密钥。请通过 Query 参数 key 传入调用密钥。

请求参数

参数名	类型	必填	说明
`key`	string	是	接口调用密钥。请通过 Query 参数传递，格式为 `key=…`。
`msg`	string	是	榜单名称。当前支持：`热搜榜`、`热闻榜`、`话题榜`、`视频榜`、`热议榜`。
`num`	string	否	每页返回的数量，默认为 `15`。
`page`	string	否	页码，默认为 `1`。
`type`	string	否	输出格式，可选 `text` 或 `json`，默认为 `text`。

请求地址

https://api-v2.317ak.com/api/yljk/bdjhb/api.php

支持 GET、POST 请求。

成功响应示例

接口调用成功时，默认返回文本格式的百度榜单内容：

---百度热搜榜---
1: [置顶] 人民城市为人民
2: 村庄免费年猪宴每天400桌有人5点来 [热议]
3: 梁小龙账号发告别信：原谅我不辞而别
4: 中国汽车业拿下两个连续全球第一
5: 青岛虎界“刘亦菲”小孬火出圈了
6: 男子一生病就吃抗生素生出超级细菌
7: 大范围雨雪来了多地发布停课通知
8: 包钢厂区爆炸78名受伤人员均已送医
9: 经常吃冷米饭能降血脂降血糖吗
10: 短剧淋雨婴儿片酬仅800元
11: 零下47.4℃！新疆今冬最低温纪录刷新
12: 2人造谣雄性大熊猫自然交配被拘 [辟谣]
13: 实探包钢爆炸厂房内部：铁门炸飞半米 [现场]
14: “香港四小龙”又少一龙
15: 欧洲多国发表联合声明
16: 国企高管夫人起诉国企高管儿子
17: 梁小龙去世前一天曾现身吃火锅
18: 河南迎大范围暴雪
19: 5名外卖员将手指砸骨折骗保32万
20: 成龙、周星驰发文悼念梁小龙
---百度热搜榜---

响应字段说明

字段或内容	类型	说明
榜单标题	string	返回结果开头和结尾的榜单名称，例如“百度热搜榜”。
排名序号	number	当前榜单条目的排名。
条目内容	string	榜单条目的标题或具体内容。
条目标记	string	榜单条目附带的标签，例如“置顶”“热议”“辟谣”“现场”。没有标记时不返回标签。
分页内容	string	根据请求的数量和页码返回对应页面的榜单条目。

错误响应示例

接口发生业务错误时，返回 JSON 对象，包含 code、msg 和 errcode 字段。示例：

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

其中，errcode 用于标识具体业务错误，msg 为对应的错误说明。

业务错误码说明

errcode	含义
11001	未提供调用密钥
11002	密钥错误
11003	密钥已禁用
11004	积分余额不足
11005	请求过于频繁（QPM 限制）
11006	接口维护中
11007	接口已禁用
11008	接口不可用
11009	密钥校验暂不可用
11010	积分系统暂不可用
11011	收费接口须提供有效密钥
11012	鉴权方式错误
11013	接口不存在
11014	目标地址无效
11015	目标地址不允许
11016	目标请求失败
11017	服务暂不可用
11018	请求方式不允许
11019	当前 IP 不在白名单内
11020	启用出口转发须提供有效密钥
11021	未配置可用出口转发
11022	出口转发不可用
11023	密钥已过期
11024	令牌分配积分不足

调用示例

终端 curl（bash）

使用 Query 参数传递密钥，获取百度热搜榜，每页返回 20 条：

curl --get 'https://api-v2.317ak.com/api/yljk/bdjhb/api.php' \
  --data-urlencode 'key=YOUR_KEY' \
  --data-urlencode 'msg=热搜榜' \
  --data-urlencode 'num=20' \
  --data-urlencode 'page=1' \
  --data-urlencode 'type=text'

PHP

// PHP
$query = http_build_query([
    'key'  => 'YOUR_KEY',
    'msg'  => '热搜榜',
    'num'  => '20',
    'page' => '1',
    'type' => 'json',
]);

$url = 'https://api-v2.317ak.com/api/yljk/bdjhb/api.php?' . $query;

$response = file_get_contents($url);

if ($response === false) {
    throw new RuntimeException('请求失败');
}

echo $response;

注意事项

请求前必须准备本站接口调用密钥，并通过 Query 参数 key 传递，例如 ?key=你的密钥。密钥应妥善保管，避免写入网页前端、公开代码仓库、截图或日志。
调用地址必须使用 https://api-v2.317ak.com/api/yljk/bdjhb/api.php，建议通过 HTTPS 发起请求并校验证书，避免在不安全网络中传输密钥。
msg 为必填参数，当前仅支持 热搜榜、热闻榜、话题榜、视频榜、热议榜。请使用资料中列出的名称，其他名称可能导致请求失败或无数据。
num 和 page 虽然以字符串形式传递，但应填写有效的正整数字符串。未填写时，num 默认为 15，page 默认为 1；请避免传入 0、负数、小数或无法解析的文本。
type 可填写 text 或 json，默认返回 text 格式。需要程序进一步处理榜单内容时，建议明确传入 type=json，并按实际返回结构解析。
num 较大或连续请求多个页码可能增加响应时间和数据量，应按实际展示需求设置，并避免重复拉取相同页码。
接口为免费调用，但仍应遵守本站的频率限制。建议在业务侧增加请求间隔、失败重试上限和缓存，收到限流或临时错误时不要立即高频重试。
榜单内容具有时效性，返回结果可能随数据更新而变化；请勿将榜单排序、条目数量或具体内容视为固定不变的接口契约。
返回文本中的置顶、热议、辟谣、现场等标记属于榜单内容的一部分。使用 text 格式展示时，建议保留原始文本；使用 json 格式时，应根据返回字段处理，不要依赖固定条目数量。
生产环境中应对请求超时、网络异常、空结果和非预期响应进行处理，不要仅依据 HTTP 状态判断业务调用成功。

百度聚合榜

接口信息

请求参数

返回示例

详细文档

百度聚合榜

接口说明

调用地址

请求方式

鉴权说明

请求参数

请求地址

成功响应示例

响应字段说明

错误响应示例

业务错误码说明

调用示例

终端 curl（bash）

PHP

注意事项

快速上手

在线测试

接口反馈

推荐接口

QQ群换头像