搜索类接口
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}
获取指定关键词的历史趋势数据，支持日、周、月粒度。
常见问题
所有接口都需要认证吗？
是的，所有接口均需要有效的密钥认证。未携带密钥或密钥无效的请求将返回认证失败错误。建议通过请求头方式传递密钥以保障安全性。
接口版本升级时如何迁移？
平台采用路径版本控制，新版本发布后旧版本将保持至少六个月的兼容期。在兼容期内，开发者可以逐步迁移至新版本。版本变更通知将通过邮件和状态页发布。