Caixa Leilão de Imóveis Auction Property Scraper

Scrapes foreclosure and auction property listings from Caixa Econômica Federal's real estate portal. Returns appraisal value, sale price, discount percentage, full address, auction modality and the edital document link as structured JSON.

---

Caixa Leilão Scraper Features

• Filter by Brazilian state, city and auction modality
• Returns appraisal value and sale price as numbers, with the discount already computed
• Links the edital (official auction notice) for every property
• Covers all modalities — Leilão SFI, Licitação Aberta, Venda Online and Venda Direta
• Runs over residential proxy
• Caps output with maxItems

---

What can you do with Caixa auction data?

• Property investors — Screen the whole country for the deepest discounts off appraisal without opening each listing.
• Real estate funds — Build a pipeline of auction inventory filtered to target states and property types.
• Market analysts — Track discount rates over time as a distress signal for regional housing markets.
• Legal teams — Pull edital links in bulk for the properties worth a compliance read.
• Lead generation — Identify areas with concentrated auction inventory for targeted outreach.

---

How Caixa Leilão Scraper Works

1. You choose a state and, optionally, an auction modality.
2. The scraper queries Caixa's property search over a residential proxy.
3. Each listing is parsed into the field set below, with the discount computed against the appraisal value.
4. Records stream to the dataset as they are parsed, stopping at maxItems.

---

Input

{
  "estado": "SP",
  "modalidade": "14",
  "maxItems": 200
}

Field	Type	Default	Description
estado	string	SP	Brazilian state code — SP, RJ, MG. Empty for all states
modalidade	string	—	Auction modality (see below). Empty for all
maxItems	integer	10	Maximum property records. Empty for no limit

Modality codes:

Code	Modality
14	Leilão SFI — Edital Único
21	Licitação Aberta
30	Venda Direta
33	Venda Online
34	Venda Direta Online

---

Caixa Leilão Scraper Output Fields

{
  "listing_id": "3190890SP",
  "property_url": "https://venda-imoveis.caixa.gov.br/sistema/detalhe-imovel.asp?hdnimovel=3190890SP",
  "edital_url": "https://venda-imoveis.caixa.gov.br/editais/edital.pdf",
  "address": "Rua das Flores, 250",
  "neighborhood": "Vila Mariana",
  "city": "São Paulo",
  "state": "SP",
  "property_type": "Apartamento",
  "modality": "Leilão SFI - Edital Único",
  "appraisal_value": 480000,
  "sale_value": 288000,
  "discount_pct": 40,
  "scraped_at": "2026-07-25T09:14:22Z"
}

Field	Type	Description
listing_id	string	Unique property identifier — e.g. 3190890SP
property_url	string	URL of the property detail page
edital_url	string	URL of the auction edital / notice document
address	string	Property street address
neighborhood	string	Neighborhood (bairro)
city	string	City
state	string	Brazilian state code (UF)
property_type	string	Property type — Apartamento, Casa, Terreno
modality	string	Auction modality description
appraisal_value	number	Appraised value in BRL (valor de avaliação)
sale_value	number	Sale / auction price in BRL
discount_pct	number	Discount percentage off the appraisal value
description	string	Property description text
scraped_at	string	ISO timestamp of extraction

---

FAQ

What is discount_pct calculated against?

The appraisal value (valor de avaliação), not a previous asking price. Both figures are in the record, so you can verify it.

Does the Caixa Leilão Scraper need an account?

No. It reads the public property search on venda-imoveis.caixa.gov.br.

What is the edital, and why does it matter?

It is the official auction notice — the legally binding document covering terms, occupancy status and any outstanding debts on the property. edital_url links it directly, and you should read it before bidding on anything.

Are prices in BRL?

Yes. appraisal_value and sale_value are both Brazilian reais, returned as numbers rather than formatted strings.

Can I filter by minimum discount?

Not at query level. Pull the state you want and filter on discount_pct in your own pipeline — the field is already computed.

---

Need More Features?

Need discount thresholds at query level, or occupancy status parsed from the edital? Open an issue on the actor.

Why Use Caixa Leilão Scraper?

• Discount already computed — Appraisal and sale price both returned, with the percentage worked out, so ranking by opportunity is a sort not a script.
• Edital linked on every record — The document that decides whether a bid is sane, one field away.
• Pay per property — No subscription. Screen one state or all of Brazil and pay for what comes back.