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:

Kontakt

Fragen zur API, Anmeldung eines größeren Abrufs oder Fehlermeldung: office@etna-realestate.com, +385 98 891 838.