# Portugal Property Auctions Scraper (Centro de Leilões) (`signalflow/portugal-centro-leiloes`) Actor Scrape centrodeleiloes.pt — Portuguese property auctions (judicial and insolvency): valor base, valor mínimo (85%) and valor de abertura (50%), court, date, address and PDF documents. Filter by district, type and value. Export to JSON/CSV/Excel. - **URL**: https://apify.com/signalflow/portugal-centro-leiloes.md - **Developed by:** [SignalFlow](https://apify.com/signalflow) (community) - **Categories:** Real estate, MCP servers - **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, NaN bookmarks - **User rating**: No ratings yet ## Pricing from $3.00 / 1,000 results This Actor is paid per event. You are not charged for the Apify platform usage, but only a fixed price for specific events. Learn more: https://docs.apify.com/platform/actors/running/actors-in-store#pay-per-event ## What's an Apify Actor? Actors are a software tools running on the Apify platform, for all kinds of web data extraction and automation use cases. In Batch mode, an Actor accepts a well-defined JSON input, performs an action which can take anything from a few seconds to a few hours, and optionally produces a well-defined JSON output, datasets with results, or files in key-value store. In Standby mode, an Actor provides a web server which can be used as a website, API, or an MCP server. Actors are written with capital "A". ## How to integrate an Actor? If asked about integration, you help developers integrate Actors into their projects. You adapt to their stack and deliver integrations that are safe, well-documented, and production-ready. The best way to integrate Actors is as follows. In JavaScript/TypeScript projects, use official [JavaScript/TypeScript client](https://docs.apify.com/api/client/js.md): ```bash npm install apify-client ``` In Python projects, use official [Python client library](https://docs.apify.com/api/client/python.md): ```bash pip install apify-client ``` In shell scripts, use [Apify CLI](https://docs.apify.com/cli/docs.md): ````bash # MacOS / Linux curl -fsSL https://apify.com/install-cli.sh | bash # Windows irm https://apify.com/install-cli.ps1 | iex ```bash In AI frameworks, you might use the [Apify MCP server](https://docs.apify.com/platform/integrations/mcp.md). If your project is in a different language, use the [REST API](https://docs.apify.com/api/v2.md). For usage examples, see the [API](#api) section below. For more details, see Apify documentation as [Markdown index](https://docs.apify.com/llms.txt) and [Markdown full-text](https://docs.apify.com/llms-full.txt). # README ## 🇵🇹 Portugal Property Auctions Scraper (Centro de Leilões) Extract Portuguese property and public auction listings from [Centro de Leilões](https://www.centrodeleiloes.pt) — 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. ```json { "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](https://mcp.apify.com/). 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](https://www.centrodeleiloes.pt), 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:** ```json { "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.* # Actor input Schema ## `distrito` (type: `string`): Optional district filter (partial match), e.g. 'Lisboa', 'Porto', 'Braga'. ## `concelho` (type: `string`): Optional municipality filter (partial match), e.g. 'Sintra', 'Oeiras', 'Benavente'. ## `tipo` (type: `string`): Filter by property type. 'all' returns every auction type. ## `tipo_processo` (type: `string`): Filter by auction process type. Judicial = court-ordered; Insolvência = insolvency; Voluntária = voluntary. ## `min_valor` (type: `integer`): Only return auctions with a base value above this amount. 0 = no limit. ## `max_valor` (type: `integer`): Only return auctions with a base value below this amount. 0 = no limit. ## `max_items` (type: `integer`): Maximum number of auctions to scrape. 0 = unlimited. ## `download_pdf` (type: `boolean`): Save each auction PDF to permanent storage and return a stable URL, so the document is never lost even if the source link expires. On by default; turn off to only keep the original source links (slightly faster). ## `proxyConfiguration` (type: `object`): Proxy settings. The Actor automatically uses the Apify RESIDENTIAL proxy for HTML pages (the source throttles datacenter IPs) and the cheaper datacenter proxy for PDF downloads, to stay fast and low-cost. Residential usage is billed by Apify. ## `include_unpriced` (type: `boolean`): Include listings with no price set yet. Off by default to avoid empty/N/A rows. ## `concurrency` (type: `integer`): How many auction detail pages to fetch in parallel. Higher = faster. ## Actor input object example ```json { "distrito": "Lisboa", "concelho": "", "tipo": "all", "tipo_processo": "all", "min_valor": 0, "max_valor": 0, "max_items": 100, "download_pdf": true, "proxyConfiguration": { "useApifyProxy": true }, "include_unpriced": false, "concurrency": 4 } ``` # Actor output Schema ## `dataset` (type: `string`): All scraped items in a table you can view, filter and export (JSON, CSV, Excel, XML). ## `documents` (type: `string`): Auction PDF documents saved to the key-value store (permanent links). # API You can run this Actor programmatically using our API. Below are code examples in JavaScript, Python, and CLI, as well as the OpenAPI specification and MCP server setup. ## JavaScript example ```javascript import { ApifyClient } from 'apify-client'; // Initialize the ApifyClient with your Apify API token // Replace the '' with your token const client = new ApifyClient({ token: '', }); // Prepare Actor input const input = { "distrito": "Lisboa" }; // Run the Actor and wait for it to finish const run = await client.actor("signalflow/portugal-centro-leiloes").call(input); // Fetch and print Actor results from the run's dataset (if any) console.log('Results from dataset'); console.log(`💾 Check your data here: https://console.apify.com/storage/datasets/${run.defaultDatasetId}`); const { items } = await client.dataset(run.defaultDatasetId).listItems(); items.forEach((item) => { console.dir(item); }); // 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/js/docs ``` ## Python example ```python from apify_client import ApifyClient # Initialize the ApifyClient with your Apify API token # Replace '' with your token. client = ApifyClient("") # Prepare the Actor input run_input = { "distrito": "Lisboa" } # Run the Actor and wait for it to finish run = client.actor("signalflow/portugal-centro-leiloes").call(run_input=run_input) # Fetch and print Actor results from the run's dataset (if there are any) print("💾 Check your data here: https://console.apify.com/storage/datasets/" + run["defaultDatasetId"]) for item in client.dataset(run["defaultDatasetId"]).iterate_items(): print(item) # 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/python/docs/quick-start ``` ## CLI example ```bash echo '{ "distrito": "Lisboa" }' | apify call signalflow/portugal-centro-leiloes --silent --output-dataset ``` ## MCP server setup ```json { "mcpServers": { "apify": { "command": "npx", "args": [ "mcp-remote", "https://mcp.apify.com/?tools=signalflow/portugal-centro-leiloes", "--header", "Authorization: Bearer " ] } } } ``` ## OpenAPI specification ```json { "openapi": "3.0.1", "info": { "title": "Portugal Property Auctions Scraper (Centro de Leilões)", "description": "Scrape centrodeleiloes.pt — Portuguese property auctions (judicial and insolvency): valor base, valor mínimo (85%) and valor de abertura (50%), court, date, address and PDF documents. Filter by district, type and value. Export to JSON/CSV/Excel.", "version": "0.1", "x-build-id": "avVJ6fNYGLrIuapef" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/signalflow~portugal-centro-leiloes/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-signalflow-portugal-centro-leiloes", "x-openai-isConsequential": false, "summary": "Executes an Actor, waits for its completion, and returns Actor's dataset items in response.", "tags": [ "Run Actor" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/inputSchema" } } } }, "parameters": [ { "name": "token", "in": "query", "required": true, "schema": { "type": "string" }, "description": "Enter your Apify token here" } ], "responses": { "200": { "description": "OK" } } } }, "/acts/signalflow~portugal-centro-leiloes/runs": { "post": { "operationId": "runs-sync-signalflow-portugal-centro-leiloes", "x-openai-isConsequential": false, "summary": "Executes an Actor and returns information about the initiated run in response.", "tags": [ "Run Actor" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/inputSchema" } } } }, "parameters": [ { "name": "token", "in": "query", "required": true, "schema": { "type": "string" }, "description": "Enter your Apify token here" } ], "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/runsResponseSchema" } } } } } } }, "/acts/signalflow~portugal-centro-leiloes/run-sync": { "post": { "operationId": "run-sync-signalflow-portugal-centro-leiloes", "x-openai-isConsequential": false, "summary": "Executes an Actor, waits for completion, and returns the OUTPUT from Key-value store in response.", "tags": [ "Run Actor" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/inputSchema" } } } }, "parameters": [ { "name": "token", "in": "query", "required": true, "schema": { "type": "string" }, "description": "Enter your Apify token here" } ], "responses": { "200": { "description": "OK" } } } } }, "components": { "schemas": { "inputSchema": { "type": "object", "properties": { "distrito": { "title": "Distrito", "type": "string", "description": "Optional district filter (partial match), e.g. 'Lisboa', 'Porto', 'Braga'.", "default": "" }, "concelho": { "title": "Concelho", "type": "string", "description": "Optional municipality filter (partial match), e.g. 'Sintra', 'Oeiras', 'Benavente'.", "default": "" }, "tipo": { "title": "Property Type", "enum": [ "all", "residential", "commercial", "land", "industrial", "other" ], "type": "string", "description": "Filter by property type. 'all' returns every auction type.", "default": "all" }, "tipo_processo": { "title": "Process Type", "enum": [ "all", "judicial", "insolvencia", "voluntaria" ], "type": "string", "description": "Filter by auction process type. Judicial = court-ordered; Insolvência = insolvency; Voluntária = voluntary.", "default": "all" }, "min_valor": { "title": "Minimum Base Value (€)", "minimum": 0, "type": "integer", "description": "Only return auctions with a base value above this amount. 0 = no limit.", "default": 0 }, "max_valor": { "title": "Maximum Base Value (€)", "minimum": 0, "type": "integer", "description": "Only return auctions with a base value below this amount. 0 = no limit.", "default": 0 }, "max_items": { "title": "Max Items", "minimum": 0, "type": "integer", "description": "Maximum number of auctions to scrape. 0 = unlimited.", "default": 100 }, "download_pdf": { "title": "Download PDF documents", "type": "boolean", "description": "Save each auction PDF to permanent storage and return a stable URL, so the document is never lost even if the source link expires. On by default; turn off to only keep the original source links (slightly faster).", "default": true }, "proxyConfiguration": { "title": "Proxy Configuration", "type": "object", "description": "Proxy settings. The Actor automatically uses the Apify RESIDENTIAL proxy for HTML pages (the source throttles datacenter IPs) and the cheaper datacenter proxy for PDF downloads, to stay fast and low-cost. Residential usage is billed by Apify.", "default": { "useApifyProxy": true } }, "include_unpriced": { "title": "Include unscheduled/unpriced listings", "type": "boolean", "description": "Include listings with no price set yet. Off by default to avoid empty/N/A rows.", "default": false }, "concurrency": { "title": "Concurrency", "minimum": 1, "maximum": 15, "type": "integer", "description": "How many auction detail pages to fetch in parallel. Higher = faster.", "default": 4 } } }, "runsResponseSchema": { "type": "object", "properties": { "data": { "type": "object", "properties": { "id": { "type": "string" }, "actId": { "type": "string" }, "userId": { "type": "string" }, "startedAt": { "type": "string", "format": "date-time", "example": "2025-01-08T00:00:00.000Z" }, "finishedAt": { "type": "string", "format": "date-time", "example": "2025-01-08T00:00:00.000Z" }, "status": { "type": "string", "example": "READY" }, "meta": { "type": "object", "properties": { "origin": { "type": "string", "example": "API" }, "userAgent": { "type": "string" } } }, "stats": { "type": "object", "properties": { "inputBodyLen": { "type": "integer", "example": 2000 }, "rebootCount": { "type": "integer", "example": 0 }, "restartCount": { "type": "integer", "example": 0 }, "resurrectCount": { "type": "integer", "example": 0 }, "computeUnits": { "type": "integer", "example": 0 } } }, "options": { "type": "object", "properties": { "build": { "type": "string", "example": "latest" }, "timeoutSecs": { "type": "integer", "example": 300 }, "memoryMbytes": { "type": "integer", "example": 1024 }, "diskMbytes": { "type": "integer", "example": 2048 } } }, "buildId": { "type": "string" }, "defaultKeyValueStoreId": { "type": "string" }, "defaultDatasetId": { "type": "string" }, "defaultRequestQueueId": { "type": "string" }, "buildNumber": { "type": "string", "example": "1.0.0" }, "containerUrl": { "type": "string" }, "usage": { "type": "object", "properties": { "ACTOR_COMPUTE_UNITS": { "type": "integer", "example": 0 }, "DATASET_READS": { "type": "integer", "example": 0 }, "DATASET_WRITES": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_READS": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_WRITES": { "type": "integer", "example": 1 }, "KEY_VALUE_STORE_LISTS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_READS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_WRITES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_INTERNAL_GBYTES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_EXTERNAL_GBYTES": { "type": "integer", "example": 0 }, "PROXY_RESIDENTIAL_TRANSFER_GBYTES": { "type": "integer", "example": 0 }, "PROXY_SERPS": { "type": "integer", "example": 0 } } }, "usageTotalUsd": { "type": "number", "example": 0.00005 }, "usageUsd": { "type": "object", "properties": { "ACTOR_COMPUTE_UNITS": { "type": "integer", "example": 0 }, "DATASET_READS": { "type": "integer", "example": 0 }, "DATASET_WRITES": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_READS": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_WRITES": { "type": "number", "example": 0.00005 }, "KEY_VALUE_STORE_LISTS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_READS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_WRITES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_INTERNAL_GBYTES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_EXTERNAL_GBYTES": { "type": "integer", "example": 0 }, "PROXY_RESIDENTIAL_TRANSFER_GBYTES": { "type": "integer", "example": 0 }, "PROXY_SERPS": { "type": "integer", "example": 0 } } } } } } } } } } ```