🏠 German Real Estate Foreclosure & ZVG-Portal Scraper

The ultimate B2B, PropTech, and Real Estate Investment scraper for the official German judicial auction and foreclosure portal (zvg-portal.de).

Extract upcoming foreclosure auctions across all 16 German federal states, complete with official court valuations in EUR (float), auction dates, courtroom addresses, property categories, and direct download links to official appraisal reports (Verkehrswertgutachten) and court notices (Amtliche Bekanntmachung).

---

🎥 48-Second Live Video Showcase (1080p HD)

Part of the official German B2B Data Suite: Automate B2B lead generation, GDPR-compliant impressum enrichment (§ 5 DDG), real-time Handelsregister (XJustiz) & insolvency KYB audits, ZVG foreclosures, and public tenders via Apify, n8n, Make.com, or AI Agents (MCP).

---

🎯 Why Use This Actor?

The official German foreclosure portal (zvg-portal.de) is notoriously difficult to automate:

• No official REST API: Information is trapped in legacy HTML tables.
• Strict Referer & Encoding Walls: Official appraisal PDFs (Gutachten) fail with a cryptic error response unless specific HTTP referer headers are sent, and responses mix legacy Windows CP1252 and UTF-8 characters.
• Manual Browsing Overhead: Investors and PropTech analysts spend hours clicking through court dropdowns and deciphering PDF attachments.

This Actor solves it completely:

• ⚡ Lightweight & Fast: Uses high-throughput asynchronous HTTP streaming without heavy browser overhead. Runs in seconds and consumes under 150 MB RAM.
• 💰 Fair Pay-Per-Event (PPE) Pricing: Pay only $0.01 USD per property ($10.00 / 1,000 properties). Invalid inputs or empty results are never charged.
• 📑 Direct Official PDF Links: Extracts direct download URLs for official appraisal reports, property photos, and court decrees.
• 🔍 Rich Filtering: Filter by Bundesland, City, 5-digit German Postal Code (PLZ), Property Type, and exact Min/Max Market Value in EUR.
• 🤖 Ready for AI Agents & Workflow Automation: Seamlessly integrate with Make.com, n8n, Zapier, or connect as an Apify MCP Tool in Claude, Cursor, and ChatGPT.

---

🏢 Supported German Federal States (states)

Pass either canonical two-letter codes, full German names, or "ALL":

Code	State Name	Code	State Name
bw	Baden-Württemberg	by	Bayern (Bavaria)
be	Berlin	br	Brandenburg
hb	Bremen	hh	Hamburg
he	Hessen (Hesse)	mv	Mecklenburg-Vorpommern
ni	Niedersachsen	nw	Nordrhein-Westfalen (NRW)
rp	Rheinland-Pfalz	sl	Saarland
sn	Sachsen (Saxony)	st	Sachsen-Anhalt
sh	Schleswig-Holstein	th	Thüringen (Thuringia)
ALL	All 16 Federal States in one run

---

⚙️ Input Parameters

Parameter	Type	Default	Description
states	Array<String>	["sn"]	Federal states to search (e.g. ["sn", "be"], ["Bayern"], or ["ALL"]).
city	String	null	Filter by city name (e.g. "Leipzig", "Berlin", "München").
postal_code	String	null	Filter by 5-digit German postal code (e.g. "04109", "10115").
property_type	String	"ALL"	Category filter: "Eigentumswohnung", "Einfamilienhaus", "Mehrfamilienhaus", "Gewerbe", "Grundstück".
min_market_value	Number	null	Minimum court-assessed market value in EUR (e.g. 100000).
max_market_value	Number	null	Maximum court-assessed market value in EUR (e.g. 500000).
max_items	Integer	50	Maximum listings to extract (controls your budget strictly).
include_details	Boolean	true	When true, fetches full court descriptions, courtroom locations, and appraisal PDF links.
proxyConfiguration	Object	null	Optional Apify proxy settings (datacenter or residential).

Example Input: High-Value Foreclosures in Saxony & Berlin

{
  "states": ["sn", "be"],
  "property_type": "Eigentumswohnung",
  "min_market_value": 150000,
  "max_market_value": 750000,
  "max_items": 25,
  "include_details": true
}

---

📊 Output Schema

Each pushed record represents a verified German foreclosure listing:

{
  "zvg_id": "14468",
  "case_number": "0030 K 0106/2025",
  "court": "Amtsgericht Kreuzberg",
  "state": "be",
  "property_type": "Eigentumswohnung (1 bis 2 Zimmer)",
  "title": "Eigentumswohnung (1 bis 2 Zimmer): Eldenaer Straße 10, 10247 Berlin, Friedrichshain",
  "address": "Eldenaer Straße 10, 10247 Berlin, Friedrichshain",
  "postal_code": "10247",
  "city": "Berlin",
  "market_value_eur": 190000.0,
  "currency": "EUR",
  "auction_date": "Dienstag, 27. Oktober 2026, 10:00 Uhr",
  "auction_location": "Amtsgericht Kreuzberg, Möckernstr. 130, 10958 Berlin, Saal A144",
  "land_register": "Friedrichshain Blatt 24783N",
  "status_notes": null,
  "is_cancelled": false,
  "description": "Es handelt sich um eine 1-Zimmerwohnung mit Küche, Bad, Flur und Balkon. Die Wohnfläche beträgt ca. 38 m²...",
  "creditor_info": "Frau Oltmanns (DZ HYP AG), Az: RVSA-A/ol 331 0237 700",
  "pdf_urls": [
    "https://www.zvg-portal.de/index.php?button=showAnhang&land_abk=be&file_id=67771&zvg_id=14468",
    "https://www.zvg-portal.de/index.php?button=showAnhang&land_abk=be&file_id=67772&zvg_id=14468"
  ],
  "documents": [
    {
      "title": "amtliche Bekanntmachung",
      "url": "https://www.zvg-portal.de/index.php?button=showAnhang&land_abk=be&file_id=67771&zvg_id=14468",
      "file_type": "pdf",
      "file_size": "122.9 kB"
    },
    {
      "title": "Gutachten",
      "url": "https://www.zvg-portal.de/index.php?button=showAnhang&land_abk=be&file_id=67772&zvg_id=14468",
      "file_type": "pdf",
      "file_size": "2690.63 kB"
    }
  ],
  "detail_url": "https://www.zvg-portal.de/index.php?button=showZvg&zvg_id=14468&land_abk=be",
  "scraped_at": "2026-10-27T17:30:00.000Z"
}

---

💡 Commercial Use Cases

1. PropTech & Investment Deal Flow: Automatically feed high-yield German foreclosure opportunities below market valuation into your CRM or internal scoring algorithm.
2. Real Estate Appraisal & Automated Valuation Models (AVM): Collect historical and upcoming court appraisal values (Verkehrswertgutachten) for neighborhood price benchmarks.
3. Banking & Distressed Asset Monitoring: Monitor non-performing loan auctions and collateral proceedings across relevant jurisdictions.
4. Make / n8n Daily Alerts: Schedule automated runs every morning to send Telegram, Slack, or email notifications whenever a new property in your target PLZ is scheduled for auction.

---

🔒 Strict Pay-Per-Event (PPE) Guarantee

• Charged strictly at $0.01 USD per pushed property (event_name: "property-scraped").
• If a search returns 0 listings, or if invalid parameters are supplied, no charge is ever applied.

---

🤖 Plug-and-Play: AI Agents (MCP), n8n & Make.com

Our actors are built natively for the next generation of automation: seamless integration into Claude Desktop, Cursor AI, AI Agent Frameworks (LangChain, AutoGen, CrewAI), and visual workflow builders like n8n and Make.com.

1. AI Agents & Model Context Protocol (MCP)

Give your AI coding assistant or desktop agent real-time access to this actor using the official Apify MCP server.

Option A: Single-Actor MCP Setup (claude_desktop_config.json / Cursor)

Add this to your %APPDATA%\Claude\claude_desktop_config.json (Windows) or ~/Library/Application Support/Claude/claude_desktop_config.json (macOS):

{
  "mcpServers": {
    "apify-zvg": {
      "command": "npx",
      "args": ["-y", "@apify/actors-mcp-server", "--actors", "AGrunert/german-real-estate-foreclosure-zvg-scraper"],
      "env": {
        "APIFY_TOKEN": "YOUR_APIFY_TOKEN"
      }
    }
  }
}

💡 Pro Tip – Equip your AI Agent with our Complete German B2B & Compliance Suite:
Pass all 6 specialized DACH actors in a single command so your agent can discover B2B leads, extract Impressum data, verify commercial register & insolvency records, search tenders, monitor real estate foreclosures, and issue tax-compliant e-invoices autonomously:

$npx -y @apify/actors-mcp-server --actors AGrunert/german-b2b-leads-directory-scraper,AGrunert/german-impressum-b2b-lead-enricher,AGrunert/german-company-kyb-insolvency-scraper,AGrunert/german-public-tenders-vergabe-scraper,AGrunert/german-real-estate-foreclosure-zvg-scraper,AGrunert/german-e-invoice-zugferd-xrechnung-suite

Hosted SSE Endpoint (for Cursor / remote agents):
https://mcp.apify.com?actors=AGrunert/german-real-estate-foreclosure-zvg-scraper&token=YOUR_APIFY_TOKEN

---

2. 1-Click Synchronous API (cURL, n8n, Make.com)

No async job polling required! Call our synchronous endpoint directly in a single HTTP request node to run the actor and receive clean parsed dataset items immediately:

curl -X POST "https://api.apify.com/v2/acts/AGrunert~german-real-estate-foreclosure-zvg-scraper/run-sync-get-dataset-items?token=YOUR_APIFY_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"states":["by","be","nw"],"property_type":"all","min_market_value":150000,"max_items":10,"include_details":true}'

---

3. Schlüsselfertige Workflow-Vorlagen im Repository (integrations/)

In our GitHub repository and Actor build package, you will find pre-built, production-tested templates in the integrations/ folder:

• integrations/n8n_workflow.json: Ready-to-import n8n workflow with automated foreclosure auction extraction and 2-step chaining into our KYB Scraper to audit involved companies and creditors. Just copy-paste the JSON into your n8n canvas.
• integrations/make_com_blueprint.json: Official Make.com scenario blueprint with pre-configured HTTP request & data mapping.
• integrations/mcp_claude_cursor_config.json: Pre-configured MCP server manifest for Claude Desktop, Cursor AI, and Windsurf.

---

🔗 Complete German B2B, Compliance & PropTech Suite by AGrunert

Combine our specialized German business actors to build end-to-end automated pipelines for B2B lead generation, corporate due diligence, public procurement, real estate intelligence, and tax-compliant e-invoicing:

Actor	Category & Pricing	Key Capabilities	Preconfigured Public Tasks
German B2B Leads, Crafts & Business Directory Scraper	Lead Generation $0.008 / lead ($8.00 / 1k)	Multi-query round-robin extraction across German business directories (11880, Gelbe Seiten), verified E.164 phone numbers (97.5% coverage), and domain verification (require_website: true).	• German Crafts, Solar & Construction Lead Finder • German B2B Company & Domain Finder
German & DACH B2B Impressum, Contact & Legal Enricher (§ 5 DDG)	Data Enrichment $0.005 / domain ($5.00 / 1k)	Automatic legal notice discovery (§ 5 DDG / § 25 MedienG), de-obfuscation of executive emails, management board/CEOs, court & registration number (HRB), VAT ID (DE...), and social profiles.	• German B2B Impressum, CEO & Contact Extractor • DACH Website to Handelsregister & VAT ID Enricher
German Company KYB, Handelsregister & Insolvency Scraper	Risk & Compliance $0.025 / check ($25.00 / 1k)	Official XJustiz 3.5.1 extraction (directors, share capital, business purpose, court) + live insolvency check (insolvenzbekanntmachungen.de) with bulk company list support.	• Complete German KYB Audit • Fast German Insolvency Screener • Bulk German Company KYB Batch Check
German Public Tenders & Procurement Scraper (service.bund.de)	B2B Tenders & Contracts $0.010 / tender ($10.00 / 1k)	Daily procurement monitoring across Bund, Länder & Kommunen; zero false positives (filters AI Bietercockpit boilerplates); direct /unterlagen/ download URLs and submission deadlines (date + time).	• German IT, Software & AI Public Tenders Monitor • German Construction & Facility Management Tenders
German Real Estate Foreclosure & ZVG-Portal Scraper (Current Actor)	PropTech & Real Estate $0.010 / property ($10.00 / 1k)	Bulk extraction of foreclosure auctions (zvg-portal.de) across all 16 states, multi-parcel market value parser (float), and direct PDF appraisal links (Verkehrswertgutachten).	• German Foreclosure Real Estate Finder • High-Value German Foreclosures (> 250k EUR)
German E-Invoice (ZUGFeRD / Factur-X / XRechnung 3.0) Suite	Finance & Invoicing $0.035 / invoice ($35.00 / 1k)	Generate DIN-5008 compliant PDF/A-3 invoices from JSON, embed CII XML, and validate with official KoSIT Schematron & EN 16931 rules.	Standalone API & Batch Suite

💡 Multi-Actor Chain Workflows & Synergy Pipelines

• Pipeline 1 (Top-of-Funnel Lead-to-Audit Engine):
  Discover companies & crafts via German B2B Directory Scraper $\rightarrow$ Enrich managing directors, direct emails, and HRB numbers via German Impressum Enricher $\rightarrow$ Verify solvency, officers, and share capital via German KYB Scraper.
• Pipeline 2 (Public Tender Win to Compliant Billing):
  Monitor federal procurement opportunities via German Public Tenders Scraper $\rightarrow$ Win bid $\rightarrow$ Bill public authorities with compliant EN 16931 XRechnung 3.0 via German E-Invoice Suite.
• Pipeline 3 (Real Estate Foreclosure Due Diligence):
  Scrape upcoming foreclosures via German Real Estate Foreclosure Scraper $\rightarrow$ Check creditor/owner companies via German KYB Scraper.

---

📞 Support & Custom Extensions

Need custom courthouse scrapers, automated PDF text parsing (OCR of valuation reports), or integration into enterprise data warehouses? Contact the author via the Apify Console.