Rate Limits

Rate limits ensure fair usage and optimal performance of the grapeminds API for all users.

Current Limits

Plan Requests / Minute Requests / Day
Trial (14 days) 60 1.000
Standard 120 10.000
Enterprise Custom Custom

Rate Limit Headers

Every API response includes headers to help you track your remaining quota:

X-RateLimit-Limit

The maximum number of requests allowed per minute.

X-RateLimit-Remaining

The number of requests remaining in the current window.

Retry-After

Seconds to wait before retrying (only present when rate limited).

When you hit the limit

If you exceed the rate limit, you will receive a 429 response:

429 Too Many Requests
{
  "message": "Too Many Attempts.",
  "retry_after": 30
}

Best Practices

Cache responses where possible to reduce the number of API calls.

Implement exponential backoff when encountering 429 errors.

Monitor the X-RateLimit-Remaining header to proactively avoid hitting limits.

Use pagination to fetch data in smaller batches instead of requesting large datasets.

Need higher limits?

Contact us for a custom Enterprise plan with higher rate limits.