API pública

Endpoints

Base: http://localhost:3000. Respostas com Cache-Control e ETag; durante a apuração os dados mudam a cada boletim do TSE (consulte no máximo a cada 15 s).

GET /api/v1/apuracao/{disputa}/{localidade}

Painel de apuração: votos por candidatura, % dos válidos, seções, comparecimento, brancos, nulos, horário do boletim e fase. Exemplo: /api/v1/apuracao/2026-gerais-presidente-1/br

GET /api/v1/apuracao/{disputa}/{uf}/municipios

Resultado de todos os municípios de uma UF (para mapas). Exemplo: /api/v1/apuracao/2026-gerais-presidente-1/pr/municipios

GET /api/v1/apuracao/{disputa}/eventos

Últimas atualizações oficiais: boletins, estados concluídos, proclamação. Exemplo: /api/v1/apuracao/2026-gerais-presidente-2/eventos

GET /api/v1/historico/{localidade}

Série histórica das eleições presidenciais 2002–2026 (Brasil, UF ou município). Exemplo: /api/v1/historico/br

GET /api/v1/parlamentares?casa={camara|senado}

Deputados ou senadores em exercício (nome, partido, UF, foto oficial). Exemplo: /api/v1/parlamentares?casa=senado

GET /api/v1/parlamentares/{casa}/{slug}

Perfil e votos registrados em plenário, agrupados como publicados. Exemplo: /api/v1/parlamentares/senado/alan-rick

GET /api/v1/proposicoes?casa=&limite=

Proposições votadas em plenário, das que andaram mais recentemente. Exemplo: /api/v1/proposicoes?limite=10

GET /api/v1/proposicoes/{casa}/{sigla-numero-ano}

Proposição: ementa oficial, autoria, situação, norma gerada, votações e tramitação completa (mais recente primeiro). Exemplo: /api/v1/proposicoes/camara/plp-281-2019

GET /api/v1/votacoes?casa=&nominal=1&limite=

Votações de plenário recentes (Câmara e Senado). Exemplo: /api/v1/votacoes?nominal=1&limite=10

GET /api/v1/votacoes/{casa}/{id}

Votação: resultado como publicado, totais oficiais (Senado), orientação de bancadas (Câmara) e o voto de cada parlamentar. Exemplo: /api/v1/votacoes/camara/2236186-60

GET /api/v1/pesquisas/{disputa}

Pesquisas registradas no TSE e resultados conferidos na fonte primária. Exemplo: /api/v1/pesquisas/2026-gerais-presidente-2

Parâmetros

• disputa: 2026-gerais-presidente-2, 2026-gerais-presidente-1 ou {ano}-gerais-presidente-{turno} para 2002–2022.
• localidade: br, sigla da UF em minúsculas (sp), zz (exterior) ou código IBGE do município (7 dígitos).

Regras de leitura

• Valor null significa “não disponível na fonte oficial”, nunca zero.
• Percentuais de candidaturas são sobre votos válidos. Não há projeções.
• A fase encerrado só aparece após a proclamação oficial registrada, com link para o ato.

Licença e atribuição

Dados originais do Tribunal Superior Eleitoral (CC-BY 4.0) e do IBGE. Ao reutilizar: “Fonte: TSE, via Mapa Brasil”, com o horário do boletim quando houver.

Para buscadores e assistentes de IA

• /llms.txt e /llms-full.txt: resumo do site, situação atual da apuração e regras de citação.
• /feed/apuracao.xml: RSS das atualizações oficiais da apuração.
• Rastreamento liberado para robôs de busca e de IA (ver robots.txt).

Metodologia: como tratamos os dados · fontes.