Skip to main content

Rate Limits

Understand the rate limiting policies for the Carapis API.

Overview​

Rate limits are in place to ensure fair usage and maintain API performance for all users.

Rate Limit Tiers​

Free Tier​

  • Requests per minute: 60
  • Requests per hour: 1,000
  • Requests per day: 10,000

Pro Tier​

  • Requests per minute: 300
  • Requests per hour: 10,000
  • Requests per day: 100,000

Enterprise Tier​

  • Requests per minute: 1,000
  • Requests per hour: 50,000
  • Requests per day: 500,000

Rate Limit Headers​

The API includes rate limit information in response headers:

X-RateLimit-Limit: 60
X-RateLimit-Remaining: 45
X-RateLimit-Reset: 1640995200
  • X-RateLimit-Limit: Maximum requests allowed in the time window
  • X-RateLimit-Remaining: Number of requests remaining
  • X-RateLimit-Reset: Unix timestamp when the rate limit resets

Handling Rate Limits​

When you exceed the rate limit, you'll receive a 429 Too Many Requests response:

{
  "error": "rate_limit_exceeded",
  "message": "Rate limit exceeded. Try again in 60 seconds.",
  "retry_after": 60
}

Best Practices​

  • Implement exponential backoff when hitting rate limits
  • Monitor rate limit headers to avoid hitting limits
  • Use webhooks for real-time data instead of polling
  • Cache responses when possible to reduce API calls

Upgrading Your Plan​

To increase your rate limits, upgrade your plan in the Carapis dashboard.