Wer Gelände oder Nachbarbebauung für ein Projekt braucht, landet sonst bei 16 Landesportalen mit eigenen Formaten, Kachelschnitten und Koordinatensystemen. Die DEUKOS API bündelt das: eine Schnittstelle, ein Bereich, fertige Dateien in IFC, DXF, GLB, OBJ oder als Geländedaten – für ganz Deutschland, die Schweiz und Liechtenstein.
Was das ist: Eine REST-Schnittstelle zu denselben Exporten wie in der DEUKOS-Karte. Sie liefert Gebäude (LoD2), Gelände (DGM1) und Flurstücke, soweit diese frei abgegeben werden. Die Geometrie besteht aus Flächen und Körpern, nicht aus parametrischen Bauteilen. Abgerechnet wird nach Fläche: 15 € je km² inkl. USt, vom Guthaben, ohne Abo.
- Bereich per Adresse, Mittelpunkt oder Koordinaten angeben, Format wählen, Dateien abholen.
- 15 € je km² (0,15 € je Hektar), Guthaben ab 100 €, getrennt von den Abos der App.
- Beschrieben als OpenAPI und als Anleitung für KI-Assistenten, damit ein Assistent die API ohne Handarbeit bedienen kann.
- Ausprobieren ohne Konto: ein Bereich bis 50 × 50 m ist kostenlos, ganz ohne Schlüssel.
Wofür Büros die API nutzen
Projektstart ohne Handarbeit
Neues Projekt im Büro angelegt, ein Skript holt das Umgebungsmodell als IFC und legt es in den Projektordner. Niemand muss die Karte öffnen, den Bereich ziehen und die Datei verschieben.
Der KI-Assistent holt das Modell
„Hol mir das Umgebungsmodell für die Musterstraße 5 in Köln, 400 Meter, als IFC.“ Ein Assistent, der Schnittstellen aufrufen kann, findet in unserer Beschreibung alles Nötige: welches Format zu welchem Programm passt, wie er den Bereich angibt und was er bei einem Fehler tun soll.
Eigene Werkzeuge im Büro
Grasshopper-Definition, Dynamo-Skript oder eigenes Auswertungsprogramm: Gelände und Gebäude kommen direkt aus der API, statt dass jemand Kacheln von Hand zusammensucht.
So funktioniert es
- Bereich prüfen – Adresse und Größe angeben, die API löst den Ort auf, nennt Fläche, Gebäudezahl und Preis. Das kostet nichts.
- Export bestellen – Format wählen und abschicken. Der Preis wird vom Guthaben abgebucht; schlägt der Auftrag fehl, wird er erstattet.
- Status abfragen – nach wenigen Minuten ist der Auftrag fertig.
- Dateien abholen – jede Datei hat eine eigene Adresse.
curl -X POST https://deukos.de/api/v1/exports \
-H "Authorization: Bearer $DEUKOS_API_KEY" \
-H "Content-Type: application/json" \
-H "Idempotency-Key: projekt-4711-ifc" \
-d '{"profile": "ifc", "address": "Marienplatz 1, München", "size_m": 500}'
Den Bereich kannst Du auf drei Arten angeben: als Adresse mit Größe in Metern, als Mittelpunkt in Längen- und Breitengrad oder als Rechteck (west, süd, ost, nord). Alle Beispiele in curl und Python stehen in der vollständigen Anleitung.
Formate
| Profil | Inhalt | Typisch für |
|---|---|---|
ifc | Gebäude und Gelände als IFC, dazu Geländepunkte | Archicad, Revit, Vectorworks, Allplan |
dxf | Gebäude, Flurstücke, Höhenkoten, Höhenlinien | AutoCAD, BricsCAD, Umgebungsplan |
glb | 3D-Modell Gelände und Gebäude | Blender, Cinema 4D, SketchUp, Twinmotion |
obj | 3D-Modell Gelände und Gebäude | 3ds Max, andere 3D-Programme |
rhino | Rhino-Paket: natives 3DM mit Layern, Gelände-Mesh und NURBS-Gelände | Rhino 7 oder neuer, Grasshopper |
gelaende | Punktraster (5, 2 oder 1 m) und Höhenlinien | Geländeauswertung, eigene Programme |
Rhino und Grasshopper
Für Rhino holst Du das Profil rhino: dasselbe Rhino-Paket
wie in der DEUKOS-Karte, also eine native 3DM-Datei mit Layern, Gelände-Mesh je
Nutzungsfläche und NURBS-Gelände auf einem ausgeblendeten Layer – kein OBJ, keine Umwandlung.
In Grasshopper rufst Du die API mit einem Python-Baustein auf; die
Anleitung enthält dafür ein fertiges Beispiel, das ohne Zusatzpakete
auskommt.
So sagst Du es Deinem KI-Assistenten
Ein Assistent, der Webschnittstellen aufrufen oder Code ausführen kann – etwa Claude oder
ChatGPT mit Werkzeugen, Claude Code oder Cursor –, braucht nur zwei Dinge: Deinen Schlüssel
als Umgebungsvariable DEUKOS_API_KEY (nie in den Chat kopieren) und einen Satz:
Nutze die DEUKOS API. Die Anleitung steht unter
https://deukos.de/api/v1/docs.md
Danach genügt ein Auftrag wie: „Hol mir das Umgebungsmodell für die Musterstraße 5 in Köln, 400 × 400 Meter, als IFC für Archicad.“ Der Assistent löst die Adresse auf, nennt Dir Ort und Preis – hier 2,40 € –, bestellt erst nach Deiner Bestätigung und legt die Datei ab.
Für Entwickler
Die Schnittstelle ist so beschrieben, dass ein Assistent sie selbst richtig bedienen kann. Die Beschreibung legt fest, welches Profil zu welchem Programm gehört. Sie nimmt Adressen statt Koordinaten an, nennt Ort und Preis vor der Bestellung zur Bestätigung und regelt für jeden Fehlercode, ob ein Assistent es erneut versuchen soll. So bestellt er nicht doppelt und gibt kein Guthaben ohne Rückfrage aus.
- OpenAPI-Beschreibung (
openapi.json) – für Werkzeuge, die Schnittstellen automatisch einbinden - Anleitung für Entwickler und KI-Assistenten (
docs.md) – Ablauf, Beispiele, Fehlercodes, Regeln
Sofort ausprobieren – ohne Konto
Bevor Du Dich anmeldest, kannst Du oder Dein KI-Assistent einen kleinen Bereich kostenlos abrufen. So siehst Du, was ankommt, bevor Du irgendetwas bezahlst.
echo '{"profile": "ifc", "address": "Prinzipalmarkt 10, Münster"}' > auftrag.json
curl -s -X POST https://deukos.de/api/v1/trial \
-H "Content-Type: application/json" -d @auftrag.json
- Ohne Konto: ein Bereich bis 50 × 50 m, alle Formate, eine Probe je Internetanschluss in 30 Tagen. Derselbe Bereich in einem weiteren Format zählt nicht extra.
- Mit kostenlosem Konto und Schlüssel: 3 Proben je Monat bis 50 × 50 m, größere Bereiche aus Guthaben.
- Startguthaben: Gutscheincode
KI-TESTunter Einstellungen → DEUKOS API einlösen: 3 €, einmal je Konto, sofort nutzbar ohne Kauf. Das reicht zum Beispiel für zwei Grundstücke mit 300 × 300 m.
Zugang und Kosten
- Ein Bereich von 400 × 400 m kostet 2,40 €, 1 × 1 km kostet 15 €. Mindestens 0,60 € je Auftrag.
- Derselbe Bereich in einem weiteren Format innerhalb von 30 Tagen: kostenlos.
- Fehlgeschlagene Aufträge werden automatisch erstattet. Abfragen von Bereich, Preis und Status kosten nichts.
- Getrennt von den Abos der App: Dein Abo-Kontingent bleibt unberührt.
- Je Auftrag höchstens 2 × 2 km, je Tag 10 km², je Monat 100 km². Für mehr Volumen schreib uns.
Ein kostenloses Konto genügt: anmelden, unter Einstellungen Guthaben kaufen und einen Schlüssel anlegen. Die Tarife der App stehen auf der Seite Preise.
Was die API nicht ist
- Kein Datenbestand zum Mitnehmen: Ergebnisse darfst Du in Deinen Projekten nutzen und je Projekt an Deine Kunden weitergeben. Eigene Datenbestände aus den Abrufen aufzubauen oder sie als Datendienst weiterzuverkaufen, ist nicht erlaubt.
- Kein Massenabruf: Große Gebiete durch viele aneinandergesetzte Aufträge abzurastern, widerspricht den Nutzungsbedingungen.
- Kein Trainingsmaterial: Die Daten dürfen nicht zum Training von KI-Modellen verwendet werden.
- Keine parametrischen Bauteile: Gebäude kommen als Flächen und Körper, nicht als Wände und Decken.
Häufige Fragen
Kann ich die API ohne Konto testen?
Ja. Ohne Konto und ohne Schlüssel ist je Internetanschluss eine Probe bis 50 × 50 m kostenlos, in 30 Tagen einmal (derselbe Bereich in weiteren Formaten zählt nicht extra). Mit kostenlosem Konto und Schlüssel gibt es 3 Proben je Monat bis 50 × 50 m, und mit dem Gutscheincode KI-TEST 3 € Startguthaben, das sofort nutzbar ist – ohne Kauf.
Kann mein KI-Assistent die API selbst bedienen?
Ja, sofern er Schnittstellen aufrufen kann. Gib ihm die Adresse der OpenAPI-Beschreibung oder der Anleitung und Deinen Schlüssel als Umgebungsvariable. Den Rest liest er dort nach. Vor jeder Bestellung nennt er Dir den Preis.
Brauche ich dafür ein Abo?
Nein. Die API läuft über Guthaben, ein kostenloses Konto genügt; nicht verbrauchtes Guthaben bekommst Du beim Widerruf binnen 14 Tagen zurück (AGB Ziffer 9). Hast Du ein Abo der App, bleibt dessen Kontingent unberührt – API und App werden getrennt abgerechnet.
Welche Länder deckt die API ab?
Gebäude und Gelände für alle 16 deutschen Bundesländer, die Schweiz und Liechtenstein. Flurstücke überall dort, wo sie frei abgegeben werden: in allen deutschen Ländern außer Bayern und in 20 Schweizer Kantonen. Woher die Daten stammen, steht unter Datenquellen.
Brauche ich Programmierkenntnisse?
Für ein eigenes Skript reichen Grundkenntnisse; die Anleitung enthält fertige Beispiele für curl und Python. Mit einem KI-Assistenten genügt oft ein Satz.
Was passiert, wenn mein Guthaben aufgebraucht ist?
Die API lehnt den Auftrag mit einer klaren Meldung ab und nennt Preis und Kauflink; es wird nichts berechnet. Nachladen kannst Du jederzeit unter Einstellungen.
Konto anlegen, Guthaben kaufen, Schlüssel erzeugen – in wenigen Minuten bestellt Dein Programm oder Dein KI-Assistent das erste Umgebungsmodell.
Guthaben kaufenAnleitung lesen