Pular para o conteúdo
Apuração Brasil

API de dados

Os mesmos dados do portal, em JSON, para integrar ao seu sistema, redação ou painel: votos, gastos, emendas, quem recebeu, contratos públicos e sanções. Registros oficiais da Câmara, do Senado, da CGU e do PNCP, atualizados todo dia.

Como começar

  1. Assine o plano Profissional.
  2. Em Minha conta, gere uma chave (até 3 ativas). Ela aparece uma vez só: guarde em lugar seguro.
  3. Mande a chave no cabeçalho Authorization: Bearer ab_… (ou X-Api-Key).
curl -H "Authorization: Bearer ab_SUA_CHAVE" \
  "https://apuracaobrasil.com/api/dados/v1/parlamentares?uf=ba&casa=camara"

Cota: 20.000 consultas por mês por conta (somando as chaves), renovada no dia 1º. Até 120 consultas por minuto por chave. Cada resposta traz os cabeçalhos X-Cota-Limite e X-Cota-Usada. Precisa de mais? Fale com a gente.

Caminhos

  • GET /api/dados/v1/parlamentares
    Deputados federais e senadores · filtros: uf, casa (camara | senado), partido, emExercicio=todos
  • GET /api/dados/v1/parlamentares/{id}
    Ficha resumida, com gastos do ano e emendas desde 2023
  • GET /api/dados/v1/parlamentares/{id}/votos
    Votações nominais e o voto · filtros: desde, ate (AAAA-MM-DD)
  • GET /api/dados/v1/parlamentares/{id}/gastos
    Cota parlamentar, lançamento por lançamento · filtros: ano
  • GET /api/dados/v1/parlamentares/{id}/emendas
    Emendas indicadas: empenhado e pago · filtros: ano
  • GET /api/dados/v1/parlamentares/{id}/proposicoes
    Propostas de autoria
  • GET /api/dados/v1/municipios/{ibge}
    Município (código IBGE de 7 dígitos) e totais de emendas
  • GET /api/dados/v1/municipios/{ibge}/emendas
    Emendas destinadas à cidade · filtros: ano
  • GET /api/dados/v1/municipios/{ibge}/pagamentos
    Quem recebeu os pagamentos de emenda na cidade · filtros: ano
  • GET /api/dados/v1/municipios/{ibge}/contratos
    Contratos publicados no PNCP · filtros: desde, ate
  • GET /api/dados/v1/empresas/{cnpj}
    Resumo do CNPJ e sanções registradas (CEIS, CNEP, CEPIM)
  • GET /api/dados/v1/empresas/{cnpj}/contratos
    Contratos públicos do fornecedor · filtros: desde, ate
  • GET /api/dados/v1/empresas/{cnpj}/pagamentos
    Pagamentos de emendas recebidos · filtros: ano
  • GET /api/dados/v1/contratos
    Contratos por estado (padrão: últimos 30 dias) · filtros: uf (obrigatória), desde, ate, orgaoCnpj
  • GET /api/dados/v1/sancoes
    Sanções registradas de empresas e entidades · filtros: uf, cadastro (CEIS | CNEP | CEPIM), vigentes=1
  • GET /api/dados/v1/uso
    Cota do mês e quanto já foi usado (não conta na cota)

Listas são paginadas: pagina (1, 2, …) e porPagina (até 500, padrão 100). A resposta diz se há mais em temMais. Valores em reais, datas em ISO 8601 (UTC). O id do parlamentar é o mesmo do fim do endereço da ficha no site.

{
  "pagina": 1, "porPagina": 100, "temMais": true,
  "dados": [ { "data": "2026-10-21T22:14:00.000Z", "orgao": "PLEN", "proposicao": "PL 2159/2026", "voto": "Sim", … } ],
  "fonte": "Câmara dos Deputados, Senado Federal, CGU (Portal da Transparência) e PNCP; organizado por apuracaobrasil.com"
}

Respostas de erro

  • 400 filtro inválido (a mensagem diz qual) · 401 chave ausente, inválida ou revogada · 402 plano não está ativo
  • 404 não encontrado · 429 limite por minuto ou cota do mês (veja Retry-After)

Regras de uso

  • Cite a fonte: os órgãos oficiais e o Apuração Brasil.
  • Registros oficiais lado a lado; um registro, sozinho, não indica irregularidade.
  • Dados de pessoa física não saem: CPF mascarado e favorecido pessoa física sem nome.
  • A chave é pessoal da conta: não a coloque em código que roda no navegador.