做资讯站点、仪表盘、新闻监控、AI 提示词热榜素材、前端演示页面的开发者看过来！
澎湃新闻热搜榜接口，一键拉取澎湃热榜，包含热搜标题、发布时间、栏目、新闻链接、封面图。自带 CORS 跨域头，前端页面直接调用不用中转，支持 JSON、TEXT 两种返回格式，可自定义返回条数、单独获取指定序号新闻。

✅ 接口亮点

1. 信源优质：澎湃新闻热搜榜单，时政资讯热榜
2. 双输出格式：JSON / TEXT 文本榜单，按需切换
3. 前端友好：自带 CORS 跨域，浏览器直接请求，无需后端代理
4. 灵活能力：自定义返回条数、单独调取指定序号新闻
5. 返回字段齐全：标题、发布时间、栏目、新闻链接、封面图
6. 混合鉴权：API Key / APP_ID+APP_SECRET 两种鉴权方式
7. 统一错误码体系，鉴权、额度、上游异常方便捕获处理

📌 接入基础信息

• 接口路径：/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. 樊振东发文抵制偷拍，人民日报：偷拍根本不是“爱”
-- 澎湃新闻热搜榜 --

📋 鉴权说明

混合鉴权二选一：

1. API Key 鉴权：缺 Key 返回 100，密钥无效 / 未授权返回 101；支持 IP 白名单校验
2. APP_ID + APP_SECRET 鉴权：缺失、不匹配、无效对应 130/131/132/133
   额外校验：实名认证、邮箱绑定、账号状态、IP 黑名单拦截

🚦 计费与限流

• price=0，计费模式以控制台为准，支持余额、套餐、订阅等多种模式
• 子 API Key 可配置日限额，打满返回 114（429）
• 上游异常返回 20001/20002/20003，业务建议增加重试、降级逻辑

📋 核心错误码速查

表格

🧩 适用开发场景

• 资讯网站、新闻仪表盘、后台大屏热榜展示
• 前端 Demo、H5、小程序直接拉取热榜（跨域友好）
• AI 工具、提示词素材、热点监控机器人
• 热榜汇总系统、定时采集脚本、内容分析项目

⚠️ 重要提醒

1. 接口仅用于学习、开发调试，遵守内容版权与相关法律法规；
2. 数据由上游透传，上游接口不稳定、超时、改版会影响返回结果；
3. 参数名称以平台控制台为准，支持自定义条数、指定序号、切换返回格式；
4. 计费、单价、额度以平台控制台显示为准。