# Brazil Judicial Property Auctions Scraper (`allanmxr/brazil-judicial-property-auctions`) Actor

Brazilian court (judicial) and bank (extrajudicial) property auctions: 1st and 2nd round dates and values, appraisal, discount, CNJ process number, court, vara, occupancy and IPTU/condominium debts. Leilões Judiciais, Leilão Imóvel, Portal Zuk, Grupo Lance, Frazão, Biasi.

- **URL**: https://apify.com/allanmxr/brazil-judicial-property-auctions.md
- **Developed by:** [Allan Marcelino](https://apify.com/allanmxr) (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 $4.00 / 1,000 property 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 Judicial Property Auctions Scraper: court and bank auctions (leilão judicial e extrajudicial de imóveis)

One flat, typed feed of **Brazilian court-ordered (judicial) and bank (extrajudicial) property auctions**, with the fields an auction investor checks first: **1st and 2nd round (1ª e 2ª praça) dates and values, appraisal, discount, CNJ process number, court, vara, comarca, occupancy and IPTU / condominium debts**.

Sources: **Leilões Judiciais** (a network of dozens of court auctioneers, 1,800+ properties), **Leilão Imóvel** (aggregator of 75+ court auctioneers; lots already covered by the other sources are left out), **Portal Zuk** (Zukerman: TJSP and banks), **Grupo Lance** (Lance Judicial), **Frazão Leilões** and **Biasi Leilões**. Same fields for every source, so you can sort and compare lots across portals.

Looking for Caixa repossessed homes, Superbid or Mega Leilões? They are in our [Brazil Real Estate Auctions Scraper](https://apify.com/allanmxr/brazil-real-estate-auctions), with the same output fields.

### What you get per lot

| Field | Example | Notes |
|---|---|---|
| `source`, `lotId`, `url` | `zuk`, `37967-236959` | |
| `title`, `propertyType` | `Apartamento - Rua ..., São Paulo/SP`, `apartment` | apartment, house, land, rural, commercial, parking, other |
| `address`, `neighborhood`, `city`, `state`, `zipCode` | `São Paulo`, `SP` | |
| `area`, `landArea` | `66.64` | m² |
| `appraisalValue` | `470549.69` | avaliação |
| `minimumBid`, `discountPct`, `currentRound` | `235274.84`, `50`, `2` | bid of the round now open |
| `firstAuctionDate`, `firstAuctionValue` | `2026-11-17T13:50:00-03:00` | 1ª praça |
| `secondAuctionDate`, `secondAuctionValue` | `2026-12-08T13:50:00-03:00` | 2ª praça |
| `auctionType`, `saleModality` | `judicial` | judicial or extrajudicial |
| `processNumber`, `court` | `0169745-62.2006.8.26.0100`, `TJSP` | court derived from the CNJ number (TJ, TRT, TRF) |
| `courtBranch`, `judicialDistrict` | `1ª VARA CÍVEL`, `SALVADOR/BA` | vara and comarca |
| `occupancy` | `occupied` | vacant, occupied or null when not published |
| `hasDebts`, `debtsAmount`, `debtTypes` | `true`, `255658.94`, `["condominium","iptu"]` | from the lot notes |
| `editalUrl`, `image`, `images`, `scrapedAt` | | |

**No personal data.** Debtors (executados), plaintiffs, heirs and bidders are never collected: no names, CPF, phones or e-mails of individuals. Lot descriptions are read only to extract numbers, dates and categories; no free text is copied to the dataset.

### Filters

Sources, states, cities, judicial or extrajudicial, only lots in the 2nd round (2ª praça), auction date range, property types, occupancy, minimum discount over the appraisal, bid range and max items. The Max items budget is split between the selected sources.

| Field | Leilões Judiciais | Leilão Imóvel | Portal Zuk | Grupo Lance | Frazão | Biasi |
|---|---|---|---|---|---|---|
| Appraisal | yes | full price or stated | 1st round value | yes | 2-round sales | 2-round sales |
| Process number | most judicial lots | about half of judicial lots | yes | yes | judicial lots | when quoted |
| Vara / comarca | single-court auctions | no | no | yes | judicial lots | no |
| Occupancy | when stated | when stated | yes | when stated | yes | yes |
| Debts | when stated | when stated | yes | when stated | when stated | when stated |

### How to use

1. Pick a state (and cities) and leave the sources on.
2. Choose **Judicial auction** and **Only lots in the 2nd round** to see the lots selling at 50% to 60% of the appraisal.
3. Set a minimum discount, for example 40. Run.

Results come sorted by best discount inside each source (Portal Zuk and Frazão: next auction first). Leilão Imóvel shows at most about 950 lots per search, so narrow the state for full coverage. The actor reads each portal politely, one request at a time, and only opens a lot page for lots that already passed the filters the list can answer.

### Who it is for

Auction investors (arrematantes), auction advisors and lawyers, real estate funds, brokers and analysts who track court and bank auctions across Brazil.

### Example input

```json
{"states": ["SP"], "cities": ["São Paulo"], "auctionTypes": ["judicial"], "onlySecondRound": true, "minDiscountPct": 40, "maxItems": 50}
```

### Example output

```json
{
    "source": "zuk",
    "lotId": "38153-238428",
    "url": "https://www.portalzuk.com.br/imovel/sp/sao-paulo/consolacao/rua-frei-caneca-219/38153-238428",
    "title": "Apartamento - Rua Frei Caneca, 219 - Consolação, São Paulo/SP",
    "propertyType": "apartment",
    "address": "Rua Frei Caneca, 219",
    "neighborhood": "Consolação",
    "city": "São Paulo",
    "state": "SP",
    "area": 41.48,
    "appraisalValue": 587320.79,
    "minimumBid": 293660.39,
    "discountPct": 50.0,
    "currentRound": 2,
    "firstAuctionDate": "2026-11-17T13:30:00-03:00",
    "firstAuctionValue": 587320.79,
    "secondAuctionDate": "2026-12-08T13:30:00-03:00",
    "secondAuctionValue": 293660.39,
    "auctionType": "judicial",
    "processNumber": "1012626-30.2020.8.26.0100",
    "court": "TJSP",
    "occupancy": "occupied",
    "hasDebts": true,
    "debtsAmount": 255658.94,
    "debtTypes": ["condominium", "iptu"],
    "editalUrl": "https://documentacaoleilao.portalzuk.com.br/2026/11/6eced30f96f4a199f22af72c19638792.pdf",
    "image": "https://imagens.portalzuk.com.br/detalhe/2026/11/a9afdc1a53e5d44cc0d7d3e46f76da79.jpg",
    "scrapedAt": "2026-11-19T01:06:15+00:00"
}
```

Real lot, trimmed of the `null` fields. Every lot has all fields.

### Pricing

Pay per event: **US$ 4.00 per 1,000 lots** (US$ 0.004 per lot, event `property-lot`), charged for each lot written to the dataset. Platform usage is included.

| Lots | Cost |
|---|---|
| 100 | US$ 0.40 |
| 1,000 | US$ 4.00 |
| 5,000 | US$ 20.00 |

### FAQ

**Which sources are covered?** Leilões Judiciais, Leilão Imóvel (only the auctioneers not covered by the other sources), Portal Zuk (zukerman.com.br redirects there), Grupo Lance (lancejudicial.com.br redirects there), Frazão Leilões and Biasi Leilões. Caixa, Superbid and Mega Leilões are in the Brazil Real Estate Auctions Scraper.

**Why is the appraisal sometimes the 1st round value?** Portal Zuk and the bank sales do not publish the appraisal. In judicial auctions the 1st round floor is the appraisal, and in fiduciary sales (Lei 9.514) it is at least the appraisal.

**Is personal data collected?** No. Only property data, courts and the selling companies.

**Do I need a proxy?** No. The actor connects directly and only falls back to Apify Proxy when a portal blocks it.

### Buscas em português

- leilão judicial de imóveis em São Paulo, Rio de Janeiro, Minas Gerais, Paraná, Goiás e todo o Brasil
- imóveis em 2ª praça com 50% de desconto sobre a avaliação
- leilão de imóveis do TJSP, TRT e Justiça Federal com número do processo, vara e comarca
- imóveis desocupados em leilão, com débitos de IPTU e condomínio informados
- leilão extrajudicial de bancos (alienação fiduciária Itaú, Santander, Bradesco)
- Leilões Judiciais, Leilão Imóvel, Portal Zuk (Zukerman), Grupo Lance (Lance Judicial), Frazão e Biasi em uma só planilha

**Preço:** US$ 4,00 por 1.000 lotes (US$ 0,004 por lote entregue). Exemplo: 100 lotes custam US$ 0,40.

### Other Actors by the same author

- [Brazil Real Estate Auctions Scraper](https://apify.com/allanmxr/brazil-real-estate-auctions)
- [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)

# Actor input Schema

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

Auction portals to search. With more than one selected you get a single merged list and Max items is split evenly between them. Caixa, Mega Leilões and Superbid are in our Brazil Real Estate Auctions actor.

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

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

Judicial: court-ordered auctions (praças) with a process number. Extrajudicial: bank and fiduciary sales (Lei 9.514) and direct sales. Leave empty for both.

## `onlySecondRound` (type: `boolean`):

Keep only lots whose 1st round already closed without bids, where the minimum bid is usually 50% to 60% of the appraisal.

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

Next auction round on or after this date.

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

Next auction round on or before this date.

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

Leave empty for all types.

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

Vacant or occupied, as published by the portal. Add Unknown to keep the lots whose occupancy is not stated (common in court auctions).

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

Only lots whose current minimum bid is at least this much below the appraisal value, for example 40. Lots without a published appraisal are dropped when this is set.

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

Lowest current minimum bid, in reais.

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

Highest current minimum bid, in reais.

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

Total lots across all portals, split evenly between them (best discount first in most portals, next auction first in Portal Zuk and Frazão). The run stops as soon as it is reached and you pay only for the lots delivered.

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

Leave empty: the actor connects directly and only falls back to Apify Proxy when a portal blocks it. Set a proxy only to force your own.

## Actor input object example

```json
{
  "sources": [
    "leiloesjudiciais",
    "leilaoimovel",
    "zuk",
    "grupolance",
    "frazao",
    "biasi"
  ],
  "states": [
    "SP"
  ],
  "cities": [
    "São Paulo"
  ],
  "onlySecondRound": false,
  "maxItems": 20
}
```

# 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": [
        "leiloesjudiciais",
        "leilaoimovel",
        "zuk",
        "grupolance",
        "frazao",
        "biasi"
    ],
    "states": [
        "SP"
    ],
    "cities": [
        "São Paulo"
    ],
    "maxItems": 20
};

// Run the Actor and wait for it to finish
const run = await client.actor("allanmxr/brazil-judicial-property-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": [
        "leiloesjudiciais",
        "leilaoimovel",
        "zuk",
        "grupolance",
        "frazao",
        "biasi",
    ],
    "states": ["SP"],
    "cities": ["São Paulo"],
    "maxItems": 20,
}

# Run the Actor and wait for it to finish
run = client.actor("allanmxr/brazil-judicial-property-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": [
    "leiloesjudiciais",
    "leilaoimovel",
    "zuk",
    "grupolance",
    "frazao",
    "biasi"
  ],
  "states": [
    "SP"
  ],
  "cities": [
    "São Paulo"
  ],
  "maxItems": 20
}' |
apify call allanmxr/brazil-judicial-property-auctions --silent --output-dataset

```

## MCP server setup

```json
{
    "mcpServers": {
        "apify": {
            "type": "http",
            "url": "https://mcp.apify.com/?tools=fetch-actor-details,allanmxr/brazil-judicial-property-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/af76DfKtiv02wyHPZ/builds/UFbRdy0Tg2p2s1uK8/openapi.json
