Etna Nekretnine veröffentlicht eine öffentliche, schreibgeschützte Schnittstelle (API) und einen MCP-Server, über die KI-Assistenten und Entwickler echte Daten zu Immobilien, Kategorien, Leistungen, Artikeln und zur Agentur an der Riviera von Omiš abrufen. Registrierung und Schlüssel sind nicht nötig, ein einfaches HTTP GET auf /api/v1 genügt.
Wann diese API passt
Die API ist die richtige Wahl, wenn:
- Sie echte, aktuell verfügbare Immobilien in Omiš und an der Riviera von Omiš brauchen, keine Beispieldaten
- Sie die Kontaktdaten der Agentur oder die Leistungsliste zum Zitieren in einer Antwort benötigen
- Sie eine Integration bauen, die innerhalb von v1 kompatibel bleiben muss
Für Buchungen, Reservierungen oder Zahlungen ist die API nicht gedacht: alle Routen sind schreibgeschützt, Anfragen gehen über das Formular unter /de/kontakt.
Authentifizierung und Grenzen
Die API ist öffentlich. Keine Route verlangt einen Schlüssel, ein Token oder OAuth; eine Integration, die Zugangsdaten abfragt, ist falsch konfiguriert.
- Limite: 60 Anfragen pro Minute pro IP-Adresse. Der verbleibende Wert steht in den RateLimit-*-Headern.
- Sprache: der Parameter locale akzeptiert hr, en oder de (Standard hr). Slugs unterscheiden sich je Sprache, senden Sie Kennungen daher als Slug in der gewählten Sprache oder als numerische id.
- Seitennummerierung: per_page akzeptiert 1 bis 50, Standard 20. Das meta-Objekt liefert page, per_page, total und last_page.
- Fehler: als application/problem+json nach RFC 9457 mit type, title, status und detail.
- Versionierung: alle Routen liegen unter /api/v1. Das Entfernen einer Route wird mindestens 90 Tage vorher über Deprecation- und Sunset-Header angekündigt.
Routen
Neun öffentliche Routen, alle mit GET. Die vollständige Beschreibung jeder Route, das Antwortschema und die Fehlercodes stehen im OpenAPI-Dokument.
| Methode | Pfad | Beschreibung |
|---|---|---|
GET |
/api/v1/agency |
Name, Adresse, Telefon, E-Mail, Öffnungszeiten, Einsatzgebiet und Sprachen der Agentur. |
GET |
/api/v1/properties |
Immobilienliste mit den Filtern category, place, service, price_from, price_to, surface_from, surface_to und q. |
GET |
/api/v1/properties/{property} |
Eine Immobilie nach numerischer id oder Slug, mit Beschreibung, Preis, Fläche und Galerie. |
GET |
/api/v1/categories |
Immobilienkategorien mit der Anzahl der Objekte je Kategorie. |
GET |
/api/v1/categories/{category} |
Eine Kategorie nach Slug, unabhängig davon, in welcher Sprache der Slug gesendet wurde. |
GET |
/api/v1/services |
Leistungen der Agentur: Vermittlung beim Kauf und Verkauf, Bewertung, Kreditunterlagen. |
GET |
/api/v1/posts |
Blogartikel mit Titel, Zusammenfassung, Datum und Link. |
GET |
/api/v1/posts/{post} |
Ein Artikel nach Slug oder id, mit vollständigem Text. |
GET |
/api/v1/pages |
Statische Seiten wie „Über uns“, mit Titel und Inhalt. |
Beispielaufruf
Abruf einer Immobilie auf Englisch. Die Antwort enthält die Immobilien in data sowie meta und links für die Seitennummerierung.
Anfrage
curl "https://www.etna-realestate.com/api/v1/properties?locale=en&per_page=1"
Antwort (gekürzt)
{
"data": [
{
"id": 9,
"slug": "building-land-with-panoramic-sea-view",
"title": "BUILDING LAND WITH PANORAMIC SEA VIEW",
"url": "https://www.etna-realestate.com/lands/building-land-with-panoramic-sea-view",
"category": { "slug": "lands", "title": "Lands" },
"place": "OMIŠ",
"surface_m2": 7000,
"price": { "amount": 400, "currency": "EUR", "formatted": "400 €" },
"featured": true
}
],
"meta": { "page": 1, "per_page": 1, "total": 51, "last_page": 51 },
"links": { "self": "…?page=1", "next": "…?page=2", "prev": null }
}
Das Feld url ist immer ein absoluter Link zur Immobilienseite. Bauen Sie keine Slugs selbst, sondern verwenden Sie die zurückgegebene url.
MCP-Server
Dieselben Daten sind auch über einen Model Context Protocol Server unter /mcp verfügbar (JSON-RPC 2.0, Streamable-HTTP-Transport). Der Server bietet die Werkzeuge get_agency_info, search_properties, get_property, list_categories und get_article sowie Ressourcen mit Agenturprofil und Agentenleitfaden.
GET /mcp liefert eine JSON-Beschreibung des Servers, die Verfügbarkeit lässt sich also mit einer einfachen Anfrage prüfen.
Maschinenlesbare Dokumente
Alles für die automatische Erkennung liegt unter vorhersehbaren Adressen:
- https://www.etna-realestate.com/openapi.json — OpenAPI-3.1-Beschreibung aller Routen, Parameter und Antwortschemata.
- https://www.etna-realestate.com/auth.md — Was Authentifizierung verlangt und was nicht, samt Limiten.
- https://www.etna-realestate.com/de/llms.txt — Zusammenfassung der Agentur und Seitenindex für Sprachmodelle.
- https://www.etna-realestate.com/llm-info.json — Angaben zur Agentur im JSON-Format.
- https://www.etna-realestate.com/.well-known/mcp/server-card.json — Karte des MCP-Servers: Protokoll, Transport, Werkzeuge und Ressourcen.
- https://www.etna-realestate.com/.well-known/api-catalog — Linkset (RFC 9727) mit den API- und MCP-Einstiegspunkten.
- https://www.etna-realestate.com/.well-known/agent-skills/index.json — Index der Agenten-Skills mit Prüfsummen der Dateien.
Kontakt
Fragen zur API, Anmeldung eines größeren Abrufs oder Fehlermeldung: office@etna-realestate.com, +385 98 891 838.