API & MCP
Die Termin-Suche gibt es als offene Schnittstelle für Entwickler und KI-Assistenten: nur lesend, ohne API-Schlüssel.
Schnellstart
curl "https://termin-in-meiner-naehe.de/api/v1/online-buchbar?kategorie=friseur&ort=10115&limit=2"Endpunkte
GET /api/v1/online-buchbar – Parameter kategorie (Pflicht), ort (PLZ oder Ort, Pflicht), umkreis_km (1–50, Standard 25), limit (1–20, Standard 10). Antwort: Treffer mit Name, Adresse, Entfernung und Buchungslink (art: plattform oder eigene_seite).
GET /api/v1/kategorien – erlaubte Kategorien. Gesundheitsberufe sind bewusst ausgenommen.
Vollständige Beschreibung: OpenAPI 3.1.
Limits und Fehler
120 Anfragen pro Minute und IP. Die Header ratelimit-limit, ratelimit-remaining und ratelimit-reset zeigen den Stand. Bei Überschreitung kommt HTTP 429 mit Retry-After. Fehler kommen als application/problem+json (RFC 9457) mit einem festen code, z. B. LOCATION_NOT_FOUND oder CATEGORY_EXCLUDED.
MCP-Server
POST https://termin-in-meiner-naehe.de/mcp (Streamable HTTP, JSON-RPC 2.0). Tools: find_bookable_near, list_categories. Konfiguration für MCP-Clients:
{"mcpServers": {"termin-in-meiner-naehe": {"url": "https://termin-in-meiner-naehe.de/mcp"}}}WebMCP im Browser
Die Startseite registriert die Tools termin_online_buchbar_finden und termin_kategorien für den KI-Agenten im Browser.
Versionierung und Abkündigung
Die Version steht im Pfad (/api/v1). Innerhalb von v1 kommen nur Felder hinzu, nichts wird umbenannt oder entfernt. Brüche gibt es nur mit einer neuen Pfadversion. Eine alte Version bleibt nach Ankündigung mindestens sechs Monate erreichbar. Angekündigt wird hier, in llms.txt und über die Header Deprecation und Sunset.
Änderungen
1.0.0 (15.10.2026): Start mit Suche, Kategorien, MCP und WebMCP.