# Caixa Imóveis & Leilões Scraper: Brazil Property Auctions (`automatic/caixa-imoveis-leiloes-scraper`) Actor

Caixa imóveis and leilões scraper: every property Caixa Econômica Federal sells in Brazil, from venda direta to leilão SFI. Minimum price, appraisal, discount, auction dates, FGTS and financing, matrícula and edital PDFs, photos. Filter by state, city, mode and discount; daily alerts.

- **URL**: https://apify.com/automatic/caixa-imoveis-leiloes-scraper.md
- **Developed by:** [Philip Kirkbride](https://apify.com/automatic) (community)
- **Categories:** Real estate, Lead generation
- **Features:** Limited permissions
- **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, 0 bookmarks
- **User rating**: No ratings yet

## Pricing

from $1.50 / 1,000 properties

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

## Caixa Imóveis & Leilões Scraper: Brazil Bank Property Auctions API

Every property Caixa Econômica Federal is selling, in one clean
spreadsheet: *venda direta online*, *venda online*, *licitação aberta*
and *leilão SFI*, in all 27 states. Pick the states, cities and filters
you care about, press Start, and get the minimum price, the appraisal
value, the discount, the auction dates and the documents you need to
decide on a bid.

- **The numbers that matter to an investor.** Minimum sale price,
  *valor de avaliação*, discount, and for SFI auctions the 1st and 2nd
  round minimums with the 2nd-round discount already worked out.
- **Auction calendar.** Date and time of the *licitação aberta* or of the
  1st and 2nd *leilão*, the edital number and item, the auctioneer and
  the auctioneer's bidding site.
- **Due-diligence links.** *Matrícula* PDF, edital and annexes PDF,
  registry office (*comarca*, *ofício*), *inscrição imobiliária* and the
  negative-auction annotation status.
- **Buying conditions.** Financing, FGTS, cash-only, who pays
  condominium fees and IPTU, and the notes Caixa adds (occupied, liens,
  unregistered area, regularisation by the buyer).
- **Photos, full address and CEP**, bedrooms, garage spaces and every
  area Caixa publishes (total, private, land).
- **Daily alerts.** Turn on *only new or changed* and each scheduled run
  returns just the properties that appeared or changed price, discount,
  sale mode or financing since the last run.
- **Know when a property is sold.** Add *sold or withdrawn* alerts and
  each property that leaves Caixa's list comes back once, marked
  `removed`, with its last-known price and details. Close the lead,
  update your pipeline, or track how fast each city sells.

**Ready to run**: the example input returns the 20 biggest discounts in
São Paulo with full details in about a minute.

### Who uses it

- **Auction investors** who check every new Caixa property in their
  states each morning, sorted by discount, before the auction dates.
- **Real estate brokers** (*corretores credenciados*) who follow direct
  sales in their cities and send matching properties to clients.
- **Leilão advisory and alert services** that need a reliable,
  deduplicated feed of Caixa properties with a stable property number.
- **Analysts** who track repossessed-property stock, prices and
  discounts by state, city and property type over time.

### Quick start

All properties for sale in two states:

```json
{"states": ["SP", "RJ"], "maxResults": 500}
```

Houses and apartments in Goiânia, at least 40% below appraisal, that
accept financing:

```json
{
  "states": ["GO"],
  "cities": ["Goiânia"],
  "propertyTypes": ["casa", "apartamento"],
  "minDiscount": 40,
  "financing": "yes",
  "maxResults": 200
}
```

A morning alert of new SFI auctions and open tenders anywhere in Brazil,
plus the ones that were sold or withdrawn (save it as a task and schedule
it daily):

```json
{
  "saleModes": ["leilao_sfi", "licitacao_aberta"],
  "onlyNewSinceLastRun": true,
  "reportRemoved": true,
  "monitoringKey": "leiloes-brasil",
  "maxResults": 5000
}
```

Properties where you can use FGTS, up to R$ 250,000, in Recife:

```json
{"states": ["PE"], "cities": ["Recife"], "fgts": "yes", "maxPrice": 250000}
```

The 100 deepest discounts in Minas Gerais and Rio de Janeiro:

```json
{"states": ["MG", "RJ"], "sortBy": "discount", "maxResults": 100}
```

A fast price list without the property pages (prices, discounts, modes,
areas and rooms only):

```json
{"states": ["RJ"], "includeDetails": false, "maxResults": 10000}
```

### Input

| Field | Type | Default | What it does |
|---|---|---|---|
| `states` | array | all states | UFs to search, e.g. `["SP", "MG"]` (state names such as `Pernambuco` work too). |
| `cities` | array | all cities | City names as you would write them: `São Paulo`, `Belo Horizonte`. Accents, capitals and hyphens do not matter. Include the city's state in `states`, or leave `states` empty. |
| `neighborhoods` | array | all | Neighborhood (*bairro*) names, used with a city. |
| `saleModes` | array | all | `venda_direta_online`, `venda_online`, `licitacao_aberta`, `leilao_sfi`. |
| `propertyTypes` | array | all | `apartamento`, `casa`, `sobrado`, `terreno`, `gleba`, `imovel_rural`, `predio`, `comercial`, `loja`, `sala`, `galpao`, `outros`. |
| `minPrice`, `maxPrice` | integer | none | Range of the minimum sale price, in reais. |
| `minDiscount` | integer | none | Minimum discount against the appraisal, in percent. |
| `minBedrooms` | integer | none | Minimum number of bedrooms. |
| `financing` | string | `any` | `yes` for properties Caixa finances, `no` for cash sales. |
| `fgts` | string | `any` | `yes` for properties where FGTS can be used, `no` for the others. |
| `sortBy` | string | `list` | `list` keeps Caixa's order (state by state, city by city); `discount` returns the largest discounts first, so with `maxResults` you get the best deals of your states, not the first ones. |
| `includeDetails` | boolean | `true` | Add auction dates, documents, photos, payment rules, registry data and CEP. Turn off for a faster price list. |
| `maxResults` | integer | `50` | Stop after this many properties. |
| `onlyNewSinceLastRun` | boolean | `false` | Return only properties not delivered before, plus the ones that changed. |
| `reportRemoved` | boolean | `false` | With `onlyNewSinceLastRun`: also return, once, each delivered property that left Caixa's list (sold, withdrawn or moved to another sale), marked `removed`. |
| `monitoringKey` | string | empty | Name for the saved history, so feeds with different filters keep separate histories. |

Every filter is optional and they can be combined. An empty input (`{}`)
returns the first 50 properties of the national list, state by state.
Leave the connection setting empty.

### Output example

One row per property. Example (an SFI auction house in Acre, with
details):

```json
{"source":"venda-imoveis.caixa.gov.br","country":"BR","propertyNumber":"1444414456176","propertyNumberFormatted":"144441445617-6","title":"MANCIO LIMA - JOSÉ MARTINS","state":"AC","city":"MANCIO LIMA","neighborhood":"JOSÉ MARTINS","address":"RUA RAUL ARANTES MEIRA, N. SN, SETOR 1 QD 155 LT 1","fullAddress":"RUA RAUL ARANTES MEIRA,N. SN SETOR 1 QD 155 LT 1, JOSÉ MARTINS - CEP: 69990-000, MANCIO LIMA - ACRE","cep":"69990-000","propertyType":"Casa","propertyTypeCode":"casa","saleMode":"Leilão SFI - Edital Único","saleModeCode":"leilao_sfi","price":356350.63,"appraisalValue":345641.0,"discountPercent":0.0,"firstAuctionPrice":356350.63,"secondAuctionPrice":306973.58,"secondAuctionDiscountPercent":11.19,"acceptsFinancing":false,"acceptsFgts":true,"cashOnly":false,"paymentMethods":["Recursos próprios.","Permite utilização de FGTS. Consulte condições e enquadramento."],"expenseRules":["Condomínio: Sob responsabilidade do comprador.","Tributos: Sob responsabilidade do comprador."],"notes":[],"totalAreaM2":298.98,"privateAreaM2":298.98,"landAreaM2":925.1,"bedrooms":3,"garageSpaces":1,"livingRooms":1,"features":["a.serv","WC","WC Emp","cozinha"],"description":"Casa, 298.98 de área total, 298.98 de área privativa, 925.10 de área do terreno, 3 qto(s), a.serv, WC, WC Emp, 1 sala(s), cozinha, 1 vaga(s) de garagem.","detailDescription":"3 Quartos, 1 Vaga na Garagem, Área de Serviço, 4 Wc, wc Emp, Sala, Cozinha.","registryNumbers":"1513","registryDistrict":"MANCIO LIMA-AC","registryOffice":"01","municipalRegistration":"71551100","negativeAuctionsRecord":"Não se aplica","edital":"0058/0226 - CPA/RE","editalItem":"1","editalUrl":"https://venda-imoveis.caixa.gov.br/editais/EL00580226CPARE.PDF","editalPublishedAt":"2026-11-12T07:38:14-03:00","auctioneer":"PATRÍCIA GRACIELE DE ANDRADE SOUSA","auctioneerSite":"https://www.pwleiloes.com.br","auctionDate":"2027-01-11T10:00:00-03:00","firstAuctionDate":"2027-01-11T10:00:00-03:00","secondAuctionDate":"2027-01-15T10:00:00-03:00","auctionEvents":[{"label":"Data do 1º Leilão","date":"2027-01-11T10:00:00-03:00"},{"label":"Data do 2º Leilão","date":"2027-01-15T10:00:00-03:00"}],"registryPdfUrl":"https://venda-imoveis.caixa.gov.br/editais/matricula/AC/1444414456176.pdf","photos":["https://venda-imoveis.caixa.gov.br/fotos/F144441445617621.jpg"],"mainPhotoUrl":"https://venda-imoveis.caixa.gov.br/fotos/F144441445617621.jpg","brokersUrl":null,"detailUrl":"https://venda-imoveis.caixa.gov.br/sistema/detalhe-imovel.asp?hdnimovel=1444414456176","listGeneratedOn":"2026-11-13","detailsIncluded":true,"detailIssue":null,"changeType":null,"removedAt":null,"sourceQuery":"states AC","scrapedAt":"2026-11-15T19:40:00+00:00"}
```

What the fields mean:

- `propertyNumber`: Caixa's 13-digit property number, the same on every
  run. Use it to join, deduplicate and track a property.
- `price`: the minimum sale price in reais. For *leilão SFI* it is the
  1st auction minimum; `secondAuctionPrice` is the 2nd round minimum and
  `secondAuctionDiscountPercent` how far that is below the appraisal.
- `discountPercent`: the discount Caixa publishes against
  `appraisalValue`.
- `auctionDate`, `firstAuctionDate`, `secondAuctionDate`: Brasília time
  (`-03:00`), as published. `auctionEvents` keeps every dated line of the
  page with its own label.
- `acceptsFinancing` comes from Caixa's list; `acceptsFgts`, `cashOnly`,
  `paymentMethods` and `expenseRules` come from the property page.
- `notes`: Caixa's remarks about the property, word for word.
- `registryPdfUrl` and `editalUrl`: direct links to the *matrícula* and
  the edital with its annexes.
- `brokersUrl`: Caixa's list of accredited brokers for direct sales.
- Areas of 0 in Caixa's list mean "not given" and are returned empty.
- `listGeneratedOn`: the day Caixa generated the state list the row
  comes from.
- `changeType`: `new` or `changed` in "only new or changed" runs, and
  `removed` for a property that left Caixa's list (with `reportRemoved`).
  A `removed` row carries the last-known price, address and auction
  details, and `removedAt` says when the run noticed it was gone.
- With `includeDetails` off, the property page fields are empty and
  `detailsIncluded` is `false`.

### Daily alerts

1. Set your filters and turn on `onlyNewSinceLastRun`.
2. Give the feed a `monitoringKey`, e.g. `sp-apartamentos`.
3. Save the input as a task and schedule it daily, or several times a
   day.

The first run returns everything that matches and remembers it. Each
later run returns only new properties and the ones whose price,
appraisal, discount, sale mode, financing, address or description
changed, marked `new` or `changed`. When Caixa has not published a new
list for a state since the last run, that state is skipped right away,
so frequent schedules stay quick and cheap. The history is kept in your
own Apify account.

Turn on `reportRemoved` to also hear about properties that are gone:
each one is delivered once, marked `removed`, the first time a freshly
downloaded list no longer has it. A property is never reported as
removed because a list could not be read; and when a large share of a
state disappears at once, the Actor waits for Caixa's next list to
confirm it before reporting. Set `maxResults` high enough for a full day of new
properties; anything above the limit is delivered on the next run.

### Pricing

Pay per result:

- **$1.50 per 1,000 properties** delivered ($0.0015 each).
- **$0.005 per run start**. The start event is charged per GB of memory;
  the default 512 MB run is one start event.

Runs that find nothing new deliver no rows and pay only the start.

### FAQ

**How fresh is the data?** Every run reads Caixa live. Caixa regenerates
its state lists once a day, and the property pages (dates, documents,
payment rules) are read at run time.

**How many properties are there?** About 24,000 nationwide, with Rio de
Janeiro, Goiás and São Paulo listing the most.

**What if my city is not found?** Write the city as it is commonly
written; accents, capitals and hyphens are ignored. A city that is not
in the lists of the states you chose is skipped and named in the run's
status, with a hint when it belongs to another state ("Recife: add PE to
states"); the rest of the search still runs. If nothing matches at all,
the run succeeds with no rows and says why.

**Do I get properties that are already sold?** No. When Caixa's page
says a property is no longer for sale, even though it is still in the
day's list, it is left out and not charged.

**Is "Exercício de Direito de Preferência" included?** No. That mode is
only for the former owner of the property and is not part of Caixa's
public list.

**What if a property page cannot be read?** The row is still delivered
with the list fields and `detailIssue` explaining what is missing. In
"only new or changed" runs it is held back and delivered on the next
run, so it is never reported as a change by mistake.

**Can I bid through the Actor?** No. Use `auctioneerSite` or
`detailUrl` to bid or make a proposal on the official sites.

### Good to know

- "Changed" follows Caixa's list: price, appraisal, discount, sale mode,
  financing, address and description. A new auction date or edital
  alone does not count as a change, which keeps frequent alert runs
  fast. Every delivered row still carries the current dates.
- Property details read one page per property, about 3,000 properties
  an hour. A first alert run over a large area (for example every SFI
  auction in Brazil) can stop at the run timeout; the next runs pick up
  the rest before reporting only what is new. For a quick overview,
  turn `includeDetails` off.
- `sortBy: "discount"` ranks by the discount in Caixa's list. For
  *leilão SFI* the list only carries the 1st round, which is usually at
  or above the appraisal, so SFI auctions rank after discounted direct
  sales; their 2nd-round discount is in each row. To browse auctions
  only, filter `saleModes` to `leilao_sfi`.
- Caixa's list prints city names in capitals without accents
  (`SAO PAULO`); your filters match either way.
- Values are as published by Caixa and may change after the run; the
  edital is the binding document.
- If Caixa cannot be read, the run says so plainly and keeps any rows
  already saved.

For help, contact us from the Actor page and include the run URL.

# Actor input Schema

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

States to search, e.g. SP and RJ. Leave empty for all 27 states.

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

Optional city names, written as you would say them: 'São Paulo', 'Rio de Janeiro', 'Goiânia'. Accents, capitals and hyphens do not matter. Select the city's state above, or leave States empty. Leave empty for every city of the chosen states.

## `neighborhoods` (type: `array`):

Optional neighborhood names, e.g. 'Campo Grande' or 'Copacabana'. Use together with a city.

## `saleModes` (type: `array`):

Which ways of selling to include. Leave empty for all of them.

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

Which property types to include. Leave empty for all of them.

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

Only properties whose minimum sale price is at least this, in reais.

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

Only properties whose minimum sale price is at most this, in reais.

## `minDiscount` (type: `integer`):

Only properties priced at least this many percent below their appraisal value, e.g. 40.

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

Only properties with at least this many bedrooms (quartos).

## `financing` (type: `string`):

Keep only properties Caixa will finance (yes), only cash sales (no), or both.

## `fgts` (type: `string`):

Keep only properties where FGTS can be used (yes), where it cannot (no), or both. This filter reads each property page.

## `sortBy` (type: `string`):

Caixa's order (state by state, city by city), or the largest discount first. With 'largest discount first' and a maximum, you get the best deals of the chosen states, not the first ones; every chosen state's list is read before the property pages.

## `includeDetails` (type: `boolean`):

Add auction dates, 1st and 2nd auction prices, edital, matrícula and photos, FGTS, payment and expense rules, registry office and the full address with CEP. Turn off for a faster price-list run.

## `maxResults` (type: `integer`):

Stop after this many properties. Caixa lists about 24,000 nationwide.

## `onlyNewSinceLastRun` (type: `boolean`):

Deliver only properties this feed has not delivered before, plus the ones whose price, discount, sale mode or financing changed, with changeType set to new or changed. The history is kept in a named key-value store in your account, so a daily schedule becomes an alert feed.

## `reportRemoved` (type: `boolean`):

With 'Only new or changed' on: when a property this feed delivered disappears from Caixa's list (sold, withdrawn or moved to another sale), deliver it once more with changeType 'removed', its last-known details and removedAt. Each removed row counts as one property.

## `monitoringKey` (type: `string`):

Optional name for the saved history, up to 64 characters, e.g. 'sp-apartamentos'. Use a different key for each feed with different filters.

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

Leave empty: the Actor chooses its connection itself.

## Actor input object example

```json
{
  "states": [
    "SP"
  ],
  "cities": [],
  "neighborhoods": [],
  "financing": "any",
  "fgts": "any",
  "sortBy": "discount",
  "includeDetails": true,
  "maxResults": 20,
  "onlyNewSinceLastRun": false,
  "reportRemoved": false,
  "monitoringKey": ""
}
```

# Actor output Schema

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

No description

## `summary` (type: `string`):

OUTPUT record: status (complete, partial, no_results or failed), items delivered, the states read, statesUnchanged (monitor runs: state lists Caixa has not regenerated since the last run), failedStates with a reason, skippedSearches (unknown states, or cities and neighborhoods not in the lists read, with a reason), notPublished (listed properties whose page says they are no longer for sale; skipped, not charged), the list generation date, new/changed counts in monitor mode and the stop reason.

# 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 = {
    "states": [
        "SP"
    ],
    "cities": [],
    "neighborhoods": [],
    "sortBy": "discount",
    "includeDetails": true,
    "maxResults": 20,
    "onlyNewSinceLastRun": false,
    "reportRemoved": false,
    "monitoringKey": ""
};

// Run the Actor and wait for it to finish
const run = await client.actor("automatic/caixa-imoveis-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 = {
    "states": ["SP"],
    "cities": [],
    "neighborhoods": [],
    "sortBy": "discount",
    "includeDetails": True,
    "maxResults": 20,
    "onlyNewSinceLastRun": False,
    "reportRemoved": False,
    "monitoringKey": "",
}

# Run the Actor and wait for it to finish
run = client.actor("automatic/caixa-imoveis-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 '{
  "states": [
    "SP"
  ],
  "cities": [],
  "neighborhoods": [],
  "sortBy": "discount",
  "includeDetails": true,
  "maxResults": 20,
  "onlyNewSinceLastRun": false,
  "reportRemoved": false,
  "monitoringKey": ""
}' |
apify call automatic/caixa-imoveis-leiloes-scraper --silent --output-dataset

```

## MCP server setup

```json
{
    "mcpServers": {
        "apify": {
            "type": "http",
            "url": "https://mcp.apify.com/?tools=fetch-actor-details,automatic/caixa-imoveis-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/BJsYtBf56TGuT1rFJ/builds/r9THLpeQLjS1zhmMb/openapi.json
