← Back to Dashboard Download .md

Rate Limiting & Usage

To ensure fair usage and system stability, API requests are rate-limited based on your Nabzclan VIP Tier.

Daily Limits

Plan Tier Daily Requests
Free 100
VIP 1 5,000
VIP 2 10,000
VIP 3 20,000
VIP 4 Unlimited

Unlimited Request Policy

If you are on the VIP 4 plan, your limit and remaining fields in API responses will return -1. This indicates that no hard limit is enforced.

Headers

Every response includes headers describing your current rate limit status:

  • X-RateLimit-Limit: Your daily limit (or empty/high number if unlimited).
  • X-RateLimit-Remaining: Requests remaining in the current window.
  • Retry-After: Seconds to wait if limit is exceeded (HTTP 429).

Exceeding Limits

If you exceed your daily limit, the API will return a 429 Too Many Requests error:

{
    "error": "rate_limit_exceeded",
    "message": "Daily request limit exceeded. Please upgrade your plan."
}