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
GET /api/v1/schemaliefert die gültigen Werte für die Felder der Anfrage.POST /api/v1/calculatemit der Beschreibung der Wohnung berechnet die Mietspanne.- Mit angegebener
kaltmietesteht die Einordnung unterdata.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-RemainingundX-RateLimit-Resetzeigen den Stand. - Das Ergebnis ist eine Einordnung nach dem Mietspiegel Potsdam und ersetzt keine Rechtsberatung.
API-Referenz · OpenAPI-Spezifikation · Berechnungslogik · Offene Daten