Zum Inhalt springen

Für Entwickler, Portale und KI-Assistenten

Öffentliche Schnittstellen

Die veröffentlichten Inserate von Immolibero lassen sich maschinell abrufen: als JSON über eine REST-API oder über einen MCP-Server, den ein Chat-Assistent direkt benutzt. Alle Wege sind öffentlich, brauchen keine Anmeldung und keinen Schlüssel, und sie lesen nur.

Die drei Wege

Alle drei arbeiten mit derselben Suche und denselben Filtern. Die Antwort unterscheidet sich je Weg; welcher passt, hängt davon ab, was du baust.

Alle Adressen beginnen mit https://www.immolibero.com.

REST-API, volle Antwort

Für eine eigene Website oder ein eigenes Portal. Gefilterte Trefferliste, Einzelinserat und Ortsvorschläge für die Eingabehilfe.

  • GET /api/v1/listings - suchen
  • GET /api/v1/listings/{slug} - ein Inserat
  • GET /api/v1/search-suggestions - Orte nachschlagen

REST-API, schlanke Antwort für KI

Dieselbe Suche, aber eine Antwort zum Formulieren von Sätzen: Felder ohne Wert fehlen ganz, Objektart und Heizung stehen als Name und als Schlüssel, und die Kosten stehen neben dem Preis. Für Assistenten, die kein MCP sprechen, ist das der Einstieg.

  • GET /api/v1/ai/listings
  • GET /api/v1/ai/listings/{slug}

MCP-Server für Chat-Assistenten

POST /mcp, JSON-RPC 2.0 über Streamable HTTP. Der Assistent fragt selbst, welche Werkzeuge es gibt, und bekommt Namen, Parameter und Beschreibungen mitgeliefert: Er muss Immolibero vorher nicht kennen.

Vier Werkzeuge: „Immobilien suchen“, „Inserat ansehen“, „Orte nachschlagen“ - für einen Ortsnamen, der mehrfach vorkommt, bevor er in die Suche geht - und „Inserat anlegen“, das den Weg zum eigenen Inserat auf der Website zeigt, ohne selbst etwas anzulegen. In einem Klienten, der eigene Connectoren erlaubt, trägst du dafür https://www.immolibero.com/mcp ein. Der Aufruf braucht den Kopf Accept: application/json, text/event-stream; ein Aufruf per GET antwortet mit 405.

In Assistenten, die das unterstützen, etwa Claude und ChatGPT, zeigt „Immobilien suchen“ die Treffer zusätzlich als Karten mit Titelbild, Titel, Preis, Kennzahlen und Ort direkt im Chat; ein Klick auf eine Karte öffnet das Exposé.

Die Beschreibung

Jeden Parameter und jedes Antwortfeld beschreibt /openapi.json nach OpenAPI 3.1. Das ist maschinenlesbar, also rohes JSON im Browser. /llms.txt sagt dasselbe kürzer, für KI-Crawler. Der MCP-Server beschreibt seine Werkzeuge selbst.

Grenzen

  • 120 Anfragen je Minute und Absender-Adresse. Die Grenze gilt für alle hier genannten Adressen gemeinsam, die Beschreibung eingeschlossen, nicht je Adresse. Wird sie überschritten, antwortet die Schnittstelle mit 429, und die Kopfzeile Retry-After nennt die Wartezeit in Sekunden. Erfolgreiche Antworten nennen Kontingent und Rest in den Kopfzeilen RateLimit-Policy und RateLimit nach dem IETF-Entwurf und in X-RateLimit-Limit und X-RateLimit-Remaining.
  • Nur lesend. Es gibt keinen Weg, über die Schnittstellen Inserate anzulegen oder zu ändern.
  • Kontaktdaten: Eine Telefonnummer gibt keine der Schnittstellen heraus, nur die Angabe, ob eine vorliegt. Die E-Mail-Adresse und die Website stehen in der vollen Antwort von GET /api/v1/listings/{slug}, und zwar nur, wenn der Anbieter sie am Inserat eingetragen hat. Die schlanke Fassung für Assistenten und die Trefferliste führen sie nicht.
  • Nur veröffentlichte Inserate. Abgeschaltete Inserate antworten mit 404.
  • Verlinke expose_url unverändert, auch in Übersichten. Die Adresse führt auf die Seite des Inserats, wo verbindlich steht, was die Antwort nur als Stand des Abrufs zeigt. Sie trägt einen Herkunftsmarker; wer sie kürzt, nimmt dem Anbieter den Nachweis, woher die Anfrage kam.

Versionen

Die Version steht im Pfad (/api/v1). Neue Felder, Parameter und Adressen können jederzeit hinzukommen. Änderungen, die Felder entfernen oder ihre Bedeutung ändern, werden auf /schnittstellen, in llms.txt und in der Beschreibung unter /openapi.json angekündigt, bevor sie in Kraft treten.

Was erlaubt ist

Der Abruf über diese Schnittstellen ist erlaubt, solange er sich im Rahmen dieser Beschreibung hält und konkrete Anfragen beantwortet: einzelne Inserate, einzelne Suchergebnisse. Nicht erlaubt ist, den Bestand ganz oder systematisch abzuziehen oder als eigene Datenbank weiterzuverwenden; die Inserate sind als Datenbank geschützt. Der Wortlaut steht in Ziffer 16 der AGB.

Unsicher, ob ein Vorhaben darunter fällt? Frag uns vorher.

Für Anbieter

Wer bei Immolibero inseriert, dessen veröffentlichte Inserate sind über diese Wege abrufbar: Titel, Ort, Preis, Ausstattung und Titelbild, und jeder Treffer trägt mit expose_url den Weg zurück auf dein Inserat. Eine Telefonnummer wird nie herausgegeben. Eine E-Mail-Adresse und eine Website stehen in der vollen Antwort zu einem einzelnen Inserat, wenn du sie am Inserat eingetragen hast - das ist dieselbe Angabe, die auch eine Anfrage über das Formular erreicht.

In Assistenten, die das unterstützen, etwa Claude und ChatGPT, kann dein Inserat als Karte im Chat erscheinen: mit Titelbild, Titel, Preis, Kennzahlen und Ort, und mit deinem Namen wie auf der Website, bei privaten Anbietern mit dem Zusatz „Privater Anbieter“. Die Karte führt auf dein Inserat.

Bitte bestätigen