Leilão Imóvel Scraper

Scrape auction property listings from leilaoimovel.com.br — Brazil's largest real estate auction aggregator. The actor crawls listing pages and extracts full detail records including sale price, appraisal value, discount percentage, bank, auctioneer, closing date, payment options, and more.

What it does

• Crawls listing pages at /encontre-seu-imovel with optional filters (state, city, bank, property type)
• Follows every property link into its detail page
• Extracts 24 fields per record, including DataLayer ecommerce event data for price accuracy
• Handles pagination automatically up to 2,445+ pages (~15 items/page)

Input

Field	Type	Description	Default
maxItems	integer	Maximum number of property listings to scrape	10
state	string	Brazilian state code, e.g. SP, RJ, MG	(all)
city	string	City slug, e.g. sao-paulo	(all)
bank	string	Bank slug, e.g. caixa-economica-federal-cef, santander	(all)
propertyType	string	Property type slug, e.g. residencial, comercial	(all)

Output fields

Each record in the dataset contains:

Field	Type	Description
property_id	string	Internal property ID
url	string	Full URL of the property detail page
title	string	Property listing title
sale_price	number	Current sale price in BRL
appraisal_value	number	Appraisal value in BRL
discount_pct	number	Discount % off the appraised value
modality	string	Auction modality (e.g. Leilão SFI Caixa, Venda Direta)
bank	string	Bank / institution selling the property
auctioneer	string	Auctioneer company name
closing_date	string	Auction closing date-time (ISO 8601)
property_type	string	Property type (Casa, Apartamento, Terreno, …)
address	string	Full property address
state	string	Brazilian state code (e.g. RJ, SP)
city	string	City name
accepts_financing	boolean	Whether the property accepts financing
accepts_fgts	boolean	Whether the property accepts FGTS
accepts_installment	boolean	Whether installment payment is accepted
origin_code	string	Bank's internal reference code
item_number	string	Item number within the auction edital
edital	string	Auction notice / edital identifier
registration_number	string	Property registration (matrícula) number
comarca	string	Judicial district
description	string	Full property description
image_url	string	URL of the first property photo
scraped_at	string	ISO 8601 timestamp of when the record was scraped

Example output

{
  "property_id": "2345696",
  "url": "https://www.leilaoimovel.com.br/imovel/pe/petrolina/...",
  "title": "Casa Caixa em Petrolina / PE",
  "sale_price": 574220.18,
  "appraisal_value": 760000.00,
  "discount_pct": 24.44,
  "modality": "Leilão SFI Caixa",
  "bank": "Caixa",
  "auctioneer": "Leilões Judiciais",
  "closing_date": "2026-07-15T10:00:00-03:00",
  "property_type": "Casa",
  "address": "Rua Exemplo, 123, Bairro Centro, Petrolina/PE",
  "state": "PE",
  "city": "Petrolina",
  "accepts_financing": true,
  "accepts_fgts": true,
  "accepts_installment": false,
  "origin_code": "PE123456",
  "item_number": "001",
  "edital": "0001/2026",
  "registration_number": "12345",
  "comarca": "Petrolina",
  "description": "Casa residencial em bom estado...",
  "image_url": "https://www.leilaoimovel.com.br/...",
  "scraped_at": "2026-06-06T19:35:00.000Z"
}

Notes

• The actor uses Brazilian residential proxy routing to ensure reliable access to leilaoimovel.com.br, which is protected by Cloudflare and blocks datacenter IPs.
• Pagination is auto-detected from the listing count shown on the first page.
• state and city filter values should be lowercase codes/slugs as used in the site's URL structure (e.g. sp not São Paulo).
• Scraping all ~37,000+ active listings without filters requires a high maxItems value and significant compute time.