Caixa Imóveis Leilão Scraper - Brazil Property Auctions

Give it Brazilian state codes and get the repossessed properties Caixa Econômica Federal has for sale there, one row each: the minimum bid, the appraisal and discount, both auction dates, occupancy, the registry details, the payment rules and links to the matrícula and edital PDFs.

It reports what Caixa published and nothing more. Whether someone still lives in the property, and who pays the unpaid condomínio, is settled by the edital, not by this table.

Input	State codes, optional cities and Caixa's own filters, or pasted property pages
Output	One row per property: minimum bid, appraisal, discount, auction dates, occupancy, registry details, payment rules, matrícula and edital links
Ceiling	5,000 properties per run
Account needed	None
Price	$0.90 per 1,000 properties on the Free plan, a little less on paid plans. The free plan's $5 a month covers about 5,500

🔍 What Caixa Imóveis Leilão Scraper does

Caixa's site will show you all of its stock, one state, one city and ten cards at a time. It will not sort by discount or show you everything under R$ 150,000 that takes financing. This runs the same search, with Caixa's own filters applied on its side, then opens each property's page and hands you the lot as a table.

Caixa sells the same kind of stock four ways, and saleMode tells you which:

Sale type	How it sells
Leilão SFI	A public auction in two rounds on two dates. The first round usually opens at the full appraisal, and the second round is where the discount is. Both dates and both minimums are on the row.
Licitação Aberta	Competing offers on one date, above a stated minimum.
Venda Online	A fixed price with a deadline, in onlineSaleEndsAt.
Venda Direta Online	A direct purchase, also at a fixed price.

City names are matched loosely, so sao jose do rio preto finds SAO JOSE DO RIO PRETO. Caixa only lists cities that hold stock today, so a city with nothing for sale gets a free row saying so rather than a quietly short list.

discountPercent is Caixa's own figure where it prints one, and otherwise worked out from the appraisal and the minimum. A first-round discount of 0% is normal: the auction opens at the valuation. On some Leilão SFI lots the minimum sits above the appraisal, so the discount comes out negative. That is Caixa's number, not a bug.

📋 What data you get from each Caixa property

What you get	Field
Caixa's property id and number, and the link	propertyId, propertyNumber, listingUrl
Property type, occupancy, bedrooms and garage spaces	propertyType, occupancyStatus, bedrooms, garageSpaces
Total, private and land area in m²	totalAreaSqm, privateAreaSqm, landAreaSqm
Appraisal, minimum bid and discount, for each round	appraisedValueBrl, minimumBidBrl, discountPercent, minimumBidSecondRoundBrl, discountPercentSecondRound
Sale type, notice and item number, the auctioneer and their site	saleMode, auctionNoticeNumber, itemNumber, auctioneer, auctioneerSite
Auction dates, or the closing time of an online sale	auctionDate, auctionDateLabel, secondAuctionDate, onlineSaleEndsAt
Matrícula, comarca, ofício and inscrição imobiliária	registrationNumber, judicialDistrict, registryOffice, municipalRegistration
The averbação dos leilões negativos	negativeAuctionNote
Address, postcode, state and city	addressFull, postalCode, state, city
Caixa's description	description
Payment methods, and four flags read from them	paymentMethods, acceptsFgts, acceptsFinancing, acceptsConsortium, cashOnly
Who pays unpaid condomínio and property tax	condoFeeRule, propertyTaxRule
Matrícula and edital PDF links, and when the notice went up	deedPdfUrl, noticePdfUrl, noticePublishedAt
Photos	photoUrls

▶️ How to scrape Caixa property auctions

1. Open Caixa Imóveis Leilão Scraper and click Try for free.
2. Put one or more state codes into States (UF), one per line, and any cities into Cities (optional).
3. Pick a Sale type, Property type or Price band if you want Caixa to narrow the search.
4. Set Maximum properties. The form starts at 50.
5. Click Start, then export the dataset as CSV, JSON or Excel.

Leave the states and the property list empty and you get one labelled sample row, not charged.

💰 How much does it cost to scrape Caixa properties?

$0.90 per 1,000 properties on the Free plan, with the property pages or without. Paid plans pay a little less: $0.89 on Starter, $0.88 on Scale and $0.87 on Business. On the free plan, the $5 Apify gives you each month covers about 5,500 properties.

Not charged: the sample row, every diagnostic row, properties dropped by minDiscountPercent or maxPriceBrl, and a property already delivered earlier in the same run.

📥 What you give it

{
  "states": ["SP"],
  "saleMode": "leilao-sfi",
  "propertyType": "apartamento",
  "maxPriceBrl": 250000,
  "includeAuctionDetails": true,
  "maxItems": 100
}

Field	Default	What it is
states	none: a free sample row, unless propertyUrls is set	Two-letter state codes, such as SP, RJ or MG.
cities	the whole state	City names inside those states. Case and accents do not matter.
saleMode	every sale type	leilao-sfi, licitacao-aberta, venda-online, venda-direta-online or direito-de-preferencia, which is almost always empty.
propertyType	any	casa, apartamento, or outros for land, shops, sheds and rural plots.
priceBand	any price	Caixa's own bands: ate-100k, 100k-200k, 200k-400k, 400k-750k or acima-750k.
minBedrooms	any	1, 2 or 3 for three or more. Caixa records bedrooms only for houses and flats, so this drops land and commercial units.
garageSpaces	any	1, 2 or 3 for three or more parking spaces. It drops land too.
acceptsFinancing	either	S for properties Caixa will finance, N for cash or own funds. Most of the stock is cash only.
minDiscountPercent	0, no minimum	Keep only properties whose first-round discount is at least this. On a Leilão SFI that first round usually sits at the appraisal, so a high value here drops most auctions.
maxPriceBrl	0, no ceiling	A ceiling on the minimum bid, in reais. On a Leilão SFI that is the first-round minimum.
includeAuctionDetails	on	Open each property's page for the dates, occupancy, registry details, payment rules and PDFs. Off reads the result list only: faster, with far fewer fields. Same price either way.
maxItems	50	Properties across every state and city in the run, 1 to 5,000.
propertyUrls	none	Caixa property pages or bare property numbers such as 878770429905-8, on their own or alongside a search.
proxyConfiguration	not needed	Leave it alone. Servers of your own listed here are used exactly as given.

📤 What you get back

A real row:

{
  "propertyId": "8787713215473",
  "propertyNumber": "878771321547-3",
  "propertyType": "Apartamento",
  "occupancyStatus": "Ocupado",
  "bedrooms": 2,
  "garageSpaces": 1,
  "totalAreaSqm": 105.01,
  "privateAreaSqm": 47.85,
  "landAreaSqm": null,
  "appraisedValueBrl": 220000,
  "minimumBidBrl": 220000,
  "minimumBidSecondRoundBrl": 132000,
  "discountPercent": 0,
  "discountPercentSecondRound": 40,
  "saleMode": "Leilão SFI",
  "auctionNoticeNumber": "0047/0226 - CPA/RE",
  "itemNumber": "416",
  "auctioneer": "AUCTIONEER NAME",
  "auctioneerSite": "www.lancecertoleiloes.com.br",
  "auctionDate": "2026-10-08T10:00:00",
  "auctionDateLabel": "1º Leilão 08/10/2026 10h00",
  "secondAuctionDate": "2026-10-15T10:00:00",
  "onlineSaleEndsAt": null,
  "registrationNumber": "156984",
  "judicialDistrict": "ARARAQUARA-SP",
  "registryOffice": "01",
  "municipalRegistration": "2212540500",
  "negativeAuctionNote": "Não se aplica",
  "addressFull": "ESTRADA MUNICIPAL ARA 347,N. 145 APTO. 203 TORRE 11, JARDIM SAO RAFAEL I - CEP: 25000-000, ARARAQUARA - SAO PAULO",
  "postalCode": "25000-000",
  "description": "2 Quartos, 1 Vaga na Garagem, Área de Serviço, Wc, Cozinha. .",
  "paymentMethods": [
    "Recursos próprios.",
    "Permite utilização de FGTS. Consulte condições e enquadramento."
  ],
  "acceptsFgts": true,
  "acceptsFinancing": false,
  "acceptsConsortium": false,
  "cashOnly": false,
  "condoFeeRule": "Condomínio: Sob responsabilidade do comprador.",
  "propertyTaxRule": "Tributos: Sob responsabilidade do comprador.",
  "deedPdfUrl": "https://venda-imoveis.caixa.gov.br/editais/matricula/SP/8787713215473.pdf",
  "noticePdfUrl": "https://venda-imoveis.caixa.gov.br/editais/EL00470226CPARE.PDF",
  "noticePublishedAt": "2026-09-09T09:45:50",
  "photoUrls": [
    "https://venda-imoveis.caixa.gov.br/fotos/F878771321547321.jpg"
  ],
  "listingUrl": "https://venda-imoveis.caixa.gov.br/sistema/detalhe-imovel.asp?hdnimovel=8787713215473",
  "state": "SP",
  "city": "ARARAQUARA",
  "scrapedAt": "2026-09-20T07:02:21.969Z"
}

Field	How to read it
appraisedValueBrl, minimumBidBrl, discountPercent	Caixa's valuation, the least you can pay, and how far under the valuation that is. On a Leilão SFI these are the first-round figures.
minimumBidSecondRoundBrl, discountPercentSecondRound	The same for the second round, only on a Leilão SFI.
auctionDate, secondAuctionDate, onlineSaleEndsAt	Brasília local time, as Caixa states it. An auction has dates; a fixed-price sale has a closing time instead.
occupancyStatus	Ocupado or Desocupado. See the limits before you rely on it.
negativeAuctionNote	"Averbado", "Em tratamento" or "Não se aplica".
condoFeeRule, propertyTaxRule	Who picks up unpaid condomínio and property tax. On an occupied flat that is not a small question.
deedPdfUrl, noticePdfUrl	The matrícula and the edital. These are the documents that matter.

With includeAuctionDetails off, a row carries only what the result card shows: the ids, sale type, city, neighbourhood, minimum bid, type, area, bedrooms, garage, notice and item number, address and one photo. Appraisal and discount come through only on the fixed-price cards, because Caixa's auction cards show the price alone.

🧾 Reading the output

Row	How to spot it	Charged
A property	has a propertyId and no _sample, _diagnostic or charged field	yes
The sample row	_sample: true, charged: false. Only when there was no valid state and no pasted property	no
A diagnostic row	_diagnostic: true, charged: false, and an errorCode	no

Real properties carry no charged field, so drop every row where charged is false and you are left with the properties.

errorCode	What happened
CITY_NOT_LISTED	A city you named has nothing for sale in that state today. When none of your cities matched, the row lists the ones that do have stock.
UNKNOWN_STATE	Not a Brazilian state code.
NO_RESULTS	Nothing for sale in that state or city under your filters.
NOT_FOUND	The property is no longer listed, usually because it sold or was pulled.
NO_USABLE_EXIT	Caixa's site could not be reached at all. Try again in a few minutes.
SEARCH_REFUSED, SEARCH_UNPARSED, SEARCH_FAILED	Caixa did not return a usable answer to that search.
LIST_REFUSED, LIST_FAILED	A page of result cards did not come back.
HTTP_ERROR, NETWORK_ERROR, DETAIL_FAILED, LOOKUP_FAILED, CITY_LIST_FAILED	One page did not come back. The rest of the run carries on.

💡 What people use it for

• An investor after every flat in one state under R$ 200,000, sorted by second-round discount with the FGTS ones flagged, which the site itself cannot show.
• Following a shortlist through its rounds: paste the property numbers into propertyUrls and run it daily. New dates and minimums show up, and a sold one comes back as NOT_FOUND.
• Pulling the edital and matrícula links for every lot in a city before a lawyer reads them.
• Counting what Caixa holds in a region, by sale type and occupancy, week on week.

🚧 What it does not do

• Judge the deal. Occupied properties, unpaid condomínio and an eviction that falls to the buyer all look alike in a spreadsheet. Read the edital.
• Vouch for occupancy. Treat it as a hint and check it against the edital, because it is the biggest swing in what a lot is worth.
• Keep listings. Caixa removes a property the moment it sells or is pulled.
• Fill blanks. Land has no bedroom count, plenty of listings have no photo, and some descriptions are a single full stop.
• Tell the two fixed-price types apart on an unfiltered run. Both come back as Venda Online. Set saleMode and the label is exact.
• Filter by area or neighbourhood. Caixa's own area filter returns the whole state for one of its bands, so it is not offered. Filter totalAreaSqm and addressFull yourself.
• Download the PDFs, bid, or send alerts. You get the links, and each run is a snapshot.
• Convert currency. Reais, exactly as Caixa states them.
• It is not an official Caixa tool. Dami's Studio is independent and is not affiliated with or endorsed by Caixa, or by any other company named on this page.

🧭 Which Brazilian property scraper do you need?

If you want	Use
Homes for sale and to rent on VivaReal and ZAP Imóveis, with fees and the advertiser's phone	VivaReal & ZAP Imóveis Scraper
Rentals and sales on QuintoAndar, with the full monthly cost	QuintoAndar Scraper
Caixa's own repossessed properties, with both auction rounds	This one
Judicial and extrajudicial auctions from auction houses and banks	Brazilian Property Auction Scraper
Classified ads on OLX Brazil, property included	OLX Brazil Scraper

❓ Questions people ask

How many properties does Caixa have listed?

On 19 September 2026 it listed 15,739 across the country, with Rio de Janeiro at 4,554 and São Paulo at 2,132. Amapá had none. The total moves every day.

Why is the first-round discount 0%?

Because a Leilão SFI opens at the appraisal. The cut comes in the second round, in discountPercentSecondRound.

Does it need a Caixa account?

No.

How current is the data?

It reads the live listings when the run starts, not Caixa's daily export, so a property added this morning is in it.

Can I watch one property over time?

Put its page URL or property number in propertyUrls and schedule the run. You get the same row each time with whatever changed, or NOT_FOUND once it is gone.

Can I call it from code or connect it to an AI assistant?

Yes. The API tab has ready-made code for Python, JavaScript and the command line. For Claude, ChatGPT or another MCP client, connect https://mcp.apify.com/?tools=fetch-actor-details,dami_studio/caixa-imoveis-leilao-scraper. Either way the run happens on your Apify account at the same price.

Is scraping Caixa's property sales legal?

These are Caixa's public sale pages. Rows carry the auctioneer's name and registry numbers, which data-protection law such as Brazil's LGPD can cover, so have a reason for collecting them. Apify's write-up on the legality of web scraping is a good starting point, and we are not lawyers.

🆘 If something breaks

Open the Issues tab on the actor page. Include the run ID and the states, cities or property numbers you asked for.