API pública de imóveis de leilão

Por que existe uma API

A Caixa publica os imóveis em arquivos CSV por estado, em ISO-8859-1, sem filtro e sem estrutura consultável. Para qualquer uso automatizado — monitorar uma cidade, cruzar com outra base, montar um painel — é preciso baixar, converter, normalizar e indexar tudo isso primeiro. É exatamente esse trabalho que a API entrega pronto, em JSON, com os nomes de município corrigidos pela base do IBGE e com campos calculados que não existem na origem.

Ela é gratuita e aberta porque o dado é público. O que pedimos em troca é uso responsável: cache do seu lado, filtros em vez de varredura completa e identificação no User-Agent.

Limites

• 30 requisições por minuto por IP, sem chave.
• Chave gratuita eleva para 120 por minuto — envie em X-API-Key ou ?chave=.
• Uso pesado (espelhar a base inteira várias vezes ao dia) merece chave dedicada: fale com a gente.

Endpoints

{
  "total": 34,
  "pagina": 1,
  "limite": 2,
  "filtros": {
    "uf": "SP",
    "cidade": "campinas",
    "precoMax": 200000
  },
  "resultados": [
    {
      "id": "8555512345678",
      "tipo": "Apartamento",
      "cidade": "Campinas",
      "uf": "SP",
      "bairro": "Jardim das Palmeiras",
      "endereco": "RUA EXEMPLO, N. 100, APTO 32",
      "preco": 145000,
      "avaliacao": 260000,
      "desconto": 44.23,
      "financiamento": true,
      "areaPrivativa": 52.4,
      "quartos": 2,
      "vagas": 1,
      "modalidade": "Venda Direta Online",
      "url": "https://www.imoveisleilaobrasil.com.br/imovel/8555512345678",
      "linkOficial": "https://venda-imoveis.caixa.gov.br/sistema/detalhe-imovel.asp?hdnimovel=8555512345678"
    }
  ]
}

{
  "id": "8555512345678",
  "tipo": "Apartamento",
  "preco": 145000,
  "…": "…"
}

{
  "atualizadoEm": "2026-08-27T01:22:04.439Z",
  "ufs": [
    {
      "uf": "SP",
      "nome": "São Paulo",
      "total": 3128,
      "cidades": 232
    }
  ]
}

{
  "uf": "SP",
  "total": 232,
  "cidades": [
    {
      "slug": "sao-paulo",
      "nome": "São Paulo",
      "total": 574,
      "menorPreco": 47000,
      "ibge": 3550308
    }
  ]
}

{
  "total": 26272,
  "cidades": 1322,
  "descontoMedio": 45.8,
  "comFinanciamento": 1717,
  "geradoEm": "2026-08-26"
}

Estabilidade e mudanças

A API é oferecida como está, sem SLA. Novos campos podem ser acrescentados aos objetos retornados a qualquer momento — por isso, escreva o seu cliente de forma tolerante a campos desconhecidos. Remoções e renomeações de campos existentes são evitadas; quando forem inevitáveis, serão anunciadas na documentação com antecedência.

Os endpoints atuais devem permanecer estáveis. Se o seu uso depende de algum comportamento específico, vale nos avisar — é mais fácil preservar o que sabemos que alguém usa.

Parâmetros de /api/imoveis

Exemplos de uso

Alguns casos que a API resolve bem:

• Monitor pessoal: um script que consulta /api/imoveis?uf=sp&cidade=campinas uma vez por dia, compara com a execução anterior e avisa sobre os IDs novos.
• Planilha de acompanhamento: exportar um recorte para CSV e cruzar com anúncios de mercado para calcular o desconto real por bairro.
• Painel regional: usar /api/ufs e /api/cidades/:uf para montar um mapa de onde há mais oferta e onde os descontos são maiores.
• Estudo de mercado: acompanhar a evolução do estoque de uma cidade ao longo dos meses, guardando o retorno de /api/estatisticas a cada carga.

O que a API não faz: enviar propostas, reservar imóveis ou informar ocupação e dívidas — esses dados não existem na fonte pública. Cada registro traz o linkOficial para a página da Caixa, onde ficam o edital e o formulário de compra.

Boas práticas de uso

• Cacheie do seu lado. A base muda uma vez por dia; consultar o mesmo recorte de minuto em minuto não traz dado novo e consome sua cota.
• Prefira filtros a paginação cega. Buscar ?uf=sp&tipo=casa&precoMax=150000 é mais rápido e mais barato do que varrer a lista inteira.
• Use o campo id como chave estável. É o número do imóvel na Caixa e permanece o mesmo enquanto ele estiver à venda.
• Trate o desaparecimento como normal. Imóvel vendido some da lista; um 404 em /api/imovel/:id costuma significar exatamente isso.
• Identifique-se. Um User-Agent com o nome do seu projeto e um contato ajuda a gente a avisar se algo mudar.

Campos retornados

Cada imóvel traz, além dos dados originais da lista da Caixa, campos calculados aqui:

Origem e licença dos dados

Os dados vêm da lista pública de imóveis da Caixa Econômica Federal, republicada em formato estruturado. São informações públicas; nós apenas normalizamos, corrigimos os nomes de município com a base do IBGE e calculamos campos derivados (preço por m², desconto recalculado). Use à vontade, citando a fonte original. A lista atual foi gerada em 26/08/2026.

A API não é a Caixa e não recebe propostas: para comprar, use o link oficial que vem em cada registro.