# Germany Property Auctions API - ZVG Zwangsversteigerung (`webdata_labs/germany-zvg-auctions-api`) Actor \[💵 $4.00 / 1K] Zwangsversteigerungen aller 16 Bundesländer vom offiziellen ZVG-Portal: Verkehrswert, Termin, Objekt, Lage. Clean English schema for international investors - appraisal, auction date, address, court files. Monitoring mode returns only new auctions. - **URL**: https://apify.com/webdata\_labs/germany-zvg-auctions-api.md - **Developed by:** [WebData Labs](https://apify.com/webdata_labs) (community) - **Categories:** Lead generation, Automation, Real estate - **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 ## Germany Property Auctions API - ZVG Zwangsversteigerungen **Scrape Zwangsversteigerungen (German court foreclosure auctions) from the official ZVG-Portal (zvg-portal.de) - all 16 Bundesländer, one clean English schema.** Verkehrswert as a real number, auction date as ISO timestamp, object type, address, court documents - not a raw German legal-text dump. Turn on monitoring mode to get only the auctions published since your last run. Germany's court foreclosure portal publishes every judicial real-estate auction in the country, but it is a legacy site with German-only legal text, per-state searches, and Word-formatted appraisal tables. This Actor reads all of it and returns normalized rows ready for Excel, CSV, JSON, dashboards, or deal-screening pipelines. ### ✅ What you get / ❌ what this isn't | This Actor gives you | This Actor is not | |---|---| | Every open foreclosure auction across all 16 German states | Not affiliated with zvg-portal.de or the Justizportal | | Appraisal value (Verkehrswert) parsed to a number, incl. accessories split | Not a bidding or legal-advice tool | | Auction date/time as ISO timestamp + cancellation flag | Not a guarantee every case publishes an appraisal (most do) | | Object type, address, case number, official PDF attachments | Not a discovery tool for private (non-judicial) sales | | Monitoring mode: only new auctions since your last run | | ### 🔎 Why use this Actor - **Screen distressed real-estate deals across Germany** - foreclosure auctions regularly close below market; the appraisal value and the address are the two numbers you need first. - **Monitor new auctions on a schedule and pay only for new rows** (`onlyNewAuctions`). - Feed a deal pipeline, alert bot, or investor newsletter with normalized rows. - Combine with our Spain Property Auctions API for a cross-border distressed-asset feed. ### 🗂️ What data you get | Field | Type | Description | |---|---|---| | `caseNumber` | string | Court case number (Aktenzeichen) | | `state`, `stateName` | string | Bundesland code and name | | `objectType` | string | Einfamilienhaus, Wohnung, Grundstück, ... | | `address` | string | Street-level location when published | | `appraisalValueEur` | number | Verkehrswert as a number (224000.00, not "224.000,00 €") | | `accessoriesValueEur` | number | Appraisal share for accessories (Zubehör) when split out | | `auctionDate` | string | ISO timestamp parsed from the German long date | | `isCancelled` | boolean | Termin aufgehoben flag | | `attachments` | array | Official announcement PDFs (amtliche Bekanntmachung) | | `detailUrl`, `zvgId` | string | Link back to the official case page | | `lastUpdatedAt` | string | Portal's last-update timestamp | With `includeDetails`: full object `description`, `venue` (Ort der Versteigerung), `landRegister` (Grundbuch), derived `court` name, and `creditorInfo`. Plus a per-state summary row (total auctions, appraisal coverage, median appraisal) and a run summary. ### 👥 Who it's for - Real-estate investors screening German foreclosure deals (domestic and international). - Distressed-asset funds and deal-flow aggregators. - Proptech data teams building auction datasets or alerts. - Agents and Immobilienmakler watching their region. ### ⚙️ How to scrape German foreclosure auctions 1. Open the Actor on Apify. 2. Pick states (`["by", "nw"]`) or use `["all"]` for the whole country. 3. Optionally enable `onlyNewAuctions` for scheduled monitoring or `includeDetails` for full descriptions. 4. Run, then open the dataset view `Auctions` or `State summaries`. 5. Export JSON, CSV, Excel, HTML, RSS, or XML, or call the Actor through the Apify API. ### 📥 Input ```json { "states": ["all"], "maxResultsPerState": 1000, "includeDetails": false, "onlyNewAuctions": false } ```` ### 📤 Output ```json { "recordType": "auction", "caseNumber": "0003 K 0038/2024", "state": "by", "stateName": "Bayern", "objectType": "Einfamilienhaus", "address": "Am Brünnlein 18, 97522 Sand am Main", "appraisalValueEur": 224000.0, "accessoriesValueEur": 5000.0, "auctionDate": "2026-10-26T09:30:00", "isCancelled": false, "attachments": [{ "title": "Amtliche Bekanntmachung", "url": "https://www.zvg-portal.de/..." }], "detailUrl": "https://www.zvg-portal.de/index.php?button=showZvg&zvg_id=48873&land_abk=by" } ``` ### 🔁 Monitoring mode (only new auctions) Set `onlyNewAuctions: true` and run on a schedule. The first run returns all current auctions and initializes a per-state memory on your account; every following run pushes **only newly published cases**. State summaries still report `totalAuctions`, `newAuctions`, and `previouslySeen`, so you always see the full picture while paying only for the delta. ### 💵 How much does it cost? The launch price is about `$4.00 / 1,000 auctions`, tier-discounted for higher Apify plans. One auction is one charged result; state summary rows are part of the same output. Germany currently lists roughly 2,500-3,500 open cases nationwide, so a full-country snapshot is a few dollars and a daily delta run is usually cents. ### 🇩🇪 Auf Deutsch **Extrahiert Zwangsversteigerungstermine aller Amtsgerichte aus dem offiziellen ZVG-Portal** (zvg-portal.de) in ein sauberes, strukturiertes Schema: Aktenzeichen, Objekt/Lage, Verkehrswert als Zahl, Termin als ISO-Datum, amtliche Bekanntmachungen (PDF) - bereit für Excel, CSV oder JSON. - Alle 16 Bundesländer in einem Lauf (`["all"]`) oder gezielt pro Land (`["by", "nw"]`). - Monitoring-Modus: nur neue Versteigerungstermine seit dem letzten Lauf. - Feldnamen sind englisch (für internationale Datenpipelines); die Originaltexte (Objektbeschreibung, Grundbuch) bleiben unverändert erhalten. Fehlt ein Feld oder funktioniert etwas nicht? Öffnen Sie ein Actor-Issue mit der Run-URL - Antwort normalerweise innerhalb eines Tages. ### ⚠️ Limits and caveats - This Actor reads the public official ZVG-Portal. It is not affiliated with the Justizportal des Bundes und der Länder. - The portal leaves the **court name empty in the list view** for every state; with `includeDetails` the Actor derives it from the land-register line where available. - A small share of cases publish no appraisal value yet ("wird noch bekannt gegeben"); `appraisalValueEur` is null there and the raw text is kept in `appraisalRaw`. - Multi-lot cases expose all parsed values in `appraisalValuesEur`. - Auction dates reflect what the portal shows; cancelled dates are flagged via `isCancelled`, not removed. ### 🧩 Related Actors - Spain Property Auctions API - the same normalized schema for Spain's BOE Subastas. - EU Tenders API - normalized TED public procurement. - US Building Permits API - normalized construction leads. ### ❓ FAQ #### Which states does it cover? All 16: Baden-Württemberg, Bayern, Berlin, Brandenburg, Bremen, Hamburg, Hessen, Mecklenburg-Vorpommern, Niedersachsen, Nordrhein-Westfalen, Rheinland-Pfalz, Saarland, Sachsen, Sachsen-Anhalt, Schleswig-Holstein, Thüringen. #### Does it translate the documents? Field names and structure are English; original German text (object descriptions, land register, announcements) is preserved as-is. Numbers and dates are normalized to machine-readable formats. #### How does monitoring mode remember what it has seen? A per-state set of case IDs is kept in a named key-value store on **your** Apify account (`germany-zvg-delta-state`). Delete that store to reset the memory. #### Does it need a proxy? No. The ZVG portal is a public official source. Enable Apify Proxy only if you hit rate limits on very frequent runs. ### 🛠️ Support For bugs, missing fields, or a feature request, open an Actor issue with the run URL, the states used, and the field or behavior you expected. ### ⭐ Rate this Actor If this Actor saved you time, please take 30 seconds to leave a review on the **Reviews** tab of [Germany Property Auctions API](https://apify.com/webdata_labs/germany-zvg-auctions-api) - reviews are the main trust signal other users see, and they directly decide which features get built next. If something is broken or a field is missing, please [open an issue](https://apify.com/webdata_labs/germany-zvg-auctions-api/issues) first - we typically respond within a day and would love the chance to fix it before you rate. # Actor input Schema ## `states` (type: `array`): State codes to scrape: bw (Baden-Württemberg), by (Bayern), be (Berlin), br (Brandenburg), hb (Bremen), hh (Hamburg), he (Hessen), mv (Mecklenburg-Vorpommern), ni (Niedersachsen), nw (Nordrhein-Westfalen), rp (Rheinland-Pfalz), sl (Saarland), sn (Sachsen), st (Sachsen-Anhalt), sh (Schleswig-Holstein), th (Thüringen). Use "all" for the whole country. ## `maxResultsPerState` (type: `integer`): Cap the number of auctions collected per state. NRW alone lists ~900 open cases. ## `includeDetails` (type: `boolean`): Fetch each auction's detail page for the full object description, venue, land-register (Grundbuch) line, derived court name, and creditor info. One extra request per auction - slower on large states. ## `onlyNewAuctions` (type: `boolean`): Push only auctions not seen in previous runs of this Actor on your account (per state). The first run returns everything and initializes the memory; every following run returns just the delta - ideal for scheduled monitoring, and you are charged only for new rows. ## `proxyConfiguration` (type: `object`): Optional. The ZVG portal is a public official source; enable Apify Proxy only if you hit rate limits. ## Actor input object example ```json { "states": [ "be" ], "maxResultsPerState": 1000, "includeDetails": false, "onlyNewAuctions": false, "proxyConfiguration": { "useApifyProxy": false } } ``` # Actor output Schema ## `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 = { "states": [ "be" ] }; // Run the Actor and wait for it to finish const run = await client.actor("webdata_labs/germany-zvg-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 = { "states": ["be"] } # Run the Actor and wait for it to finish run = client.actor("webdata_labs/germany-zvg-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 '{ "states": [ "be" ] }' | apify call webdata_labs/germany-zvg-auctions-api --silent --output-dataset ``` ## MCP server setup ```json { "mcpServers": { "apify": { "command": "npx", "args": [ "mcp-remote", "https://mcp.apify.com/?tools=webdata_labs/germany-zvg-auctions-api", "--header", "Authorization: Bearer " ] } } } ``` ## OpenAPI specification ```json { "openapi": "3.0.1", "info": { "title": "Germany Property Auctions API - ZVG Zwangsversteigerung", "description": "[💵 $4.00 / 1K] Zwangsversteigerungen aller 16 Bundesländer vom offiziellen ZVG-Portal: Verkehrswert, Termin, Objekt, Lage. Clean English schema for international investors - appraisal, auction date, address, court files. Monitoring mode returns only new auctions.", "version": "0.1", "x-build-id": "ycfVNO33l3jUpNDSB" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/webdata_labs~germany-zvg-auctions-api/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-webdata_labs-germany-zvg-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~germany-zvg-auctions-api/runs": { "post": { "operationId": "runs-sync-webdata_labs-germany-zvg-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~germany-zvg-auctions-api/run-sync": { "post": { "operationId": "run-sync-webdata_labs-germany-zvg-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", "required": [ "states" ], "properties": { "states": { "title": "German states (Bundesländer)", "type": "array", "description": "State codes to scrape: bw (Baden-Württemberg), by (Bayern), be (Berlin), br (Brandenburg), hb (Bremen), hh (Hamburg), he (Hessen), mv (Mecklenburg-Vorpommern), ni (Niedersachsen), nw (Nordrhein-Westfalen), rp (Rheinland-Pfalz), sl (Saarland), sn (Sachsen), st (Sachsen-Anhalt), sh (Schleswig-Holstein), th (Thüringen). Use \"all\" for the whole country.", "default": [ "all" ], "items": { "type": "string" } }, "maxResultsPerState": { "title": "Max auctions per state", "minimum": 1, "maximum": 5000, "type": "integer", "description": "Cap the number of auctions collected per state. NRW alone lists ~900 open cases.", "default": 1000 }, "includeDetails": { "title": "Include detail pages", "type": "boolean", "description": "Fetch each auction's detail page for the full object description, venue, land-register (Grundbuch) line, derived court name, and creditor info. One extra request per auction - slower on large states.", "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 state). The first run returns everything and initializes the memory; every following run returns just the delta - ideal for scheduled monitoring, and you are charged only for new rows.", "default": false }, "proxyConfiguration": { "title": "Proxy", "type": "object", "description": "Optional. The ZVG portal is a public official source; enable Apify Proxy only if you hit rate limits.", "default": { "useApifyProxy": false } } } }, "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 } } } } } } } } } } ```