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)/{ortSlug}/api/stadtteile.json— Bezirke/Stadtteile mit Centroid (z. B. /Berlin/api/stadtteile.json)
Stadtteil-Abfrage: Bezirksnamen aus stadtteile.json, dann listings.json-Items nach district, stadtteil oder address.addressSubLocality filtern.
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 (inkl. district/stadtteil) |
/{ortSlug}/api/stadtteile.json | Stadtteile/Bezirke mit Centroid (items[].name, lat, lng) |
Datenstruktur
Discovery (/api/listings.json): schemaVersion, type, entryPoints, perCityListingsPattern, perCityStadtteilePattern, hint
Stadtteile (/{ortSlug}/api/stadtteile.json): ort, totalCount, items[] mit name, lat, lng
Listings (/{ortSlug}/.../api/listings.json): zusaetzlich totalCount, truncated, maxItems (500 auf Ort-/VA-Ebene). Auf Ortsebene: stadtteileApi, districtFilterHint. Array items mit u. a. name (inkl. Bezirk), district, stadtteil, url, offers.price, address.addressSubLocality.
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.jsonist nur fuer Browser-Widgets — nicht fuer KI-APIs.- Keine externen Tracker; alle Ressourcen werden lokal gehostet (DSGVO).