Die öffentliche API
Lesender Zugriff auf den Katalog von athaus.ai und den amtlichen Bodenwert, ohne Anmeldung, beschrieben als OpenAPI 3.1.
| Basisadresse | https://api.athaus.ai |
| Beschreibung | https://api.athaus.ai/openapi.json, OpenAPI 3.1 |
| Anmeldung | keine für die öffentlichen Wege |
| Format | JSON, Fehler immer als { "error": "<code>" } (Fehlercodes) |
| Drossel | je Aufrufer, 429 wenn es zu viele werden (Limits) |
Was dort steht
Nur der öffentliche, lesende Teil: Inserate suchen, ein Inserat holen, die Lage-Grundlage zu einer Postleitzahl oder einem Punkt. Kein Weg, der eine Anmeldung braucht, steht im Dokument; die eingeloggten Wege der App haben keine fremden Aufrufer. Wer mit seinem eigenen Bestand, seinen Anfragen oder Vorschlägen arbeiten will, nimmt den MCP-Server.
Der Katalog enthält ausschließlich Objekte, die Anbieter selbst bei Athaus eingestellt haben. Inserate anderer Portale sind nicht enthalten. Ein Objekt mit "beispiel": true ist ein erfundenes Beispiel zur Ansicht, kein Angebot.
Ein Aufruf
curl "https://api.athaus.ai/api/public/properties?city=Leipzig&transaction_type=buy&page_size=3"{
"items": [{ "id": "…", "title": "…", "city": "Leipzig", "asked_price": 289000, "total_rooms": 3, "square_meters": 78 }],
"total": 41,
"page": 1,
"page_size": 3
}Die Werte oben sind ein Beispiel der Form. Jeder Weg mit allen Parametern und Antworten steht in der Referenz.