Zum Inhalt springen
← Zurück zum Rechner

JSON-API

Die Berechnung des Rechners als JSON: Wohnung beschreiben, Mietspanne und Einordnung der Kaltmiete zurückbekommen. Die API gibt die Werte des Mietspiegel Potsdam aus derselben Datengrundlage aus wie diese Website. Sie ist öffentlich und braucht keine Anmeldung.

In drei Schritten

  1. GET /api/v1/schema liefert die gültigen Werte für die Felder der Anfrage.
  2. POST /api/v1/calculate mit der Beschreibung der Wohnung berechnet die Mietspanne.
  3. Mit angegebener kaltmiete steht die Einordnung unter data.einordnung.

Beispiel

Dieselbe Anfrage in drei Sprachen. Sie wird beim Bauen der Website gegen die API geprüft.

curl

curl -X POST https://mietspiegelrechner-potsdam.de/api/v1/calculate \
  -H 'Content-Type: application/json' \
  -d '{"version":"2026","wohnflaeche":55,"baualter":"1949 bis 1970","klassifikation":"D, E, F, G, kein Energieausweis","kaltmiete":400}'

JavaScript

const response = await fetch('https://mietspiegelrechner-potsdam.de/api/v1/calculate', {
  method: 'POST',
  headers: { 'Content-Type': 'application/json' },
  body: JSON.stringify({
    "version": "2026",
    "wohnflaeche": 55,
    "baualter": "1949 bis 1970",
    "klassifikation": "D, E, F, G, kein Energieausweis",
    "kaltmiete": 400
  }),
})
const { meta, data } = await response.json()

Python

import requests

response = requests.post(
    "https://mietspiegelrechner-potsdam.de/api/v1/calculate",
    json={
        "version": "2026",
        "wohnflaeche": 55,
        "baualter": "1949 bis 1970",
        "klassifikation": "D, E, F, G, kein Energieausweis",
        "kaltmiete": 400,
    },
    timeout=10,
)
print(response.json()["data"])

Was zurückkommt

Erfolgreiche Antworten haben die Form { meta, data }. In meta stehen softwareVersion, dataVersion (das Datenjahr des Mietspiegels) und updated; data enthält die Mietspanne je Quadratmeter und, wenn eine Kaltmiete mitgeschickt wurde, die Einordnung. Fehler kommen als HTTP 400 mit error.code und den gültigen Werten. Die vollständige Antwort steht auf der Referenzseite .

Grenzen

  • Höchstens 60 Anfragen pro Minute und IP-Adresse; die Header X-RateLimit-Limit, X-RateLimit-Remaining und X-RateLimit-Reset zeigen den Stand.
  • Das Ergebnis ist eine Einordnung nach dem Mietspiegel Potsdam und ersetzt keine Rechtsberatung.

API-Referenz · OpenAPI-Spezifikation · Berechnungslogik · Offene Daten