Für Entwickler:innen

Die Wohnlupe Daten-API.

WohnlupenScore, Themen-Teilscores und 87 amtliche Indikatoren für alle 400 Kreise Deutschlands — als schlankes JSON. Read-only, cachebar, Access-Control-Allow-Origin: *. Der Zugang läuft über einen persönlichen Token.

Zugang nur mit Token

Die API ist nicht frei zugänglich. Jeder Datenabruf braucht einen gültigen Zugangstoken — ohne gültigen Token antwortet die API mit 401 Unauthorized.

1
Token anfragen
Schreib uns kurz, wofür du die Daten nutzen willst: mail@wohnlupe.de. Du bekommst einen persönlichen Token.
2
Token als Header senden
Bei jedem Request einen der beiden Header mitschicken:
```
Authorization: Bearer DEIN_TOKEN
X-API-Key: DEIN_TOKEN
```

Loslegen

curl -H "Authorization: Bearer DEIN_TOKEN" \
  https://wohnlupe.de/api/v1/regions/11000

Behandle deinen Token wie ein Passwort — nicht in öffentlichen Frontends oder Repositories einbetten. Die Abfrage läuft serverseitig, damit der Token geheim bleibt.

Endpunkte

GET/api/v1/indicators

Katalog aller Indikatoren (Key, Label, Einheit, Richtung, Thema, Quelle).

curl -H "Authorization: Bearer DEIN_TOKEN" \
  https://wohnlupe.de/api/v1/indicators

GET/api/v1/indicators/{key}

Ein Indikator über alle Kreise — alle Einzelwerte, für Vergleiche und Downloads.

curl -H "Authorization: Bearer DEIN_TOKEN" \
  https://wohnlupe.de/api/v1/indicators/alq

GET/api/v1/regions

Liste aller Kreise: AGS, Name, Land, Raumtyp und WohnlupenScore.

curl -H "Authorization: Bearer DEIN_TOKEN" \
  https://wohnlupe.de/api/v1/regions

GET/api/v1/regions/{ags}

Ein Kreis: Score, Themen-Teilscores und alle Einzelwerte. {ags} = 5-stelliger Gemeindeschlüssel.

curl -H "Authorization: Bearer DEIN_TOKEN" \
  https://wohnlupe.de/api/v1/regions/11000

GET/api/v1/values

Flexible Mehrwert-Abfrage: viele Einzelwerte auf einmal, gefiltert nach Kreisen und Indikatoren.

curl -H "Authorization: Bearer DEIN_TOKEN" \
  https://wohnlupe.de/api/v1/values?regions=02000,11000&indicators=alq,hh_veink

Übersicht & Stände jederzeit unter GET https://wohnlupe.de/api/v1 — dieser Discovery-Endpunkt ist offen und listet Version, Datenstand und die Auth-Hinweise.

Gut zu wissen

JSON & CORS

Alle Antworten sind JSON, cross-origin lesbar. Fehler kommen als { error, message } mit passendem Statuscode.

Read-only

Nur GET. Die Daten ändern sich mit dem Datenstand (Deutschlandatlas, INKAR, DWD), nicht auf Zuruf.

Stabile Schlüssel

{ags} ist der amtliche 5-stellige Gemeindeschlüssel des Kreises, {key} ein Indikator-Key aus /indicators.

Lizenz & Namensnennung: Die Daten stammen von BBSR (Deutschlandatlas, INKAR) und DWD und stehen unter dl-de/by-2.0 bzw. CC BY 4.0. Bei Nutzung bitte die Quelle nennen (z. B. „Daten: BBSR/DWD via wohnlupe.de").