P
← início

API pública v1

Dados da Câmara dos Deputados, já normalizados e com ementas simplificadas. Sem autenticação. Use à vontade.

Em beta. Shapes podem mudar sem aviso. Antes de construir em cima, abre issue.

Deputados

GET/api/v1/deputados
uf
— Sigla do estado (ex: SP)
partido
— Sigla do partido (ex: PT)
q
— Busca por nome (min. 2 chars)
limit
— Padrão 100, máx 500
offset
— Padrão 0
Testar: /api/v1/deputados?uf=MG&limit=5 →
GET/api/v1/deputados/:id

Inclui estatísticas (gastos, projetos, votos) do deputado no ano atual.

Testar: /api/v1/deputados/204549 →

Votações

GET/api/v1/votacoes
tema
— Tema classificado (ex: Saúde)
desde
— Data ISO (ex: 2026-01-01)
ate
— Data ISO
limit
— Padrão 100, máx 500
offset
— Padrão 0
Testar: /api/v1/votacoes?tema=Saúde&limit=5 →

Partidos

GET/api/v1/partidos

Lista todos os partidos com representação + gastos totais no ano.

Testar: /api/v1/partidos →

Senadores

GET/api/v1/senadores
uf
— Sigla do estado (ex: SP)
partido
— Sigla do partido (ex: PT)
q
— Busca por nome (min. 2 chars)
limit
— Padrão 100, máx 500
offset
— Padrão 0
Testar: /api/v1/senadores?uf=MG&limit=5 →

Temas (classificação IA)

GET/api/v1/temas/:slug

Stats agregados + projetos e votações classificados nesse tema.

limit
— Padrão 50, máx 200 (projetos e votações)
Testar: /api/v1/temas/saude →

Votação detalhada

GET/api/v1/votacoes/:id

Inclui breakdown por tipo de voto + lista de cada voto individual com partido/UF.

Testar: /api/v1/votacoes/2278826-130 →

PL da semana (editorial automatizado)

GET/api/v1/pl-da-semana

O 'oQueMuda' já vem parseado em array de strings.

semana
— Código ISO específico (ex: 2026-W18). Sem isso, retorna histórico.
limit
— Padrão 20, máx 100
Testar: /api/v1/pl-da-semana?limit=5 →

Destaques da semana

GET/api/v1/destaques

Cards editoriais automatizados — maior gasto, voto unânime, voto rachado, etc.

semana
— ISO (ex: 2026-W18). Sem isso, última semana.
tipo
— 'atencao' ou 'destaque' pra filtrar
Testar: /api/v1/destaques →

Promessas de campanha

GET/api/v1/promessas

Cada promessa tem fonte (URL) obrigatória + evidências verificáveis.

politicoTipo
— 'chefe_executivo' | 'deputado' | 'senador'
politicoId
— ID do político
status
— 'cumprida' | 'parcial' | 'descumprida' | 'em_andamento' | 'nao_avaliada'
tema
— Tema classificado
limit
— Padrão 100, máx 500
offset
— Padrão 0
Testar: /api/v1/promessas?status=cumprida&limit=10 →

Exports CSV

GET/api/v1/despesas.csv

Download direto em CSV. Abre no Excel, Google Sheets, etc.

ano
— Padrão ano atual
uf
— Filtra por UF
partido
— Filtra por sigla do partido
limit
— Padrão 10000, máx 50000
Testar: /api/v1/despesas.csv?ano=2026&uf=SP →

Fontes