Pricing

Rating

Developer

Actor stats

Categories

Share

Caixa Leioes API

Este web scraper permite buscar dados no site de leilões da Caixa federal com filtros específicos por estado, cidade e modo de busca.

Configuração dos Parâmetros

Os parâmetros de busca podem ser configurados no arquivo de configuração JSON ou passados diretamente ao iniciar o scraper. O schema JSON de entrada é descrito a seguir:

• state (string): Estado para buscar. Valores possíveis:
  • AC, AL, AM, AP, BA, CE, DF, ES, GO, MA, MG, MS, MT, PA, PB, PE, PI, PR, RJ, RN, RO, RR, RS, SC, SE, SP, TO.
• city (string): Cidade para buscar (ex.: "SAO PAULO").
• mode (integer): Modo de busca, conforme os tipos disponíveis:
  • 4 - 1º Leilão SFI
  • 5 - 2º Leilão SFI
  • 2 - Concorrência Pública
  • 14 - Leilão SFI - Edital Único
  • 21 - Licitação Aberta
  • 9 - Venda Direta FAR
  • 34 - Venda Direta Online
  • 33 - Venda Online
• numberOfPages (integer): Número máximo de páginas a serem raspadas (máximo 1000), 0 raspa todas as paginas.
• sameDomainDelaySecs (integer): Delay entre requisições ao mesmo domínio (padrão: 1 segundo).
• minConcurrency (integer): Número mínimo de páginas para raspar simultaneamente.
• maxConcurrency (integer): Número máximo de páginas para raspar simultaneamente.
• isDetailsEnable (bool): Indica se a raspagem de detalhes adicionais para cada página deve ser habilitada (true para habilitar, false para desabilitar).

Exemplo de configuração:

{
"state":"SP",
"city":"SAO PAULO",
"mode":33,
"numberOfPages":50,
"sameDomainDelaySecs":2,
"minConcurrency":1,
"maxConcurrency":5
}

Detalhes do Retorno do Scraper

Este documento descreve o formato de retorno dos dados coletados pelo scraper. Cada registro de propriedade contém informações importantes sobre o imóvel, incluindo valores de avaliação, descontos, e características do imóvel.

Estrutura do Retorno

O scraper retorna um objeto JSON com as seguintes propriedades:

• evaluationValue (number): Valor de avaliação do imóvel.

• minimumSaleValue1 (number): Primeiro valor mínimo de venda, geralmente associado a um leilão ou tipo específico de venda.

• minimumSaleValue2 (number): Segundo valor mínimo de venda, utilizado em algumas modalidades que possuem etapas múltiplas de leilão.

• minimumSaleValue (number): Valor mínimo de venda, considerando a menor oferta entre os valores mínimos de venda disponíveis.

• discount (number): Percentual de desconto aplicado ao valor de venda em relação ao valor de avaliação.

• propertyType (string): Tipo do imóvel (ex.: "Apartamento", "Casa", "Comercial", etc.).

• rooms (integer): Número de quartos do imóvel.

• garage (integer): Número de vagas de garagem disponíveis no imóvel.

• propertyNumber (string): Número identificador do imóvel (geralmente fornecido pela imobiliária ou entidade de leilão).

• registrationNumber (string): Número de registro do imóvel, comumente utilizado para identificação no cartório de imóveis.

• district (string): Bairro onde o imóvel está localizado.

• office (string): Cartório onde o imóvel está registrado.

• realEstateRegistration (string): Registro imobiliário do imóvel, utilizado em processos formais de compra e venda.

• auctionRecord (string): Registro de leilão, caso o imóvel esteja em processo de leilão. Esse campo documenta o número ou referência do leilão.

• privateArea (number): Área privativa do imóvel em metros quadrados, ou seja, a área que é exclusivamente do proprietário.

• landArea (number): Área total do terreno em metros quadrados, incluindo área construída e áreas externas do lote.

• matriculaUrl (string): URL completa para download da matrícula do imóvel em formato PDF.

• paymentMethods (array): Lista das formas de pagamento aceitas para o imóvel (ex.: recursos próprios, FGTS, financiamento).

• expenseRules (array): Lista das regras para pagamento das despesas associadas ao imóvel (ex.: condomínio, tributos).

• address (string): Endereço completo do imóvel.

• notice (string): Informações completas do edital do leilão.

• auctioneer (string): Nome do leiloeiro responsável pelo leilão.

• firstAuctionDate (string): Data e horário do primeiro leilão.

• secondAuctionDate (string): Data e horário do segundo leilão (quando aplicável).

• url (string): URL da página de detalhes do imóvel.

Exemplo de Retorno

Com input isDetailsEnable igual a falso, temos o retorno abaixo

{
"price":310000,
"description":"SAO PAULO - RES CLUB HOUSE VILA PRUDENTE | R$ 310.000,00",
"image":"https://venda-imoveis.caixa.gov.br/fotos/F155550814458721.jpg",
"type":"Apartamento",
"rooms":2,
"edital":"0078/0224",
"propertyNumber":"155550814458-7",
"numberItem":566,
"address":"RUA DAS LOBELIAS,N. 380 Apto. 44 BL B, VILA PRUDENTE",
"garage":1
}

Com input isDetailsEnable igual a verdadeiro, temos o retorno abaixo

{
"evaluationValue":"176.000,00",
"minimumSaleValue1":"187.000,00",
"minimumSaleValue2":"105.600,00",
"minimumSaleValue":"105.600,00",
"discount":"40,31",
"propertyType":"Apartamento",
"rooms":"2",
"garage":"1",
"propertyNumber":"855553241178-4",
"registrationNumber":"41550",
"district":"JOINVILLE-SC",
"office":"03",
"realEstateRegistration":"1311000083950314",
"auctionRecord":"N",
"privateArea":"54,14m2",
"landArea":"64,00m2",
"matriculaUrl":"https://venda-imoveis.caixa.gov.br/editais/matricula/SP/1311000083950314.pdf",
"paymentMethods":[
"Recursos próprios.",
"Permite utilização de FGTS. Consulte condições e enquadramento.",
"Permite financiamento - somente SBPE. Consulte condições antes de efetuar a proposta."
],
"expenseRules":[
"Condomínio: Sob responsabilidade do comprador.",
"Tributos: Sob responsabilidade do comprador."
],
"address":"AVENIDA APARECIDA DO RIO NEGRO,N. 33 APTO. 604 TORRE 02 VG 173, 31 SUBD DE PIRITUBA - CEP: 05144-085, SAO PAULO - SAO PAULO",
"notice":"Leilão SFI - Edital Único 0054/0225 - CPA/RE",
"auctioneer":"RUDIVAL ALMEIDA GOMES JUNIOR",
"firstAuctionDate":"29/09/2025",
"secondAuctionDate":"06/10/2025",
"url":"https://venda-imoveis.caixa.gov.br/sistema/detalhe-imovel.asp?hdnOrigem=index&hdnimovel=1311000083950314"
}

Notas

• evaluationValue e minimumSaleValue são valores importantes para o comprador, pois indicam o valor de mercado e o menor valor aceito, respectivamente.
• discount é calculado com base no valor de avaliação e o valor mínimo de venda, permitindo identificar a atratividade da oferta.
• privateArea e landArea são úteis para entender a dimensão real do imóvel e o espaço privativo.