# Portugal Property Auctions API - e-leiloes Judicial Auctions (`webdata_labs/portugal-e-leiloes-auctions-api`) Actor \[💵 $4.00 / 1K] Official Portugal e-leiloes judicial auctions in a clean English schema: minimum bid, appraisal discount, court case, debtor signals, location, and enforcement-agent contact for property, vehicle, and equipment auction sourcing. - **URL**: https://apify.com/webdata\_labs/portugal-e-leiloes-auctions-api.md - **Developed by:** [WebData Labs](https://apify.com/webdata_labs) (community) - **Categories:** Real estate, Lead generation, Developer tools - **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, 0 bookmarks - **User rating**: No ratings yet ## Pricing from $3.00 / 1,000 auction records This Actor is paid per event. You are not charged for the Apify platform usage, but only a fixed price for specific events. Since this Actor supports Apify Store discounts, the price gets lower the higher subscription plan you have. 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 API - e-leiloes Judicial Auctions **💵 $4.00 / 1,000 auction records. No actor-start fee. Platform usage included.** Structured, English-normalized data from **[e-leiloes.pt](https://www.e-leiloes.pt)** - the official national judicial e-auction portal of Portugal, run by **OSAE** (Ordem dos Solicitadores e dos Agentes de Execução). Real estate, vehicles, equipment, furniture and machinery sold through court-ordered (penhora / execução) auctions, turned into a clean investor-lead schema with the discount math, the judicial process and the enforcement-agent contact the raw portal never gives you in one place. Blue ocean: nobody else exposes the official e-leiloes register as an API. ### Why this Actor - **Official source.** Straight from the OSAE portal, not a re-seller aggregator. - **Investor-ready fields.** Appraisal value, minimum bid, opening bid, current bid and a derived **discount vs appraisal %** - the number distressed-asset buyers actually filter on. - **Motivated-seller / debt signals.** Court, case number and the debtors (`executados`) with tax IDs (NIF), plus encumbrances (ónus) with amounts and dates. - **Lead contact baked in.** The enforcement agent's name, licence (cédula), phone and email - a direct line to the person running each sale. - **Clean English.** Portuguese asset types, subtypes and modalities mapped to English; two mixed response encodings handled transparently. - **Monitoring mode.** Return only auctions you have not seen before, per district and asset type. ### Example input ```json { "districts": ["Lisboa", "Porto"], "assetTypes": ["Real estate"], "status": "live", "minValueEur": 50000, "maxValueEur": 300000, "includeDetails": true, "maxResults": 500 } ```` Leave `districts` empty to search **all of Portugal**. `assetTypes` accepts English names (`Real estate`, `Vehicle`, `Equipment`, `Furniture`, `Machinery`, `Right`) or their numeric codes. ### Example output (one auction, abridged) ```json { "recordType": "auction", "source": "e-leiloes.pt", "reference": "LO1487622026", "auctionUrl": "https://www.e-leiloes.pt/evento/LO1487622026", "assetType": "Real estate", "assetSubtype": "Rural land", "title": "Terreno arvense", "appraisalValueEur": 111156.63, "minBidEur": 94483.14, "openingBidEur": 55578.32, "discountPctVsAppraisal": 15.0, "openingPctOfAppraisal": 50.0, "vatChargeable": false, "vatPct": 23.0, "district": "Santarém", "municipality": "Abrantes", "parish": "Mouriscas", "totalAreaSqm": 349540, "latitude": 39.49, "longitude": -8.12, "endDate": "2026-07-08T10:00:00", "status": "live", "court": "Santarém - Juízo Comércio - Juiz 3", "caseNumber": "838/23.0T8STR", "debtors": [{ "name": "Amadeu dos Santos Guia", "taxId": "176795553", "isClaimant": false }], "encumbrances": [{ "type": "Mortgage", "amountEur": 1758.32, "contractDate": "2018-08-13" }], "ceremonyDate": "2026-07-08T14:30:00", "ceremonyLocation": "Lisboa - Palácio da Justiça", "agentName": "Vanda Fonseca Silva", "agentLicense": "299", "agentEmail": "vanda.c.silva@aj.caaj.pt", "agentPhone": "919226167" } ``` The run also emits one `search_summary` row per scope (available auctions, collected count, median minimum bid) and, in monitoring mode, `newAuctions` / `previouslySeen` counts. ### Fields Core (always): `reference`, `auctionUrl`, `assetType`, `assetSubtype`, `propertyType` (T-typology for dwellings), `modality`, `title`, `appraisalValueEur`, `minBidEur`, `currentBidEur`, `discountPctVsAppraisal`, `hasBids`, `district`, `municipality`, `parish`, `startDate`, `endDate`, `status`, `photoUrl`. With **Include full details** (optional, slower): `openingBidEur`, `openingPctOfAppraisal`, `vatChargeable`, `vatPct`, `description`, `observations`, `usableAreaSqm`, `dependentAreaSqm`, `totalAreaSqm`, `street`, `postalCode`, `latitude`, `longitude`, `vehiclePlate`, `caseNumber`, `courtDistrict`, `court`, `debtors[]`, `encumbrances[]`, `ceremonyDate`, `ceremonyLocation`, `ceremonyAddress`, `agentName`, `agentEmail`, `agentPhone`, `agentLicense`, `agentCourtDistrict`, `agentAddress`, `photoCount`, `documentCount`. ### Common uses - **Distressed real-estate sourcing** - live judicial property auctions filtered by district, value and discount. - **Vehicle / equipment auction feeds** - dealers and liquidators tracking court sales. - **Enforcement-agent lead lists** - reach the agente de execução managing each lot. - **Scheduled monitoring** - run daily in monitoring mode and get only the new auctions. ### Notes and limits - The portal serves a fixed page size; large districts are paged automatically. Use `maxResults` to cap volume and cost. - `includeDetails` adds one request per auction. It is optional and slower; leave it off for a fast, cheap headline scan. From Apify cloud, the official portal can intermittently time out on detail requests, so detail rows should be treated as best-effort until the portal is serving steadily. - `e-leiloes.pt` presents an incomplete TLS certificate chain; the Actor verifies first and falls back to an unverified context only for this host. - This Actor reads **public** auction notices that the portal publishes for transparency of court-ordered sales. It is an independent tool, not affiliated with OSAE or e-leiloes.pt, and does not place bids or submit anything to the portal. Respect the portal's terms and applicable law (incl. GDPR) when using debtor/agent personal data. # Actor input Schema ## `districts` (type: `array`): Portuguese districts to search. One request per district. Valid values: Aveiro, Beja, Braga, Bragança, Castelo Branco, Coimbra, Évora, Faro, Guarda, Ilha da Graciosa, Ilha da Madeira, Ilha das Flores, Ilha de Porto Santo, Ilha de Santa Maria, Ilha de São Jorge, Ilha de São Miguel, Ilha do Faial, Ilha do Pico, Ilha Terceira, Leiria, Lisboa, Portalegre, Porto, Santarém, Setúbal, Viana do Castelo, Vila Real, Viseu. Leave empty or use "all" to search all of Portugal (cap with Max results). ## `assetTypes` (type: `array`): Optional filter. Accepts English names or codes: Real estate (1), Vehicle (2), Equipment (3), Furniture (4), Machinery (5), Right (6). Empty = all asset types. ## `status` (type: `string`): "live" = auctions currently on sale (a decorrer). "ended" = terminated auctions. ## `minValueEur` (type: `integer`): Only auctions whose minimum acceptable bid (valor mínimo) is at or above this value. ## `maxValueEur` (type: `integer`): Only auctions whose minimum acceptable bid (valor mínimo) is at or below this value. ## `includeDetails` (type: `boolean`): Fetch each auction's detail record for area, coordinates, VAT, opening bid, the judicial process (court, case number, debtors), encumbrances (ónus), the auction ceremony, and the enforcement agent's name, phone and email. One extra request per auction - slower on large searches, but this is where the investor-lead and contact fields come from. ## `onlyNewAuctions` (type: `boolean`): Push only auctions not seen in previous runs of this Actor on your account (per district and asset type). The first run returns everything and initializes memory; every following run returns just the delta - ideal for scheduled monitoring, and you are charged only for new rows. ## `maxResults` (type: `integer`): Cap the number of auctions collected per district/asset-type combination. ## `proxyConfiguration` (type: `object`): Apify cloud reaches e-leiloes.pt more reliably through RESIDENTIAL proxy exits than direct datacenter IPs. Keep enabled unless you have a reason to test direct access. ## Actor input object example ```json { "districts": [ "Lisboa" ], "assetTypes": [ "Real estate" ], "status": "live", "includeDetails": false, "onlyNewAuctions": false, "maxResults": 10, "proxyConfiguration": { "useApifyProxy": true, "apifyProxyGroups": [ "RESIDENTIAL" ] } } ``` # Actor output Schema ## `auctions` (type: `string`): No description ## `summaries` (type: `string`): No description ## `errors` (type: `string`): No description ## `output` (type: `string`): No description # 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 = { "districts": [ "Lisboa" ], "assetTypes": [ "Real estate" ], "maxResults": 10 }; // Run the Actor and wait for it to finish const run = await client.actor("webdata_labs/portugal-e-leiloes-auctions-api").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 = { "districts": ["Lisboa"], "assetTypes": ["Real estate"], "maxResults": 10, } # Run the Actor and wait for it to finish run = client.actor("webdata_labs/portugal-e-leiloes-auctions-api").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 '{ "districts": [ "Lisboa" ], "assetTypes": [ "Real estate" ], "maxResults": 10 }' | apify call webdata_labs/portugal-e-leiloes-auctions-api --silent --output-dataset ``` ## MCP server setup ```json { "mcpServers": { "apify": { "command": "npx", "args": [ "mcp-remote", "https://mcp.apify.com/?tools=webdata_labs/portugal-e-leiloes-auctions-api", "--header", "Authorization: Bearer " ] } } } ``` ## OpenAPI specification ```json { "openapi": "3.0.1", "info": { "title": "Portugal Property Auctions API - e-leiloes Judicial Auctions", "description": "[💵 $4.00 / 1K] Official Portugal e-leiloes judicial auctions in a clean English schema: minimum bid, appraisal discount, court case, debtor signals, location, and enforcement-agent contact for property, vehicle, and equipment auction sourcing.", "version": "0.1", "x-build-id": "oV609h4KpaEvm7msY" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/webdata_labs~portugal-e-leiloes-auctions-api/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-webdata_labs-portugal-e-leiloes-auctions-api", "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/webdata_labs~portugal-e-leiloes-auctions-api/runs": { "post": { "operationId": "runs-sync-webdata_labs-portugal-e-leiloes-auctions-api", "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/webdata_labs~portugal-e-leiloes-auctions-api/run-sync": { "post": { "operationId": "run-sync-webdata_labs-portugal-e-leiloes-auctions-api", "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": { "districts": { "title": "Districts (distritos)", "type": "array", "description": "Portuguese districts to search. One request per district. Valid values: Aveiro, Beja, Braga, Bragança, Castelo Branco, Coimbra, Évora, Faro, Guarda, Ilha da Graciosa, Ilha da Madeira, Ilha das Flores, Ilha de Porto Santo, Ilha de Santa Maria, Ilha de São Jorge, Ilha de São Miguel, Ilha do Faial, Ilha do Pico, Ilha Terceira, Leiria, Lisboa, Portalegre, Porto, Santarém, Setúbal, Viana do Castelo, Vila Real, Viseu. Leave empty or use \"all\" to search all of Portugal (cap with Max results).", "items": { "type": "string" } }, "assetTypes": { "title": "Asset types", "type": "array", "description": "Optional filter. Accepts English names or codes: Real estate (1), Vehicle (2), Equipment (3), Furniture (4), Machinery (5), Right (6). Empty = all asset types.", "default": [ "Real estate" ], "items": { "type": "string" } }, "status": { "title": "Auction status", "enum": [ "live", "ended" ], "type": "string", "description": "\"live\" = auctions currently on sale (a decorrer). \"ended\" = terminated auctions.", "default": "live" }, "minValueEur": { "title": "Min minimum-bid (EUR)", "minimum": 0, "type": "integer", "description": "Only auctions whose minimum acceptable bid (valor mínimo) is at or above this value." }, "maxValueEur": { "title": "Max minimum-bid (EUR)", "minimum": 0, "type": "integer", "description": "Only auctions whose minimum acceptable bid (valor mínimo) is at or below this value." }, "includeDetails": { "title": "Include full details", "type": "boolean", "description": "Fetch each auction's detail record for area, coordinates, VAT, opening bid, the judicial process (court, case number, debtors), encumbrances (ónus), the auction ceremony, and the enforcement agent's name, phone and email. One extra request per auction - slower on large searches, but this is where the investor-lead and contact fields come from.", "default": false }, "onlyNewAuctions": { "title": "Only new auctions (monitoring mode)", "type": "boolean", "description": "Push only auctions not seen in previous runs of this Actor on your account (per district and asset type). The first run returns everything and initializes memory; every following run returns just the delta - ideal for scheduled monitoring, and you are charged only for new rows.", "default": false }, "maxResults": { "title": "Max results per scope", "minimum": 1, "maximum": 20000, "type": "integer", "description": "Cap the number of auctions collected per district/asset-type combination.", "default": 10 }, "proxyConfiguration": { "title": "Proxy", "type": "object", "description": "Apify cloud reaches e-leiloes.pt more reliably through RESIDENTIAL proxy exits than direct datacenter IPs. Keep enabled unless you have a reason to test direct access.", "default": { "useApifyProxy": true, "apifyProxyGroups": [ "RESIDENTIAL" ] } } } }, "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 } } } } } } } } } } ```