# Rate Limits

> Wie viele Aufrufe die Tentary API erlaubt: Punkte pro Minute und pro Tag, was ein Aufruf kostet und was du bei einem 429 tust.

Source: https://tentary.com/de/help/api/rate-limits/
Last updated: 2026-10-28

---

Die Tentary API zählt Punkte statt Aufrufe. Lesen ist günstig, Auswertungen und Uploads kosten mehr.

## Limits

| Limit | Punkte |
| --- | --- |
| Pro Konto und Minute | 300 |
| Pro Konto und Tag | 10.000 |
| Pro API-Schlüssel und Minute | 120 |

Die Limits pro Konto gelten für alle Schlüssel und alle verbundenen KI-Apps zusammen.

## Was ein Aufruf kostet

| Aufruf | Punkte |
| --- | --- |
| Lesen | 1 |
| Ändern | 3 |
| Aktion, die eine Bestätigung braucht | 5 |
| Auswertung (Umsatz, Abos, Besuche), Kundensuche mit `paid_only` oder Datei-Upload (`POST /v1/files`) | 10 |

## Gleichzeitige Aufrufe

Ein Konto kann höchstens 8 Aufrufe gleichzeitig ausführen. Davon dürfen höchstens 2 Auswertungen, Kundensuchen mit `paid_only` oder Datei-Uploads sein. Weitere Aufrufe bekommen den Status 429 mit dem Code `busy` und einem Header `Retry-After`.

## Limits für einzelne Aktionen

Dazu kommen eigene Limits für einzelne Aktionen:

- **Test-E-Mails:** 10 pro Stunde und 30 pro Tag.
- **Feedback:** 10 pro Tag.
- **Bestätigungen:** höchstens 50 Anfragen pro Konto und Tag.

## Wenn ein Limit erreicht ist

Die API antwortet mit dem Status 429 und dem Code `rate_limited`. Der Header `Retry-After` nennt die Sekunden, die du warten sollst. Die Nachricht lautet:

```text
Rate limit reached. Wait N seconds, or ask for fewer items per call.
```

Jeder Aufruf kostet mindestens 1 Punkt, auch wenn Tentary ihn abweist: zum Beispiel wegen eines unbekannten Parameters, eines Bodys, der nicht zum Schema passt, eines Bodys über 1 MB oder eines Limits. Ein Aufruf, den das Minuten- oder Tageslimit abweist, kostet nur diesen 1 Punkt. Ein Aufruf, der später abgewiesen wird, zum Beispiel durch das Limit für Test-E-Mails oder eine Prüfung der Werte, zählt seine vollen Punkte.

Warte nach einem 429 die Sekunden aus `Retry-After`. Wiederhole den Aufruf nicht sofort in einer Schleife: Auch jeder abgewiesene Aufruf kostet 1 Punkt.

> **Tipp:** Hole bei Listen mit `limit` mehr Einträge pro Seite, statt viele kleine Seiten abzurufen. Siehe [Pagination](https://tentary.com/de/help/api/pagination/).