做资讯站点、仪表盘、新闻监控、AI 提示词热榜素材、前端演示页面的开发者看过来！
澎湃新闻热搜榜接口，一键拉取澎湃热榜，包含热搜标题、发布时间、栏目、新闻链接、封面图。自带 CORS 跨域头，前端页面直接调用不用中转，支持 JSON、TEXT 两种返回格式，可自定义返回条数、单独获取指定序号新闻。
✅ 接口亮点
- 信源优质：澎湃新闻热搜榜单，时政资讯热榜
- 双输出格式：JSON / TEXT 文本榜单，按需切换
- 前端友好：自带 CORS 跨域，浏览器直接请求，无需后端代理
- 灵活能力：自定义返回条数、单独调取指定序号新闻
- 返回字段齐全：标题、发布时间、栏目、新闻链接、封面图
- 混合鉴权：API Key / APP_ID+APP_SECRET 两种鉴权方式
- 统一错误码体系，鉴权、额度、上游异常方便捕获处理
📌 接入基础信息
- 接口路径：
/ppyw - 完整域名：
https://api.xiaotuo.net - 调试入口：
https://api.xiaotuo.net/api/v1/calls/invoke - 鉴权：hybrid 混合鉴权
- 响应：auto_upstream，上游透传
调用地址：
https://api.xiaotuo.net/ppyw
TEXT 格式返回示例
-- 澎湃新闻热搜榜 --
1. 马上评｜“独生女继承遗产后遭离婚分产”怎么会反复上热搜
2. 董明珠发话“长头发该剪了”，珠海格力技工学校为师生安排免费剪发
3. 博闻丨举报校内有“风水蛙”后，老师年度考核被判不合格
4. 当AI开始写代码，还需要什么样的程序员？
5. 樊振东发文抵制偷拍，人民日报：偷拍根本不是“爱”
-- 澎湃新闻热搜榜 --
📋 鉴权说明
混合鉴权二选一：
- API Key 鉴权：缺 Key 返回 100，密钥无效 / 未授权返回 101；支持 IP 白名单校验
- APP_ID + APP_SECRET 鉴权：缺失、不匹配、无效对应 130/131/132/133
额外校验：实名认证、邮箱绑定、账号状态、IP 黑名单拦截
🚦 计费与限流
- price=0，计费模式以控制台为准，支持余额、套餐、订阅等多种模式
- 子 API Key 可配置日限额，打满返回 114（429）
- 上游异常返回 20001/20002/20003，业务建议增加重试、降级逻辑
📋 核心错误码速查
表格
| 错误码 | HTTP | 含义 |
|---|---|---|
| 100 | 401 | API Key 为空 |
| 101 | 401 | API Key 无效、未绑定接口 |
| 102 | 403 | IP 不在白名单 |
| 106 | 403 | 余额 / 套餐额度不足 |
| 114 | 429 | 子密钥日限额已满 |
| 20001 | 502 | 上游服务失败 |
| 20002 | 504 | 上游超时 |
🧩 适用开发场景
- 资讯网站、新闻仪表盘、后台大屏热榜展示
- 前端 Demo、H5、小程序直接拉取热榜（跨域友好）
- AI 工具、提示词素材、热点监控机器人
- 热榜汇总系统、定时采集脚本、内容分析项目
⚠️ 重要提醒
- 接口仅用于学习、开发调试，遵守内容版权与相关法律法规；
- 数据由上游透传，上游接口不稳定、超时、改版会影响返回结果；
- 参数名称以平台控制台为准，支持自定义条数、指定序号、切换返回格式；
- 计费、单价、额度以平台控制台显示为准。
