API · v1 · Open Data

Open-Data-API

Zwei offene JSON-Endpoints ohne Anmeldung: Plattform-Kennzahlen und aggregierte Bodenrichtwerte pro Bundesland. Zugang zu einzelnen Bebauungsplänen richten wir auf Anfrage ein.

Offene Endpoints

Plattform-Kennzahlen

GET /api/v1/meta

Bestandszahlen der Plattform: erfasste Pläne, davon solche mit maschinenlesbaren Festsetzungen, abgedeckte Bundesländer und Gemeinden, Anzahl der Bodenrichtwerte. Für Dashboards, Daten-Journalismus und Coverage-Auswertungen.

Wichtig für die Interpretation: total_plaene zählt jeden erfassten Plan, auch solche, von denen nur der Geltungsbereich vorliegt. Nur mit_festsetzungen (8.501 von 78.842) trägt Kennzahlen wie GRZ, GFZ oder Vollgeschosse. Wer Coverage berichtet, sollte die zweite Zahl nennen — die erste beschreibt den Bestand, nicht die Datentiefe.

/api/v1/meta →

Bodenrichtwerte pro Bundesland

GET /api/v1/bodenrichtwerte/{bundesland}

Aggregierte Bodenrichtwerte eines Bundeslands — Median sowie 5. und 95. Perzentil, gefiltert auf Bauland-Nutzungen und beschränkt auf den jeweils neuesten Stichtag der Quelle. Quelle: BORIS-Dienste der Gutachterausschüsse.

Jede Antwort führt den vorgeschriebenen Quellenvermerk im Feld attribution und das Lizenzkürzel in license mit. Beide gehören bei Weiterverwendung übernommen (siehe Nutzungsbedingungen, Abschnitt 2).

/api/v1/bodenrichtwerte/hamburg →

Liegt für ein Bundesland kein Aggregat vor oder steht eine Quelle wegen eines Datenbefunds unter Prüfung, antwortet der Endpoint mit 404. Die API liefert grundsätzlich keine Werte aus, die die Website zurückhält.

Selbstbeschreibung

GET /api/v1/

Listet die verfügbaren Endpoints, das Rate-Limit und die Lizenzhinweise maschinenlesbar auf.

Plan-Level-Daten — auf Anfrage

Der Grund ist Datenqualität, nicht Geschäftsmodell: Der Detailgrad schwankt je Plan erheblich, und ein Großteil des Bestands liegt nur als Geltungsbereich vor. Über die Website erscheinen solche Pläne mit dem passenden Hinweis; über eine JSON-Schnittstelle wanderten sie ungefiltert in fremde Oberflächen, wo wir den Kontext nicht mehr kontrollieren. Deshalb klären wir vorab, welcher Ausschnitt für den jeweiligen Zweck belastbar ist.

Für einzelne Abfragen ohne Integration eignen sich der interaktive Grundstücks-Check und die B-Plan-Übersicht.

Lizenz und Attribution

Die zugrunde liegenden Daten stammen aus offiziellen Open-Data-Quellen der Länder und Kommunen — Bebauungspläne überwiegend unter dl-de/by-2.0 oder CC0, Bodenrichtwerte je nach Bundesland unter dl-de/by-2-0 bzw. dl-de/zero-2-0. Diese Lizenzen erlauben die Weiterverwendung ausdrücklich, auch kommerziell.

Bei Weiterverwendung ist Namensnennung Pflicht, soweit die jeweilige Lizenz sie verlangt. Maßgeblich ist der Wortlaut, den die Antwort mitliefert:

attribution — der vorgeschriebene Quellenvermerk des Datenhalters, wörtlich zu übernehmen. Eine eigene Umschreibung erfüllt die Lizenz nicht.
license — das Lizenzkürzel der Quelle.
_meta.attribution — Sammelhinweis über alle in der API verwendeten Quellenarten, ergänzend zum Vermerk des einzelnen Datensatzes.

Ein Verweis allein auf darfichbauen.de genügt nicht — die Originalquelle muss durchgereicht werden. Als Zusatz gern: „via darfichbauen.de Open-Data-API".

Beispiel — mit curl

curl -s "https://darfichbauen.de/api/v1/meta" \
  | jq '{bestand: .total_plaene, mit_kennzahlen: .mit_festsetzungen}'

curl -s "https://darfichbauen.de/api/v1/bodenrichtwerte/hamburg" \
  | jq '{median: .median_eur_m2, p5: .p5_eur_m2, p95: .p95_eur_m2,
         quelle: .attribution, lizenz: .license}'

Changelog

2026-08 — Bodenrichtwerte liefern den Quellenvermerk des Datenhalters (attribution) und das Lizenzkürzel (license) mit, statt einer festen Umschreibung. Dokumentation auf den tatsächlichen Funktionsumfang korrigiert.
v1 (2026-04) — Initial-Release: meta und bodenrichtwerte offen, Plan-Level-Endpoints auf Anfrage.