◆ DealPilot Platform
Greife programmatisch auf deine Immobilien-Objekte zu — anlegen, lesen, ändern, löschen. Eine vollständige REST-Schnittstelle über HTTPS, JSON rein und raus. Für Pro-Konten.
Die API gibt dir vollen Lese- und Schreibzugriff auf deinen eigenen Objektbestand. Typische Anwendungen:
Neue Investments aus einer Tabelle, einem CRM oder einem Akquise-Tool direkt in DealPilot kippen — ohne manuelles Abtippen.
Mietänderungen, neue Finanzierungskonditionen oder Sanierungskosten aus deinem System per PUT nach DealPilot spiegeln.
Alle Objektdaten abrufen und in eigene Auswertungen, BI-Tools oder ein Investoren-Reporting einspeisen.
Objekt- und Mandanten-/Halter-Daten exportieren und an die Buchhaltung oder den StB übergeben.
Einen ganzen Bestand aus einer Alt-Lösung übernehmen — Schleife über deine Datensätze, je ein POST.
Veraltete Objekte per DELETE entfernen oder Felder programmatisch korrigieren.
Ein Key sieht und ändert ausschließlich die Objekte des eigenen Kontos — nie fremde Daten und nie mehr, als der Pro-Plan erlaubt.
Basis-URL für alle Aufrufe:
https://app.dealpilot.junker-immobilien.io/api/v1
Den API-Key erzeugst du in DealPilot unter Einstellungen → Account & Sicherheit → DealPilot API. Er wird genau einmal vollständig angezeigt (Aufbau dpk_live_…) — danach nur noch der Anfang. Verloren? Einfach widerrufen und neu erzeugen.
# Alle eigenen Objekte abrufen
curl -H "X-API-Key: dpk_live_DEIN_KEY" \
https://app.dealpilot.junker-immobilien.io/api/v1/objects
| Punkt | Details |
|---|---|
| Header | X-API-Key: dpk_live_… bei jedem Aufruf |
| Voraussetzung | Aktiver Pro-Plan. Fällt das Konto unter Pro, sind die Keys inaktiv. |
| Geltungsbereich | Nur die Objekte des eigenen Kontos. Voller CRUD (Lesen/Schreiben/Löschen). |
| Rate-Limit | 120 Anfragen pro Minute und Key (darüber 429). |
| Speicherung | Der Key wird serverseitig nur als SHA-256-Hash abgelegt — der Klartext ist nicht wiederherstellbar. |
{ "items": [ { "id": "…", "name": "…", "kpis": { … }, "thumbnail": "…" } ], "count": 1 }
{ "name": "Beispielstraße 1", "data": { "kp": 250000, "nkm": 980, "halter": "privat" } }
{ "ok": true }
Ein Objekt hat eine schlanke Hülle; alle Rechen-Eingaben liegen im data-Objekt:
| Feld | Typ | Bedeutung |
|---|---|---|
id | string | Eindeutige ID |
name | string | Anzeigename |
data | object | Alle Eingabefelder (siehe Gruppen unten) |
photos | array | Objektfotos |
ai_analysis | string | Gespeicherte KI-Analyse |
data-Objekt akzeptiert beim Anlegen/Ändern beliebige Schlüssel und gibt sie unverändert wieder zurück. Es gibt keine serverseitige Whitelist — alle hier gelisteten Felder (und künftige) gehen 1:1 durch.Alle data-Felder, nach Themen gruppiert:
Lage, Größe, Baujahr, Einheiten.
plzortstrhnrobjartwflbaujahrkaufdatwirtschaftlicher_uebergangkuerzelaussteinheitenzimmerbad_anzetageetagen_gesgaragenstellpl_aussenbalkon_flaemodernisBankwert, Sachverständigenwert, Lage-Scores, Bodenrichtwert.
bankvalsvwertmakrolagemikrolagebrwmeagsflThese, Risiken, Vermietungsstand, Exit, KI-Texte.
thesisrisikennotizenvermstandexitstrbank_instai_stratai_verkai_riskai_marktKaufpreis und alle Erwerbsnebenkosten (Makler, Notar, Grundbuch, Grunderwerbsteuer …).
kpmakler_pnotar_pgba_pgest_pji_pSanierung, Möblierung, Küche, Geräte, PV, Stellplatz.
sanmoeblinv_kuecheinv_moebelinv_geraeteinv_pvinv_stellplatzinv_sonstNettokaltmiete, Zusatzeinnahmen, Steigerungen, Leerstand, Mietspiegel-Detailmodus.
nkmzeumlagefmietstgwertstgkostenstgleerstandbtjexit_bmymietspiegelme_modusme_sollme_anzme_intme_pctUmlagefähige und nicht-umlagefähige Kosten, Rücklagen, Mietausfall, BWK-Pauschalen.
hg_ulgrundsteuerul_sonsthg_nulweg_reigen_rmietausfallnul_sonstbwk_ul_pctbwk_nul_pctbwk_kp_pctEigenkapital, Darlehen 1 (Betrag/Zins/Tilgung/Bindung/Typ/Auszahlung), Anschlussfinanzierung.
ekd1d1zd1td1_bindjd1_typed1_auszahld1_vertraganschl_zanschl_tanschl_bjZweites Darlehen mit eigener Anschlussfinanzierung.
d2d2zd2td2_bindjd2_instd2_typed2_auszahld2_azd2_atBausparsumme, Rate, Zuteilung, Zins, Mindestquote, Darlehenskonditionen.
bspar_instbspar_vertragbspar_sumbspar_ratebspar_zuteilbspar_zinsbspar_quote_minbspar_dar_zbspar_dar_tBis zu vier Vergleichspreise mit Label.
kp1kp1lkp2kp2lkp3kp3lkp4kp4lAfA-Satz, Gebäudeanteil, zu versteuerndes Einkommen, Grenzsteuersatz, Werbungskosten-Übernahme.
afa_satzgeb_antzvegrenzsan_tax_activesan_tax_yearsmoebl_tax_activemoebl_tax_yearsZusatzangaben für den erweiterten Deal-Score.
ds2_zustandds2_energieds2_mietausfallds2_marktmieteds2_bevoelkerungds2_nachfrageds2_marktfaktords2_wertsteigerungds2_entwicklungSterne- und Qualitätsbewertung je Gewerk.
rate_kuecherate_badrate_bodenrate_fensterqual_kuechequal_badqual_bodenqual_fensterAusstattungsdetails für die AVM-Bewertung.
eq_heatingeq_windowseq_flooreq_batheq_guest_wceq_store_roomeq_wallseq_roofeq_elevatorWer das Objekt hält und — bei Überführung in eine Gesellschaft — die steuerlich relevanten Eckwerte.
| Feld | Bedeutung |
|---|---|
halter | ID des haltenden Mandanten (privat oder eine Gesellschaft) |
obj_herkunft | neukauf oder ueberfuehrung |
halter_seit | Stichtag des Halterwechsels (Cut Privat → Gesellschaft) |
verkehrswert_ueberf | Verkehrswert als AfA-Bemessungsgrundlage der Gesellschaft |
ueberf_preis | Überführungspreis (Grunderwerbsteuer-Basis) |
gesellschafterdarlehen | Gesellschafterdarlehen (z.B. gestundeter Kaufpreis) |
Felder aus externen Anbindungen und gespeicherte Modul-Zustände.
erwerbsartanbietertyp_immometrica_id_immometrica_online_since_immometrica_portals_avm_state_mb_state| Status | Bedeutung |
|---|---|
401 | Kein, ungültiger oder widerrufener Key |
403 | Konto kein Pro / deaktiviert |
404 | Objekt nicht gefunden (oder nicht deins) |
429 | Rate-Limit überschritten (120/min) |
Fehler kommen als JSON: { "error": "…" }
# Objekt anlegen curl -X POST -H "X-API-Key: dpk_live_DEIN_KEY" -H "Content-Type: application/json" \ -d '{"name":"Beispielstraße 1","data":{"kp":250000,"nkm":980,"d1":200000,"d1z":3.8}}' \ https://app.dealpilot.junker-immobilien.io/api/v1/objects # Miete aktualisieren curl -X PUT -H "X-API-Key: dpk_live_DEIN_KEY" -H "Content-Type: application/json" \ -d '{"data":{"nkm":1050}}' \ https://app.dealpilot.junker-immobilien.io/api/v1/objects/OBJEKT_ID # Objekt einer Gesellschaft zuweisen curl -X PUT -H "X-API-Key: dpk_live_DEIN_KEY" -H "Content-Type: application/json" \ -d '{"data":{"halter":"MANDANT_ID","obj_herkunft":"ueberfuehrung"}}' \ https://app.dealpilot.junker-immobilien.io/api/v1/objects/OBJEKT_ID # Objekt löschen curl -X DELETE -H "X-API-Key: dpk_live_DEIN_KEY" \ https://app.dealpilot.junker-immobilien.io/api/v1/objects/OBJEKT_ID