API
Rate-Limits
Anfragen-Limits pro API-Schlüssel und Endpunkt.
Limits gelten pro API-Schlüssel — alle Anfragen mit demselben Schlüssel teilen sich das Budget, unabhängig von der Quell-IP.
Limits
Standardmäßig pro 1 minute:
| Endpunkt | Limit |
|---|---|
GET /v2/search | 30 |
POST /v2/mcp/poliscope | 60 |
GET /v2/files/{id}/download, /content | 180 |
| Alle anderen Endpunkte | 120 |
GET /v2/health | unbegrenzt |
Antwort-Header
Jede Antwort enthält den aktuellen Stand:
x-ratelimit-limit: 60
x-ratelimit-remaining: 47
x-ratelimit-reset: 23x-ratelimit-reset ist die Anzahl Sekunden bis das Budget zurückgesetzt wird.
Limit überschritten
Wenn das Limit erreicht ist, antwortet die API mit 429 Too Many Requests:
{
"error": "Too Many Requests",
"message": "Rate limit exceeded. Retry in 23 seconds."
}Zusätzlich wird der Standard-Header retry-after (Sekunden) gesetzt. Warte mindestens diese Zeit ab, bevor du den Request wiederholst.
Brauchst du höhere Limits? Schreib uns kurz mit deinem Use-Case — Limits können pro Vertrag angehoben werden.