Platform

Casafari ist die KI-Agent-native Plattform für Immobiliendatenintelligenz. Der umfassendste Immobilienindex Europas: ein bereinigter, deduplizierter Immobiliengraph für Wohn- und Gewerbeimmobilien, zum Kauf und zur Miete, in 16 Ländern.Der umfassendste Immobilienindex Europas: ein bereinigter, deduplizierter Immobiliengraph.

Wie der Graph aufgebaut ist

Limits und Nutzungszeiträume

Die Casafari API- und MCP-Plattform begrenzen je nach Plan, wie schnell und wie viele Aufrufe ein Konto tätigen kann. Diese Seite listet diese Limits auf. Es handelt sich um die Limits, auf die sich Klausel 7.4 der Nutzungsbedingungen bezieht, wenn dort erwähnt wird, dass diese in der Dokumentation veröffentlicht sind. Sie gelten gleichermaßen für REST und MCP und sind unabhängig von den Token-Kosten pro Aufruf.

Limits je Plan

LimitFreeAgentAgencyBusinessCustom
Tokens1.000 für 30 Tage, maximal 500 pro gleitendem 3-Stunden-Zeitraum1.500 pro Monat, maximal 600 pro gleitendem 3-Stunden-Zeitraum10.000 monatlich, maximal 3.000 pro gleitendem 3-Stunden-Fenster50.000 monatlich, maximal 15.000 pro gleitendem 3-Stunden-FensterWie vereinbart
Anfragen pro Minute6202020Wie vereinbart
Gleichzeitige Anfragen2333Wie vereinbart
Verschiedene Orte pro Tag10505050Wie vereinbart
Anfragen pro gleitendem 3-Stunden-Fenster50UnbegrenztUnbegrenztUnbegrenztWie vereinbart
Anfragen pro Tag100UnbegrenztUnbegrenztUnbegrenztWie vereinbart
Anfragen pro gleitendem 7-Tage-Fenster300UnbegrenztUnbegrenztUnbegrenztWie vereinbart
Tokens pro Tag (festes Tageslimit)1,00050,00050,00050,000Wie vereinbart
Seitengröße25 ErgebnisseIndividuelles Maximum je OperationIndividuelles Maximum je OperationIndividuelles Maximum je OperationWie vereinbart
Seitentiefe100 Ergebnisse (4 Seiten) pro SucheIndividuelles Maximum je OperationIndividuelles Maximum je OperationIndividuelles Maximum je OperationWie vereinbart
Ausgabenlimit für CreditsNicht anwendbar25.000 Tokens pro Abonnementzeitraum25.000 Tokens pro Abonnementzeitraum25.000 Tokens pro AbonnementzeitraumWie vereinbart
Mitglieder, API-Keys, OAuth-Clients1, 2, 21, 3, 310, 20, 2050, 50, 50Wie vereinbart

Preise finden Sie unter Preise.

So lesen Sie die Angaben:

  • Ein Tag beginnt um 00:00 Uhr UTC, und eine Minute entspricht der aktuellen UTC-Minute. Die gleitenden Fenster bewegen sich kontinuierlich: Die Nutzung fällt 3 Stunden bzw. 7 Tage nach der jeweiligen Anfrage aus dem Fenster.
  • Anfragen werden gezählt, unabhängig davon, ob sie Tokens verbrauchen: Kostenfreie Abrufe wie Ortssuchen (locations_search), zurückerstattete Abrufe sowie aus Zahlungsgründen abgelehnte Anfragen zählen mit. Zwei Abrufe zählen niemals mit, sodass ein Nutzer jederzeit den Kontostand einsehen und eine Zahlung abschließen kann: die Kontostatusabfrage (account_status, GET /v1/account) und der Status des Zahlungslinks (GET /v1/account/payment-links/{id}). Ortssuchen und die Kontostatusabfrage kosten 0 Tokens.
  • Ein bestimmter Ort ist eine in der Anfrage genannte Lokalität: ein location_id sowie ein Kreis, ein Polygon oder eine Straßenadresse (Comparables akzeptiert eine Adresse oder einen Kreis). Das Nennen eines bereits am Tag genutzten Ortes zählt nicht erneut. Kostenfreie Abfragen zählen ebenfalls zum Limit von 10 Orten; ein Nutzer, der viele Orte abfragt, erreicht also das Tageslimit für Orte, bevor er eine kostenpflichtige Anfrage stellt.
  • Im Plan Free gelten die Limits gemeinsam: Sobald das erste Limit erreicht ist, wird die nächste Anfrage gestoppt.
  • Die 1.000 Tokens des Plans Free gelten für die ersten 30 Tage. Danach bleiben Ortssuchen und die Kontostatusabfrage kostenfrei, während andere Aufrufe einen Zahlungslink zurückgeben. Maximal 500 davon können innerhalb von 3 Stunden genutzt werden.
  • Agent, Agency und Business basieren auf der Anzahl der Tokens, nicht der Anfragen: Es gilt das monatliche Token-Kontingent sowie ein maximaler Wert innerhalb von 3 Stunden. Die Nutzung darüber hinaus wird ausschließlich über Prepaid-Guthaben abgerechnet; es erfolgen keine nachträglichen Rechnungen. Nicht verbrauchte Tokens verfallen am Ende des Monats.
  • Wird bei einer Operation die maximale Seitengröße oder -tiefe überschritten, wird die Anfrage mit 400 page_depth_exceeded abgelehnt. Die Antwort gibt den betroffenen Parameter sowie den Maximalwert an.
  • Individuelle Limits werden vertraglich vereinbart.

Claro AI im Free-Plan

Für Claro AI gilt im Free-Plan eine eigene Obergrenze: Insgesamt 4 Suchanfragen, unabhängig von der Art der Suche und der Reihenfolge, gelten für die gesamte Organisation. Die Nutzung über REST und MCP wird hierbei gemeinsam gezählt.

  • Als Suche gelten claro_search_premises (POST /v1/claro/search), claro_refine_search (POST /v1/claro/search/refine) oder claro_search_plots (POST /v1/claro/plots/search). Jede Seite zählt als eine Suchanfrage: Das Abrufen einer Folgeseite mittels Cursor oder Offset wird erneut als Suche gewertet.
  • Es können nur Ergebnisse dieser Suchanfragen geöffnet werden: claro_get_premises, claro_get_plot und claro_compare_premises funktionieren nur mit den IDs, die durch diese Suchen geliefert wurden. Details zu anderen IDs werden verweigert.
  • Die 5. Suchanfrage oder ein Detailabruf einer anderen ID wird mit 402 payment_required und dem Grund trial_limit abgelehnt. Die Antwort enthält einen upgrade_url, über den der Kontoinhaber oder eine für die Abrechnung zuständige Person Credits erwerben kann; der Kauf von Tokens erfordert kein Abonnement und hebt das Limit auf. Der Free-Plan umfasst 4 Claro AI-Suchanfragen inklusive ihrer Ergebnisse; bei Erreichen des Limits sollte die Anwendung pausieren und einen entsprechenden Hinweis ausgeben, statt die Anfrage zu wiederholen. Suchanfragen, auf die Claro keine Antwort lieferte, werden nicht gezählt.
  • Claro-Operationen, die keine Tokens verbrauchen, unterliegen nicht dieser Obergrenze. Suchanfragen kosten auch hier Tokens gemäß Ihrem Plan, und die oben genannten Anfrage-Limits gelten ebenso für Claro-Aufrufe. Bezahlte Pläne haben kein Such-Limit.

Konten mit Credits ohne Abonnement

Ein Konto, das Prepaid-Guthaben erworben hat und über kein Abonnement verfügt, kann nur das erworbene Guthaben ausgeben und hat daher kein 3-Stunden- oder 7-Tage-Fenster und kein Ausgabenlimit. Die Schutzmechanismen liegen bei 20 Anfragen pro Minute, 3 gleichzeitigen Anfragen, 50 unterschiedlichen Standorten pro Tag und maximal 25.000 Tokens pro Tag. Bis das Konto die geschäftliche Verifizierung durchlaufen hat oder bis 7 Tage nach dem ersten Guthabenkauf vergangen sind, gelten weiterhin die Schutzmechanismen des Free-Plans für Anfragen pro Minute (6), gleichzeitige Anfragen (2) und unterschiedliche Standorte pro Tag (10). Der Guthabenkauf erfordert eine verifizierte Karte; in den ersten 7 Tagen nach Kartenverifizierung ist ein Kauf auf maximal 4.000 € begrenzt.

Kontoerstellung

  • Pro Netzwerk können täglich maximal 3 Konten eröffnet werden, verteilt auf die Konsole, die Registrierungs-API und den OAuth-Login. Bei Überschreitung erfolgt die Antwort 429 signup_limited.
  • Pro E-Mail-Adresse können täglich (UTC) maximal 3 Registrierungen über die Registrierungs-API gestartet werden.
  • Der Bestätigungscode per E-Mail ist 10 Minuten lang gültig und erlaubt 5 Versuche. Pro E-Mail-Adresse können innerhalb von 15 Minuten maximal 3 Codes versendet werden, und maximal 20 pro Netzwerk innerhalb einer Stunde.

Status der Nutzung prüfen

Überprüfen Sie Ihre Nutzung mit dem account_status-Tool, das in den Location Lookup-, Area Insights- und Comparables-Servern verfügbar ist. Verwenden Sie hierfür GET https://platform.casafari.com/v1/account (mit Ihrem API-Key im X-API-Key-Header oder als Authorization: Bearer <api_key>) oder besuchen Sie die Konsole, die Ihnen den rollierenden 3-Stunden-Zeitraum, den heutigen Verbrauch seit 00:00 Uhr UTC sowie den rollierenden 7-Tage-Zeitraum anzeigt. Aufrufe des Kontostatus verbrauchen 0 Tokens.

Verhalten bei Erreichen eines Limits

StatusProblemtypZeitpunktVorgehensweise
429request_limit_reachedEin Sicherheitslimit für Anfragen wurde erreicht: parallele Anfragen, Anfragen pro Minute, 3 Stunden, Tag, 7 Tage oder unterschiedliche Objekte. Das Feld window gibt an, welches Limit betroffen ist (siehe unten).Warten Sie Retry-After Sekunden ab und versuchen Sie es dann erneut.
429usage_limit_reachedDas 3-Stunden-Token-Fenster (session) eines Plans ist aufgebraucht und es sind keine Credits mehr vorhanden. Die Antwort enthält limit, reset_at, Retry-After sowie einen upgrade_url zum Erwerb von Credits.Warten Sie bis reset_at oder nutzen Sie den upgrade_url, um Credits zu erwerben.
429daily_limit_reachedDas tägliche Token-Limit des Kontos wurde erreicht. Es wird jeweils um 00:00 Uhr UTC zurückgesetzt.Versuchen Sie es nach dem Zurücksetzen erneut.
402payment_requiredDie Tokens sind aufgebraucht. Enthält eine upgrade_url sowie einen Link-Header mit rel="payment".Laden Sie unter upgrade_url Tokens nach (dies kann der Kontoinhaber oder ein für die Abrechnung autorisiertes Mitglied tun). Fragen Sie etwa alle 5 Sekunden über GET /v1/account/payment-links/{id} den Status ab, bis der Vorgang abgeschlossen ist, und versuchen Sie es dann erneut.
402payment_required mit dem Grund spending_cap_reachedFür Agent, Agency und Business: Das verbrauchte Guthaben hat in diesem Zeitraum das Ausgabenlimit erreicht.Warten Sie den nächsten Zeitraum ab oder erhöhen Sie das Limit in den Abrechnungseinstellungen des Kontos.
400page_depth_exceededDie Seitengröße oder Seitentiefe überschreitet den zulässigen Höchstwert.Fordern Sie weniger Ergebnisse an oder beenden Sie die Paginierung.

Das window-Mitglied von request_limit_reached

window benennt das Anfragelimit, das überschritten wurde. Dies ist kein Token-Nutzungsfenster: Es gibt an, welche Zeile der obigen Tabelle die Anfrage verweigert hat, da ein Anfragelimit die Anzahl der Anfragen zählt, nicht die Tokens.

windowDas überschrittene LimitFreeAgent, Agency und Business
concurrencyGleichzeitig laufende Anfragen (die noch aktiv und jünger als 120 Sekunden sind)23
minuteAnfragen innerhalb der aktuellen UTC-Minute620
sessionAnfragen innerhalb eines rollierenden 3-Stunden-Zeitraums50Unbegrenzt
dayAnfragen innerhalb eines UTC-Tages100Unbegrenzt
weekAnfragen innerhalb eines rollierenden 7-Tage-Zeitraums300Unbegrenzt
monthAnfragen innerhalb eines rollierenden 30-Tage-ZeitraumsUnbegrenztUnbegrenzt
locationsUnterschiedliche Orte, die am UTC-Tag angefragt wurden1050

Verwechseln Sie dies nicht mit dem Token-Nutzungsfenster der Pläne. Dies wird mit usage_limit_reached verweigert, welches Tokens zählt und das 3-Stunden-Fenster als session bezeichnet. Ein request_limit_reached mit window session bezieht sich auf die 3-Stunden-Anfrageanzahl, und week auf die 7-Tage-Anfrageanzahl. month wird nur für Konten mit eigenen Limits gesetzt, etwa bei Custom-Verträgen. Warten Sie die in Retry-After angegebene Sekundenanzahl ab, bis dieses Limit wieder freigegeben wird.

Fehler werden im Format application/problem+json zurückgegeben, wobei jeder Typ eine eigene Seite unter https://platform.casafari.com/errors/<code> hat. Über MCP kommen dieselben Verweigerungen als Zahlungs- oder Tool-Fehler mit identischen Mitgliedern an. Ein KI-Assistent kann die Zahlung nicht selbst vornehmen: Der Kontoinhaber oder ein berechtigtes Mitglied muss den Zahlungslink öffnen, um Tokens nachzuladen.

Das Ausgabenlimit begrenzt das Guthaben, das ein Agent-, Agency- oder Business-Abonnement pro Abrechnungszeitraum verbrauchen kann, einschließlich automatischer Aufladungen. Der Standardwert beträgt 25.000 Tokens (1.000 €). Bei Erreichen werden Anfragen, die Guthaben verbrauchen, abgelehnt und keine automatische Aufladung durchgeführt, bis der Zeitraum endet oder das Limit erhöht wird. Anfragen innerhalb der Nutzungsgrenzen bleiben weiterhin möglich.

Für die Plattform besteht kein SLA: Casafari ist um ständige Verfügbarkeit bemüht, garantiert jedoch keinen ununterbrochenen oder fehlerfreien Betrieb und veröffentlicht keine Uptime-Werte (siehe die Nutzungsbedingungen). Diese Limits dienen der Stabilität der Plattform. Bei Custom-Verträgen gelten individuelle Limits. Die Limits des bestehenden Casafari MCP-Servers und der REST API richten sich nach dem Vertrag des jeweiligen Kunden und sind hier nicht aufgeführt. Claro AI, ein Produkt der Plattform, wird in Plattform-Tokens abgerechnet, wobei für Claro eigene Limits pro Konto gelten: siehe Limits und Fehler.

Siehe auch: Nutzungsbedingungen (Abschnitte 7 und 8), REST API und die FAQ.

Fragen dazu

Tipp: Fügen Sie .md an eine URL an, um den Inhalt als Markdown zu lesen.