# Leilão de Imóveis Caixa Scraper: Mega, Superbid (`allanmxr/brazil-real-estate-auctions`) Actor

Brazilian property auction lots in one flat feed: appraisal value, minimum bid, discount, auction rounds, occupancy, FGTS and financing, edital, matrícula and photos. Covers Caixa repossessed homes, Superbid and Mega Leilões. Filter by state, city, discount and property type.

- **URL**: https://apify.com/allanmxr/brazil-real-estate-auctions.md
- **Developed by:** [Allan Marcelino](https://apify.com/allanmxr) (community)
- **Categories:** Real estate, Lead generation, Automation
- **Features:** Limited permissions
- **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, 0 bookmarks
- **User rating**: No ratings yet

## Pricing

from $3.00 / 1,000 property auction lots

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?

An Actor is a serverless cloud program that runs on the Apify platform. It has two run modes.
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.

Apify vocabulary and the platform model are defined once, in the agent quickstart at https://apify.com/agents.md.

## 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.

Do not guess an integration path. Every one of them is in the agent quickstart at https://apify.com/agents.md: the Apify MCP server, Agent Skills with the Apify CLI, the JavaScript and Python clients, the REST API, and the account-free path for an agent with no human to sign in. It also carries the rule on stating cost before the first paid run.

For examples already wired to this Actor's own input schema, see the [API](#api) section below.

Each client library has reference documentation the quickstart does not restate: [JavaScript/TypeScript](https://docs.apify.com/api/client/js/docs.md) (`npm install apify-client`) and [Python](https://docs.apify.com/api/client/python/docs.md) (`pip install apify-client`).

# README

## Brazil Real Estate Auctions Scraper: Caixa, Superbid and Mega Leilões (leilão de imóveis)

One flat, typed feed of **Brazilian property auctions and bank-repossessed sales**: Caixa Econômica Federal (licitação aberta, venda direta online, leilão SFI), Superbid Imóveis and Mega Leilões. Same fields for every source, so you can sort and compare lots across portals.

### What you get per lot

`source`, `lotId`, `url`, `title`, `propertyType`, `address`, `neighborhood`, `city`, `state`, `zipCode`, `area` (m²), `landArea`, `bedrooms`, `parkingSpots`, `appraisalValue`, `minimumBid`, `discountPct` (over the appraisal), `firstAuctionDate`, `firstAuctionValue`, `secondAuctionDate`, `secondAuctionValue`, `auctionType` (`judicial`, `extrajudicial`, `directSale`, `openBidding`), `saleModality`, `occupancy` (`vacant`, `occupied` or `null` when the portal does not say), `acceptsFinancing`, `acceptsFgts`, `editalUrl`, `matriculaUrl`, `images`, `scrapedAt`.

Only data about the property and the selling companies or agencies. No names, CPF, phones or e-mails of individuals, including debtors in judicial auctions.

### Filters

Sources, states, cities, property types, sale types, occupancy, minimum discount over the appraisal, bid range, area range, bedroom range, financing, FGTS, auction date range and max items. The Max items budget is split between the selected sources.

| Filter | Caixa | Superbid | Mega Leilões |
|---|---|---|---|
| State / city | list per state | whole market, filtered | search path per state and city |
| Occupancy | **not published**, always `null` | from the lot data | from the lot description |
| Accepts FGTS | always known | not published | from the payment terms |
| Accepts financing | always known | when published | from the payment terms |

**Caixa does not inform occupancy** anywhere (list, lot page or edital), so its lots always come with `occupancy: null`. The occupancy filter never guesses: `vacant` or `occupied` return only lots that state it, which leaves every Caixa lot out; add `unknown` to the filter to keep the lots with no stated occupancy.

### How to use

1. Pick states (and cities) and leave the sources on.
2. Set the minimum discount, for example 40, and occupancy `vacant` (Superbid and Mega Leilões only, see above).
3. Run. Results are sorted by best discount inside each source.

Caixa blocks data center IPs, so on Apify the actor reads it through Apify Proxy residential (Brazil). Superbid and Mega Leilões need no proxy. Each portal is listed once per run and the lot pages are opened only for lots that already passed the filters the list can answer.

Caixa regenerates its state lists once a day. The first run of the day stores them, compressed, in a named key-value store of your account (`caixa-csv-cache`, about 1 MB for the whole country, replaced every day); the next runs of that day read them from there, which makes them faster.

### Who it is for

Property investors who buy below appraisal, auction advisors and brokers, real estate funds, lawyers and analysts who track bank repossessions (imóveis retomados) and judicial or extrajudicial auctions across Brazil.

### Example input

```json
{"states": ["SP"], "cities": ["Campinas"], "minDiscountPct": 30, "occupancy": ["vacant"], "maxItems": 50}
```

### Example output

```json
{
    "source": "caixa",
    "lotId": "8444427984549",
    "url": "https://venda-imoveis.caixa.gov.br/sistema/detalhe-imovel.asp?hdnimovel=8444427984549",
    "title": "Apartamento - Mansoes Recreio Estrela D'Alva I, Cidade Ocidental/GO",
    "propertyType": "apartment",
    "neighborhood": "MANSOES RECREIO ESTRELA D'ALVA I",
    "city": "CIDADE OCIDENTAL",
    "state": "GO",
    "zipCode": "72885-770",
    "area": 52.23,
    "bedrooms": 2,
    "appraisalValue": 63000,
    "minimumBid": 6300,
    "discountPct": 90,
    "auctionType": "directSale",
    "saleModality": "Venda Online",
    "occupancy": null,
    "acceptsFinancing": false,
    "acceptsFgts": false,
    "matriculaUrl": "https://venda-imoveis.caixa.gov.br/editais/matricula/GO/8444427984549.pdf",
    "images": ["https://venda-imoveis.caixa.gov.br/fotos/F844442798454921.jpg"],
    "scrapedAt": "2026-11-18T14:09:11+00:00"
}
```

Real lot, trimmed of the `null` fields (`address`, `landArea`, `parkingSpots`, the auction rounds and `editalUrl`). Every lot has all fields.

### Pricing

Pay per event: **US$ 3.00 per 1,000 lots** (US$ 0.003 per lot, event `lot`), charged for each lot written to the dataset. Platform usage (compute and residential proxy) is included.

| Lots | Cost |
|---|---|
| 100 | US$ 0.30 |
| 1,000 | US$ 3.00 |
| 10,000 | US$ 30.00 |

Example: SP and Campinas, 30 lots = US$ 0.09.

### FAQ

**Which sources are covered?** Caixa Econômica Federal (licitação aberta, venda direta online, leilão SFI), Superbid Imóveis and Mega Leilões.

**Why does Caixa never show occupancy?** Caixa does not publish it anywhere. The Actor never guesses: `occupancy` stays `null`.

**How fresh is the Caixa data?** Caixa regenerates its state lists once a day, around 22:00 Brasília time. The Actor reads the list of the current day.

**Do I need a proxy?** No. The Actor uses Apify Proxy residential (Brazil) by itself for Caixa only.

**Is personal data collected?** No. Only property data and the selling companies or agencies.

### Buscas em português

- leilão de imóveis em Campinas, São Paulo, Rio de Janeiro, Curitiba, Belo Horizonte e todo o Brasil
- imóveis da Caixa à venda por estado: licitação aberta, venda direta online e leilão SFI
- apartamentos e casas desocupadas com desconto acima de 40% sobre a avaliação
- imóveis retomados que aceitam FGTS e financiamento
- primeiro e segundo leilão com datas, valor de avaliação, lance mínimo, edital e matrícula
- leilão judicial e extrajudicial de imóveis (Superbid, Mega Leilões)

**Preço:** US$ 3,00 por 1.000 lotes (US$ 0,003 por lote entregue). Exemplo: 100 lotes custam US$ 0,30.

### Other Actors by the same author

- [Brazil Vehicle Auctions Scraper](https://apify.com/allanmxr/brazil-vehicle-auctions-scraper)
- [Brazil Public Tenders Scraper](https://apify.com/allanmxr/brazil-public-tenders)
- [Brazil Real Estate Scraper](https://apify.com/allanmxr/brazil-real-estate-scraper)
- [Mexico Vehicle Auctions Scraper](https://apify.com/allanmxr/mexico-vehicle-auctions-scraper)

# Actor input Schema

## `sources` (type: `array`):

Portals to search. With more than one selected you get a single merged list and Max items is split evenly between them.

## `states` (type: `array`):

Leave empty to search all of Brazil.

## `cities` (type: `array`):

City names, one per line, for example Campinas or São Paulo. Accents and capital letters do not matter. Needs at least one state selected above.

## `propertyTypes` (type: `array`):

Leave empty for all types.

## `occupancy` (type: `array`):

Vacant or occupied, as written in the lot description (Superbid and Mega Leilões). Caixa does not publish occupancy for any lot: choosing Vacant or Occupied without Unknown leaves every Caixa lot out. Add Unknown to keep the lots whose occupancy is not stated.

## `minBedrooms` (type: `integer`):

Lots that do not state bedrooms (land, commercial) are dropped when a bedroom filter is set.

## `maxBedrooms` (type: `integer`):

Highest number of bedrooms.

## `minArea` (type: `number`):

Built or private area of the property.

## `maxArea` (type: `number`):

Built or private area of the property.

## `minDiscountPct` (type: `number`):

Only lots whose minimum bid is at least this much below the appraisal value, for example 40.

## `minPrice` (type: `integer`):

Lowest minimum bid, in reais.

## `maxPrice` (type: `integer`):

Highest minimum bid, in reais.

## `acceptsFinancing` (type: `boolean`):

Keep only lots that state they accept bank financing.

## `acceptsFgts` (type: `boolean`):

Keep only lots that state they accept FGTS. Caixa publishes this for every lot.

## `auctionTypes` (type: `array`):

Leave empty for all. Open bidding (licitação aberta) exists only on Caixa.

## `auctionDateFrom` (type: `string`):

Next auction round on or after this date. Direct sales have no auction date and are dropped when a date is set.

## `auctionDateTo` (type: `string`):

Next auction round on or before this date.

## `maxItems` (type: `integer`):

Total lots across all portals, best discount first inside each portal. The run stops as soon as it is reached and you pay only for the lots delivered.

## `proxyConfiguration` (type: `object`):

Leave empty: the actor already picks the cheapest connection that each portal accepts (Caixa needs Brazilian residential IPs, the others need no proxy). Set a proxy only to force your own.

## Actor input object example

```json
{
  "sources": [
    "caixa",
    "superbid",
    "megaleiloes"
  ],
  "states": [
    "SP"
  ],
  "cities": [
    "Campinas"
  ],
  "acceptsFinancing": false,
  "acceptsFgts": false,
  "maxItems": 30
}
```

# Actor output Schema

## `results` (type: `string`):

All scraped items in the default dataset.

# 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 = {
    "sources": [
        "caixa",
        "superbid",
        "megaleiloes"
    ],
    "states": [
        "SP"
    ],
    "cities": [
        "Campinas"
    ],
    "maxItems": 30
};

// Run the Actor and wait for it to finish
const run = await client.actor("allanmxr/brazil-real-estate-auctions").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 = {
    "sources": [
        "caixa",
        "superbid",
        "megaleiloes",
    ],
    "states": ["SP"],
    "cities": ["Campinas"],
    "maxItems": 30,
}

# Run the Actor and wait for it to finish
run = client.actor("allanmxr/brazil-real-estate-auctions").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 '{
  "sources": [
    "caixa",
    "superbid",
    "megaleiloes"
  ],
  "states": [
    "SP"
  ],
  "cities": [
    "Campinas"
  ],
  "maxItems": 30
}' |
apify call allanmxr/brazil-real-estate-auctions --silent --output-dataset

```

## MCP server setup

```json
{
    "mcpServers": {
        "apify": {
            "type": "http",
            "url": "https://mcp.apify.com/?tools=fetch-actor-details,allanmxr/brazil-real-estate-auctions"
        }
    }
}
```

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/5r9WFir2ObTTqDDaM/builds/l9UPUgl5GNwbfTC7F/openapi.json
