立即访问开发文档，进入最新入口页和监测记录等精彩热度指数内容，及时体验从这里开始。
开发文档
认证方式
黑料官网|黑料开放数据接口采用密钥认证机制，开发者需在每次请求中携带有效的接口密钥。密钥通过首页申请表单获取，审核通过后发送至注册邮箱。平台支持两种认证方式，开发者可根据实际需求选择。
方式一：请求头认证（推荐）
// 在请求头中携带认证信息
Authorization: Bearer sk_live_您的密钥
Content-Type: application/json
X-Request-ID: 自定义请求标识（可选）
方式二：查询参数认证
https://pfnyowm.cn/api/v1/search?api_key=sk_live_您的密钥&keyword=查询词
建议优先使用请求头认证方式，避免密钥暴露在访问日志中。请妥善保管密钥，不要在客户端代码或公开仓库中硬编码密钥信息。
便捷搜索今日榜单便捷首页高速详情移动友好专题归档今日趋势
请求规范
所有接口请求遵循统一的规范格式，基础地址为 https://pfnyowm.cn/api/v1/，所有请求必须使用安全传输协议。
| 规范项 | 说明 |
|---|---|
| 基础地址 | https://pfnyowm.cn/api/v1/ |
| 传输协议 | 仅支持安全传输协议，不支持非加密连接 |
| 请求格式 | 查询接口使用查询参数，提交接口使用请求体 |
| 响应格式 | 统一返回标准结构化数据格式 |
| 字符编码 | 统一使用通用字符编码 |
| 时间格式 | 统一使用标准时间格式 |
| 版本控制 | 通过路径中的版本号区分，当前为第一版 |
响应格式
所有接口返回统一的响应结构，包含状态码、消息、数据体和请求标识四个顶层字段。
{
"code": 200, // 业务状态码
"message": "请求成功", // 状态描述
"data": { ... }, // 业务数据体
"request_id": "req_xxx" // 请求追踪标识
}
当请求失败时，响应体中的 data 字段为空，message 字段包含具体错误描述。建议开发者在代码中优先判断 code 字段，非二百状态码均视为异常。
错误处理
接口异常时返回标准化错误响应，开发者应根据错误码进行相应处理。建议实现重试机制和降级策略，提升系统健壮性。
{
"code": 429,
"message": "请求频率超出限制，请降低调用频率或升级套餐",
"data": null,
"request_id": "req_abc123",
"retry_after": 60
}
对于频率超限错误，响应中包含 retry_after 字段，指示建议的等待秒数。对于服务端错误，建议采用指数退避策略进行重试，最多重试三次。
最佳实践
密钥安全
将密钥存储在环境变量或配置中心，不要硬编码在源代码中。定期轮换密钥，发现泄露立即重置。
请求优化
合理使用分页参数，避免单次请求过大数据量。对频繁查询的数据进行本地缓存，减少重复请求。
错误处理
实现完善的错误处理逻辑，区分可重试错误和不可重试错误。记录请求标识便于问题排查。
合规使用
遵守内容使用政策，不将数据用于违法违规用途。对获取的数据进行二次脱敏后再向终端用户展示。