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:

1{
2    "state": "SP",
3    "city": "SAO PAULO",
4    "mode": 33,
5    "numberOfPages": 50,
6    "sameDomainDelaySecs": 2,
7    "minConcurrency": 1,
8    "maxConcurrency": 5
9}

---

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.

Exemplo de Retorno

Com input isDetailsEnable igual a falso, temos o retorno abaixo

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

Com input isDetailsEnable igual a verdadeiro, temos o retorno abaixo

1{
2  "evaluationValue": "176.000,00",
3  "minimumSaleValue1": "187.000,00",
4  "minimumSaleValue2": "105.600,00",
5  "minimumSaleValue": "105.600,00",
6  "discount": "40,31",
7  "propertyType": "Apartamento",
8  "rooms": "2",
9  "garage": "1",
10  "propertyNumber": "855553241178-4",
11  "registrationNumber": "41550",
12  "district": "JOINVILLE-SC",
13  "office": "03",
14  "realEstateRegistration": "1311000083950314",
15  "auctionRecord": "N",
16  "privateArea": "54,14m2",
17  "landArea": "64,00m2"
18}

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.