Ö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.

REST-API, volle Antwort

Für eine eigene Website, ein eigenes Portal oder eine Auswertung. 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.

Drei Werkzeuge: Inserate suchen, ein Inserat lesen, und einen Ort nachschlagen, bevor ein mehrdeutiger Name in die Suche geht. 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.

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.
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.
Gib expose_url unverändert weiter. 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.

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.