Kontingente und Limits
Jeder Tarif hat ein Monatskontingent. Gezählt werden nur Abfragen, die ein Ergebnis liefern.
Kontingente je Tarif
#| Tarif | Abfragen im Monat | Aktive Schlüssel | Webhooks |
|---|---|---|---|
| Kostenlos | 500 | 3 | nein |
| Starter | 25.000 | 5 | nein |
| Pro | 250.000 | 10 | ja, bis zu 10 |
| Enterprise | nach Vereinbarung, bis 5.000.000 | 25 | ja, bis zu 10 |
Alle Tarife enthalten alle Datensätze und alle vier Zugänge. Preise stehen auf der Seite Preise.
Was zählt und was frei ist
#| Aufruf | Zählt |
|---|---|
| Abfrage eines Datensatzes mit Ergebnis, über API, SDK, CLI oder MCP | ja, eine Abfrage |
| Verlauf eines Datensatzes, auch als CSV | ja, eine Abfrage |
| Liste als CSV | ja, eine Abfrage |
| Aufruf mit Fehler (400, 401, 404, 429, 500) | nein |
| Katalog, Änderungsprotokoll, OpenAPI-Beschreibung | nein |
| MCP: initialize, ping, tools/list | nein |
| Webhook-Nachrichten an deinen Server | nein, erst der Abruf des neuen Werts zählt |
Verbrauch ablesen
#Jede Antwort mit gültigem Schlüssel trägt zwei Header:
Im MCP-Server steht derselbe Stand im Ergebnis unter _meta. Im Konto siehst du den Verbrauch des Monats und je Schlüssel, wann er zuletzt genutzt wurde.
Monatswechsel
#Das Kontingent gilt je Kalendermonat und beginnt am Ersten um 00:00 Uhr deutscher Zeit von vorn. Nicht genutzte Abfragen verfallen und werden nicht übertragen.
Wenn das Kontingent aufgebraucht ist
#Weitere Abfragen bekommen bis zum Monatsersten den Status 429 mit dem Code kontingent_erreicht. Es entstehen keine Zusatzkosten, und nichts wird automatisch hochgestuft. Wechselst du im Konto in einen größeren Tarif, gilt das neue Kontingent sofort.
In Starter, Pro und Enterprise gibt es einen Puffer von 10 % über dem Kontingent: Die API zählt weiter, schickt beim Erreichen des Kontingents eine Mail und antwortet erst nach dem Puffer mit 429. Kündigst du oder wechselst in einen kleineren Tarif, gilt das bisherige Kontingent bis zum Monatsende.
Weitere Grenzen
#| Was | Grenze |
|---|---|
| Webhooks je Konto | 10, ab Tarif Pro |
| Antwortzeit deines Servers auf einen Webhook | 8 Sekunden |
| Zustellversuche je Webhook-Nachricht | 5, einer je Tag |
| Anmeldelinks | 3 je E-Mail-Adresse in 10 Minuten |
| Nachrichten über das Kontaktformular | 5 je Stunde |
| Feiertage und Arbeitstage | Jahre 2015 bis 2035 |
| Tabellen | Stichtage ab 01.01.2015 |
Abfragen sparen
#- Antworten einen Tag lang zwischenspeichern. Die meisten Werte ändern sich nur zum 1. Januar oder 1. Juli. Die API sagt dir selbst, wie lange: jede Datensatz-Antwort trägt
Cache-Control: max-age=…bis zur nächsten Mitternacht deutscher Zeit. - Danach mit der gemerkten
ETagim HeaderIf-None-Matchnachfragen. Hat sich nichts geändert, kommt Status 304 ohne Inhalt zurück, und die Abfrage zählt nicht gegen dein Kontingent. Die offiziellen SDKs machen das automatisch, siehe SDK JavaScript und SDK Python. - Den Verlauf einmal übernehmen und Änderungen per Webhook nachziehen, statt regelmäßig nachzufragen, oder mit /export den ganzen Tabellenbestand in einer Abfrage holen.
- Feiertage einmal je Jahr und Land abrufen und lokal speichern.
- In Web-Anwendungen die API vom Server aus aufrufen und das Ergebnis im Cache deines Hostings halten, siehe Einsatz in Next.js.
Fragen zu höheren Kontingenten beantworten wir über das Kontaktformular. Quellenkontor rechnet Business-Verträge per Rechnung ab.
Fehlt etwas oder ist etwas unklar? Schreib uns, wir ergänzen die Doku.