Scraper de Imóveis da Caixa Econômica Federal

Um Actor do Apify que realiza scraping de imóveis disponíveis na plataforma de vendas da Caixa Econômica Federal (venda-imoveis.caixa.gov.br). Permite buscar e filtrar imóveis por estado, cidade, tipo, modalidade de venda e faixa de valor.

📋 Índice

• Visão Geral
• Como Usar
  • Via Apify Console
  • Via API do Apify
• Parâmetros de Entrada
• Formato de Saída
• Exemplos
• Suporte

🎯 Visão Geral

Este Actor automatiza a busca de imóveis disponíveis na plataforma da Caixa Econômica Federal. Ele:

• ✅ Busca imóveis por estado e cidade
• ✅ Filtra por tipo de imóvel (Casa, Apartamento)
• ✅ Filtra por modalidade de venda (Leilão, Licitação, Venda Online, Compra Direta)
• ✅ Filtra por faixa de valor
• ✅ Processa automaticamente todas as páginas de resultados
• ✅ Coleta detalhes completos de cada imóvel
• ✅ Retorna dados estruturados em JSON

🚀 Como Usar

Via Apify Console

1. Acesse o Actor no Apify Console

   • Navegue até o Actor no Apify Platform
   • Clique em "Start" para iniciar uma nova execução

2. Configure os Parâmetros de Entrada

   • Preencha os campos obrigatórios: Estado e Cidade
   • Opcionalmente, configure os filtros adicionais
   • Clique em "Start" para iniciar a execução

3. Aguarde a Conclusão

   • O Actor processará todas as páginas automaticamente
   • O progresso pode ser acompanhado em tempo real

4. Baixe os Resultados

   • Após a conclusão, os resultados estarão disponíveis no Dataset
   • Você pode baixar em formato JSON, CSV, Excel, etc.

Via API do Apify

Exemplo em Python

from apify_client import ApifyClient

# Inicializa o cliente
client = ApifyClient("SEU_TOKEN_APIFY")

# Prepara os parâmetros de entrada
run_input = {
    "estado": "SC",
    "cidade_nome": "SAO JOSE",
    "modalidade": "auction",
    "tipo_imovel": "Casa",
    "faixa_valor": "Até R$100.000,00"
}

# Executa o Actor
run = client.actor("pizani/caixa-imoveis-scraper").call(run_input=run_input)

# Aguarda a conclusão e obtém os resultados
for item in client.dataset(run["defaultDatasetId"]).iterate_items():
    print(item)

Exemplo em JavaScript/Node.js

const { ApifyClient } = require('apify-client');

const client = new ApifyClient({
    token: 'SEU_TOKEN_APIFY',
});

const input = {
    estado: "SC",
    cidade_nome: "SAO JOSE",
    modalidade: "auction",
    tipo_imovel: "Casa",
    faixa_valor: "Até R$100.000,00"
};

(async () => {
    const run = await client.actor("pizani/caixa-imoveis-scraper").call(input);
    
    const { items } = await client.dataset(run.defaultDatasetId).listItems();
    console.log(items);
})();

Exemplo com cURL

curl -X POST \
  https://api.apify.com/v2/acts/pizani~caixa-imoveis-scraper/runs \
  -H "Authorization: Bearer SEU_TOKEN_APIFY" \
  -H "Content-Type: application/json" \
  -d '{
    "estado": "SC",
    "cidade_nome": "SAO JOSE",
    "modalidade": "auction",
    "tipo_imovel": "Casa"
  }'

📥 Parâmetros de Entrada

Parâmetros Obrigatórios

Parâmetro	Tipo	Descrição	Exemplo
estado	string	UF do estado onde buscar imóveis	"SC", "SP", "RJ"

Parâmetros Opcionais

Parâmetro	Tipo	Descrição	Valores Possíveis
cidade_nome	string	Nome da cidade (em MAIÚSCULAS)	"SAO JOSE", "SAO PAULO"
modalidade	string	Modalidade de venda	"" (Todos), "auction" (Leilão SFI), "bid" (Licitação aberta), "online" (Venda online), "direct" (Compra Direta)
tipo_imovel	string	Tipo de imóvel	"" (Todos), "Casa", "Apartamento"
faixa_valor	string	Faixa de valor do imóvel	"" (Todas), "Até R$100.000,00", "De R$100.000,01 até R$200.000,00", "De R$200.000,01 até R$400.000,00", "De R$400.000,01 até R$750.000,00", "Acima de R$750.000,00", "Indiferente"

Estados Disponí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

📤 Formato de Saída

Os resultados são salvos no Dataset do Apify no formato JSON. Cada item representa um imóvel com informações completas. Exemplo de um registro:

{
  "id_imovel": "1234567890123",
  "tipo_venda": "AUCTION",
  "titulo": "RESIDENCIAL EXEMPLO",
  "descricao": "2 Quartos, 1 Vaga na Garagem, Área de Serviço, Wc, Sala, Cozinha.",
  "url_imagem": "https://venda-imoveis.caixa.gov.br/fotos/F123456789012321.jpg",
  "valor": "R$ 150.000,00",
  "nome_empreendimento": "RESIDENCIAL EXEMPLO",
  "valores": {
    "valor_avaliacao": "250.000,00",
    "valor_minimo_venda_1_leilao": "250.000,00",
    "valor_minimo_venda_2_leilao": "150.000,00",
    "valor_minimo_venda": "",
    "desconto": "40.00%",
    "texto_completo": "Valor de avaliação: R$ 250.000,00\nValor mínimo de venda 1º Leilão: R$ 250.000,00\nValor mínimo de venda 2º Leilão: R$ 150.000,00\ndesconto de 40.00%"
  },
  "informacoes_principais": {
    "tipo_imovel": "Apartamento",
    "quartos": 2,
    "garagem": 1,
    "numero_imovel": "123456789012-3",
    "matriculas": ["0201234567890123"],
    "comarca": "SAO JOSE-SC",
    "oficio": "02",
    "inscricao_imobiliaria": "0201234567890123",
    "averbacao_leiloes_negativos": "Não se aplica",
    "texto_completo": "Tipo de imóvel: Apartamento\nQuartos: 2\nGaragem: 1\nNúmero do imóvel: 123456789012-3\nMatrícula(s): 0201234567890123\nComarca: SAO JOSE-SC\nOfício: 02\nInscrição imobiliária: 0201234567890123\nAverbação dos leilões negativos: Não se aplica"
  },
  "area": {
    "area_total": "75,50",
    "area_privativa": "58,30",
    "area_terreno": "",
    "texto_completo": "Área total = 75,50 m2\nÁrea privativa = 58,30 m2"
  },
  "informacoes_leilao": {
    "tipo_leilao": "Leilão Único",
    "edital": "0080/0225 - CPA/RE",
    "numero_item": "457",
    "leiloeiro": "NOME DO LEILOEIRO",
    "endereco": "RUA EXEMPLO, N. 123 APTO. 101, BAIRRO EXEMPLO - CEP: 88000-000, SAO JOSE - SANTA CATARINA",
    "descricao": "2 Quartos, 1 Vaga na Garagem, Área de Serviço, Wc, Sala, Cozinha.",
    "condominio": "full",
    "tributos": "buyer",
    "texto_completo": "Leilão Único\nEdital: 0080/0225 - CPA/RE\nNúmero do item: 457\nLeiloeiro(a): NOME DO LEILOEIRO\nEndereço: RUA EXEMPLO, N. 123 APTO. 101, BAIRRO EXEMPLO - CEP: 88000-000, SAO JOSE - SANTA CATARINA\nDescrição: 2 Quartos, 1 Vaga na Garagem, Área de Serviço, Wc, Sala, Cozinha.\nCondomínio: full\nTributos: buyer",
    "datas": [
      {
        "ordem": "1º",
        "tipo": "Leilão",
        "data": "20/01/2026",
        "hora": "10h00"
      },
      {
        "ordem": "2º",
        "tipo": "Leilão",
        "data": "26/01/2026",
        "hora": "10h00"
      }
    ]
  },
  "fotos": [
    "https://venda-imoveis.caixa.gov.br/fotos/F123456789012321.jpg"
  ],
  "link_matricula": "https://venda-imoveis.caixa.gov.br/editais/matricula/SC/1234567890123.pdf",
  "data_coleta": "2026-01-22T03:18:19.164958",
  "created_at": "2026-01-21T07:23:23.000Z",
  "updated_at": null,
  "neighborhood": "BAIRRO EXEMPLO",
  "city": "SAO JOSE",
  "uf": "SC",
  "address": "RUA EXEMPLO, N. 123 APTO. 101, BAIRRO EXEMPLO - CEP: 88000-000, SAO JOSE - SANTA CATARINA",
  "accepts_fgts": 1,
  "accepts_financing": 0,
  "auction_notice_link": "https://venda-imoveis.caixa.gov.br/editais/EL00800225CPARE.PDF",
  "link": "https://venda-imoveis.caixa.gov.br/sistema/detalhe-imovel.asp?hdnimovel=1234567890123",
  "initial_payment": 75000.0,
  "pagina": 1
}

Campos Principais

• id_imovel: Identificador único do imóvel
• tipo_venda: Modalidade (AUCTION, BID, ONLINE, DIRECT)
• valor: Valor do imóvel formatado
• valores: Objeto com valores de avaliação, leilões e descontos
• informacoes_principais: Tipo, quartos, garagem, matrículas, comarca
• area: Área total, privativa e do terreno
• informacoes_leilao: Detalhes do leilão, edital, leiloeiro, datas
• address: Endereço completo do imóvel
• accepts_fgts: Aceita FGTS (1 = sim, 0 = não)
• accepts_financing: Aceita financiamento (1 = sim, 0 = não)
• initial_payment: Valor do pagamento inicial (50% do valor)

Nota: O Actor sempre coleta detalhes completos de cada imóvel, incluindo todas as informações de valores, áreas, leilões e documentação.

## 📞 Suporte

Para questões, problemas ou sugestões:

1. Verifique se os parâmetros estão corretos (especialmente o nome da cidade em maiúsculas)
2. Consulte a documentação do Apify: https://docs.apify.com/
3. Verifique os logs de execução no Apify Console para identificar erros

## 📝 Notas Importantes

- **Nome da Cidade**: Sempre use MAIÚSCULAS e sem acentos. Exemplos:
  - ✅ `"SAO JOSE"` 
  - ✅ `"SAO PAULO"`
  - ✅ `"FLORIANOPOLIS"`
  - ❌ `"São José"`
  - ❌ `"são paulo"`

Caso necessite de ajude, use a aba issues

- **Detalhes Completos**: O Actor sempre coleta detalhes completos de cada imóvel, o que pode aumentar o tempo de execução, mas garante informações mais completas.

- **Paginação Automática**: O Actor processa automaticamente todas as páginas de resultados, não é necessário configurar isso manualmente.

---