Voltar ao início
API REST · OpenAPI 3.1

Dados eleitorais brasileiros como infraestrutura.

Eleições, pesquisas, médias ponderadas com IC 95% e drift histórico de candidatos — tudo via REST autenticado por Bearer token. Para jornalistas, devs e analistas que precisam construir em cima de dados oficiais consolidados.

openapi.yaml Pegar minha API key Metodologia das médias

Quickstart (60 segundos)

1. Pega tua key no dashboard:

https://electiolab.com/dashboard/api

2. Faz teu primeiro request:

curl -H "Authorization: Bearer el_free_abc123def456" \
  https://electiolab.com/api/v1/elections

3. Resposta:

{
  "data": [
    {
      "id": "...",
      "name": "Presidente 2026",
      "type": "presidente",
      "year": 2026,
      "round": 1,
      "election_date": "2026-10-04",
      "is_active": true
    },
    ...
  ],
  "count": 56
}

Endpoints

MétodoEndpointDescrição
GET/api/v1/elections

Lista todas as eleições (presidente, governador, senador, deputado).

GET/api/v1/polls

Pesquisas eleitorais com resultados por candidato. Suporta CSV.

Params: election_id?, format=json|csv, limit

GET/api/v1/averages

Médias ponderadas com IC 95% — fórmula em /docs/weighted-averages.

Params: election_id?

GET/api/v1/candidates-by-slug

Até 3 candidatos consolidados (média + última pesquisa).

Params: slug (até 3×)

GET/api/v1/drift

Série temporal de % de um candidato em pesquisas (1º turno).

Params: candidate_id, days≤365

GET/api/v1/me

Status da própria API key (tier, rate limit, uso).

Params: Bearer obrigatório

Spec completa em /openapi.yaml — importável em Postman, Insomnia, Bruno ou similar.

Tiers e rate limit

TierLimite mensalPreçoNotas
anonymous60 req/mês—Sem token
free1.000 req/mêsR$ 0Cadastro gratuito
pro50.000 req/mêsR$ 49/mêsInclui CSV export e drift
business500.000 req/mêsR$ 199/mêsInclui SLA + suporte por e-mail

Cada response inclui X-RateLimit-Limit, X-RateLimit-Remaining e X-RateLimit-Reset headers para o cliente saber quando vai bater no teto.

Boas práticas e citação