# Caixa Leilões - Scraper Completo (`leadercorp/caixa-leiloes-scraper`) Actor

Scraper de imóveis em leilão e venda direta da Caixa Econômica Federal. Retorna dados completos: valores, descontos, datas de leilão, formas de pagamento, matrícula PDF e muito mais.

- **URL**: https://apify.com/leadercorp/caixa-leiloes-scraper.md
- **Developed by:** [Leadercorp](https://apify.com/leadercorp) (community)
- **Categories:** Real estate
- **Stats:** 38 total users, 4 monthly users, 100.0% runs succeeded, 0 bookmarks
- **User rating**: No ratings yet

## Pricing

from $5.00 / 1,000 results

This Actor is paid per event. You are not charged for the Apify platform usage, but only a fixed price for specific events.

Learn more: https://docs.apify.com/actors/running/actors-in-store.md#pay-per-event

## What's an Apify Actor?

Actors are web data automations that power AI and operations. They run on the Apify platform to scrape websites, process data, connect APIs, and automate workflows.
In Batch mode, an Actor accepts a well-defined JSON input, performs an action which can take anything from a few seconds to a few hours,
and optionally produces a well-defined JSON output, datasets with results, or files in key-value store.
In Standby mode, an Actor provides a web server which can be used as a website, API, or an MCP server.
Actors are written with capital "A".

## How to integrate an Actor?

If asked about integration, you help developers integrate Actors into their projects.
You adapt to their stack and deliver integrations that are safe, well-documented, and production-ready.
The best way to integrate Actors is as follows.

- **AI agents and MCP clients** — the [Apify MCP server](https://docs.apify.com/integrations/mcp.md) at `https://mcp.apify.com` (remote, streamable HTTP, OAuth on first use).
- **Agentic workflows and local Actor development** — [Agent Skills](https://apify.com/.well-known/agent-skills/index.json) with the [Apify CLI](https://docs.apify.com/cli/docs.md): `npm install -g apify-cli`, then `apify login`.
- **JavaScript/TypeScript projects** — the official [JS/TS client](https://docs.apify.com/api/client/js/docs.md): `npm install apify-client`.
- **Python projects** — the official [Python client](https://docs.apify.com/api/client/python/docs.md): `pip install apify-client`.
- **Any other language** — the [REST API](https://docs.apify.com/api/v2.md).

For usage examples, see the [API](#api) section below.

For more details, see Apify documentation as [Markdown index](https://docs.apify.com/llms.txt) and [Markdown full-text](https://docs.apify.com/llms-full.txt).

# README

## Caixa Leilões — Scraper Completo

Extrai dados detalhados de imóveis em leilão e venda direta da **Caixa Econômica Federal** (venda-imoveis.caixa.gov.br).

Ao contrário de soluções que retornam apenas os dados básicos do CSV oficial, este scraper acessa a **página de detalhe de cada imóvel** e retorna informações completas: data e hora exata do leilão, formas de pagamento aceitas, link para a matrícula em PDF, foto, descrição completa, dados do cartório e muito mais.

***

### O que este Actor faz

1. Baixa a lista oficial de imóveis do estado escolhido diretamente do CSV da Caixa
2. Filtra por cidade, modalidade, faixa de preço, desconto mínimo e número de quartos
3. Acessa a página de detalhe de cada imóvel individualmente
4. Extrai e estrutura todos os dados disponíveis
5. Salva o resultado no dataset do Apify, pronto para exportar em JSON, CSV ou Excel

***

### Parâmetros de entrada

| Parâmetro | Tipo | Padrão | Descrição |
|---|---|---|---|
| `estado` | string | `SP` | UF do estado (obrigatório). Ex: `SP`, `RJ`, `MG` |
| `cidade` | string | `CAMPINAS` | Nome da cidade para filtrar (obrigatório). Ex: `CAMPINAS`, `BELO HORIZONTE` |
| `bairro` | string | — | Parte do nome do bairro para filtrar (busca parcial) |
| `modalidade` | string | — | Tipo de venda: `4` = 1º Leilão SFI, `5` = 2º Leilão SFI, `2` = Concorrência Pública, `14` = Leilão Edital Único, `21` = Licitação Aberta, `9` = Venda Direta FAR, `34` = Venda Direta Online, `33` = Venda Online |
| `maxResultados` | integer | `0` | Limite de imóveis a processar (0 = sem limite). Útil para testes |
| `precoMinimo` | integer | — | Valor mínimo de venda em reais. Ex: `100000` |
| `precoMaximo` | integer | — | Valor máximo de venda em reais. Ex: `500000` |
| `descontoMinimo` | integer | — | Percentual mínimo de desconto sobre o valor de avaliação. Ex: `30` |
| `quartos` | integer | — | Número mínimo de quartos |
| `delayRequisicoes` | integer | `0` | Pausa em segundos entre requisições |
| `concorrenciaMinima` | integer | `3` | Mínimo de requisições paralelas |
| `concorrenciaMaxima` | integer | `10` | Máximo de requisições paralelas |

***

### Campos retornados

| Campo | Tipo | Descrição |
|---|---|---|
| `numeroImovel` | string | Código único do imóvel na Caixa |
| `estado` | string | UF do estado |
| `cidade` | string | Nome da cidade |
| `bairro` | string | Nome do bairro |
| `cep` | string | CEP do imóvel |
| `endereco` | string | Endereço completo |
| `tipo` | string | Tipo do imóvel (Apartamento, Casa, Terreno, etc.) |
| `quartos` | integer | Número de quartos |
| `garagem` | integer | Número de vagas de garagem |
| `areaPrivativa` | string | Área privativa em m² |
| `areaTerreno` | string | Área do terreno em m² |
| `valorAvaliacao` | number | Valor de avaliação em R$ |
| `valorMinimo` | number | Valor mínimo de venda em R$ |
| `desconto` | number | Percentual de desconto sobre o valor de avaliação |
| `modalidade` | string | Modalidade de venda (ex: Venda Online, 1º Leilão SFI) |
| `dataLeilao` | string | Data e hora do leilão no formato `DD/MM/AAAA HH:MM:SS` |
| `formasPagamento` | array | Lista de formas de pagamento aceitas |
| `regrasDespesas` | array | Regras para pagamento de IPTU, condomínio, etc. |
| `descricao` | string | Descrição completa do imóvel |
| `matricula` | string | Número da matrícula no cartório |
| `comarca` | string | Comarca do cartório de registro |
| `oficio` | string | Número do ofício |
| `inscricaoImobiliaria` | string | Inscrição imobiliária na prefeitura |
| `averbacaoLeiloes` | string | Status de averbação para leilões |
| `urlMatricula` | string | Link direto para o PDF da matrícula do imóvel |
| `foto` | string | URL da foto principal do imóvel |
| `link` | string | Link para a página de detalhe no site da Caixa |
| `coletadoEm` | string | Data e hora da coleta (ISO 8601) |

***

### Exemplo de entrada

```json
{
    "estado": "SP",
    "cidade": "CAMPINAS",
    "modalidade": "5",
    "precoMaximo": 400000,
    "descontoMinimo": 20,
    "quartos": 2,
    "maxResultados": 50
}
```

### Exemplo de saída

```json
{
    "numeroImovel": "10206716",
    "estado": "SAO PAULO",
    "cidade": "CAMPINAS",
    "bairro": "JARDIM SOARES",
    "cep": "13050-430",
    "endereco": "RUA DAS FLORES, N. 123, JD SOARES - CEP: 13050-430, CAMPINAS - SAO PAULO",
    "tipo": "Apartamento",
    "quartos": 2,
    "garagem": 1,
    "areaPrivativa": "62,00",
    "areaTerreno": null,
    "valorAvaliacao": 320000,
    "valorMinimo": 240000,
    "desconto": 25,
    "modalidade": "2º Leilão SFI",
    "dataLeilao": "15/04/2026 10:00:00",
    "formasPagamento": [
        "Financiamento habitacional com recursos FGTS",
        "Exclusivamente à vista (somente recursos próprios)"
    ],
    "regrasDespesas": [
        "Condomínio: Sob responsabilidade do comprador, até o limite de 10% em relação ao valor de avaliação.",
        "Tributos: Sob responsabilidade do comprador."
    ],
    "descricao": "2 Quartos, 1 Vaga na Garagem, Sala, Cozinha, Banheiro.",
    "matricula": "45678",
    "comarca": "CAMPINAS",
    "oficio": "2º OFÍCIO",
    "inscricaoImobiliaria": "3.254.789-0",
    "averbacaoLeiloes": "Sim",
    "urlMatricula": "https://venda-imoveis.caixa.gov.br/editais/matricula/SP/0000010206716.pdf",
    "foto": "https://venda-imoveis.caixa.gov.br/fotos/F000001020671621.jpg",
    "link": "https://venda-imoveis.caixa.gov.br/sistema/detalhe-imovel.asp?hdnimovel=10206716",
    "coletadoEm": "2026-03-31T22:00:00.000Z"
}
```

***

### Desempenho

- **Velocidade:** Utiliza requisições HTTP diretas (sem browser), processando até 10 imóveis simultaneamente
- **Campinas/SP (~60 imóveis):** menos de 1 minuto
- **São Paulo/SP (~3.000 imóveis):** aproximadamente 8 a 15 minutos
- **Brasil inteiro:** recomendado rodar por estado separadamente
- **Proxy:** utiliza IPs residenciais brasileiros automaticamente para garantir acesso ao site

***

### Casos de uso

- Monitorar oportunidades de compra com alto desconto em uma cidade específica
- Alimentar sistemas de alertas imobiliários
- Comparar preços de avaliação com valores de mercado
- Pesquisa e análise do mercado de imóveis em leilão judicial e extrajudicial
- Integração com planilhas, CRMs ou aplicativos via API do Apify

***

### Notas

- Os dados refletem o estado do site no momento da execução. Recomenda-se agendar execuções diárias para manter a base atualizada.
- O campo `dataLeilao` pode estar vazio para imóveis de venda direta (sem data de leilão definida).
- A matrícula em PDF é gerada pelo cartório e pode estar indisponível temporariamente.
- Este Actor respeita os termos de uso do site da Caixa Econômica Federal e utiliza apenas dados públicos.

# Actor input Schema

## `estado` (type: `string`):

Estado para buscar imóveis

## `cidade` (type: `string`):

Nome da cidade para filtrar (ex: CAMPINAS)

## `bairro` (type: `string`):

Nome do bairro para filtrar (parcial)

## `modalidade` (type: `string`):

Tipo de venda/leilão

## `maxResultados` (type: `integer`):

Limite de imóveis a processar (0 = sem limite). Use para testes ou buscas rápidas.

## `precoMinimo` (type: `integer`):

Valor mínimo de venda do imóvel

## `precoMaximo` (type: `integer`):

Valor máximo de venda do imóvel

## `descontoMinimo` (type: `integer`):

Percentual mínimo de desconto em relação ao valor de avaliação

## `quartos` (type: `integer`):

Número mínimo de quartos

## `delayRequisicoes` (type: `integer`):

Pausa entre requisições para evitar bloqueios

## `concorrenciaMinima` (type: `integer`):

Número mínimo de requisições simultâneas

## `concorrenciaMaxima` (type: `integer`):

Número máximo de requisições simultâneas

## Actor input object example

```json
{
  "estado": "SP",
  "cidade": "CAMPINAS",
  "bairro": "JARDIM SOARES",
  "modalidade": "",
  "maxResultados": 10,
  "precoMinimo": 100000,
  "precoMaximo": 500000,
  "descontoMinimo": 20,
  "quartos": 2,
  "delayRequisicoes": 0,
  "concorrenciaMinima": 3,
  "concorrenciaMaxima": 10
}
```

# Actor output Schema

## `dataset` (type: `string`):

Lista completa de imóveis em leilão com todos os detalhes (endereço, valores, descontos, etc)

## `statistics` (type: `string`):

Resumo da busca: total de imóveis encontrados, filtros aplicados, timestamp de execução

# API

You can run this Actor programmatically using our API. Below are code examples in JavaScript, Python, and CLI, as well as the OpenAPI specification and MCP server setup.

## JavaScript example

```javascript
import { ApifyClient } from 'apify-client';

// Initialize the ApifyClient with your Apify API token
// Replace the '<YOUR_API_TOKEN>' with your token
const client = new ApifyClient({
    token: '<YOUR_API_TOKEN>',
});

// Prepare Actor input
const input = {};

// Run the Actor and wait for it to finish
const run = await client.actor("leadercorp/caixa-leiloes-scraper").call(input);

// Fetch and print Actor results from the run's dataset (if any)
console.log('Results from dataset');
console.log(`💾 Check your data here: https://console.apify.com/storage/datasets/${run.defaultDatasetId}`);
const { items } = await client.dataset(run.defaultDatasetId).listItems();
items.forEach((item) => {
    console.dir(item);
});

// 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/js/docs

```

## Python example

```python
from apify_client import ApifyClient

# Initialize the ApifyClient with your Apify API token
# Replace '<YOUR_API_TOKEN>' with your token.
client = ApifyClient("<YOUR_API_TOKEN>")

# Prepare the Actor input
run_input = {}

# Run the Actor and wait for it to finish
run = client.actor("leadercorp/caixa-leiloes-scraper").call(run_input=run_input)

# Fetch and print Actor results from the run's dataset (if there are any)
print(f"💾 Check your data here: https://console.apify.com/storage/datasets/{run.default_dataset_id}")
for item in client.dataset(run.default_dataset_id).iterate_items():
    print(item)

# 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/python/docs/quick-start

```

## CLI example

```bash
echo '{}' |
apify call leadercorp/caixa-leiloes-scraper --silent --output-dataset

```

## MCP server setup

```json
{
    "mcpServers": {
        "apify": {
            "type": "http",
            "url": "https://mcp.apify.com/?tools=fetch-actor-details,leadercorp/caixa-leiloes-scraper"
        }
    }
}

```

The hosted server signs you in with OAuth on first connect, so no API token belongs in this config. Clients without OAuth support can send an `Authorization: Bearer <APIFY_API_TOKEN>` header instead, using a token from API & Integrations in Apify Console (https://console.apify.com/settings/integrations).

## OpenAPI specification

Download the OpenAPI definition: https://api.apify.com/v2/actors/l3QeUiJVEtg15dpH2/builds/FZzftoUdhlQlshdPd/openapi.json