API pública
Acesse os dados do painel Eleições 2026 por uma API REST gratuita, sem cadastro e sem chave. Endpoints JSON pra usar em pesquisa, jornalismo de dados, dashboards e estudos acadêmicos.
No banco congelado
/candidates lista (2 candidatos do 2º turno)Recorte oficial: de 25 de março a 31 de outubro de 2026. A coleta parou em 31/10/2026, depois da rodada das 21h, e o snapshot público é o final. Até lá, a coleta rodava cinco vezes por dia (07h, 10h, 13h, 16h e 21h BRT) e o snapshot era refeito ao fim de cada rodada.
Como começar
Três jeitos rápidos de bater na API. Todos os exemplos retornam o mesmo JSON com totais do banco.
curl -s https://eleicoes2026.sapienslabs.com.br/api/v1/stats
import requests
BASE = "https://eleicoes2026.sapienslabs.com.br/api/v1"
r = requests.get(f"{BASE}/stats").json()
print(r["data"])
const BASE = 'https://eleicoes2026.sapienslabs.com.br/api/v1';
const r = await fetch(`${BASE}/stats`).then(x => x.json());
console.log(r.data);
Endpoints
Todos são GET, retornam JSON com envelope { "data": ..., "meta": {...} }
e respeitam o cutoff oficial de 25/03/2026. Veja a documentação completa
no Swagger.
| Caminho | O que retorna | Tente |
|---|---|---|
/api/v1/stats |
Totais gerais (artigos, candidatos, fontes), os artigos do último dia da série (articles_last_day) e o carimbo da última coleta. Candidatos em três contagens: total_candidates, os dois do 2º turno; total_candidates_monitored, os 23 nomes que o monitor seguiu; total_candidates_first_round, as chapas que foram às urnas no 1º turno. |
↗ |
/api/v1/candidates |
Os 23 nomes que o monitor seguiu, com KPIs (artigos, sentimento médio), a data de saída (saiu_em), o grupo e o resultado oficial do TSE (resultado, com a fonte). Filtro: status (candidate, os dois do 2º turno; dropped, os outros). |
↗ |
/api/v1/candidates/{slug} |
Detalhe de qualquer um dos 23 nomes: KPIs, distribuição de sentimento, top fontes e tópicos, e o resultado oficial. | ↗ |
/api/v1/candidates/{slug}/sentiment |
Série diária: volume e sentimento médio sobre o candidato. | ↗ |
/api/v1/articles |
Lista paginada de artigos. Filtros: candidate, source, from, to, page, page_size. |
↗ |
/api/v1/articles/{id} |
Metadados de um artigo: todos os candidatos com vínculo verificado, tópicos, cluster Zeitgeist, classificação editorial. | — |
/api/v1/veiculos |
Mapa dos veículos: rótulo editorial, proveniência, sede, dono, artigos, justificativa e fontes. Só perfis revisados. Filtros: rotulo, uf, proveniencia, q. |
↗ |
/api/v1/personagens |
Quem aparece nas matérias sem estar numa chapa: pessoas citadas, papel, candidatos com quem dividem a matéria e curva no tempo, desde 10/08/2026. Só o agregado, com piso de matérias. Filtros: period (1t, de 10/08 a 04/10; 2t; rep, a repercussão, o padrão; all, desde 10/08; 7d e 30d, de antes do congelamento, respondem com rep), limit. Página: /personagens. |
↗ |
/veiculos.csv |
Dataset do mapa dos veículos (só perfis revisados): rótulo, eixo, sede, dono, artigos, justificativa, fontes. UTF-8, vírgula. Rubrica em /veiculos/rubrica. | ↗ |
/veiculos.json |
O mesmo dataset em JSON, com meta (licença, atribuição, data de geração). |
↗ |
O que a API expõe — e o que não expõe
✓ Expõe
- Dados derivados do projeto: sentimento por candidato, tópicos, classificação editorial e cluster Zeitgeist.
- Metadados do artigo: título, URL original (link de volta pra origem), fonte, data de publicação.
- Snippet curto (
description, até 320 caracteres) só no detalhe de cada artigo.
✗ Não expõe
- Corpo dos artigos. Pra ler na íntegra, siga o
urlde cada artigo até o veículo original. - Endpoints de escrita — a API é estritamente
GET. - Dados pessoais ou de navegação dos visitantes do painel.
Limites e cache
Sem autenticação. Não tem chave, não tem cadastro, não tem cota individual.
Rate limit por IP. 60 requisições por minuto, aplicado na borda pela Cloudflare. Se você precisa de volume maior pra um projeto de pesquisa, fale com a gente — o limite serve só pra conter abuso.
Cache de 5 minutos (Cache-Control: public, max-age=300).
O snapshot do banco é o final, de 31/10/2026; respostas em cache vêm do edge
da Cloudflare.
CORS aberto. Origem *, métodos GET
e OPTIONS. Pode chamar de qualquer navegador.
Versionamento. Mudanças retro-incompatíveis vão pra
/api/v2/. A v1 fica estável; alterações são aditivas (novos
endpoints, novos campos opcionais).
404 estruturado. Recursos inexistentes retornam
HTTP 404 com JSON { "detail": "..." }.
Licença e atribuição
Dados disponibilizados sob Creative Commons Atribuição 4.0 (CC BY 4.0). Você pode copiar, redistribuir, transformar e construir em cima — inclusive pra uso comercial — desde que dê o crédito apropriado.
Atribuição sugerida:
SapiensLabs — Eleições 2026 (eleicoes2026.sapienslabs.com.br) — CC BY 4.0
Os dados derivados (sentimento, tópicos, classificações, série temporal) são produção própria do projeto. Os links apontam pros veículos originais — cite-os quando reproduzir conteúdo deles.
Quer contribuir, reportar erro ou conversar sobre o projeto? Mande email pra leonardo@sapienslabs.com.br.