Encerrado · série congelada em 31/10/2026 dados de 31/10/2026, 21:01
PROJETO · DADOS ABERTOS

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.

Documentação interativa (Swagger) OpenAPI JSON Redoc

No banco congelado

117.687
artigos de imprensa
23
nomes seguidos pelo monitor, os que /candidates lista (2 candidatos do 2º turno)
2.360
fontes de imprensa
31/10 21h01
última coleta

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
curl -s https://eleicoes2026.sapienslabs.com.br/api/v1/stats
Python
import requests
BASE = "https://eleicoes2026.sapienslabs.com.br/api/v1"
r = requests.get(f"{BASE}/stats").json()
print(r["data"])
JavaScript
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 url de 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.