Fontes de dados

Tudo o que um extrato afirma vem de uma destas fontes oficiais — e cada uma tem cobertura, cadência e limitações próprias. Conhecê-las é parte do método: um dado correto lido sem contexto vira conclusão errada.

Câmara dos Deputados — API de Dados Abertos

Endereço: dadosabertos.camara.leg.br · REST, JSON, sem autenticação.

O que cobre: identificação e situação de deputados federais; despesas da CEAP com nota fiscal em PDF (urlDocumento); proposições e tramitações; votações nominais com voto individual e orientação de bancada; participação em eventos; comissões e cargos.

Cadência: dados de despesas e votações são publicados com defasagem de dias; a situação cadastral (licença, vacância) é atualizada continuamente.

Limitações conhecidas:

  • A busca por nome é literal — não tolera variação de acento ou grafia, e opera sobre o nome parlamentar (de urna), não o nome civil.
  • O endpoint de eventos mostra participação registrada, não a frequência oficial — o registro oficial de presença em plenário é publicado separadamente em camara.leg.br.
  • A busca padrão retorna só quem está em exercício: parlamentares licenciados ou afastados exigem consulta por legislatura.
  • A causa de um afastamento não consta na API — exige fonte adicional (Diário da Câmara).

Senado Federal — Dados Abertos + Portal de Transparência

Endereço: legis.senado.leg.br/dadosabertos (JSON via header Accept) · despesas via CSV anual/diário no Portal de Transparência.

O que cobre: lista e detalhe dos 81 senadores em exercício; mandatos, titularidade e suplência; autorias com indicação de autor principal; votações; despesas da CEAPS.

Cadência: o CSV da CEAPS é atualizado diariamente; dados legislativos, continuamente.

Limitações conhecidas:

  • O CSV da CEAPS exige tratamento obrigatório: encoding não-UTF-8 e campos vazios — sem esse tratamento, os totais saem errados (o Playbook 02 detalha; duplicatas são checagem preventiva — zero encontradas na revalidação de 2026).
  • O Senado não publica presença em sessões por senador — o extrato usa proxies (licenças e participação em votações nominais) declarando a limitação.
  • O serviço de discursos trunca silenciosamente janelas maiores que 1 ano (HTTP 200 com dados parciais) — a consulta correta é ano a ano.
  • Votações secretas registram só “Votou”, sem direção — “não pública por regimento”.
  • A API do Senado usa estrutura XML-primeiro convertida; alguns campos mudam de forma entre endpoints.
  • Autoria coletiva pode inflar contagens se o filtro de autor principal não for aplicado.

CLDF — Dados Abertos (CKAN) + PLe

Endereço: dados.cl.df.gov.br (CKAN com datastore consultável por API JSON) · ple.cl.df.gov.br (proposições).

O que cobre: relação nominal mensal de deputados distritais, verba indenizatória (por comprovante, com prestador e CNPJ), remuneração mensal, diárias, proposições (via PLe) e a página oficial de normas aprovadas por parlamentar.

Cadência: relação nominal e remuneração são mensais; verba indenizatória, ~mensal com defasagem de semanas.

Limitações conhecidas (validadas ao vivo em 07/2026):

  • O dataset de verbas indenizatórias é parcial na origem — os arquivos publicados cobrem fração dos 24 gabinetes (5 em 2025; 10 em 2026 até maio). A prestação de contas integral está no Portal da Transparência da CLDF, não no dado aberto. O extrato reporta a cobertura junto com qualquer valor.
  • A busca do datastore é sensível a acentos, e o campo de nome mistura nome civil e nome parlamentar no mesmo recurso.
  • Votações nominais e frequência não existem em dado aberto estruturado — só nas atas/Diário da CLDF (PDF). O extrato declara essa lacuna.
  • O dataset de emendas parlamentares não tem campo de autor — atribuição por parlamentar não é possível pelo dado aberto.

O que este site deliberadamente NÃO usa

  • Fontes secundárias (imprensa, agregadores, wikis): violam a regra da fonte primária — qualquer afirmação sem URL oficial não entra no extrato.
  • Bancos de dados próprios: os dados ficam onde sempre estiveram, nos servidores públicos. A consulta acontece no momento do uso, pela IA do próprio cidadão.
  • Dados eleitorais (TSE, candidaturas, campanhas): fora de escopo por desenho — este projeto cobre apenas mandatos em exercício.

Validação

Os endpoints documentados nos playbooks são validados ao vivo periodicamente — a data da última validação aparece no selo da página inicial e as mudanças relevantes entram no changelog. Encontrou um endpoint fora do ar ou com formato alterado? Reporte: segurança.