Para desenvolvedores
API pública
Os mesmos dados do site, em JSON, sem cadastro. Use em reportagens, pesquisas e outros projetos (dados sob CC BY 4.0: cite a fonte).
Base
https://api.detectordebananada.com.br/v1ou https://detectordebananada.com.br/api/v1 (o mesmo conteúdo)
Formato
JSON UTF-8, só GET. Percentuais de 0 a 1; datas AAAA-MM-DD.
Ids
Políticos por slug; votações e projetos por id com - (ex.: CD-2372903).
Valores fixos
casa: CD | SF · espectro: esquerda, centro-esquerda, centro, centro-direita, direita, sem-classificacao, sem-partido · periodo: total, leg57, leg56, gov:lula3, gov:bolsonaro, 2019…2026 (lista em /meta). Erros: { "erro": "mensagem" } com 400/404/429/500. Cache de 5 minutos.
Geral
GET
/api/v1/metaData da última atualização, fontes, períodos, presidentes, espectros e totais.
Exemplo: /api/v1/metaGET
/api/v1/statusSituação da coleta por área (OK, atrasada, com erro), última leitura de cada fonte e a próxima rodada.
Exemplo: /api/v1/statusGET
/api/v1/buscaBusca global (aceita nome sem acento), resultados agrupados por tipo.
Parâmetros:
Exemplo: /api/v1/busca?q=joseq, tipos=politico,partido,projeto,votacao,tema, limiteGET
/api/v1/destaquesÚltimas votações do Plenário, pódio de presença, as mais divididas do mês e consensos.
Exemplo: /api/v1/destaquesGET
/api/v1/semanaResumo dos 7 dias: frases prontas, contagens, votações, leis, vetos e quem mais faltou na Câmara.
Parâmetros:
Exemplo: /api/v1/semanaate=AAAA-MM-DDGET
/api/v1/composicaoCadeiras por espectro na Câmara e no Senado e o Presidente atual.
Exemplo: /api/v1/composicao
Parlamentares
GET
/api/v1/parlamentaresLista com Bananômetro, presença, participação e governismo.
Parâmetros:
Exemplo: /api/v1/parlamentares?uf=SP&casa=SFcasa, uf, partido, espectro, ativo=1, q, periodo, ordem=nome|bananometro|presenca, limiteGET
/api/v1/parlamentares/{slug}Perfil completo com métricas do período, comparações e resumo em frases.
Parâmetros:
Exemplo: /api/v1/parlamentares/ricardo-ayresperiodoGET
/api/v1/parlamentares/{slug}/votosVotos do parlamentar no Plenário (50 por página). Com comissoes=1, as votações nominais de comissões.
Parâmetros:
Exemplo: /api/v1/parlamentares/ricardo-ayres/votos?contra_partido=1periodo, tema, contra_partido=1, comissoes=1, paginaGET
/api/v1/parlamentares/{slug}/presencasPresença dia a dia em um ano e resumo por ano.
Parâmetros:
Exemplo: /api/v1/parlamentares/ricardo-ayres/presencas?ano=2025anoGET
/api/v1/parlamentares/{slug}/iniciativasProjetos de autoria e contagem por desfecho.
Parâmetros:
Exemplo: /api/v1/parlamentares/ricardo-ayres/iniciativasdesfecho=vitoria|avancou|andamento|derrota, paginaGET
/api/v1/parlamentares/{slug}/trajetoriaPartidos, períodos em exercício e eventos do mandato.
Exemplo: /api/v1/parlamentares/ricardo-ayres/trajetoria
Votações e projetos
GET
/api/v1/votacoesVotações (30 por página) com placar por espectro, índice de polarização (0 a 100) e consenso.
Parâmetros:
Exemplo: /api/v1/votacoes?casa=SFcasa, desde, ate, tema, resultado=aprovada|rejeitada, q, plenario=0, comissoes=1, ordem=polarizacao|consenso, limite, paginaGET
/api/v1/votacoes/{id}Votação com orientações e o voto de cada parlamentar.
Exemplo: /api/v1/votacoes/CD-2374400-121GET
/api/v1/proposicoesProjetos (30 por página).
Parâmetros:
Exemplo: /api/v1/proposicoes?tipo=PECq, tipo, tema, autor, espectro_autor, desfecho, casa, ano, paginaGET
/api/v1/proposicoes/{id}Projeto com autores, temas, votações e a Jornada da Lei.
Exemplo: /api/v1/proposicoes/CD-2372903GET
/api/v1/vetosVetos presidenciais.
Parâmetros:
Exemplo: /api/v1/vetos?presidente=lula3presidente, resultado, ano
Comparações
GET
/api/v1/rankings/{metrica}Rankings com histograma. Métricas: presenca, participacao, iniciativas, derrotas, governismo, fidelidade, bananometro.
Parâmetros:
Exemplo: /api/v1/rankings/presenca?casa=CD&periodo=leg57nivel=politico|partido|espectro, casa, periodo, uf, partido, espectro, limite, ordem=desc|ascGET
/api/v1/partidosPartidos com espectro e médias dos membros.
Parâmetros:
Exemplo: /api/v1/partidosperiodoGET
/api/v1/partidos/{sigla}Partido com governismo por governo e membros.
Parâmetros:
Exemplo: /api/v1/partidos/ptperiodoGET
/api/v1/temasTemas com contagens.
Exemplo: /api/v1/temasGET
/api/v1/temas/{slug}Tema com votações, projetos, quem mais propõe e voto por espectro.
Exemplo: /api/v1/temas/saudeGET
/api/v1/presidenciaPresidentes com leis, MPs e vetos.
Exemplo: /api/v1/presidenciaGET
/api/v1/presidentes/{chave}Presidente com série anual, vetos e governismo dos partidos.
Exemplo: /api/v1/presidentes/lula3
Feeds RSS para jornalistas
Assine no seu leitor de RSS (Feedly, Inoreader, Thunderbird…) e receba cada votação nova e o resumo da semana. Atualizados a cada 5 minutos.
Baixar tudo (dumps diários)
Quer o banco inteiro? Não precisa martelar a API: baixe as tabelas completas em CSV (UTF-8, com cabeçalho), compactadas com gzip e atualizadas a cada coleta. Licença CC BY 4.0: cite o Detector de Bananada e as fontes oficiais.
Os tipos completos de cada resposta estão no arquivo docs/api-contrato.md do repositório (publicação em breve).