API-Dokumentation

immonika.de stellt eine oeffentliche, read-only Listings-API als statische JSON-Dateien bereit. Es gibt keinen API-Key, keine Schreibzugriffe und keinen separaten API-Server — die Dateien werden taeglich mit dem Portal neu generiert.

Empfohlener Einstieg

/api/listings.json — Discovery (Verweise, kein Gesamt-Feed)
/api/cities.json — alle Orte mit mindestens einem Inserat
/{ortSlug}/api/listings.json — Inserate eines Ortes (z. B. /Berlin/api/listings.json)

Weitere Filterebenen: /{ortSlug}/{Vermarktungsart}/api/listings.json (Kaufen, Mieten, Pachten), danach Objektart und Unterkategorie.

Endpunkte

Pfad	Beschreibung
/api/listings.json	Discovery-Stub (`type: discovery`)
/api/cities.json	Orte mit `listingCount` und Ziel-URL
/openapi.json	OpenAPI 3.0 (Standardpfad)
/swagger.json	Swagger-Alias (gleicher Inhalt)
/api/openapi.json	OpenAPI unter /api/
/api/sitemap-api.xml	Sitemap aller Orts-API-URLs
/ai-index.json	Kompakter KI-Einstieg (JSON)
/llms.txt	LLM-orientierte Dokumentation (DE/EN)
`/{ortSlug}/api/listings.json`	Schema.org `RealEstateListing` in `items`

Datenstruktur

Discovery (/api/listings.json): schemaVersion, type, entryPoints, perCityListingsPattern, hint

Listings (/{ortSlug}/.../api/listings.json): zusaetzlich totalCount, truncated, maxItems (500 auf Ort-/VA-Ebene), Array items mit u. a. name, url, offers.price, numberOfRooms, floorSize, address.

Unter Kaufen heisst die Objektart Eigentumswohnungen (nicht „Wohnungen“); Wohnungen gilt bei Mieten.

OpenAPI / Maschinenlesbar

Fuer Tools, die Swagger oder OpenAPI erwarten:

Hinweise fuer KI-Crawler

HTML-Seiten enthalten JSON-LD; API-Daten sind unter /api/ partitioniert.
/{ortSlug}/leanlist.json ist nur fuer Browser-Widgets — nicht fuer KI-APIs.
Keine externen Tracker; alle Ressourcen werden lokal gehostet (DSGVO).