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 agora
Recorte oficial: desde 25 de março de 2026. Coleta automática cinco vezes por dia (07h, 10h, 13h, 16h e 21h BRT). Snapshot público regenerado ao fim de cada coleta.
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/statsimport 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) e timestamp da última coleta. | ↗ |
/api/v1/candidates |
Lista os candidatos monitorados com KPIs (artigos, sentimento médio). | ↗ |
/api/v1/candidates/{slug} |
Detalhe de um candidato: KPIs, distribuição de sentimento, top fontes e tópicos. | ↗ |
/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: candidatos mencionados, 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 (7d, 30d, all), 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 é regenerado ao fim de cada coleta; entre coletas,
respostas 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.