Erste Schritte
Rate Limits
Ein gemeinsames Kontingent pro Konto, gemessen pro Monat, Tag und Stunde.
Limits nach Plan
| Plan | Pro Monat | Pro Tag | Pro Stunde | Pro Bulk-Aufruf |
|---|---|---|---|---|
| Free | 30.000 | 1.000 | 100 | 100 |
| Starter | 150.000 | Ohne Limit | 1.500 | 500 |
| Pro | 500.000 | Ohne Limit | 5.000 | 1.000 |
| Business | 2.000.000 | Ohne Limit | 20.000 | 2.000 |
| Enterprise | Individuell | |||
Ein Kontingent gilt für alle Produkte, und jeder berechnete Aufruf zählt einmal.
Die Demo ohne Schlüssel erlaubt etwa 100 Anfragen pro Tag und IP.
Rate-Limit-Header
- X-RateLimit-Limit
Monatliches Kontingent.
- X-RateLimit-Remaining
In diesem Monat verbleibende Anfragen.
- X-RateLimit-Reset
Wann das Monatskontingent zurückgesetzt wird, als Unix-Timestamp.
- X-RateLimit-Daily-*
Dieselben drei für das Tageslimit, bei Plänen mit Tageslimit.
- X-RateLimit-Hourly-*
Dieselben drei für das Stundenlimit.
- Retry-After
Sekunden, bis das erreichte Limit zurückgesetzt wird.
HTTP/2 200
x-ratelimit-meter: request
x-ratelimit-limit: 30000
x-ratelimit-remaining: 25820
x-ratelimit-reset: 1793491200
x-ratelimit-daily-limit: 1000
x-ratelimit-daily-remaining: 788
x-ratelimit-hourly-limit: 100
x-ratelimit-hourly-remaining: 86Wenn ein Limit erschöpft ist
reason
- hourly_limit
Das Stundenlimit ist erschöpft; es wird innerhalb der Stunde frei.
- daily_quota
Das Tageslimit ist erschöpft; es wird um Mitternacht UTC zurückgesetzt.
- monthly_quota
Das Monatskontingent ist erschöpft; es wird an Ihrem Reset-Datum zurückgesetzt.
- insufficient_for_batch
Ein Bulk-Aufruf brauchte mehr, als übrig ist; needed nennt die Anzahl.
{
"error": "rate_limit_exceeded",
"reason": "daily_quota",
"message": "You have used today's 1,000 requests.",
"meter": "request",
"plan": "Free",
"limit": 1000,
"usage": 1000,
"remaining": 0,
"resetDate": "2026-11-01",
"resetAt": "2026-10-07T00:00:00Z",
"retryAfter": 35400,
"softBlock": false,
"upgrade": {
"recommendedPlan": "Starter",
"url": "https://ipscanner.io/pricing",
"message": "You have used 100% of today's request allowance. The Starter plan has no daily cap."
}
}