Für Entwickler:innen

Die Wohnlupe Daten-API.

WohnlupenScore, die neun Oberkategorien und die „Wohnlupenblick"-Einordnungen für alle 400 Kreise und 16 Bundesländer — als schlankes JSON. Die einzelnen Roh-Kennzahlen bleiben bewusst außen vor. 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 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://www.wohnlupe.de/api/v1/kreise/11000

Interaktive API-Konsole öffnenzugangsgeschützt

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/kreise

Liste aller Kreise: AGS, Name, Land und WohnlupenScore (0–100).

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

GET/api/v1/kreise/{ags}

Ein Kreis: WohnlupenScore + „Wohnlupenblick"-Gesamteinschätzung. {ags} = 5-stelliger Gemeindeschlüssel.

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

GET/api/v1/kreise/{ags}/kategorien

Die neun Oberkategorien eines Kreises — je Score (0–100) und „Wohnlupenblick"-Text. Ohne Einzelwerte.

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

GET/api/v1/laender

Liste aller 16 Bundesländer: ID, Name und Landesschnitt-WohnlupenScore.

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

GET/api/v1/laender/{id}

Ein Bundesland: Landesschnitt-Score, Rang unter 16 und Gesamt-Text. {id} = 2-stellige Bundesland-ID.

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

GET/api/v1/laender/{id}/kategorien

Die neun Oberkategorien eines Bundeslands — je Landesschnitt-Score und „Wohnlupenblick"-Text.

curl -H "Authorization: Bearer DEIN_TOKEN" \
  https://www.wohnlupe.de/api/v1/laender/11/kategorien

GET/api/v1/laender/{id}/kreise

Alle Kreise eines Bundeslands mit AGS, Name und WohnlupenScore.

curl -H "Authorization: Bearer DEIN_TOKEN" \
  https://www.wohnlupe.de/api/v1/laender/11/kreise

Übersicht & Stände jederzeit unter GET https://www.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, nicht auf Zuruf.

Stabile Schlüssel

{ags} ist der amtliche 5-stellige Gemeindeschlüssel des Kreises, {id} die 2-stellige Bundesland-ID (z. B. 11 = Berlin).

Lizenz & Namensnennung: Die Daten kommen vom BBSR (dl-de/by-2.0) und vom DWD (CC BY 4.0); Wohnlupe hat sie bearbeitet. Bei Nutzung bitte die Quelle nennen: „Daten: BBSR, DWD · via wohnlupe.de, bearbeitet".