Dados das eleições para jornalistas, pesquisadores e desenvolvedores

1Começo rápido

# sem chave (até ~1 pedido/s e 1.000 por dia por IP)
curl -s --compressed "https://colinhadigital.com/api/v1/resultados/br/1"

# com chave gratuita (até ~10 pedidos/s e 50.000 por dia)
curl -s --compressed -H "X-API-Key: SUA_CHAVE" \
  "https://colinhadigital.com/api/v1/municipios/pe/25216/resultados/11?e=2024-1"

# resultado oficial do 2º turno (presidente, Brasil)
curl -s -H "X-API-Key: SUA_CHAVE" "https://colinhadigital.com/api/v1/apuracao?cargo=1&abr=br&turno=2"

const API = "https://colinhadigital.com/api/v1/";

async function get(rota) {
  const r = await fetch(API + rota, { headers: { "X-API-Key": "SUA_CHAVE" } });
  if (r.status === 429) {                      // passou do limite: espere e tente de novo
    const s = +r.headers.get("Retry-After") || 2;
    await new Promise(ok => setTimeout(ok, s * 1000));
    return get(rota);
  }
  if (!r.ok) throw new Error((await r.json()).erro);
  return r.json();
}

const d = await get("apuracao?cargo=1&abr=br&turno=1&top=4");
d.candidatos.forEach(c => console.log(`${c.urna} (${c.n}): ${c.pct}%`));

import time, requests

API = "https://colinhadigital.com/api/v1/"
s = requests.Session()
s.headers["X-API-Key"] = "SUA_CHAVE"          # sem esta linha funciona com limite menor

def get(rota, **params):
    while True:
        r = s.get(API + rota, params=params, timeout=60)
        if r.status_code == 429:                # respeite o Retry-After
            time.sleep(int(r.headers.get("Retry-After", "2")))
            continue
        r.raise_for_status()
        return r.json()

d = get("resultados/pe/11", e="2024-1", m=25216)   # prefeito de Petrolina (PE), 2024
for n, urna, partido, _, votos, *_ in d["cands"]:
    print(n, urna, partido, votos)

Para descobrir o código de um município, use /api/v1/busca/lugares?q=nome (código TSE de 5 dígitos; o código do IBGE vem junto). Há uma lista de todas as rotas em /api/v1/.

2Limites de uso

O dia vira à meia-noite de Brasília. Toda resposta traz os cabeçalhos X-Limite-Dia, X-Restante-Dia e X-Limite-Segundo. Passou do limite? Você recebe 429 com Retry-After (segundos para tentar de novo). Precisa de mais? fale com a gente.

3Chave gratuita

Só pedimos o nome do projeto e um e-mail de contato. A chave aparece uma única vez na tela — guarde-a.

Já tenho uma chave

4Rotas

Todas são GET e começam com https://colinhadigital.com/api/v1/. O botão “Experimente” chama a API daqui mesmo, sem chave (conta no limite do seu IP) e mostra o começo da resposta.

Eleições e busca

Resultados

Município, colégio, seção e boletim de urna

Perfil do eleitorado

Resultado oficial da apuração de 2026 (1º e 2º turno)

Gerenciar a chave

5Códigos usados

Limites conhecidos dos dados do TSE: 1998 sem presidente e sem nº de local; 2000 com alguns estados incompletos; perfil do eleitorado só de 2010 em diante; boletins de urna de 2012 em diante. Detalhes e correções no registro de correções do Raio-X.

6Erros

O corpo do erro é sempre JSON: {"erro": "mensagem em português", "documentacao": "https://colinhadigital.com/dados/"}.

7Termos de uso (versão 2026-10-10)

1. Dados públicos. A origem é o Tribunal Superior Eleitoral (TSE) e outras fontes oficiais indicadas. A Colinha Digital, da Vorax Segurança Cibernética, organiza e trata esses dados. Não é sistema oficial e não tem vínculo com a Justiça Eleitoral, partidos ou candidatos.
2. Sem garantia. A API é oferecida “como está”, sem garantia de disponibilidade ou de ausência de erros. O resultado oficial é sempre o publicado pelo TSE — confira lá antes de qualquer decisão importante.
3. Cite a fonte. Ao publicar qualquer coisa feita com estes dados, cite “Colinha Digital / Vorax” e a fonte TSE (veja como citar). A reutilização, inclusive comercial, é permitida com essa atribuição.
4. É proibido usar a API para disparo em massa de mensagens (WhatsApp, SMS, e-mail, robôs), para desinformação ou para apresentar dados alterados como se fossem oficiais; para identificar, expor ou perseguir pessoas; ou para contornar os limites (várias chaves, troca de IPs).
5. Lei eleitoral. Quem usa os dados responde pelo que publica, inclusive perante a legislação eleitoral (Lei 9.504/1997 e resoluções do TSE). A API não contém pesquisas eleitorais.
6. Suspensão e mudanças. Podemos suspender chaves usadas fora destes termos e ajustar limites. Mudanças que quebrem a compatibilidade irão para um novo endereço (/api/v2) com aviso nesta página.
7. Prioridade do site. Em picos (dia de eleição e apuração), a API pode ficar mais lenta para preservar o atendimento ao eleitor no site.

8Como citar

Texto curto (gráficos, matérias, posts)

Fonte: TSE, via Colinha Digital / Vorax (colinhadigital.com/dados)

ABNT (NBR 6023)

VORAX SEGURANÇA CIBERNÉTICA. Colinha Digital: dados eleitorais públicos — API v1. Dados de origem: Tribunal Superior Eleitoral (TSE). [S. l.]: Vorax, 2026. Disponível em: https://colinhadigital.com/dados/. Acesso em: 10 out. 2026.

BibTeX

@misc{colinhadigital_api_2026,
  author       = {{Vorax Segurança Cibernética}},
  title        = {Colinha Digital: dados eleitorais públicos (API v1)},
  year         = {2026},
  howpublished = {\url{https://colinhadigital.com/dados/}},
  note         = {Dados de origem: Tribunal Superior Eleitoral (TSE). Acesso em: 2026-10-10}
}

9Privacidade (LGPD)

• Sem chave: não guardamos nada sobre os seus pedidos além do registro técnico do servidor web (IP, horário e endereço pedido), apagado automaticamente pela rotação de registros. A contagem do limite por IP fica só na memória do servidor.
• Com chave: guardamos o nome do projeto, o e-mail, a data do cadastro, a versão dos termos aceitos, a contagem de pedidos por dia (90 dias) e a data do último uso. Para frear cadastros automáticos, guardamos por até 2 dias uma impressão digital (hash) do IP do cadastro — nunca o IP em si.
• Finalidade do e-mail: exclusivamente contato sobre a API (avisos de mudança, falhas, uso abusivo). Base legal: procedimentos para atender ao seu pedido (art. 7º, V, da LGPD) e legítimo interesse na segurança do serviço (art. 7º, IX). O e-mail nunca é publicado, vendido, compartilhado, usado para propaganda ou campanha, nem entra em relatórios.
• Prazo: enquanto a chave existir. Chave sem uso por 12 meses é apagada com o e-mail. Você mesmo pode apagar tudo a qualquer momento no formulário acima.
• A chave é guardada só como hash: nem a Vorax consegue lê-la depois de criada.
• Seus direitos (acesso, correção, exclusão) e o contato do encarregado estão na Política de privacidade.

?Dúvidas, limite maior ou parceria

Fale com a Vorax pelo WhatsApp +55 92 98466-7519. Para jornais, TVs e rádios há também a versão com a marca do veículo.