Sign in Get API key
ZVG-Portal API

ZVG-Portal API for German Foreclosure Auction Search, Listing Details and Courts

Scrappa's ZVG-Portal API returns structured JSON from ZVG-Portal, the public foreclosure auction portal of the German courts. Search auctions by land, court, postal code, city, object type, auction date and appraised value. Open an auction for the land registry entry, address, description, appraised value, auction date, venue and document links. Read the court of an auction with all its current auctions. Sale auctions only.

500 free credits
No card needed
From $0.20 / 1k
Pay as you go
Structured JSON
Ready for apps
API key access
Test in minutes
Start for free View documentation
Browse endpoints Try first endpoint
5
Endpoints
16
German lands
$0.20
Per 1k requests

Try it now

Make one request. Inspect structured JSON.

Use the first endpoint in this API family with a Scrappa API key. Every account includes 500 free monthly credits, so you can validate the response shape before buying credits.

Get free API key Try in Playground Open docs
Request preview
Request 
curl -X GET "https://scrappa.co/api/zvg-portal/v1/search?land=hb&sort=price_asc&per_page=5" \
  -H "Accept: application/json" \
  -H "X-API-KEY: YOUR_API_KEY"
JSON response 
{
  "success": true,
  "data": {
    "search_metadata": { "total_results": 15, "page": 1, "per_page": 5, "total_pages": 3, "has_next_page": true, "filtered_out": 0 },
    "listings": [
      {
        "zvg_id": 4812,
        "land": "hb",
        "case_number": "0011 b K 0078/2025",
        "court": "Bremen",
        "object_type": "Eigentumswohnung (1 bis 2 Zimmer), 2-Zimmer-Wohnung",
        "address": { "text": "Gnesener Straße 18, 27576 Bremerhaven", "postal_code": "27576", "city": "Bremerhaven" },
        "verkehrswert": { "raw": "6.000,00 €", "amount": 6000.0, "currency": "EUR" },
        "auction_date": "2026-11-09T09:30:00+01:00",
        "cancelled": false
      }
    ]
  },
  "meta": { "endpoint_family": "search", "billable": true }
}

What you can build

Structured data for real applications. Here are some ideas.

Foreclosure Deal Alerts

Watch new auctions by land, court, postal code and object type and compare each appraised value with your price limit.

Auction Calendars

List every auction in a date range and sort by auction date to plan court visits.

Court Research

Open an Amtsgericht and read all of its current auctions in one call.

Due Diligence Files

Collect the land registry entry, description and links to the expert report and notice for each auction.

Location Pickers

Build land and court pickers from the locations route.

ZVG-Portal foreclosure auction API

ZVG-Portal API for German foreclosure auctions, appraised values and courts

The ZVG-Portal API is built for investors, lawyers, real-estate analysts and alert tools that follow German court foreclosure auctions. Each search item carries the case number, court, object type, address, appraised value as text and number, auction date, cancellation status and document links. Listing detail adds the procedure type, land registry entry, description and the auction venue. The data is public and sale only.

One search route per land with court, postal code, city, street, object type, procedure type, case number and auction date filters.

Filters are always honoured: items that break a filter are never returned, and a cancelled auction never matches a price, type or address filter.

Paging is exact: a page past the last page returns an empty list with the true totals.

The appraised value (Verkehrswert) is free text on the source. Scrappa keeps the text and adds the amounts as numbers.

There is no rent, bedroom, bathroom, photo or coordinate data on the source, so the API has none. Failures are never billed.

Choose the right ZVG-Portal API endpoint

Use Auction Search for coverage

Pass a land code and filters, then page through the results with the page parameter.

Open ZVG-Portal Auction Search API docs

Use Listing Detail for the full record

Pass the zvg_id and land of a search item to get the description, land registry entry, venue and documents.

Open ZVG-Portal Listing API docs

Use Locations to find court ids

Type a land or court name and pass the court id to the search or court route.

Open ZVG-Portal Locations API docs

Available endpoints

Everything you need in one API.

Related resources

Realitica API overview

Compare German foreclosure auctions with Balkan property listings.

Scrappa vs ScrapingBee / ScraperAPI

See how Scrappa compares to the official API.

ZVG-Portal auction data as JSON
Scrappa:
ScrapingBee / ScraperAPI: Build your own parser
Filters guaranteed on every item
Scrappa:
ScrapingBee / ScraperAPI: Not available
Price per 1k requests
Scrappa: From $0.20
ScrapingBee / ScraperAPI: Varies by plan
Unified API key
Scrappa: Yes (80+ APIs)
ScrapingBee / ScraperAPI: Scraping only
Free tier
Scrappa: 500 credits/month
ScrapingBee / ScraperAPI: Trial credits only

Key features

Auction search, listing detail, court profile, locations and reference data as JSON
Appraised values as numbers with the original text, auction dates as ISO 8601
All 16 German lands and every Amtsgericht with its court id
Links, names and sizes of the notice, expert report and expose documents
Honest gaps: sale only, no rent, rooms, photos or coordinates exist on the source

Frequently asked questions

No. Scrappa is an independent service and is not affiliated with or endorsed by the German courts or the ZVG-Portal. The API returns structured JSON from public auction data through a Scrappa API key.

No. Only successful responses are billed. A valid empty result, such as Hamburg or Mecklenburg-Vorpommern, is successful and billable.

The portal states the living area only in the free description text of some auctions, and it has no photos or coordinates. The listing route returns the area when the text names it. Documents are returned as links.

A cancelled auction has no object and no appraised value on the portal. Scrappa never returns an item that breaks a filter, so cancelled auctions appear only when you set no type, price or address filter.

Start using the ZVG-Portal API

Sign up and get 500 free credits. No credit card required.

Create Free Account View Documentation