Limits und Obergrenzen

Die Limits gelten je Absender und zählen REST-API und MCP-Server zusammen.

Rate-Limit

Grenze	Wert
Aufrufe je IP-Adresse	300 je Minute
Aufrufe je API-Key	120 je Minute (Standard)

Den Wert je API-Key legt Ihr Brand Success Management beim Ausstellen des Keys fest und kann ihn später anpassen.

Bei Überschreitung antwortet Brandhub mit 429. Der Header Retry-After nennt die Wartezeit in Sekunden.

Hinweis

Brandhub prüft das Limit vor der Authentifizierung. Aufrufe mit falschem Key zählen mit.

Suche per MCP

Für search_pages, get_brand_context und get_corporate_language mit Suchbegriff sowie für search_website gelten zusätzliche Grenzen, weil eine Suche nach Bedeutung mehr Rechenzeit kostet als ein normaler Abruf. search_media zählt nur mit, wenn es nach Bedeutung sucht (Modul „Markenagent (KI)“ aktiv).

Grenze	Wert
Länge einer Suchanfrage	300 Zeichen
Treffer je Suche	5 Standard, 10 maximal
Suchen je API-Key	30 je Minute
Suchen je API-Key	500 je Tag (Standard)
Suchen nach Bedeutung je Marke	500 je Tag

Ist eine Grenze erreicht, antwortet das Tool mit einem Fehler und dem Zeitpunkt, ab dem es wieder sucht („Wieder möglich ab …“).

Das Tageslimit je API-Key zählt jede Suche über diesen Key, im Volltext wie nach Bedeutung. Ihr Brand Success Management kann den Wert je Key anpassen, wie beim Limit für Aufrufe je Minute.

Der Tagesdeckel je Marke zählt nur Suchen nach Bedeutung, über alle Keys der Marke zusammen. Dazu gehören die oben genannten Tools, sofern das Modul „Markenagent (KI)“ für Ihre Marke aktiv ist. Beide Tageslimits laufen bis Mitternacht. search_pages ohne Suchbegriff liefert die Seitenliste und zählt nur gegen das Rate-Limit für Aufrufe.

Schreiben

Grenze	Wert
Blöcke je Seite	200
Länge eines Titels	255 Zeichen

Die Grenze für Blöcke gilt per REST beim Anlegen einer Seite und beim Ersetzen des gesamten Inhalts, per MCP beim Anlegen einer Seite mit create_page.