# Europe Distressed Property Scraper - Foreclosures & Auctions (`abotapi/distressed-eu-scraper`) Actor

Distressed-property leads across Europe: German ZVG foreclosure auctions, Polish KRZ restructuring proceedings, and Spanish BOE judicial auctions in one run, with detail enrichment, resume, and incremental change tracking.

- **URL**: https://apify.com/abotapi/distressed-eu-scraper.md
- **Developed by:** [Abot API](https://apify.com/abotapi) (community)
- **Categories:** Real estate, Automation, Developer tools
- **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, 0 bookmarks
- **User rating**: No ratings yet

## Pricing

from $1.80 / 1,000 distressed property 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/actors/running/actors-in-store.md#pay-per-event

## What's an Apify Actor?

An Actor is a serverless cloud program that runs on the Apify platform. It has two run modes.
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.

Apify vocabulary and the platform model are defined once, in the agent quickstart at https://apify.com/agents.md.

## 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.

Do not guess an integration path. Every one of them is in the agent quickstart at https://apify.com/agents.md: the Apify MCP server, Agent Skills with the Apify CLI, the JavaScript and Python clients, the REST API, and the account-free path for an agent with no human to sign in. It also carries the rule on stating cost before the first paid run.

For examples already wired to this Actor's own input schema, see the [API](#api) section below.

Each client library has reference documentation the quickstart does not restate: [JavaScript/TypeScript](https://docs.apify.com/api/client/js/docs.md) (`npm install apify-client`) and [Python](https://docs.apify.com/api/client/python/docs.md) (`pip install apify-client`).

# README

## Europe Distressed Property Scraper

Distressed-property and insolvency leads across Europe in one run: German foreclosure auctions (ZVG), Polish restructuring proceedings (KRZ), and Spanish judicial auctions (BOE). Pick one country or combine lanes in a single run, enrich each record from its detail page, and track what changed between scheduled runs.

### Why This Scraper?

- **Three registers, one actor.** Walk the German ZVG foreclosure auction portal, the Polish KRZ restructuring register, and the Spanish BOE judicial auction portal. Each lane keeps its own native filters, and every record comes back normalized to one schema.
- **Detail enrichment built in.** Every record can be opened on its source page for the full description, case numbers, parties, valuations, auction dates, and attached documents (appraisals, official announcements, photos).
- **Made for recurring monitoring.** Resume an interrupted run from its ID, or let incremental mode remember what you already scraped and return only NEW and UPDATED records, with EXPIRED markers when a record leaves the source.
- **Search the way each register wants.** German state, city and auction-date windows; Polish entity, identifier and case-signature lookups; Spanish auction status and deadline ranges. Or just paste links and let URL mode sort them out.
- **Honest by design.** If a register refuses every request the run fails loudly instead of returning an empty dataset that looks like "no results". A genuine empty search says so.

### Use Cases

- **Who:** Investors and buyers hunting below-market property across EU foreclosure and judicial-auction channels.
- **Who:** Restructuring and insolvency professionals tracking proceedings by company name or identifier in Poland.
- **Who:** Lead-generation teams feeding distressed-property signals into CRM systems and alerting pipelines on a schedule.
- **Who:** Analysts comparing distressed inventory levels across European markets from one dataset.

### Data You Get

> Sample shape: values are illustrative placeholders, not from a live record.

| Field | Example |
| --- | --- |
| `recordId` | `"es:boe:SUB-JA-2026-000000"` |
| `country` | `"de"`, `"pl"` or `"es"` |
| `source` | `"zvg"`, `"krz"` or `"boe"` |
| `title` | `"Apartment (1 to 2 rooms): Musterstraße 1, 12345 Musterstadt"` |
| `distressType` | `"foreclosure_auction"`, `"restructuring_proceeding"`, `"judicial_auction"` |
| `caseNumber` | `"0123 O 0045/2026"` |
| `auctionDate` | `"2026-11-03T09:30:00"` |
| `deadlineAt` | `"2026-11-20"` |
| `location.address` / `location.city` / `location.region` | `"Musterstraße 1, 12345 Musterstadt"` / `"Musterstadt"` / `"BE"` (the property, not the court) |
| `valueAmount` / `valueCurrency` | `250000` / `"EUR"` |
| `status` | `"scheduled"`, `"zakończone"`, `"Celebrándose"` |
| `parties` | `[{ "role": "authority", "name": "Sample Court" }]` |
| `attachments` | `[{ "label": "Gutachten1.pdf", "url": "..." }]` |
| `description` | full detail description (when enrichment is on) |
| `details` | per-source detail block (valuation, lot data, register data) |
| `court` / `stateName` / `objectType` / `propertyType` | German rows: the Amtsgericht (filled from the record page when `fetchDetails` is on, or from the court filter; otherwise null, never the state name), state name, object type as listed (with room counts) and property type (the category only, e.g. Eigentumswohnung); the auction kind is in `details.artDerVersteigerung` |
| `area` / `pricePerSqm` | German rows: area and price per square metre (when the listing states an area) |
| `daysUntilAuction` / `isNewSinceLastRun` | days until the auction; new-since-last-run flag (incremental runs) |
| `changeType` / `changedFields` / `firstSeenAt` / `lastSeenAt` | incremental-mode metadata |
| `url` | source record URL |

### How to Use

1. Pick a **Mode**: `search` (default) walks the country lanes with your filters; `url` reads only the links you paste. Pasted links are ignored in search mode, and the run log says so.
2. In search mode, pick your **country lanes** (Germany, Poland, Spain) and set each lane's filters (German state/city/dates, Polish entity name or identifier, Spanish auction status and date windows). In url mode, paste register links.
3. Set **Max items** and whether to fetch detail pages, then click **Start**.
4. Download the dataset as JSON, CSV or Excel, or read it through the API.

**German foreclosure auctions:**

```json
{
  "mode": "search",
  "country": ["de"],
  "deLand": "be",
  "deCity": "Berlin",
  "deSort": "2",
  "fetchDetails": true,
  "maxItems": 50
}
```

**Polish restructuring proceedings by entity:**

```json
{
  "mode": "search",
  "country": ["pl"],
  "plEntityName": "Sample Company Name",
  "plIdentifier": "0000000000",
  "maxItems": 20
}
```

**Spanish judicial auctions by deadline window:**

```json
{
  "mode": "search",
  "country": ["es"],
  "esAuctionStatus": "EJ",
  "esDeadlineFrom": "2026-10-01",
  "esDeadlineTo": "2026-12-31",
  "maxItems": 100
}
```

**Paste links from any supported register (url mode):**

```json
{
  "mode": "url",
  "urls": [
    "https://www.zvg-portal.de/index.php?button=showZvg&zvg_id=14429&land_abk=be",
    "https://subastas.boe.es/detalleSubasta.php?idSub=SUB-JA-2026-263220&ver=1"
  ],
  "fetchDetails": true
}
```

Prefer to paste links? URL mode reads German foreclosure record pages and Spanish auction pages; each auction gives one record. **Behaviour change:** in url mode, leaving the **URLs** field untouched now scrapes the two example links below instead of nothing. Pasting several tabs of the same Spanish auction returns that auction once.

| Link shape | Example | Result |
|---|---|---|
| German record page (showZvg) | `https://www.zvg-portal.de/index.php?button=showZvg&zvg_id=14429&land_abk=be` | one record (a session is opened for you first) |
| Spanish auction, general data (ver=1) | `https://subastas.boe.es/detalleSubasta.php?idSub=SUB-JA-2026-263220&ver=1` | one record |
| Spanish auction, other tab (ver=2) or lots tab (ver=3) | `...detalleSubasta.php?idSub=SUB-JA-2026-263220&ver=3` | same record as ver=1, returned once |
| Spanish auction without ver | `https://subastas.boe.es/detalleSubasta.php?idSub=SUB-JA-2026-263220` | one record |
| Spanish auction under the /reg/ path | `https://subastas.boe.es/reg/detalleSubasta.php?idSub=SUB-JA-2026-263220` | one record |
| German search form page | `https://www.zvg-portal.de/index.php?button=Termine%20suchen` | skipped with a warning; use search mode |
| Spanish search form page | `https://subastas.boe.es/subastas_ava.php` | skipped with a warning; use search mode |
| Polish register home | `https://krz.ms.gov.pl/` | skipped with a warning; it has no per-record link, use search mode |

When a German court or place filter matches no listing, the run log says so and names the state(s) searched. A court name that matches no court of the state is reported instead of silently returning the whole state. City names with umlauts match in any spelling (Köln, Koeln).

#### Run it from your code

**Python:**

```python
from apify_client import ApifyClient

client = ApifyClient("YOUR_APIFY_TOKEN")
run = client.actor("abotapi/distressed-eu-scraper").call(run_input={
    "country": ["de"],
    "deLand": "be",
    "deCity": "Berlin",
    "fetchDetails": True,
    "maxItems": 50,
})

for item in client.dataset(run["defaultDatasetId"]).iterate_items():
    print(item["recordId"], item["title"], item.get("valueAmount"))
```

**JavaScript:**

```javascript
import { ApifyClient } from 'apify-client';

const client = new ApifyClient({ token: 'YOUR_APIFY_TOKEN' });
const run = await client.actor('abotapi/distressed-eu-scraper').call({
    country: ['es'],
    esAuctionStatus: 'EJ',
    fetchDetails: true,
    maxItems: 50,
});

const { items } = await client.dataset(run.defaultDatasetId).listItems();
for (const item of items) console.log(item.recordId, item.title);
```

Or connect it to Make, Zapier, n8n, Google Sheets or webhooks from the **Integrations** tab.

#### Resume and recurring updates

- **Resume** (`resumeFromRunId`) continues one interrupted run: paste its run ID and the actor skips everything already collected there, so you don't pay twice.
- **Incremental mode** (`incrementalMode`) is for scheduled runs over the same scope. Each record is classified `NEW`, `UPDATED` (with `changedFields`), `UNCHANGED` (suppressed and not billed unless `emitUnchanged` is on) or `EXPIRED` (only after a run that scanned the whole scope, and only with `emitExpired`). Use `stateKey` to share one baseline across slightly different filter variants, and `ignoreFieldsForChanges` to exclude noisy fields from the comparison. The two features are mutually exclusive; pick one per run.

### Send results into your apps (MCP connectors)

Optionally send a summary of each returned record into an app connected through Apify MCP integrations. Select one or more **MCP connectors** and, for Notion, provide the parent page URL or ID. The actor creates a Notion page per record; other connectors receive a best-effort write or digest. Exports are capped by **Max items to export per connector** (50 by default), and connector failures do not change dataset output.

| Field | What it does |
|---|---|
| `mcpConnectors` | Selected MCP connectors (empty = no export). |
| `notionParentPageUrl` | Notion parent page URL or ID; required for Notion exports. |
| `maxNotifyListings` | Maximum records sent to each selected connector (default `50`, maximum `1000`). |

### Input Parameters

All parameters are optional unless noted. Each country lane uses only its own filters.

| Parameter | Type | Default | Description |
| --- | --- | --- | --- |
| `mode` | string | `search` | `search` walks the country lanes with your filters; `url` reads only the pasted links. |
| `country` | array | `["de"]` | Country lanes to walk, in order: `de`, `pl`, `es`. Search mode only. |
| `deLand` | string | `be` | German state code (required for the ZVG search): `bw`, `by`, `be`, `bb`, `hb`, `hh`, `he`, `mv`, `ni`, `nw`, `rp`, `sl`, `sn`, `st`, `sh`, `th`. |
| `deLands` | array | (none) | Several German states in one run (codes, or `all` for all 16). Replaces `deLand` when set; `deLand` keeps working. |
| `deCourt` | string | (none) | One Amtsgericht of the selected state, by the town the portal lists (for example `Charlottenburg`, `München`). |
| `deObjectType` | string | (none) | German object-type filter. |
| `deStreet` | string | (none) | German street filter. |
| `dePostalCode` | string | (none) | German postal code filter. |
| `deCity` | string | (none) | German city filter; matches the town in the address (not the street); umlaut spellings (Köln, Koeln) both match. |
| `deAuctionType` | string | (none) | German auction-type selector. |
| `deAuctionDateFrom` | string | (none) | Only auctions on/after this date (YYYY-MM-DD). |
| `deAuctionDateTo` | string | (none) | Only auctions on/before this date (YYYY-MM-DD). |
| `deSort` | string | `2` | Sort: `2` auction date, `1` last update, `3` case number. |
| `plEntityName` | string | (none) | Polish entity name to search in the restructuring register. |
| `plIdentifier` | string | (none) | KRS/NIP/PESEL identifier to combine with the name. |
| `plCaseSignature` | string | (none) | Exact case signature (sygnatura). |
| `plSoleTraderName` | string | (none) | Sole-trader business name (JDG). |
| `plFirstName` | string | (none) | Natural-person first name (with `plLastName`). |
| `plLastName` | string | (none) | Natural-person last name (with `plFirstName`). |
| `esAuctionStatus` | string | `EJ` | Spanish auction lifecycle: `EJ`, `PU`, `SU`, `CA`, `FS`, or empty for all. |
| `esDeadlineFrom` | string | (none) | Spanish conclusion date on/after (YYYY-MM-DD). |
| `esDeadlineTo` | string | (none) | Spanish conclusion date on/before (YYYY-MM-DD). |
| `esStartFrom` | string | (none) | Spanish start date on/after (YYYY-MM-DD). |
| `esStartTo` | string | (none) | Spanish start date on/before (YYYY-MM-DD). |
| `urls` | array | one German record and one Spanish auction example | Pasted record links: a German foreclosure record page or a Spanish auction page. Read in url mode only. |
| `fetchDetails` | boolean | `true` | Open each record's detail page for the full field set. |
| `maxItems` | integer | `50` | Total result cap across all lanes (`0` = no limit; the German register alone holds thousands of auctions, so set a number you are happy to pay for). |
| `maxPages` | integer | `0` | Page cap per search walk; `0` = until natural end. |
| `proxy` | object | standard pool | Connection settings. Poland uses its own premium connection automatically. |
| `resumeFromRunId` | string | (none) | Continue a previous run; only unpushed records are saved. |
| `incrementalMode` | boolean | `false` | Track changes across scheduled runs; only NEW/UPDATED returned. Mutually exclusive with `resumeFromRunId`. |
| `stateKey` | string | (none) | Named incremental baseline; derived from the scope when empty. |
| `emitUnchanged` | boolean | `false` | Also return UNCHANGED records in incremental mode. |
| `emitExpired` | boolean | `false` | Also return EXPIRED records in incremental mode. |
| `ignoreFieldsForChanges` | array | (none) | Extra fields that never count as a change. |
| `mcpConnectors` | array | (none) | Optional MCP connectors to receive returned record summaries after the run. |
| `notionParentPageUrl` | string | (none) | Parent page URL or ID required for Notion page creation. |
| `maxNotifyListings` | integer | `50` | Maximum records sent to each connector (`1`-`1000`). |

### Output Example

The Output tab offers three tables: **Overview** (one row per record, including court, state, object type, area and days until the auction), **Detail-enriched** (runs with detail fetching on) and **Changes** (change type, changed fields, first and last seen, for incremental runs). A run summary record is also stored in the key-value store.

> Sample shape: values are illustrative placeholders, not from a live record.

**Example record (Spain, detail-enriched):**

```json
{
  "recordId": "es:boe:SUB-JA-2026-000000",
  "country": "es",
  "source": "boe",
  "title": "Sample commercial unit, ground floor, Sampletown",
  "distressType": "judicial_auction",
  "caseNumber": "0000 0000 00 0000 00",
  "proceedingId": "SUB-JA-2026-000000",
  "publishedAt": "2026-09-01",
  "deadlineAt": "2026-10-11",
  "location": { "address": "Calle Muestra 1", "city": "Sampletown", "region": "Sample", "country": "es" },
  "valueAmount": 125887.5,
  "valueCurrency": "EUR",
  "status": "Celebrándose",
  "parties": [{ "role": "authority", "name": "Sample Court" }],
  "description": "Sample auction description.",
  "attachments": [{ "label": "Documento 1", "url": "https://subastas.boe.es/verDocumento.php?..."}],
  "url": "https://subastas.boe.es/detalleSubasta.php?idSub=SUB-JA-2026-000000",
  "raw": {}
}
```

### Plan Requirement

Germany (ZVG) and Spain (BOE) start on the standard connection and do not require residential access. No connection tier has been measured as required for them, and the actor does not claim it works without any action on every plan: it escalates to the platform's residential connection only when the standard one is refused, and it also needs proxy access on your account. Poland (KRZ) sits behind a protection layer that blocks plain requests, so it is read through a browser session on the platform's residential connection (Polish exit); this lane is the least predictable of the three.

What you will see in the run log when a connection is not available:

- Warning: "The selected connection is unavailable to this run. Apify free plans do not include residential proxies. Continuing on a backup connection; some pages may still be unavailable."
- Info: "Served over the backup connection (the default connection was unavailable)."
- Failure, proxy refused: "The proxy connection was refused for this account, so no page could be read. Your Apify plan does not include proxy access; a paid plan is required."
- Failure, residential unavailable: "No results: residential proxies are unavailable on this run (Apify free plans do not include them), and the backup connection could not load the requested ... pages."
- Failure, no page loaded: "Could not load any results page (the requests failed), so nothing was collected. This is a connection problem, not an empty search."

If you enter your own proxy URLs, they are used as given.

### FAQ

#### How much does it cost?

You pay per record returned (the `apify-default-dataset-item` event), and records whose detail page was fetched also bill the `detail-enrichment` event, once per record. Records not returned (for example unchanged ones in incremental mode) are not billed. There are no monthly fees; check the Pricing tab for the current per-event prices.

#### Is it legal to scrape these registers?

These are public registers: German foreclosure auctions are published under the ZVG statute, the Polish restructuring register is a public government service, and Spanish judicial auctions are published by the official state gazette. The actor reads the same pages a browser would, at a polite pace, and links every record back to its official source.

#### Can I get only new or changed records on a schedule?

Yes. Use incremental mode: the actor remembers its baseline per scope and returns only what changed (NEW, UPDATED), with optional EXPIRED markers for records that left the source. Use `stateKey` to share one baseline across slightly different filter variants.

#### Why does a run return fewer records than I expected?

**Max items** (50 by default) stops the run once the cap is reached, walking the selected country lanes in order; raise it or set it to `0` to collect everything. Narrow filter combinations (a single German city, an exact Polish case signature) can also simply match few records; clear a filter to widen the search.

#### What does each country return?

Germany: every foreclosure auction the register lists for the chosen state, with the property address, appraised value, auction date and attached documents (appraisal, announcement). German rows also carry court, state name, object type, auction type, area, price per square metre (when the listing states an area) and days until the auction; incremental mode adds an is-new flag (the equivalent of a new-auctions-only switch). Hamburg and Mecklenburg-Vorpommern currently list no auctions (an empty state is reported as an empty result, not as a connection problem). Spain: judicial and tax-office auctions with value, deadline, authority and lot details; the "all statuses" choice is too wide for the portal, so pick one status. Poland: insolvency and restructuring proceedings of companies and sole traders found by name or identifier. These are signals about the owner, not a property list, and only entities whose name contains your search words are returned.

#### How current are the German and Spanish lists?

Both registers are read live on every run, so you see what is published that day. Dates are the portal's own: the auction date for Germany and the closing date of bidding for Spain.

#### Why did my run fail instead of returning an empty dataset?

One of the registers refused every request in that run, or no proxy access was available (see Plan Requirement for the exact messages). The run is failed loudly rather than returning an empty dataset that would look like "no results". Wait and rerun.

#### Can I use it with AI agents or MCP?

Yes, the run output is a clean JSON dataset that works with MCP connectors and any AI workflow. Use the `mcpConnectors` input to send results straight into your apps after each run.

### 🔗 Want more Distressed data?

Pair this actor with these related scrapers from the same team:

<table>
<tr><td>🧩 <a href="https://apify.com/abotapi/distressed-au-nz-scraper"><b>Distressed Property Scraper</b></a><br>Find mortgagee-sale and distressed-property listings in Australia and New Zealand. NZ...</td><td>🏠 <a href="https://apify.com/abotapi/distressed-ca-scraper"><b>Canada Distressed Property Scraper</b></a><br>Canadian tax-sale properties from taxsales.ca: tender and auction listings across 9...</td></tr>
<tr><td>🧩 <a href="https://apify.com/abotapi/boe-es-auction-scraper"><b>Spain Property &amp; Judicial Auctions Scraper</b></a><br>Scrape Spain's official BOE auction portal: judicial and public auction listings with...</td><td>📇 <a href="https://apify.com/abotapi/gowork-eu-scraper"><b>GoWork Scraper</b></a><br>Extract company profiles from GoWork France and Germany, including contact details...</td></tr>
<tr><td>🏠 <a href="https://apify.com/abotapi/auction-com-scraper"><b>Auction.com Scraper</b></a><br>Extract foreclosure, REO, short-sale, and auction listings from Auction.com in minutes...</td><td>🧩 <a href="https://apify.com/abotapi/propwire-property-leads-scraper"><b>Propwire Scraper</b></a><br>Scrape Propwire.com: 157M+ US MLS &amp; off-market properties with owner names, mailing...</td></tr>
</table>

👉 [Browse all abotapi scrapers](https://apify.com/abotapi)

### 💬 Support

- 🐞 **Found a bug or a missing field?** Open a ticket on the [Issues tab](https://apify.com/abotapi/distressed-eu-scraper/issues/open). We usually reply within hours.
- 🛠️ **Need another site, extra fields or a private build?** Email <contact@abotapi.com>.
- ⭐ **Enjoying it?** A quick review on the actor page helps other users find it.

# Actor input Schema

## `mode` (type: `string`):

How to discover records. 'search' walks the selected country lanes with your filters. 'url' reads only the links you paste into urls. Pasted links are ignored in search mode; the run log tells you when that happens.

## `country` (type: `array`):

Which registers to walk, in order. Germany = ZVG foreclosure auction portal. Poland = KRZ restructuring register (entity search). Spain = BOE judicial auctions. Each selected lane uses its own filters below.

## `deLand` (type: `string`):

German federal state code for the foreclosure search: bw, by, be (Berlin), bb, hb, hh, he, mv, ni, nw, rp, sl, sn, st, sh, th. The portal requires one.

## `deLands` (type: `array`):

Search several German states in one run. Pick 'all' for all 16. When set, it replaces the single state above. The single-state field keeps working.

## `deCourt` (type: `string`):

Restrict to one court (Amtsgericht) of the selected state, by the town the portal lists, e.g. 'Charlottenburg' in Berlin or 'München' in Bavaria. Umlaut spellings (Köln, Koeln) both work. A name that matches no court is reported in the run log. Empty = whole state.

## `deObjectType` (type: `string`):

Portal object-type token. Leave empty for all.

## `deStreet` (type: `string`):

Street filter, e.g. 'Uhlandstraße'.

## `dePostalCode` (type: `string`):

Postal code filter, e.g. '10717'.

## `deCity` (type: `string`):

City filter, e.g. 'Berlin'.

## `deAuctionType` (type: `string`):

Portal art selector: -1 = all, 0-8 = specific kinds of enforcement sale.

## `deAuctionDateFrom` (type: `string`):

Only auctions on/after this date. Format YYYY-MM-DD.

## `deAuctionDateTo` (type: `string`):

Only auctions on/before this date. Format YYYY-MM-DD.

## `deSort` (type: `string`):

Sort the foreclosure list: by auction date (default), by last update, or by case number.

## `plEntityName` (type: `string`):

Company (or other entity) name to search in the restructuring register, e.g. 'ALFA'. The register matches broadly; expect many results for short names.

## `plIdentifier` (type: `string`):

Optional exact identifier to combine with the entity name: KRS or NIP for entities, PESEL for persons.

## `plCaseSignature` (type: `string`):

Exact case signature (sygnatura) when you know it, e.g. 'III KRZ 12/26'. Results are limited without other filters.

## `plSoleTraderName` (type: `string`):

Firm name for sole traders with business activity (JDG).

## `plFirstName` (type: `string`):

First name of a natural person / sole trader.

## `plLastName` (type: `string`):

Last name of a natural person / sole trader (with first name).

## `esAuctionStatus` (type: `string`):

Auction lifecycle filter. EJ = ongoing, PU = upcoming with bid, SU = without bid phase, CA = concluded/awarded... Leave empty for all.

## `esDeadlineFrom` (type: `string`):

Auction conclusion date on/after this date. Format YYYY-MM-DD.

## `esDeadlineTo` (type: `string`):

Auction conclusion date on/before this date. Format YYYY-MM-DD.

## `esStartFrom` (type: `string`):

Auction start date on/after this date. Format YYYY-MM-DD.

## `esStartTo` (type: `string`):

Auction start date on/before this date. Format YYYY-MM-DD.

## `urls` (type: `array`):

Pasted links to read in URL mode: a German foreclosure record page (index.php?button=showZvg\&zvg_id=...\&land_abk=...) or a Spanish auction page (detalleSubasta.php?idSub=SUB-..., any tab, with or without ver, also under /reg/). Several tabs of one auction return one record. Search form pages and Polish register links cannot be read from a link (use search mode); they are skipped with a warning. Left untouched, this field holds one example per supported shape.

## `fetchDetails` (type: `boolean`):

Open each result's detail page (full description, attachments, parties, values). Adds one request per record; disable for fast listing-only runs.

## `maxItems` (type: `integer`):

Stop after this many results in total across all countries. Default 50; 0 = no limit (the German register alone holds thousands of auctions, so set a number you are happy to pay for).

## `maxPages` (type: `integer`):

Stop each search walk after this many result pages. 0 = walk until the natural end. Max items always applies too.

## `proxy` (type: `object`):

Connection used for requests. Germany and Spain work with the standard pool; the Polish register needs residential exits (set automatically when the Poland lane is selected).

## `resumeFromRunId` (type: `string`):

Continue a previous run: only records not already in that run's dataset are pushed. Leave empty for a fresh run.

## `incrementalMode` (type: `boolean`):

Track records across scheduled runs with the same scope: only NEW or UPDATED records are returned (UNCHANGED suppressed), and records that disappear are marked EXPIRED. Mutually exclusive with Resume.

## `stateKey` (type: `string`):

Name for the incremental baseline when you want to share one baseline across different filter variants. Leave empty to derive it from the scope automatically.

## `emitUnchanged` (type: `boolean`):

In incremental mode, also return records that did not change (marked UNCHANGED).

## `emitExpired` (type: `boolean`):

In incremental mode, also return records seen previously that no longer appear (marked EXPIRED).

## `ignoreFieldsForChanges` (type: `array`):

Advanced: record fields that should never count as a change (in addition to the built-in ignore list). Example: \["updatedAt"].

## `mcpConnectors` (type: `array`):

Optionally send a summary of each returned property to connected apps. Authorize a connector under Apify > Settings > Integrations, then select it here. Notion creates a page per record; other connectors receive a best-effort write or digest. Leave empty to skip. Dataset results are unaffected.

## `notionParentPageUrl` (type: `string`):

URL or ID of the Notion page where record pages should be created. Required for Notion; ignored by other connectors.

## `maxNotifyListings` (type: `integer`):

Maximum number of records written to each connector. Does not affect dataset output.

## Actor input object example

```json
{
  "mode": "search",
  "country": [
    "de"
  ],
  "deLand": "be",
  "deObjectType": "",
  "deAuctionType": "",
  "deSort": "2",
  "esAuctionStatus": "EJ",
  "urls": [
    "https://www.zvg-portal.de/index.php?button=showZvg&zvg_id=14429&land_abk=be",
    "https://subastas.boe.es/detalleSubasta.php?idSub=SUB-JA-2026-263220&ver=1",
    "https://subastas.boe.es/detalleSubasta.php?idSub=SUB-JA-2026-263220&ver=2",
    "https://subastas.boe.es/detalleSubasta.php?idSub=SUB-JA-2026-263220&ver=3",
    "https://subastas.boe.es/detalleSubasta.php?idSub=SUB-JA-2026-263220",
    "https://subastas.boe.es/reg/detalleSubasta.php?idSub=SUB-JA-2026-263220",
    "https://www.zvg-portal.de/index.php?button=Termine%20suchen",
    "https://subastas.boe.es/subastas_ava.php"
  ],
  "fetchDetails": true,
  "maxItems": 20,
  "maxPages": 0,
  "proxy": {
    "useApifyProxy": true
  },
  "incrementalMode": false,
  "emitUnchanged": false,
  "emitExpired": false,
  "maxNotifyListings": 50
}
```

# Actor output Schema

## `overview` (type: `string`):

No description

## `detail` (type: `string`):

No description

## `changes` (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 '<YOUR_API_TOKEN>' with your token
const client = new ApifyClient({
    token: '<YOUR_API_TOKEN>',
});

// Prepare Actor input
const input = {
    "mode": "search",
    "country": [
        "de"
    ],
    "deLand": "be",
    "deSort": "2",
    "esAuctionStatus": "EJ",
    "urls": [
        "https://www.zvg-portal.de/index.php?button=showZvg&zvg_id=14429&land_abk=be",
        "https://subastas.boe.es/detalleSubasta.php?idSub=SUB-JA-2026-263220&ver=1",
        "https://subastas.boe.es/detalleSubasta.php?idSub=SUB-JA-2026-263220&ver=2",
        "https://subastas.boe.es/detalleSubasta.php?idSub=SUB-JA-2026-263220&ver=3",
        "https://subastas.boe.es/detalleSubasta.php?idSub=SUB-JA-2026-263220",
        "https://subastas.boe.es/reg/detalleSubasta.php?idSub=SUB-JA-2026-263220",
        "https://www.zvg-portal.de/index.php?button=Termine%20suchen",
        "https://subastas.boe.es/subastas_ava.php"
    ],
    "maxItems": 20,
    "proxy": {
        "useApifyProxy": true
    }
};

// Run the Actor and wait for it to finish
const run = await client.actor("abotapi/distressed-eu-scraper").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 '<YOUR_API_TOKEN>' with your token.
client = ApifyClient("<YOUR_API_TOKEN>")

# Prepare the Actor input
run_input = {
    "mode": "search",
    "country": ["de"],
    "deLand": "be",
    "deSort": "2",
    "esAuctionStatus": "EJ",
    "urls": [
        "https://www.zvg-portal.de/index.php?button=showZvg&zvg_id=14429&land_abk=be",
        "https://subastas.boe.es/detalleSubasta.php?idSub=SUB-JA-2026-263220&ver=1",
        "https://subastas.boe.es/detalleSubasta.php?idSub=SUB-JA-2026-263220&ver=2",
        "https://subastas.boe.es/detalleSubasta.php?idSub=SUB-JA-2026-263220&ver=3",
        "https://subastas.boe.es/detalleSubasta.php?idSub=SUB-JA-2026-263220",
        "https://subastas.boe.es/reg/detalleSubasta.php?idSub=SUB-JA-2026-263220",
        "https://www.zvg-portal.de/index.php?button=Termine%20suchen",
        "https://subastas.boe.es/subastas_ava.php",
    ],
    "maxItems": 20,
    "proxy": { "useApifyProxy": True },
}

# Run the Actor and wait for it to finish
run = client.actor("abotapi/distressed-eu-scraper").call(run_input=run_input)

# Fetch and print Actor results from the run's dataset (if there are any)
print(f"💾 Check your data here: https://console.apify.com/storage/datasets/{run.default_dataset_id}")
for item in client.dataset(run.default_dataset_id).iterate_items():
    print(item)

# 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/python/docs/quick-start

```

## CLI example

```bash
echo '{
  "mode": "search",
  "country": [
    "de"
  ],
  "deLand": "be",
  "deSort": "2",
  "esAuctionStatus": "EJ",
  "urls": [
    "https://www.zvg-portal.de/index.php?button=showZvg&zvg_id=14429&land_abk=be",
    "https://subastas.boe.es/detalleSubasta.php?idSub=SUB-JA-2026-263220&ver=1",
    "https://subastas.boe.es/detalleSubasta.php?idSub=SUB-JA-2026-263220&ver=2",
    "https://subastas.boe.es/detalleSubasta.php?idSub=SUB-JA-2026-263220&ver=3",
    "https://subastas.boe.es/detalleSubasta.php?idSub=SUB-JA-2026-263220",
    "https://subastas.boe.es/reg/detalleSubasta.php?idSub=SUB-JA-2026-263220",
    "https://www.zvg-portal.de/index.php?button=Termine%20suchen",
    "https://subastas.boe.es/subastas_ava.php"
  ],
  "maxItems": 20,
  "proxy": {
    "useApifyProxy": true
  }
}' |
apify call abotapi/distressed-eu-scraper --silent --output-dataset

```

## MCP server setup

```json
{
    "mcpServers": {
        "apify": {
            "type": "http",
            "url": "https://mcp.apify.com/?tools=fetch-actor-details,abotapi/distressed-eu-scraper"
        }
    }
}
```

The hosted server signs you in with OAuth on first connect, so no API token belongs in this config. Clients without OAuth support can send an `Authorization: Bearer <APIFY_API_TOKEN>` header instead, using a token from API & Integrations in Apify Console (https://console.apify.com/settings/integrations).

## OpenAPI specification

Download the OpenAPI definition: https://api.apify.com/v2/actors/zgAXyOLR02hwuPFEk/builds/sw5zdgPdorgDmhkly/openapi.json