API & IntegrationFür Entwickler

Diese Sektion ist für Entwickler, die bodenrichtwert.ai in eigene Systeme einbinden. Wenn du nur deinen KI-Assistenten (ChatGPT, Claude, Gemini, Copilot) mit Bodenrichtwerten versorgen willst, bist du unter Leitfäden besser aufgehoben — dort sind die Schritt-für-Schritt-Anleitungen ohne Code.

Überblick

bodenrichtwert.ai liefert Bodenrichtwerte aus ganz Deutschland per HTTP-API. Ein einziger Call übernimmt beides: die Auflösung der Adresse in amtliche Geokoordinaten und den anschließenden Abruf der Bodenrichtwerte — normalisiert und gemäß dl-de/by-2-0 attribuiert.

Zwei Integrationswege

Beide Wege sprechen denselben OAuth-2.0-Flow unter https://bodenrichtwert.ai/oauth/*. Details unter Authentifizierung.

Schnellstart

1. Account anlegen und einloggen
2. Authentifizierung einrichten — API-Key aus dem Dashboard, OAuth 2.0 für End-User-Flows oder Client-Credentials für Server-Jobs.
3. Ersten Request absetzen — GET /api/bodenrichtwert.

Was du wissen solltest

• Bundesländer ohne Abdeckung: Schleswig-Holstein, Sachsen und Bayern werden mit HTTP 451 abgewiesen — wir liefern keine Falschwerte.
• Attribution ist Pflicht: Jede Antwort enthält einen attribution.text-Block. Bitte in der Ausgabe an den Endnutzer sichtbar zeigen oder verlinken (dl-de/by-2-0).
• Rate Limit: 120 Requests/Minute pro IP — bei Bulk-Jobs mit 429 Retry-After rechnen.
• Zwischenspeicherung: Wir speichern Antworten serverseitig 7 Tage nach SHA-256 der Koordinate zwischen. Treffer aus dem Zwischenspeicher werden im Dashboard unter „Verlauf" markiert.

OpenAPI-Spec

Die vollständige OpenAPI-3.1-Spec für Custom GPTs, Gemini Gems, Copilot Studio und jede Plattform, die OpenAPI-Descriptions lädt:

• openapi.json
• openapi.yaml

Plattform-konfiguration: