Como este portal funciona

O que este portal não faz

Fontes

Endereços exatos

• TSE — dados abertos: arquivos consolidados de candidaturas, bens declarados, prestação de contas e pesquisas registradas, em cdn.tse.jus.br/estatistica/sead/odsele.
• TSE — DivulgaCandContas: detalhe de cada candidatura (foto oficial, documentos anexados, composição da chapa, marcas do registro), em divulgacandcontas.tse.jus.br/divulga/rest/v1.
• Câmara dos Deputados: votações nominais em plenário, cota parlamentar e proposições apresentadas, em dadosabertos.camara.leg.br/api/v2.
• Senado Federal: votações nominais dos senadores em exercício, em legis.senado.leg.br/dadosabertos.

Como os dados são cruzados

Um candidato do TSE e um parlamentar da Câmara ou do Senado são a mesma pessoa em bases que não conversam entre si. O cruzamento é feito assim:

• Câmara — por CPF. A API expõe o CPF do deputado, então o casamento é por documento e não deixa margem a erro.
• Senado — por nome completo e UF. A API do Senado não expõe CPF. O vínculo só é aceito quando o par nome+estado corresponde a exatamente uma candidatura; havendo qualquer ambiguidade, preferimos não vincular a vincular errado. Por isso alguns senadores candidatos aparecem sem a seção de atuação parlamentar.

Frequência de atualização

A ingestão roda automaticamente todo dia às 6h. O TSE republica os arquivos consolidados uma vez por dia, de madrugada; consultar com mais frequência não traria dado novo. A data e a hora da última carga bem-sucedida de cada conjunto estão na tabela acima e no rodapé de todas as páginas.

Limites conhecidos

• Percentuais de pesquisa não existem em dado aberto. O TSE publica o registro da pesquisa, não o resultado. Os números por candidato ficam no PDF do protocolo. Por isso a página de pesquisas mostra contratante, custo, amostra e metodologia — e não um gráfico de intenção de voto.
• Os anexos do registro não têm endereço público estável. Sabemos quais documentos cada candidatura anexou — certidões criminais de 1º e 2º grau, federais e estaduais, e o plano de governo — porque a API lista nome e tipo de cada um. O arquivo em si só é acessível pela página oficial da candidatura, para onde levamos o leitor. Enquanto for assim, não há como extrair e organizar o texto dos planos de governo por tema.
• A cota parlamentar não está disponível. O endpoint da Câmara que servia os gastos da cota do gabinete responde com lista vazia para todos os deputados e todos os anos consultados. Enquanto continuar assim, a seção de cota não aparece nas páginas — preferimos a ausência declarada a um zero que pareceria gasto nenhum.
• Prestação de contas é parcial. Os valores financeiros refletem o que foi entregue até a última carga e mudam a cada novo relatório da campanha.
• Situação da candidatura muda. Registro deferido, indeferido, em recurso, renúncia e substituição são estados que se alteram ao longo do processo. A página mostra o estado da última carga, com a data à vista.

Quando o dado muda

Declaração de bens é retificável, situação de julgamento muda ao longo do processo, candidatura é substituída. Um portal que mostra só o valor de hoje faz o leitor concluir que a notícia de ontem estava errada — quando na verdade os dois estavam certos, em momentos diferentes.

Por isso, a cada sincronização comparamos os campos que importam — patrimônio declarado, situação de julgamento, situação de cassação, partido, coligação, teto de gasto e nome de urna — com o que já tínhamos, e anotamos a diferença. Quando há alteração, ela aparece numa seção O que mudou nesta candidatura na página do candidato, com data, valor anterior e valor novo. Esse registro é nosso, não do TSE, e começa na data em que passamos a acompanhar: alterações anteriores a ela não foram capturadas.

Conformidade

O portal foi construído para caber nas regras da Justiça Eleitoral sobre tratamento de informação eleitoral: sem ranqueamento, sem juízo de valor, sem propaganda paga, com ordenação neutra declarada e carimbo de origem e data em todas as telas. Cada página de candidatura traz o link para o registro oficial correspondente, para que qualquer informação possa ser conferida na fonte.