Pular para conteúdo

Tribunal Superior Eleitoral — dados eleitorais (tse)

O tse-fetcher coleta do repositório de dados eleitorais do Tribunal Superior Eleitoral (TSE), no CDN de estatísticas eleitorais (cdn.tse.jus.br/estatistica/sead/odsele), quatro conjuntos de arquivos ZIP: candidatos, bens de candidatos, votação nominal por município e zona, e prestação de contas de campanha. O conversor do lake declara doze datasets; os quatro primeiros abaixo têm dados convertidos, os oito seguintes são reconhecidos pelo conversor mas não são baixados pelo fetcher (estado so-bruto).

Dataset O que é Origem Período no bruto Estado Página
candidatos Candidaturas registradas, com perfil e situação de totalização consulta_cand_<ano>.zip 2018 a 2026 convertido candidatos
bens-candidatos Bens declarados pelas candidaturas bem_candidato_<ano>.zip 2018 a 2026 convertido bens-candidatos
votacao-munzona Votos nominais por candidatura, município e zona votacao_candidato_munzona_<ano>.zip 2018, 2020, 2024 (2022 e 2026 no bruto, não abertos) convertido votacao-munzona
prestacao-contas Receitas e despesas de campanha (quatro tabelas num dataset, separadas pela partição tabela) prestacao_de_contas_eleitorais_candidatos_<ano>.zip 2020 a 2026 convertido prestacao-contas
votacao-secao Votos por seção eleitoral votacao_secao_<ano>_<UF>.zip não baixado so-bruto votacao-secao
detalhe-votacao-munzona Totais da apuração por município e zona detalhe_votacao_munzona_<ano>.zip não baixado so-bruto detalhe-votacao-munzona
detalhe-votacao-secao Totais da apuração por seção detalhe_votacao_secao_<ano>.zip não baixado so-bruto detalhe-votacao-secao
eleitorado Perfil do eleitorado perfil_eleitorado_<ano>.zip não baixado so-bruto eleitorado
redes-sociais Redes sociais informadas pelas candidaturas rede_social_candidato_<ano>.zip não baixado so-bruto redes-sociais
motivo-cassacao Motivos de indeferimento, cassação ou não diplomação motivo_cassacao_<ano>.zip não baixado so-bruto motivo-cassacao
vagas Vagas em disputa por cargo e unidade eleitoral consulta_vagas_<ano>.zip não baixado so-bruto vagas
boletim-urna Boletins de urna bweb_<turno>_<UF>_<data>.zip não baixado so-bruto boletim-urna

Como o TSE publica

  • O portal de dados abertos (dadosabertos.tse.jus.br) organiza os conjuntos por ano (candidatos-<ano>, resultados-<ano>, prestacao-de-contas-eleitorais-<ano>, eleitorado-<ano>). Todos os conjuntos conferidos declaram a licença Creative Commons Attribution (CC BY). Candidatos e resultados declaram atualização diária; a prestação de contas não declara frequência. Cada arquivo traz a data e a hora de geração nas colunas DT_GERACAO e HH_GERACAO.
  • Os arquivos ficam no CDN em ZIP por ano. Dentro de cada ZIP há um CSV por unidade da federação, o consolidado BRASIL e, nas eleições gerais, o BR (candidaturas de abrangência nacional); o leiame.pdf descreve o layout. A prestação de contas é um ZIP nacional por ano, com quatro famílias de CSV e quatro leiame_*.pdf.
  • Os CSV usam Latin-1, ponto e vírgula e aspas duplas em todos os campos, inclusive os numéricos. Campos de texto livre (descrição de bem, histórico) podem conter quebra de linha dentro das aspas.
  • O LEIAME define marcadores: #NULO (campo em branco, -1 nos numéricos), #NE (informação não registrada naquele ano, -3) e -4 (dado pessoal não divulgável). O LEIAME de 2024 informa que o CPF do candidato não é divulgado naquele ano (art. 33, § 2º, da Resolução TSE nº 23.609/2019).

O que vale para todos os datasets

  • Dupla contagem (corrigida). O BRASIL repete as UFs e o BR. Até a versão 0.3.3 o conversor lia os três, e as linhas apareciam em dobro. Agora, em candidatos, bens-candidatos, votacao-munzona e prestacao-contas, o BRASIL só é lido quando o ZIP não tem os arquivos por UF, e o BR vai para uf=br. Conferido em candidatos e bens-candidatos (2018) e nas contagens de votacao-munzona (2018, 2020, 2024): o BRASIL tem exatamente as linhas das UFs mais o BR. Lake gerado antes da correção: apague a pasta do dataset e reconverta (veja o CHANGELOG.md).
  • Tudo é texto. O lake guarda todas as colunas como texto, incluindo valores em reais com vírgula decimal e datas dd/mm/aaaa, e os marcadores #NULO, #NE, -1, -3 e -4 ficam literais.
  • Dados pessoais. Candidaturas e prestação de contas trazem nomes, CPF, título de eleitor, data de nascimento, gênero e cor/raça. São públicos por lei eleitoral, mas pessoais; cada página lista as colunas no cabeçalho como inventário.
  • Eleições suplementares vêm dentro do arquivo do ciclo ordinário correspondente.

Quebras que valem para mais de um conjunto

Desde Mudança Afeta
2020 Prestação de contas passa a ser um arquivo nacional único por ano; os arquivos por UF anteriores foram removidos do CDN prestacao-contas
2024 CPF do candidato não divulgado (-4); situação do registro de candidatura deixa de ser preenchida (#NE) candidatos
2020 Colunas de diploma da votação por município e zona mudam de nome (..._diploma para ..._dconst_diploma) votacao-munzona