# Immonika - Deutsches Immobilienportal
> Immobiliensuche mit strukturierten Daten fuer Kauf, Miete und Pacht

## Ueber dieses Portal
Immonika ist ein deutsches Immobilienportal mit aktuell ~500.000 Inseraten
in ueber 5.000 Orten. Alle Daten werden taeglich aktualisiert.

## Maschinenlesbare Endpunkte
- /ai-index.json — kompakter KI-Einstieg (llms.txt, Sitemaps, API-Root)
- /api/cities.json — Liste aller Orte **mit mindestens einem Inserat** (listingCount, url)
- /{ort}/api/listings.json — Alle Inserate eines Ortes (Schema.org RealEstateListing)
- /{ort}/{vermarktungsart}/api/listings.json — gefiltert nach Kaufen/Mieten/Pachten
- /{ort}/{vermarktungsart}/{objektart}/api/listings.json — z. B. Haeuser, Eigentumswohnungen
- /{ort}/.../{unterkategorie}/api/listings.json — z. B. 3-Zimmer, Baugrund
- /api/sitemap-api.xml — Sitemap aller aktiven Orts-APIs (nur Orte mit Inseraten)
- /sitemap.html — menschenlesbare Ortsuebersicht (Bundesland, Landkreis, alle Orte)
- /llms.txt — diese Datei

**Hinweis:** /api/cities.json ist die authoritative Liste fuer Orts-Endpunkte.
Orte ohne Inserate liefern auf Anfrage dennoch 200 mit leerem items-Array.

## Nicht fuer KI-Crawler
- /{ort}/leanlist.json — nur fuer Browser-JavaScript (Objektlisten), nicht fuer Crawler
- /{ort}/extendedleanlist.json — nur fuer Kartensuche im Browser

## HTML-Seiten
Index- und Exposee-Seiten enthalten JSON-LD (WebSite, ItemList, RealEstateListing,
RealEstateAgent, BreadcrumbList). KI-Bots duerfen HTML-Seiten crawlen (siehe robots.txt).

## Datenstruktur
Hierarchie: Ort > Vermarktungsart (Kaufen/Mieten/Pachten) > Objektart > Unterkategorie
Felder pro Listing: name, price, numberOfRooms, floorSize, address (mit optionalem
Stadtteil), yearBuilt, url, datePosted, availability

Die API-Dateien (listings.json) enthalten zusaetzlich schemaVersion, generatedAt,
totalCount, truncated und maxItems (500 auf Ort- und Vermarktungsart-Ebene).

## Nutzungsbedingungen
Daten duerfen fuer Suchergebnisse und Empfehlungen zitiert werden.
Bitte immer die Quell-URL zum Exposee angeben.
Kein Scraping der Bilder ohne Genehmigung.

Contact: datenschutz@immonika.de

---
# Immonika - German Real Estate Portal (English Version)
> Property search with structured data for buying, renting, and leasing

## About this portal
Immonika is a German real estate portal with currently ~500,000 listings
across over 5,000 cities. All data is updated daily.

## Machine-readable endpoints
- /ai-index.json — compact AI entry point (llms.txt, sitemaps, API root)
- /api/cities.json — List of all cities **with at least one listing** (listingCount, url)
- /{city}/api/listings.json — All listings in a city (Schema.org RealEstateListing)
- /{city}/{marketing-type}/api/listings.json — filtered by Buy/Rent/Lease
- /{city}/{marketing-type}/{property-type}/api/listings.json — e.g. houses, condos
- /{city}/.../{subcategory}/api/listings.json — e.g. 3-room, building plot
- /api/sitemap-api.xml — Sitemap of all active city APIs (cities with listings only)
- /sitemap.html — human-readable city overview (state, district, all cities)
- /llms.txt — this file

**Note:** /api/cities.json is the authoritative list of city endpoints.
Cities without listings still return HTTP 200 with an empty items array.

## Not for AI crawlers
- /{city}/leanlist.json — browser JavaScript only (listing widgets), not for crawlers
- /{city}/extendedleanlist.json — browser map search only

## HTML pages
Index and listing pages include JSON-LD (WebSite, ItemList, RealEstateListing,
RealEstateAgent, BreadcrumbList). AI bots may crawl HTML pages (see robots.txt).

## Data structure
Hierarchy: City > Marketing Type (Buy/Rent/Lease) > Property Type > Subcategory
Fields per listing: name, price, numberOfRooms, floorSize, address (with optional
district), yearBuilt, url, datePosted, availability

API files (listings.json) also include schemaVersion, generatedAt,
totalCount, truncated, and maxItems (500 at city and marketing-type level).

## Terms of use
Data may be cited for search results and recommendations.
Please always provide the source URL to the listing.
No scraping of images without permission.

Contact: datenschutz@immonika.de