接口列表

黑料网-曝光排行API文档平台所有可用的黑料网舆情数据接口端点，按功能分类展示请求方法、路径和功能说明。

搜索类接口

GET /api/v1/search

根据关键词和筛选条件搜索公开舆情信息，返回结构化摘要列表。支持布尔运算、时间范围、来源筛选。

GET /api/v1/search/suggest

根据输入前缀返回搜索建议词列表，用于实现搜索框自动补全功能。

POST /api/v1/search/batch

批量提交多个搜索任务，异步返回结果。适用于需要同时查询多个关键词的场景。

榜单类接口

GET /api/v1/rank/hot

获取当前实时热点榜单，支持按分类和地域筛选。数据每五分钟自动更新。

GET /api/v1/rank/rising

获取热度快速上升的话题列表，用于发现新兴热点和趋势。

GET /api/v1/rank/history

查询指定日期的历史榜单数据，支持回溯最近九十天的榜单记录。

报告类接口

POST /api/v1/report/generate

根据指定主题生成舆情分析报告，包含趋势图表、情感分析和风险评估。

GET /api/v1/report/status/{task_id}

查询报告生成任务的处理状态和进度。

GET /api/v1/report/download/{report_id}

下载已生成的报告文件，支持多种输出格式。

推送与分析类接口

POST /api/v1/webhook/subscribe

订阅实时推送服务，设置触发规则和回调地址。支持关键词触发和阈值告警。

DELETE /api/v1/webhook/unsubscribe/{sub_id}

取消指定的推送订阅。

POST /api/v1/classify

对输入文本进行分类标注，返回事件类型、领域、情感和风险等级。

GET /api/v1/trend/{keyword}

获取指定关键词的历史趋势数据，支持日、周、月粒度。

常见问题

所有接口都需要认证吗？

是的，所有接口均需要有效的密钥认证。未携带密钥或密钥无效的请求将返回认证失败错误。建议通过请求头方式传递密钥以保障安全性。

接口版本升级时如何迁移？

平台采用路径版本控制，新版本发布后旧版本将保持至少六个月的兼容期。在兼容期内，开发者可以逐步迁移至新版本。版本变更通知将通过邮件和状态页发布。

⚠️接口返回数据仅供合规用途，禁止用于任何违法违规行为。查看内容政策