Brazilian Property Auction Scraper

Brazilian Property Auction Scraper: judicial and extrajudicial auctions with both praças, bids and PDFs

Pick auction types, states, cities or banks and you get one row per property up for auction in Brazil: the minimum bid, the appraisal and discount, both praças with their own dates and minimum bids, the auction house, occupancy, the court case and links to the matrícula and edital PDFs. The seller's own notes are never returned, because they name debtors, so only the structured facts are kept. The catch is a ceiling: the portal this reads never serves more than 969 results for one search, so a wide query has to be split by state or city to reach the rest.

🔍 What Brazilian Property Auction Scraper does

It reads one portal that carries the private auction houses and the bank portfolios in a single index. On 19 September 2026 that was about 31,000 live listings, 13,700 of them judicial or extrajudicial and about 18,700 that were not Caixa stock. For each result it opens the property page, where the rounds, the auction house, the areas and the PDFs live.

rounds is the field the rest exists for. A judicial auction runs in two praças: the first at or near the appraisal, the second a couple of weeks later at a fraction of it. minimumBidBrl at the top of the row is the price live right now, and rounds shows what each praça asks and when it opens.

The 969 ceiling is the portal's own. It serves 19 results a page and nothing past page 51, whatever total it prints at the top. Name states and each one becomes its own search with its own 969, so naming all 27 reaches far more than one national query. Name cities and they are searched together, with the state filter dropped because the cities already pin the place.

Auction notices name people: the debtor, sometimes the creditor, sometimes an owner mid-sentence. The run reads the seller's notes for the case number, court, district and registry number, then throws the prose away. Every string that does go out is checked against a personal-data pattern list first, and a field that trips it is dropped with a warning in the log.

Field names match the Caixa Imóveis Leilão Scraper wherever the meaning is the same, so the two datasets stack.

📥 What you give it

{
  "auctionCategories": ["judicial", "extrajudicial"],
  "states": ["SP", "RJ"],
  "propertyTypes": ["apartamento", "casa"],
  "minDiscountPercent": 40,
  "maxPriceBrl": 400000,
  "sortBy": "discount-desc",
  "maxItems": 200
}

Every field is optional, but a run needs at least one filter or one pasted page. With none, it returns a free sample row.

📤 What you get back

A real judicial listing from a real run, with one photo kept:

{
  "propertyId": "3020681",
  "listingUrl": "https://www.leilaoimovel.com.br/imovel/sp/sao-paulo/residencial-apartamento-desocupado-de-92-83-m-no-condominio-parque-marajoara-sol-jardim-marajoara-sao-paulo-desocupado-imovel-3020681",
  "state": "SP",
  "city": "São Paulo",
  "neighbourhood": "Jardim Marajoara",
  "street": "Av. Interlagos",
  "addressFull": "Avenida Interlagos, 492- Apartamento nº 12",
  "propertyType": "Apartamento",
  "auctionCategory": "Judicial",
  "auctionHouse": "Máximo Leilões",
  "occupancyStatus": "Desocupado",
  "appraisedValueBrl": 720592.07,
  "minimumBidBrl": 360296.03,
  "discountPercent": 50,
  "rounds": [
    { "round": 1, "startsAt": "2026-09-17T16:00:00", "minimumBidBrl": 720592.07 },
    { "round": 2, "startsAt": "2026-10-07T16:00:00", "minimumBidBrl": 360296.03 }
  ],
  "auctionDate": "2026-10-07T16:00:00",
  "auctionEndsAt": "2026-10-07T16:00:00",
  "totalAreaSqm": null,
  "privateAreaSqm": 92.83,
  "bedrooms": null,
  "garageSpaces": 1,
  "paymentTerms": "Somente à vista",
  "courtCaseNumber": "4000053-82.2015.8.26.0002",
  "court": "1ª Vara Cível do Foro Regional de Santo Amaro",
  "judicialDistrict": "Capital",
  "registrationNumber": "216.352 - 216.453",
  "registryOffice": null,
  "deedPdfUrl": "https://d24y7usudqxuz0.cloudfront.net/bens/0000000100/matricula-vaga-6a6bb212e3299.pdf",
  "noticePdfUrl": "https://d24y7usudqxuz0.cloudfront.net/bens/0000000100/edital-6a70f62388f40.pdf",
  "photoUrls": [
    "https://image.leilaoimovel.com.br/images/81/apartamento-em-sao-paulo-sp-3020681-imovel-3020681-906ac8f5b686be18a249c2898868d3b9b7fb4166-g.webp"
  ],
  "listedAt": "2026-09-17",
  "geoPrecision": "Localização Precisa",
  "isNewListing": true,
  "scrapedAt": "2026-09-20T04:26:15.154Z"
}

A field the notice does not state comes back null. It is never guessed. With includeAuctionDetails off, rounds is empty and the house, areas, case details and PDFs are null.

🧾 Reading the output

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

▶️ How to run it

1. Open Brazilian Property Auction Scraper and click Try for free. 2. Keep or change the Auction type, and put state codes into States (UF), one per line. 3. Narrow it with Property type, Selling institution or the price and discount fields if you like. 4. Set Maximum properties, which starts at 50, and pick an Order. The order decides which properties you get when there are more than your maximum. 5. Click Start, then export the dataset as CSV, JSON or Excel.

💰 How much does it cost?

$0.90 per 1,000 properties, flat on every Apify plan, with the property pages or without.

Not charged: the sample row, every diagnostic row, properties your own price or discount limits drop, and a property already delivered earlier in the same run. A run that cannot reach the portal returns a free row saying so.

💡 What people use it for

• Hunting second praças: sort by discount-desc and read rounds for the date the price drops.
• Following one bank's repossessions across the country with sellerInstitutions.
• One view of the market, with these rows stacked on the Caixa scraper's under the same field names.
• A weekly list of court auctions in one comarca, with the case number on every row.

🚧 What it does not do

• More than 969 rows from one search. Split by state or city.
• Seller prose. There is no description field, and there will not be one.
• PDF contents. You get the matrícula and edital links; reading them is up to you.
• Live bids or bid history. It returns the listed minimum, not the current high bid.
• Full detail on every judicial listing. bedrooms and totalAreaSqm are often null there, because the notice does not state them.
• Every auction house. A house that does not list on the portal will not appear.
• Fixed dates. A property can be pulled, settled or rescheduled without notice, so treat a row as true at scrapedAt.
• Advice. An edital and a current matrícula decide what you are buying, not a row in a dataset.

🧭 Which Brazilian property scraper do you need?

❓ Questions people ask

What is the difference between judicial and extrajudicial? A judicial auction is ordered by a court inside a case, and the row carries the case number, court and district. An extrajudicial one is run by a creditor, usually a bank enforcing a mortgage, outside court.

What are 1ª and 2ª praça? The two rounds. The first opens at or near the appraisal. If nobody bids, the second opens days or weeks later at a much lower minimum, which is where the big discounts come from.

How is discountPercent worked out? It is the portal's own figure and is not recalculated here, so it matches what a buyer sees on the page.

Can I get every auction in Brazil in one run? Not from one query. Name all 27 states and each gets its own search, which raises the reachable total.

How long does a run take? On 20 September 2026, 100 São Paulo properties with their pages took 94 to 113 seconds. For the same 60 properties in Minas Gerais, the list-only setting took 23.5 seconds against 40.1 with pages.

Do I need an account or an API key? No.

🆘 If something breaks

Open the Issues tab on the actor page. Include the run ID and the filters you used, or the property URL.