REST API

Der direkte Weg für eigene Anwendungen, Hintergrund-Jobs, Portfolio-Auswertungen, Low-Code-Tools (n8n, Zapier, Make) und überall dort, wo du HTTP sprichst.

Base URL

https://api.bodenrichtwert.ai

Alle Endpunkte erwarten einen Bearer Token im Authorization-Header.

Schnellster Einstieg: Einen API-Key im Dashboard → API-Keys erstellen und als Bearer brw_pat_… senden. Für SaaS-Integrationen mit End-User-Login oder Server-zu-Server-Flows siehe Authentifizierung.

Endpunkte

GET /api/bodenrichtwert — Adresse rein, normalisierter Bodenrichtwert raus.
GET /api/me — dein Profil, Plan und aktuelle Nutzung.
POST /api/bodenwert — Bodenrichtwert auf abweichende Dichte (GFZ) umrechnen; mit Fläche der gesamte Bodenwert. Reine Berechnung, zählt nicht gegen das Kontingent.

Beispiel — cURL

curl -H "Authorization: Bearer brw_pat_..." \
  "https://api.bodenrichtwert.ai/api/bodenrichtwert?address=Unter+den+Linden+1,+Berlin"

Beispiel — Node.js (Fetch)

const res = await fetch('https://api.bodenrichtwert.ai/api/bodenrichtwert?address=Berlin', {
  headers: { Authorization: `Bearer ${process.env.BRW_TOKEN}` },
})

if (!res.ok) {
  throw new Error(`${res.status}: ${await res.text()}`)
}

const data = await res.json()
console.log(data.bodenrichtwerte)

Beispiel — Python (requests)

import os, requests

r = requests.get(
    "https://api.bodenrichtwert.ai/api/bodenrichtwert",
    params={"address": "Unter den Linden 1, Berlin"},
    headers={"Authorization": f"Bearer {os.environ['BRW_TOKEN']}"},
    timeout=10,
)
r.raise_for_status()
print(r.json()["bodenrichtwerte"])

Was du nicht vergessen darfst

Rate Limits respektieren — 120 Requests/Minute pro IP. Für Bulk-Jobs Pausen einbauen oder mit 429 Retry-After arbeiten.
Attribution anzeigen — gib den attribution.text in deiner UI sichtbar aus. Das ist Lizenz-Pflicht (dl-de/by-2-0).
SH/SN/BY-Check — bei deutschlandweiten Anfragen fang HTTP 451 sauber im Client ab.

OpenAPI-Spec

Die vollständige OpenAPI-3.1-Spec liegt unter:

Plattformen wie Custom GPTs, Gemini Gems oder Copilot Studio, die OpenAPI-Descriptions importieren, binden bodenrichtwert.ai darüber als Action/Tool ein.