🇵🇹 Portugal Property Auctions Scraper (Centro de Leilões)

Extract Portuguese property and public auction listings from Centro de Leilões — the national portal aggregating court-ordered, insolvency, and voluntary auctions. Get structured data on prices (valor base, valor mínimo 85%, valor de abertura 50%), tribunals, process numbers, addresses, and Google Maps links.

---

🎯 Why use this Scraper?

Auction opportunities in Portugal are scattered across dozens of court notices and auction-house announcements. This Actor solves that by:

• Bulk extraction of property auctions from a single national aggregator.
• Structured output (JSON / Excel / CSV) instead of manually browsing post-by-post.
• Smart, Portugal-specific fields — the valor mínimo (85% of the valor base, the legal valid-bid threshold) and the valor de abertura (50%, the lowest accepted opening bid), plus price-per-m².
• Google Maps links on every property so you can inspect locations instantly.
• Court & process tracking — tribunal, process number, and insolvency solicitor on each record.

---

🏢 Use Cases

• Real-estate investors — spot undervalued properties before the auction date.
• Lawyers & solicitors — monitor tribunal calendars and competing listings.
• Market research — analyse starting prices, surface areas, and price-per-m² by district.
• Data enrichment — append auction data to an existing property or CRM dataset.

---

📦 Output Data

Each result is a structured record with the following fields:

referencia, tipo, tipo_processo, valor_base, valor_base_fmt, licitacao_minima, data_leilao, tribunal, numero_processo, morada, concelho, distrito, area_m2, descricao, solicitador, detail_url, pdf_url, photos, google_maps_url, status, valor_abertura_fmt, price_per_m2.

Example output

ℹ️ The values below are illustrative samples, not a real listing.

{
  "referencia": "016/22",
  "tipo": "residential",
  "tipo_processo": "insolvencia",
  "valor_base": 226000.0,
  "valor_base_fmt": "226.000,00 €",
  "licitacao_minima": "192.100,00 €",
  "data_leilao": "19 de agosto de 2022",
  "tribunal": "Tribunal Judicial da Comarca de Santarém",
  "numero_processo": "2359/21.7",
  "morada": "Carrascal, Murteira, Benavente",
  "concelho": "Benavente",
  "distrito": "Santarém",
  "area_m2": 240.0,
  "descricao": "Prédio Urbano – composto por casa de rés-do-chão e logradouro.",
  "solicitador": "João EXEMPLO, Lda",
  "detail_url": "https://www.centrodeleiloes.pt/leilao-exemplo/",
  "pdf_url": "N/A",
  "photos": [
    "https://www.centrodeleiloes.pt/wp-content/uploads/exemplo-1.jpg"
  ],
  "google_maps_url": "https://www.google.com/maps/search/?api=1&query=...",
  "status": "inactive",
  "valor_abertura_fmt": "113.000,00 €",
  "price_per_m2": 941.67
}

About the value fields (Portuguese auction law, CPC): three numbers matter, all tied to the valor base (e.g. €226.000):

• valor_base_fmt — the starting valuation set by the judge / tax authority.
• licitacao_minima — the valor mínimo, by law 85% of the base (Art. 816 CPC). A bid at or above this is automatically valid.
• valor_abertura_fmt — the valor de abertura, 50% of the base — the lowest bid the platform accepts. Bids between 50% and 85% are licitação condicional (conditional) and need the judge's and creditors' approval; bids below 50% are rejected automatically.

---

⚙️ Input

Field	Type	Default	Description
distrito	string	""	Optional district filter (partial match), e.g. Lisboa, Porto.
concelho	string	""	Optional municipality filter (partial match), e.g. Sintra, Faro.
tipo	string	"all"	Property type: all, residential, commercial, land, industrial, other.
tipo_processo	string	"all"	Process type: all, judicial, insolvencia, voluntaria.
min_valor	integer	0	Minimum base value in €. 0 = no limit.
max_valor	integer	0	Maximum base value in €. 0 = no limit.
max_items	integer	100	Maximum auctions to return. 0 = unlimited.
download_pdf	boolean	false	Download auction PDFs to the Key-Value Store.

---

💡 Tips

• Start small — run with max_items: 5 to verify the output format before a full scrape.
• Filter by concelho — useful when a district covers many municipalities (e.g. Lisboa has 18 concelhos).
• Price filters — combine min_valor and max_valor to focus on your investment bracket.
• PDF documents are saved by default to permanent storage, so the legal conditions are never lost if the source link expires. Set download_pdf: false to keep only the source links for slightly faster runs.
• Full national export — set tipo: all and max_items: 0 for a complete snapshot.

---

🤖 Use it as an AI Tool (MCP)

This Actor is Model Context Protocol (MCP) compatible, so AI assistants like Claude can call it directly through the Apify MCP Server. The input is described so an assistant can fill it in from a natural-language request, for example:

"Find 20 upcoming property auctions in Lisboa district with a base value under 300,000 € and return their addresses, auction dates, and minimum bid values."

The assistant maps that to distrito: "Lisboa", max_valor: 300000, max_items: 20 and reads the structured results — no manual configuration needed.

---

📜 Disclaimer

This Actor extracts publicly available auction notices from Centro de Leilões. The data is published for public information purposes. You are responsible for using the data in compliance with applicable laws. Do not use the data for unlawful purposes. Always verify auction details directly with the relevant tribunal or auction house before bidding.

---

🇵🇹 Documentação em Português

Extrator de Leilões de Imóveis — Centro de Leilões

Extraia leilões de imóveis e hastas públicas de Centro de Leilões, o portal nacional que agrega leilões judiciais, de insolvência e voluntários.

Funcionalidades:

• 🔍 Extração estruturada de preços, tribunais, números de processo e moradas.
• 📊 Cálculos: valor mínimo (85% do valor base) e valor de abertura (50%), mais preço por m².
• 📍 Link do Google Maps em cada imóvel.
• ⚖️ Informação do tribunal, juízo e solicitador/insolvente.

Utilização:

{
  "distrito": "Lisboa",
  "tipo": "residential",
  "max_items": 20
}

Dados extraídos:

• Referência, tipo de imóvel e tipo de processo.
• Valor base e valor mínimo de licitação.
• Data do leilão, tribunal e número de processo.
• Morada, concelho, distrito e área em m².
• Descrição completa, fotos e links para documentos.

---

Dados e preços fornecidos apenas a título indicativo — as informações oficiais prevalecem sempre.