核心功能
Senado Federal API 提供巴西联邦参议院全面的立法数据开放接口，分为两大系统：LEGIS（立法活动）和 ADM（行政透明度）。LEGIS 覆盖议员信息、法案追踪、议程投票、委员会事务等完整立法流程；ADM 专注财政透明度，包括议员办公经费（CEAP）、住房补贴、政府合同、公务员薪酬及企业卡消费记录。
显著优点
- 官方权威: 直接源自巴西联邦参议院
legis.senado.leg.br和adm.senado.gov.br，数据实时性与准确性最高 - 功能完备: 支持60+类查询场景，从法案全文到议员学术履历，从当日议程到历年投票记录
- 无需认证: 完全开放访问，降低使用门槛
- 双格式支持: JSON/XML 可选，便于不同技术栈集成
- 财政透明: ADM 系统提供罕见的政府支出细颗粒度数据，包括CEAP逐项、合同全链条、公务员薪酬等
潜在局限
- 数据嵌套深: 响应结构复杂（3-4层嵌套），需额外解析处理
- 日期格式不统一: 不同端点使用 YYYYMMDD、YYYYMM 或 YYYY，易混淆
- API版本混杂: v1 端点已废弃但仍在文档中，需留意
/processo等新推荐路径 - 稳定性波动: 偶发500错误，建议实现指数退避重试
- 单条/列表返回不一致: 单结果时可能返回对象而非数组
适用人群
- 政治研究者与学者：分析立法行为、投票模式、党派动态
- 记者与调查机构：追踪特定法案进展、挖掘财政支出异常
- 公民社会组织：监督议员履职、推进政府透明度
- 数据科学家：巴西政治数据集构建、选举研究
- 开发者：政务信息应用、新闻自动化、政策追踪工具
常规风险提示
- 数据解读需专业知识: 巴西立法程序复杂（如"regime de urgência"、"tramitação conclusiva"），误解流程状态可能导致错误分析
- 隐私边界: ADM 数据虽公开，但涉及个人住址、完整CPF等敏感信息，使用需符合巴西数据保护法（LGPD）
- 时效性差异: 立法数据通常实时，但财政数据可能有月度延迟
- 政治敏感性: 财政透明度数据常用于政治监督，使用场景可能引发争议