Como autenticar
Base: https://api.governabrasil.com. A chave vai no cabeçalho, nunca na URL — chave em endereço vaza em log de servidor, em histórico de navegador e em cache de CDN.
curl -H "Authorization: Bearer SUA_CHAVE" \
https://api.governabrasil.com/v1/apuracao/2026-gerais-presidente-2/brTambém aceitamos x-api-key: SUA_CHAVE. As respostas da API saem como private, no-store: elas não podem ser guardadas por CDN, porque o que uma CDN guardasse não entraria na sua contagem nem passaria pela sua cota. Guarde em cache do seu lado, respeitando o ETag que devolvemos.
O que cada resposta de recusa quer dizer
401: chave ausente, desconhecida ou revogada.402: a chave está certa, o período pago venceu. Renove no painel.429: cota do mês esgotada ou rajada acima do teto por minuto. O corpo diz qual dos dois.
A chave é segredo de servidor: não a coloque em aplicativo de navegador, onde qualquer visitante a lê. Chame a API do seu backend e sirva o resultado ao seu cliente.
Endpoints
GET /v1/apuracao/{disputa}/{localidade}- Painel de apuração: votos por candidatura, % dos válidos, seções totalizadas, comparecimento, brancos, nulos, horário do boletim e fase.
GET /v1/apuracao/{disputa}/{uf}/municipios- Resultado de todos os municípios de uma UF, para mapas.
GET /v1/apuracao/{disputa}/exterior/cidades- As 186 cidades do exterior com seção eleitoral, uma a uma.
GET /v1/apuracao/{disputa}/eventos- Atualizações oficiais: boletins, estados concluídos, proclamação.
GET /v1/historico/{localidade}- Série histórica das eleições presidenciais 2002–2026 (Brasil, UF ou município).
GET /v1/pesquisas/{disputa}- Pesquisas registradas no TSE, com números conferidos na fonte primária.
GET /v1/parlamentares?casa={camara|senado}- Deputados e senadores em exercício, com partido, UF e foto oficial.
GET /v1/votacoes/{casa}/{id}- Votação de plenário: resultado publicado, totais oficiais, orientação de bancada e o voto de cada parlamentar.
GET /v1/proposicoes/{casa}/{sigla-numero-ano}- Proposição: ementa, autoria, situação, norma gerada e tramitação.
GET /v1/despesas/{casa}/{slug}- Cota parlamentar por ano, com fornecedor e documento.
GET /v1/emendas/{casa}/{slug}- Emendas de um parlamentar, com empenho e pagamento.
GET /v1/contas/{uf}- Contas públicas de estados e municípios.
Parâmetros
- disputa:
2026-gerais-presidente-2,2026-gerais-presidente-1ou{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
nullsignifica “não disponível na fonte oficial”, nunca zero. - Percentual de candidatura é sobre votos válidos.
- A fase
encerradosó aparece após a proclamação oficial registrada, com link para o ato. - Durante a apuração os números mudam a cada boletim do TSE: consultar mais de uma vez a cada 15 s não traz dado novo, só gasta cota.
Licença e atribuição
Os dados originais são do Tribunal Superior Eleitoral (CC-BY 4.0) e do IBGE, e seguem públicos na fonte. O que se paga aqui é o acesso ao nosso tratamento deles: coleta contínua, conferência, normalização, série histórica unificada e contrato estável. Ao reutilizar, cite “Fonte: TSE, via Governa Brasil”, com o horário do boletim quando houver.
Para buscadores e assistentes de IA
- /llms.txt e /llms-full.txt: resumo do site e regras de citação.
- /feed/apuracao.xml: RSS das atualizações oficiais da apuração.
Metodologia: como tratamos os dados · fontes.