Überblick
Was die API liefert
Marktwert mit Spanne
Median, Unter- und Obergrenze sowie €/m² — die Spanne leitet sich aus der Modellgüte ab.
Konfidenz & Bewertbarkeit
Ehrliche Einstufung, wann ein Wert gezeigt werden darf und wann auf eine persönliche Einschätzung übergeleitet werden sollte.
Amtlicher Bodenrichtwert
Adressgenaue Abfrage der BORIS-Portale, regionaler Liegenschaftszins und Marktmieten.
Adressprüfung
Normalisiert Eingaben, liefert Koordinaten und erkennt mehrdeutige Adressen.
Schema für Formulare
Pflichtgrad, Wirkung und Hilfetexte je Feld — Ihr Funnel fragt nur, was den Wert verbessert.
Reproduzierbar
Jede Bewertung erhält eine request_id und bleibt mit Engine-Version und Datenstand abrufbar.
Objekttypen
Mehrfamilienhaus (MFH), Wohn- und Geschäftshaus (WGH), Eigentumswohnung (ETW), Einfamilienhaus (EFH), Doppelhaushälfte (DHH), Reihenhaus (RH), Reihenendhaus (REH), Villa, Bungalow, Bauernhaus / Resthof, Burg / Schloss, Besondere Immobilie, Sonstiges Wohnobjekt.
Wertindikation, kein Gutachten
Ergebnisse ersetzen kein Verkehrswertgutachten nach § 194 BauGB.
Schnellstart
In drei Schritten zur ersten Bewertung
- 1
Schlüssel erstellen
Kostenlos registrieren, dann unter Einstellungen → API-Zugang einen Schlüssel anlegen. Der Schlüssel wird genau einmal angezeigt.
Zum API-Zugang - 2
Erste Anfrage senden
Mindestangaben: PLZ, Objekttyp und Wohnfläche. Jede weitere Angabe erhöht die Konfidenz.
cURLcurl -X POST "https://immoanalyse.pro/api/v1/valuation" \ -H "X-API-Key: IHR_API_SCHLUESSEL" \ -H "Content-Type: application/json" \ -d '{"adresse":"Suderwichstraße 143","plz":"45665","ort":"Recklinghausen","haustyp":"mfh","baujahr":1965,"wohnflaeche":320,"grundstuecksflaeche":1668,"kaltmiete":1800,"zustandSterne":3}' - 3
Antwort darstellen
Zeigen Sie
marktwertimmer zusammen mit der Spanne und richten Sie die Darstellung nachbewertbarkeit.statusaus (siehe Antwort lesen).Beispielantwort (echter Aufruf, gekürzt){ "request_id": "22c4adf2-c9ef-4da4-b72c-c41a13f135a9", "cached": false, "schema_version": "1.2", "engine_version": "2026.09.01", "data_as_of": null, "bewertbarkeit": { "status": "not_reliably_valuable", "begruendung": "Datenbasis und Modellgüte tragen keinen belastbaren Einzelwert — bitte auf eine persönliche Einschätzung überleiten.", "limitations": [] }, "marktwert": { "median": 476732, "min": 399039, "max": 554425, "waehrung": "EUR", "preis_pro_m2": 1490 }, "konfidenz": { "wert": 35, "level": "niedrig", "treiber": [ { "key": "modellguete", "label": "Modellgüte (hedonische Regression)", "status": "schwach", "beitrag_punkte": 32, "einfluss": "hoch", "detail": "Bestimmtheitsmaß R² = 32 % über 29 Vergleichsangebote." }, { "key": "stichprobe", "label": "Umfang der Vergleichsdaten", "status": "schwach", "beitrag_punkte": -20, "einfluss": "hoch", "detail": "29 Vergleichsangebote in der Region (PLZ 45665)." }, { "key": "verfahrensmix", "label": "Zusammenspiel Ertrags- und Vergleichswert", "status": "gut", "beitrag_punkte": 5, "einfluss": "mittel", "detail": "Zwei unabhängige Verfahren stützen das Ergebnis." } ] }, "verbesserungs_hinweise": [ { "feld": "modernisierung_punkte", "label": "Modernisierungsgrad", "hinweis": "Ein Modernisierungsgrad von 0–20 Punkten (ImmoWertV Anlage 2) präzisiert die Restnutzungsdauer gegenüber der Sterne-Bewertung.", "expected_impact": "mittel", "estimated_confidence_gain": null } ], "methodik": { "berechnungsmethode": "durchschnitt", "verfahrensmodus": "ertragswert-fuehrend", "regionale_datenbasis": "PLZ 45665", "datenpunkte": 29 }, "vergleichswert": 487680, "vergleichsobjekte": [ { "plz": "45665", "ort": "Recklinghausen", "haustyp": "mfh", "baujahr": 1970, "wohnflaeche_m2": 309, "kaufpreis_pro_m2": 1456, "kaufpreis_geschaetzt": 450000, "lage_bezug": "gleiche PLZ", "aehnlichkeit": "sehr hoch", "aehnlichkeit_score": 100, "jahr": 2026, "preisart": "angebotspreis" }, { "plz": "45665", "ort": "Recklinghausen", "haustyp": "mfh", "baujahr": 1974, "wohnflaeche_m2": 315, "kaufpreis_pro_m2": 1841, "kaufpreis_geschaetzt": 580000, "lage_bezug": "gleiche PLZ", "aehnlichkeit": "sehr hoch", "aehnlichkeit_score": 92, "jahr": 2026, "preisart": "angebotspreis" } ], "vergleichsstatistik": { "anzahl": 20, "median_pro_m2": 1515, "p25_pro_m2": 1361, "p75_pro_m2": 1861, "streuung_prozent": 33, "preisart": "angebotspreis" }, "ertragswert": 451187, "bodenwert": { "gesamt": 341940, "pro_m2": 205, "quelle": "boris", "confidence": "hoch", "hinweis": "Amtlicher Bodenrichtwert (BORIS) an der adressgenauen Koordinate." }, "liegenschaftszins": { "wert": 3.38, "quelle": "regional-pool" }, "miete": { "quelle": "eingabe", "kaltmiete_monat": 1800, "marktmiete_pro_m2": 8, "marktmiete_pro_m2_min": 7.9, "marktmiete_pro_m2_max": 8.5, "datenpunkte": 23, "brutto_rendite_prozent": 4.53 }, "kennzahlen": { "marktwert_vor_abschlag": 476732, "kaufpreisfaktor": 22.1, "jahresnettokaltmiete": 21600, "netto_rendite_prozent": 3.53, "bwk_quote_prozent": 22, "ist_miete_pro_m2": 5.63, "mietpotenzial_prozent": 42.1, "bodenwert_dominanz": "dominiert", "bodenwert_anteil_prozent": 74, "liquidationswert_greift": false, "hedonik_anker_korrektur": null }, "gebaeude": { "restnutzungsdauer_jahre": 36, "modernisierungspunkte": 8, "zustand_modifikator_prozent": 0, "gewerbeanteil_prozent": null }, "erklaerungen": { "marktwert": "Der Marktwert von 476.732 € ergibt sich aus dem gewichteten Zusammenspiel von Ertrags- und Vergleichswert. Die Spanne von 399.039 € bis 554.425 € (±16 %) leitet sich aus der Güte des Regressionsmodells (R² 32 %, 29 Vergleichsobjekte) ab.", "vergleichswert": "Der Vergleichswert basiert auf einer hedonischen Regression über 29 reale Angebote in der Region (PLZ 45665). Der Modellpreis von 1524 €/m² wurde um den Zustandsfaktor (0 %) auf 1524 €/m² angepasst und mit 320 m² multipliziert." }, "warnungen": [ "Der Bodenwert macht einen hohen Anteil am Objektwert aus (§ 38 ImmoWertV) — der Vergleichswert wird stärker gewichtet." ], "kontingent": { "limit": 25, "verbraucht": 1, "verbleibend": 24, "reset_at": "2026-11-01T00:00:00.000Z", "tarif": "developer" } }
Sicherheit
Authentifizierung
X-API-Key (alternativ Authorization: Bearer …).X-API-Key: iap_live_…
Content-Type: application/json- Nur Server-zu-Server: den Schlüssel nie im Browser, in Apps oder öffentlichen Repositories verwenden.
- Gespeichert wird nur ein Fingerabdruck (SHA-256). Verlorene Schlüssel löschen und neu erstellen.
- Schlüssel lassen sich pausieren und sofort löschen — gelöschte Schlüssel liefern 401.
- Alle Schlüssel eines Kontos teilen sich Kontingent und Minuten-Limit des Tarifs.
Referenz
Endpunkte
https://immoanalyse.pro/api/v1. Die vollständige Spezifikation steht als OpenAPI 3.1 bereit (z. B. für Postman oder Code-Generatoren)./valuationImmobilie bewerten
Marktwert mit Spanne, Konfidenz, Bewertbarkeit und vollständiger ImmoWertV-Herleitung. Zählt auf das Monatskontingent — identische Anfragen innerhalb von 10 Minuten nicht.
/address-lookupAdresse prüfen
Normalisiert und geocodiert eine Adresse. Koordinaten direkt als lat/lon an /valuation übergeben — dann wird der amtliche Bodenrichtwert punktgenau abgefragt. Eigenes Kontingent, 30 Tage Zwischenspeicher.
/schema?haustyp=etwFeld-Schema
Felder in Formular-Reihenfolge mit Pflichtgrad, Wirkung, Einheit und Optionen — bauen Sie Ihr Formular daraus, statt Felder fest zu verdrahten.
/typesObjekttypen
Unterstützte und bewusst nicht unterstützte Objekttypen mit Begründung.
/result/{request_id}Ergebnis erneut abrufen
Liefert Anfrage und Ergebnis unverändert — für Nachvollziehbarkeit, PDFs oder spätere Anzeige.
Adressprüfung — Anfrage
curl -X POST "https://immoanalyse.pro/api/v1/address-lookup" \
-H "X-API-Key: IHR_API_SCHLUESSEL" \
-H "Content-Type: application/json" \
-d '{"adresse":"Suderwichstraße 143, 45665 Recklinghausen"}'Adressprüfung — Antwort
{
"schema_version": "1.2",
"engine_version": "2026.09.01",
"cached": false,
"quality": "exact",
"valuation_ready": true,
"normalized": {
"strasse": "Suderwichstraße",
"hausnummer": "143",
"plz": "45665",
"ort": "Recklinghausen",
"stadtteil": "Suderwich",
"bundesland": "Nordrhein-Westfalen",
"land": "DE",
"formatiert": "Suderwichstraße 143, 45665 Recklinghausen"
},
"koordinaten": {
"lat": 51.6070144,
"lon": 7.248129
},
"alternativen": [],
"ambiguous": false,
"hinweise": [],
"quelle": "geoapify"
}Eingaben
Felder je Objekttyp
GET /schema ausliefert.| Feld | Typ | Angabe | Wirkung | Beschreibung |
|---|---|---|---|---|
plzPostleitzahl | Text | Pflicht | hoch | Fünfstellige deutsche PLZ. Bestimmt die regionale Datenbasis der Bewertung. |
ortOrt | Text | Empfohlen | mittel | Verbessert die Auswahl der Vergleichsobjekte und den regionalen Liegenschaftszins. Erhöht die Trefferqualität der Vergleichsobjekte. |
adresseStraße und Hausnummer | Text | Empfohlen | hoch | Basis für die adressgenaue Abfrage des amtlichen Bodenrichtwerts (BORIS). Ermöglicht den amtlichen Bodenrichtwert statt einer Schätzung. |
latBreitengrad | Zahl | Optional | mittel | Aus dem Address-Lookup übernehmen. Umgeht das unpräzise Geocoding bei der Bodenrichtwert-Abfrage. |
lonLängengrad | Zahl | Optional | mittel | Aus dem Address-Lookup übernehmen. |
wohnflaecheWohnfläche gesamt | Zahl m² | Pflicht | hoch | Wohnfläche in Quadratmetern. Zentrale Bezugsgröße des Vergleichswertverfahrens. |
grundstuecksflaecheGrundstücksfläche | Zahl m² | Empfohlen | hoch | Ohne Grundstücksfläche kann kein amtlicher Bodenwert angesetzt werden — der Ertragswert wird dann nicht gerechnet. Ermöglicht Bodenwert, Ertragswert und die §-38-Prüfung. |
baujahrBaujahr | Ganzzahl | Empfohlen | hoch | Grundlage der Restnutzungsdauer nach ImmoWertV. Ohne Baujahr wird pauschal die halbe Gesamtnutzungsdauer angesetzt. Ohne Baujahr ist die Restnutzungsdauer und damit der Ertragswert nur grob geschätzt. |
zustandSterneZustand | Auswahl 1 · 2 · 3 · 4 · 5 | Empfohlen | hoch | Wirkt als Zu-/Abschlag auf den Vergleichswert (−15 % bis +12 %) und auf die Restnutzungsdauer. |
modernisierung_punkteModernisierungsgrad (ImmoWertV Anlage 2) | Ganzzahl | Optional | mittel | Optionaler Feinwert 0–20 Punkte. Überschreibt die aus dem Zustand abgeleiteten Punkte bei der Restnutzungsdauer. Präzisiert die Restnutzungsdauer gegenüber der groben Sterne-Bewertung. |
bauschadenGradBekannte Bauschäden | Auswahl keine · leicht · mittel · schwer | Optional | mittel | Führt zu einem Instandsetzungsabschlag und verkürzt die Restnutzungsdauer. |
denkmalschutzDenkmalgeschützt | Ja/Nein | Optional | gering | Erhöht Liegenschaftszins und Bewirtschaftungskosten (höheres Bewirtschaftungsrisiko). |
kaltmieteIst-Kaltmiete gesamt (monatlich) | Zahl €/Monat | Pflicht | hoch | Ohne Miete ist kein Ertragswert möglich — das Ergebnis beruht dann allein auf dem Vergleichswert. Fehlt die Angabe, wird ersatzweise die regionale Marktmiete angesetzt. Ohne Miete entfällt das führende Ertragswertverfahren. |
stellplatzMieteMonatStellplatzmieten (monatlich) | Zahl €/Monat | Optional | gering | Fließt als zusätzlicher Reinertrag (90 %) in den Ertragswert ein. |
ist_erbbaurechtErbbaurecht | Ja/Nein | Optional | hoch | Bei Erbbaurecht wird ohne Bodenwert gerechnet und ein Wertabschlag berücksichtigt. |
erbbauzins_jahrErbbauzins pro Jahr | Zahl €/Jahr | Optional | mittel | Nur bei Erbbaurecht. Mindert den Jahresrohertrag. |
erbbaurecht_restlaufzeitRestlaufzeit Erbbaurecht | Ganzzahl Jahre | Optional | mittel | Nur bei Erbbaurecht. Begrenzt die Kapitalisierungsdauer. |
kaufpreisKaufpreis / Preisvorstellung | Zahl € | Optional | gering | Beeinflusst die Bewertung nicht, liefert aber Kaufpreisfaktor, Rendite und eine Markteinordnung. |
bodenrichtwert_pro_m2Bodenrichtwert | Zahl €/m² | Optional | hoch | Überschreibt die BORIS-Abfrage. Nur setzen, wenn ein amtlicher Wert vorliegt. |
- Die Anzahl der Wohneinheiten fließt aktuell nicht in die Bewertung ein — maßgeblich sind Gesamtwohnfläche und Gesamtmiete.
Ausgaben
Antwort lesen
bewertbarkeit.status | valuable → Spanne anzeigen · valuable_with_limitations → Spanne mit Hinweisen anzeigen · not_reliably_valuable → keinen Einzelwert anzeigen, auf persönliche Einschätzung überleiten. |
bewertbarkeit.vergleichsbasis | Grundlage der Einstufung: sehr ähnliche Vergleichsobjekte (valuable ab 8, eingeschränkt ab 3) und deren Preisstreuung (valuable unter 35 %, eingeschränkt unter 50 %). |
marktwert | median, min, max in Euro sowie preis_pro_m2. Die Spanne kommt aus der Engine — bitte nie selbst bilden oder runden. |
konfidenz | wert (0–100), level und treiber[] — welche Faktoren die Sicherheit erhöhen oder senken. |
verbesserungs_hinweise[] | Welche Angabe die Bewertung am stärksten verbessern würde (Grundlage für eine „Was fehlt noch?“-Frage im Funnel). |
vergleichswert · ertragswert · bodenwert | Ergebnisse der einzelnen ImmoWertV-Verfahren inkl. Quelle des Bodenwerts (z. B. amtlicher Bodenrichtwert). |
liegenschaftszins · miete · kennzahlen | Kapitalisierungszins mit Herkunft, Markt- und Ist-Miete, Kaufpreisfaktor, Renditen, Bewirtschaftungskosten. |
vergleichsobjekte · vergleichsstatistik | Anonymisierte Vergleichsangebote der Region mit Ähnlichkeit sowie Median und Streuung der €/m². |
erklaerungen · warnungen | Laienverständliche Texte zu jedem Ergebnis und fachliche Warnungen (z. B. hoher Bodenwertanteil nach § 38 ImmoWertV). |
kontingent | limit, verbraucht, verbleibend, reset_at und tarif — nach jeder Bewertung. |
request_id · cached | Kennung für /result/{request_id}; cached = true, wenn die Antwort aus dem 10-Minuten-Zwischenspeicher kam. |
Fair Use
Limits & Kontingente
| Tarif | Bewertungen / Monat | Adressprüfungen / Monat | Anfragen / Minute | Schlüssel |
|---|---|---|---|---|
| Developer | 25 | 100 | 10 | 2 |
| Starter | 500 | 2.000 | 30 | 5 |
| Business | 2.500 | 10.000 | 60 | 10 |
| Scale | 10.000 | 40.000 | 120 | 25 |
X-RateLimit-Limit: 30
X-RateLimit-Remaining: 29
X-RateLimit-Reset: 1792396800
X-Quota-Limit: 500
X-Quota-Remaining: 412
X-Quota-Reset: 2026-11-01T00:00:00.000Z- Minuten-Limit: gleitendes 60-Sekunden-Fenster. Bei Überschreitung 429 mit
Retry-After. - Monatskontingent: bei Erschöpfung 402. Ein Tarifwechsel gilt sofort.
- Zwischenspeicher: identische Bewertungen 10 Minuten, Adressen 30 Tage — Wiederholungen kosten kein Kontingent.
- Zahlungsverzug: der gebuchte Tarif läuft 7 Tage weiter, danach gelten die Developer-Limits bis zur Zahlung.
Fehlerbehandlung
Fehlercodes
code bleibt stabil, status ist der genaue Grund.| HTTP | status | Bedeutung |
|---|---|---|
| 400 | validation_error, invalid_json | Eingaben oder JSON ungültig — details[] nennt die Felder. |
| 401 | unauthorized, key_expired | Schlüssel fehlt, ist falsch, pausiert, gelöscht oder abgelaufen. |
| 402 | quota_exceeded | Monatskontingent ausgeschöpft — X-Quota-Reset nennt den Neubeginn. |
| 404 | not_found, result_not_found | Route oder request_id unbekannt. |
| 413 | payload_too_large | Anfrage größer als 64 KB. |
| 422 | property_type_not_supported | z. B. unbebautes Grundstück oder reines Gewerbe — es wird nie ein Wert geliefert. |
| 422 | input_implausible | Eingaben widersprüchlich (z. B. Jahres- statt Monatsmiete). |
| 422 | region_data_insufficient | Zu wenig Vergleichsdaten in der Region. |
| 422 | address_not_resolved | Adresse nicht auflösbar. |
| 429 | rate_limited | Minuten-Limit erreicht — Retry-After nennt die Wartezeit in Sekunden. |
| 503 | temporary_market_data_unavailable | Marktdatenquelle vorübergehend gestört — später erneut versuchen. |
| 500 | internal_error | Unerwarteter Fehler — bitte request_id bzw. Zeitpunkt an den Support senden. |
{
"error": {
"code": "property_type_not_supported",
"status": "property_type_not_supported",
"message": "Unbebaute Grundstücke werden nicht automatisch bewertet: die hedonische Vergleichswert-Engine ist auf bebaute Wohnimmobilien (€/m² Wohnfläche) trainiert. Für Grundstücke ist der Bodenrichtwert (BORIS) die maßgebliche Größe — er kann über den Address-Lookup bzw. das Feld bodenrichtwert_pro_m2 bezogen werden, ersetzt aber keine Verkehrswertermittlung."
}
}Stabilität
Versionierung & Änderungen
schema_version (aktuell 1.3) und engine_version (aktuell 2026.10.19). Neue Felder kommen nur additiv hinzu — ignorieren Sie unbekannte Felder. Inkompatible Änderungen erscheinen ausschließlich unter einer neuen Hauptversion und werden vorab per E-Mail angekündigt.Version 1.3 · Oktober 2026
- bewertbarkeit.status wird aus der Vergleichsbasis abgeleitet: Zahl sehr ähnlicher Vergleichsobjekte (Lage, Baujahr, Fläche) und deren Preisstreuung
- Neues Feld bewertbarkeit.vergleichsbasis mit sehr_aehnliche_objekte, streuung_prozent und vergleichsobjekte_umgebung
- Rund 36.000 zusätzliche Vergleichsangebote im Marktdatenpool
Version 1.2 · Oktober 2026
- Eigene Adresse https://immoanalyse.pro/api/v1 und OpenAPI-Spezifikation
- Tarife mit Kontingent je Konto statt je Schlüssel
- Neue Header X-RateLimit-Reset und X-Quota-Limit/-Remaining/-Reset; kontingent.reset_at und kontingent.tarif
- Adressprüfung mit präziserem Geocoding und 30 Tage Zwischenspeicher (cached)
Version 1.1 · September 2026
- bewertbarkeit, konfidenz.treiber[], verbesserungs_hinweise[], data_as_of
- Endpunkte /address-lookup, /schema, /types und /result/{request_id}
- Idempotenz: identische Anfragen innerhalb von 10 Minuten zählen nicht erneut
Version 1.0 · August 2026
- Erste Version der Bewertung per API
Ausprobieren
Playground
Wird nur für diese Anfrage verwendet und nicht gespeichert. Testaufrufe zählen auf Ihr Kontingent. Schlüssel erstellen
Die Antwort erscheint hier — inklusive Status, Dauer und verbleibendem Kontingent.
Diese Anfrage im eigenen Code
curl -X POST "https://immoanalyse.pro/api/v1/valuation" \
-H "X-API-Key: IHR_API_SCHLUESSEL" \
-H "Content-Type: application/json" \
-d '{"adresse":"Suderwichstraße 143","plz":"45665","ort":"Recklinghausen","haustyp":"mfh","baujahr":1965,"wohnflaeche":320,"grundstuecksflaeche":1668,"kaltmiete":1800,"zustandSterne":3}'Preise
Tarife
Developer
Kostenlos testen und integrieren
ohne Zahlungsdaten
- 25 Bewertungen pro Monat
- 100 Adressprüfungen pro Monat
- 10 Anfragen pro Minute
- Bis zu 2 API-Schlüssel
- Alle Endpunkte & Objekttypen
- Support per E-Mail
Starter
Für Makler und erste Integrationen
zzgl. 19 % USt., monatlich kündbar
- 500 Bewertungen pro Monat
- 2.000 Adressprüfungen pro Monat
- 30 Anfragen pro Minute
- Bis zu 5 API-Schlüssel
- E-Mail-Support
Business
Für Portale und Lead-Funnels
zzgl. 19 % USt., monatlich kündbar
- 2.500 Bewertungen pro Monat
- 10.000 Adressprüfungen pro Monat
- 60 Anfragen pro Minute
- Bis zu 10 API-Schlüssel
- Bevorzugter Support
Scale
Für PropTechs und Finanzierer mit Volumen
zzgl. 19 % USt., monatlich kündbar
- 10.000 Bewertungen pro Monat
- 40.000 Adressprüfungen pro Monat
- 120 Anfragen pro Minute
- Bis zu 25 API-Schlüssel
- Individuelle Limits auf Anfrage
Mehr Volumen, eigene Limits oder Abrechnung per Rechnung? Schreiben Sie uns.
FAQ
Häufige Fragen
Bereit für die erste Bewertung?
Schlüssel erstellen, Anfrage senden, Ergebnis darstellen — in wenigen Minuten. Fragen beantworten wir unter [email protected].
Kostenlos Schlüssel erstellen