# API & Integration

> Kurzer Überblick über bodenrichtwert.ai, die Datenherkunft (Gutachterausschüsse für Grundstückswerte) und die zwei Integrationswege.

Diese Sektion ist für Entwickler, die <brand-name>



</brand-name>

 in eigene Systeme einbinden. Wenn du **nur** deinen KI-Assistenten (ChatGPT, Claude, Gemini, Copilot) mit Bodenrichtwerten versorgen willst, bist du unter [Leitfäden](/docs/integration-guides) besser aufgehoben — dort sind die Schritt-für-Schritt-Anleitungen ohne Code.

## Überblick

**** 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

<table>
<thead>
  <tr>
    <th>
      Dein Anwendungsfall
    </th>
    
    <th>
      Empfohlener Weg
    </th>
  </tr>
</thead>

<tbody>
  <tr>
    <td>
      Backend-Job, Skript, Batch-Export, Low-Code-Tool (n8n, Zapier, Make), Custom GPT / Gemini Gem / Copilot Studio
    </td>
    
    <td>
      <a href="/docs/entwickler-einstieg/rest-api">
        REST API
      </a>
    </td>
  </tr>
  
  <tr>
    <td>
      Eigener MCP-Client, Agent-Framework mit MCP-Support (LangGraph, Code-Agent, Workspace-Integration)
    </td>
    
    <td>
      <a href="/docs/entwickler-einstieg/mcp-server">
        MCP Server
      </a>
    </td>
  </tr>
</tbody>
</table>

Beide Wege sprechen denselben OAuth-2.0-Flow unter `https://bodenrichtwert.ai/oauth/*`. Details unter [Authentifizierung](/docs/entwickler-einstieg/authentication).

## Schnellstart

1. [Account anlegen und einloggen](/login)
2. [Authentifizierung einrichten](/docs/entwickler-einstieg/authentication) — 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`](/docs/entwickler-einstieg/rest-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 nach SHA-256 der Koordinate zwischen und liefern sie 24 Stunden lang direkt aus; danach wird im Hintergrund erneuert. Fällt die amtliche Quelle aus, antworten wir bis zu 30 Tage lang mit dem letzten bekannten Wert und kennzeichnen ihn mit `cache_stale: true` — [Details](/docs/entwickler-einstieg/rest-api/bodenrichtwert#zwischenspeicherung). 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](https://api.bodenrichtwert.ai/openapi.json)
- [openapi.yaml](https://api.bodenrichtwert.ai/openapi.yaml)

Plattform-konfiguration:

<table>
<thead>
  <tr>
    <th>
      Endpoint
    </th>
    
    <th>
      URL
    </th>
  </tr>
</thead>

<tbody>
  <tr>
    <td>
      Authorization URL
    </td>
    
    <td>
      <code>
        https://bodenrichtwert.ai/oauth/authorize
      </code>
    </td>
  </tr>
  
  <tr>
    <td>
      Token URL
    </td>
    
    <td>
      <code>
        https://bodenrichtwert.ai/oauth/token
      </code>
    </td>
  </tr>
  
  <tr>
    <td>
      Dynamic Client Registration (RFC 7591)
    </td>
    
    <td>
      <code>
        https://bodenrichtwert.ai/oauth/register
      </code>
    </td>
  </tr>
  
  <tr>
    <td>
      PKCE
    </td>
    
    <td>
      S256 (für public Clients)
    </td>
  </tr>
  
  <tr>
    <td>
      Scope
    </td>
    
    <td>
      <em>
        (leer — keine Scopes)
      </em>
    </td>
  </tr>
</tbody>
</table>