核心用法
Senado Federal API 是巴西联邦参议院的官方开放数据接口，覆盖立法活动的完整生命周期。主要功能模块包括：
议员数据：实时在任议员名单（/senador/lista/atual.json）、完整档案（含学术背景、职业经历、政党归属、委员会职务）、历史任期、发言记录（discursos.json）、投票记录及请假状态。
立法追踪：支持多维度检索法案（/materia/pesquisa/lista.json），可按类型（PL/PEC/PLS等）、作者、关键词、年份、审议状态筛选；提供法案全文、修正案、报告人、完整流转历史（tramitação）及当前状态查询。
议程与投票：议会全体会议日程（/plenario/agenda/dia/{data}.json）、月度议程、投票结果（含记名投票）、委员会日程及iCal订阅源。
委员会管理：常设委员会与混合委员会清单、成员构成、会议记录、表决数据。
辅助资源：速记文本（taquigrafia）、演讲全文、政党团块构成、领导层信息等。
---
显著优点
1. 官方权威数据源：直接来自巴西联邦参议院，数据时效性与准确性高于第三方聚合平台
2. 零门槛访问：无需API密钥或认证，支持JSON/XML双格式，降低开发成本
3. 覆盖深度罕见：不仅包含基础法案信息，还延伸至议员学术历史、职业背景、请假记录等细节
4. 实时立法追踪：tramitando=S 参数可筛选当前审议中的法案，支持政策监控场景
5. 标准化日期接口：提供iCal格式委员会日程，便于集成日历系统
---
局限性与注意事项
- 语言障碍：全部数据为葡萄牙语，非葡语用户需额外处理本地化
- 日期格式混乱：不同端点采用
YYYYMMDD、YYYYMM、YYYY等多种格式，需仔细对照文档 - API版本迭代：材料相关接口存在v1废弃风险（2025年起
/materia/{sigla}/{numero}/{ano}已标记弃用） - 速率限制未明确：官方未公布限流策略，高频爬取存在潜在封禁风险
- 数据完整性波动：历史数据（如早期任期记录）可能存在缺失
---
适合人群
- 巴西政治研究者与学术机构
- 立法透明度监督组织（如OpenGov倡导者）
- 需要合规追踪巴西监管动态的国际企业法务部门
- 新闻机构政治记者与数据新闻团队
- 开发巴西政务应用的第三方服务商
---
常规风险提示
- 政治敏感性：巴西近年来政治极化严重，法案追踪与议员数据查询可能涉及敏感议题
- 数据解读门槛：立法程序复杂（如
tramitação状态编码），需熟悉巴西国会内部规则才能准确解析 - 缓存策略建议：建议实施合理缓存机制，避免对速记文本等大数据端点造成重复请求