ZVG Property Auction Scraper – German Foreclosure Data

Scrape official German property foreclosure auctions (Zwangsversteigerungen) from zvg-portal.de — the official court auction portal run by the German state justice administrations. Extracts every publicly announced auction across all 16 Bundesländern.

---

🚀 Why use this scraper?

🔗 Live links — no dead portal URLs

• Detail pages mirrored to the Apify Key-Value Store → detail_url is a public, permanent link
• All PDFs mirrored: appraisal reports (Gutachten), exposés, official announcements, photos, info sheets, every attachment
• PDF links inside the mirrored detail HTML are rewritten — click through directly from the detail page

📊 Bidding limits calculated automatically

• limit_50_percent — minimum bid per § 85a ZVG (below this, no Zuschlag)
• limit_70_percent — threshold per § 74a ZVG (above this, creditors generally can't object)

🔁 Monitoring mode — only new auctions

• Set only_new_auctions: true for recurring runs
• Day 1: full snapshot. From day 2: only new listings (~50–200/day nationwide)
• Zero duplicates — seen IDs persist across runs, crashes, and manual re-runs

🏛️ Structured Grundbuch data

• gemarkung, flurstueck, flaeche_ha, grundbuch_blatt as separate fields

🗺️ Geo links

• map_url: direct Google Maps link per property

📋 33 structured fields per listing

• ISO dates, real numbers (not "224.000,00 €" strings)
• All 16 Bundesländer in one run. Each state's detail page variant handled

---

⚙️ Input Example

Single-family homes in Bavaria, Q3 2026:

{
  "bundeslaender": ["by"],
  "objektarten": ["3", "19"],
  "von_datum": "01.07.2026",
  "bis_datum": "30.09.2026",
  "nur_aktive_termine": true,
  "mit_details": true
}

Daily nationwide monitoring run:

{
  "bundeslaender": [],
  "nur_aktive_termine": true,
  "only_new_auctions": true
}

📤 Output Example

Each dataset item represents one auction (Termin). All 33 fields filled:

{
  "zvg_id": 48715,
  "land_abk": "by",
  "bundesland": "Bayern",
  "aktenzeichen": "K 0081/2024",
  "amtsgericht": "Augsburg",
  "art_der_versteigerung": "Zwangsversteigerung zum Zwecke der Aufhebung der Gemeinschaft",
  "objekt_typ": "Doppelhaushälfte",
  "objekt_adresse": "Afrastraße 5 a, 86179 Augsburg",
  "objekt_beschreibung": "Doppelhaushälfte und Garage mit Schuppen; Wohnfläche ca. 141 m²; Baujahr 2004; Grundstücksgröße 375 m²",
  "verkehrswert_eur": 690000.00,
  "limit_50_percent": 345000.00,
  "limit_70_percent": 483000.00,
  "termin_datum": "2026-10-15",
  "termin_uhrzeit": "09:30",
  "termin_aufgehoben": false,
  "ort_der_versteigerung": "Amtsgericht Augsburg, Justizgebäude Am Alten Einlaß 1, 86150 Augsburg, Sitzungssaal Zi.Nr. 101",
  "glaeubiger_info": "Sparkasse XYZ, Aktenzeichen 1234/5678",
  "gemarkung": "Haunstetten",
  "flurstueck": "1234/5",
  "flaeche_ha": 0.0375,
  "grundbuch_blatt": "15265",
  "grundbuch_text": "Haunstetten Blatt 15265",
  "ansprechpartner": "Rechtspfleger Müller, Amtsgericht Augsburg, Tel. 0821/1234-0",
  "url_amtl_bekanntmachung": "https://api.apify.com/v2/key-value-stores/xxxx/records/amtl_bekanntmachung_48715.pdf",
  "url_gutachten": "https://api.apify.com/v2/key-value-stores/xxxx/records/gutachten_48715.pdf",
  "url_exposee": "https://api.apify.com/v2/key-value-stores/xxxx/records/exposee_48715.pdf",
  "url_gericht": "https://www.justiz.bayern.de/gericht/ag/a/",
  "map_url": "https://maps.google.de/maps?q=Afrastraße+5+a+86179+Augsburg",
  "anhang_urls": [
    "https://api.apify.com/v2/key-value-stores/xxxx/records/anhang_125267.pdf",
    "https://api.apify.com/v2/key-value-stores/xxxx/records/anhang_125270.pdf"
  ],
  "detail_url": "https://api.apify.com/v2/key-value-stores/xxxx/records/detail_48715.html",
  "detail_url_source": "https://www.zvg-portal.de/index.php?button=showZvg&zvg_id=48715&land_abk=by",
  "letzte_aktualisierung": "2026-09-28",
  "scraped_at": "2026-10-01T06:00:00+00:00"
}

Note: All PDF and detail URLs point to your Apify Key-Value Store, not the session-locked portal — they work permanently, in your browser, CRM, or spreadsheet.

---

Field Descriptions

Field	Type	Description
zvg_id	integer	Unique auction ID from zvg-portal.de
land_abk	string	State code (by, nw, be, …)
bundesland	string	Full state name
aktenzeichen	string	Court file number
amtsgericht	string	Responsible court
art_der_versteigerung	string	Auction type (foreclosure, partition, …)
objekt_typ	string	Property type (detached house, condo, plot, …)
objekt_adresse	string	Property address
objekt_beschreibung	string	Full property description (size, year built, condition)
verkehrswert_eur	number	Court-appraised market value in EUR
limit_50_percent	number	50% minimum bid (§ 85a ZVG)
limit_70_percent	number	70% threshold (§ 74a ZVG)
termin_datum	date	Auction date (ISO format)
termin_uhrzeit	string	Auction time (HH:MM)
termin_aufgehoben	boolean	true if the auction was cancelled
ort_der_versteigerung	string	Courtroom / session location
glaeubiger_info	string	Creditor details (bank, reference)
gemarkung	string	Land-registry district
flurstueck	string	Plot number
flaeche_ha	number	Plot area (hectares)
grundbuch_blatt	string	Land-registry folio number
grundbuch_text	string	Raw land-registry text line
ansprechpartner	string	Contact person / firm
url_amtl_bekanntmachung	string	PDF: official announcement (KV Store)
url_gutachten	string	PDF: expert opinion / valuation (KV Store)
url_exposee	string	PDF: sales exposé (KV Store)
url_gericht	string	Court website URL
map_url	string	Map location URL (Google Maps / GeoServer)
anhang_urls	string[]	All attachments (KV Store)
detail_url	string	Mirrored detail page (KV Store, clickable)
detail_url_source	string	Original portal URL for reference
letzte_aktualisierung	date	Last update date on the portal
scraped_at	datetime	UTC timestamp when scraped

Note on KV-Store URLs: Fields detail_url, url_amtl_bekanntmachung, url_gutachten, url_exposee, and entries in anhang_urls point to the Apify Key-Value Store — not the original portal. The portal protects detail pages and PDFs with session cookies. By mirroring them to the KV store, they are permanently accessible without a session. The original portal URL is preserved in detail_url_source for traceability.

---

🔁 Monitoring Mode

Set only_new_auctions: true to activate cross-run deduplication:

1. The actor creates a persistent KV store (zvg-seen) on first run.
2. Each yielded auction is recorded in this store.
3. On subsequent runs, only auctions not seen before are returned.
4. The state survives crashes, restarts, and configuration changes.

Ideal for cron jobs:

• Day 1: all current auctions
• Day 2+: only new auctions since the last run

---

⚙️ Input Konfiguration / Input Configuration

Parameter Overview

Field	Type	Default	Description
bundeslaender	string[]	[] (= all 16)	2-letter state codes (by, nw, be, …). Empty = all states.
objektarten	string[]	[] (= all)	Property type IDs. See table below.
verfahrensart	string	"" (= all)	Procedure type. See table below.
ort	string	""	City / town name
plz	string	""	5-digit ZIP code
strasse	string	""	Street name
von_datum	string	""	Earliest auction date (DD.MM.YYYY)
bis_datum	string	""	Latest auction date (DD.MM.YYYY)
nur_aktive_termine	boolean	true	Skip cancelled auctions (recommended)
mit_details	boolean	true	Fetch full detail pages (descriptions, PDFs, Grundbuch). Adds ~2× runtime but significantly more data.
max_listings	integer	0 (= no limit)	Maximum number of listings per run
only_new_auctions	boolean	false	Monitoring mode: only return auctions not seen in previous runs

Property Types (objektarten)

ID	Type
1	Reihenhaus (terraced house)
2	Doppelhaushälfte (semi-detached)
3	Einfamilienhaus (detached house)
19	Zweifamilienhaus (two-family house)
4	Mehrfamilienhaus (multi-family)
5	Eigentumswohnung 1–2 Zi. (condo 1–2 rooms)
6	Eigentumswohnung 3–4 Zi. (condo 3–4 rooms)
7	Eigentumswohnung ab 5 Zi. (condo 5+ rooms)
8	Gewerbeeinheit (commercial unit)
13	Wohn-/Geschäftshaus (residential-commercial)
9	Garage
10	Kfz-Stellplatz (parking space)
11	Kfz-Stellplatz Tiefgarage (underground parking)
12	Sonstiges Teileigentum (other partial ownership)
14	Gewerblich genutztes Grundstück (commercial plot)

Procedure Types (verfahrensart)

ID	Type
""	All types
"-1"	Aufhebung der Gemeinschaft (partition sale)
"0"	Zwangsvollstreckung (ordinary foreclosure)
"1"	Antrag Insolvenzverwalter (insolvency)
"2"	Antrag Erbe (inheritance)
"3"	Zwangsversteigerung von Schiffen (ships)
"4"	Zwangsversteigerung von Luftfahrzeugen (aircraft)
"5"	Wohnungseigentum (condominium)
"6"	Seekabel (submarine cable)
"7"	Aufgebotsverfahren (public summons)
"8"	Sonstiges (other)

---

❓Use Cases

Use Case	Description
🏗️ Investor Deal Flow	Daily feed of new distressed-asset opportunities filtered by region, property type, value range
📊 Portfolio Benchmarking	Compare court-appointed valuations (Verkehrswert) against private-market appraisals
📈 Market Research	Track foreclosure volume trends by state, city, property type over time
🔗 CRM Enrichment	Augment internal property leads with public foreclosure signals
📄 PDF Pipeline	Automatically download expert opinions (Gutachten) for automated valuation models
🔔 Auction Monitoring	Get notified only when new auctions appear in your target regions
🏛️ PropTech Integration	Feed structured foreclosure data into real-estate platforms and analytics tools
⚖️ Legal & Insolvency	Stay current on proceedings for active cases

---

❓ FAQ

Is it legal to scrape zvg-portal.de?

Foreclosure auction dates are public court announcements required by law (§ 39, § 40 ZVG). The Actor accesses only publicly available data — no login, no circumvention of access restrictions. Results may contain personal data (creditors, contact persons) protected under GDPR; only process it with a legitimate reason and consult your lawyer if unsure.

Why do PDF links point to apify.com instead of zvg-portal.de?

The portal locks PDFs and detail pages behind session cookies — original links die when the session ends. This Actor mirrors every document to the Key-Value Store during the crawl, so your links keep working permanently. The original URL stays in detail_url_source.

How does monitoring mode avoid duplicates?

Seen listing IDs persist in a named Key-Value Store across runs. State survives crashes, restarts, and manual re-runs — you never get the same auction twice.

Do I need proxies?

No. The portal has no meaningful anti-bot protection. Proxies are optional.

Can I get the data via API?

Yes — every run's dataset is available through the Apify API (see the API tab), plus webhooks and integrations (Slack, Google Sheets, Zapier/Make, and more).

Something's not working / I need a custom feature

Open a ticket in the Issues tab — the Actor is actively maintained. Custom extensions (geocoding, webhook alerts, extra fields) on request.