API-Dokumentation

Die Kingscookies API liefert Mietspiegel-Daten als JSON: Vergleichsmiete für eine Wohnung, Regeln und Merkmale eines Mietspiegels, Mietpreisbremse und Änderungen. Jede Abfrage bezieht sich auf einen Stichtag. Ergebnisse sind Berechnungen und als Einschätzung gekennzeichnet – keine Rechtsberatung.

Maschinenlesbar: OpenAPI-Spezifikation (openapi.json)

Zugang

Basis-URL: https://kingscookies.de/api/v1. Jeder Aufruf braucht einen API-Schlüssel als Bearer-Token:

curl -H "Authorization: Bearer IHR_SCHLÜSSEL" \
  "https://kingscookies.de/api/v1/vergleichsmiete?ags=08222000&flaeche=70&baujahr=1965"

Tarife und Limits

Tarif	pro Minute	pro Monat	Basistabellen	Daten-Feed
Free (Entwickler)	10	1.000	–	–
Starter	60	20.000	–	–
Pro	120	200.000	ja	–
Enterprise (Daten-Feed + SLA)	600	unbegrenzt	ja	ja

Wird ein Limit erreicht, antwortet die API mit Status 429. Gezählt werden nur erfolgreiche Abfragen, und zwar zusammengefasst je Kunde, Monat und Endpunkt – einzelne Abfragen werden nicht gespeichert.

Endpunkte

`GET /vergleichsmiete`

Ortsübliche Vergleichsmiete für eine Wohnung: Mittelwert, Spanne (falls der Mietspiegel eine ausweist), Monatsbetrag, angewandte Zu- und Abschläge.

`ags`	Amtlicher Gemeindeschlüssel, 8 Ziffern (Pflicht)
`flaeche`	Wohnfläche in m² (Pflicht)
`baujahr`	Baujahr
`merkmale[]`	Vorhandene Merkmale – Schlüssel aus `GET /mietspiegel/{ags}`
`werte[…]`	Weitere Eingaben des Mietspiegels, z. B. `werte[wohnlage]=4`; bei Tabellenmietspiegeln `werte[wohnlage]=einfach\|mittel\|gut`, `werte[region]=ost\|west` (Berlin), `werte[energieklasse]=A+…H\|ohne` (Potsdam)
`stichtag`	Datum (Standard: heute)

Fehlt eine Angabe, die der Mietspiegel braucht, rechnet die API ohne den betreffenden Zuschlag und nennt die Angabe unter unbekannt – sie wird nie geraten. Einzige Ausnahme: Bei Tabellenmietspiegeln mit Wohnlagen gilt ohne Angabe die mittlere Wohnlage; das steht dann als „Annahme“ in hinweise. Fehlen Gebiet oder Energieklasse dort, wo die Tabelle danach unterscheidet, antwortet die API mit 422.

{
  "data": {
    "einschaetzung": true,
    "gemeinde": { "ags": "08222000", "name": "Mannheim" },
    "vergleichsmiete_eur_qm": { "von": "8.25", "mittel": "9.70", "bis": "11.35" },
    "vergleichsmiete_monat":  { "von": "577.27", "mittel": "679.14", "bis": "794.59" },
    "unbekannt": [],
    "hinweise": ["Einschätzung auf Grundlage des qualifizierten Mietspiegels Mannheim 2025/2026. Keine Rechtsberatung.", "…"]
  },
  "meta": { "api_version": "1", "stichtag": "2026-10-07" }
}

`GET /mietpreisbremse`

Ob eine Landesverordnung zur Mietpreisbremse die Gemeinde am Stichtag erfasst; optional mit vergleichsmiete_eur_qm und miete_eur_qm die Grenze (Vergleichsmiete + 10 %) und die Abweichung in Prozent. Die wichtigsten Ausnahmen (Neubau, umfassende Modernisierung, höhere Vormiete) werden immer mitgeliefert.

`GET /gemeinden`

Liste der Gemeinden mit freigegebenen Daten.

`GET /mietspiegel/{ags}`

Regeln, Merkmalskatalog und Ausgaben-Historie des Mietspiegels, der am Stichtag galt. Vollständige Basistabellen ab Tarif Pro.

`GET /changes?seit=JJJJ-MM-TT`

Änderungen seit einem Datum (neue Mietspiegel, Verordnungen), älteste zuerst, je Seite 500 Einträge; weiter mit nach_id.

Fehler

401	API-Schlüssel fehlt oder ist ungültig
403	Zugang deaktiviert
404	Keine Daten für Gemeinde oder Stichtag
422	Eingabe ungültig oder vom Mietspiegel nicht abgedeckt (z. B. Wohnfläche außerhalb des Geltungsbereichs)
429	Minutenlimit oder Monatskontingent erreicht

Fehlerantworten enthalten immer ein Feld message mit einer verständlichen Beschreibung.

Quellen und Aktualität

Jede Antwort nennt den Mietspiegel mit Quelle, Abrufdatum und Prüfsumme der Originaldatei. Übernommen werden nur Zahlen und Rechenregeln. Neue Mietspiegel werden nach einer Prüfung freigegeben; meta.datenstand zeigt den aktuellen Stand.