Rate Limits
Rate limits protect the API from abuse and ensure fair usage across all customers. Limits vary by plan.
Per-Plan Limits
| Plan | Requests/min | Credits/month |
|---|---|---|
| Free | 10 | 1,000 |
| Project | 30 | 7,000 |
| Bootstrap | 60 | 28,000 |
| Startup | 120 | 85,000 |
| Growth | 200 | 200,000 |
Rate Limit Headers
Every API response includes rate limit information in the headers:
| Header | Description |
|---|---|
X-RateLimit-Limit | Maximum requests per minute for your plan |
X-RateLimit-Remaining | Remaining requests in the current window |
X-RateLimit-Reset | Unix timestamp when the rate limit resets |
Handling 429 Errors
When you exceed the rate limit, the API returns a 429 Too Many Requests response. To handle this gracefully:
- Check the
X-RateLimit-Resetheader for when you can retry - Implement exponential backoff in your retry logic
- Queue requests to stay within your per-minute limit
- Consider upgrading your plan if you consistently hit limits
{
"error": {
"code": "rate_limit_exceeded",
"message": "Rate limit exceeded. Retry after 30 seconds."
}
}Tips
- Cache results where possible to reduce API calls
- Batch related queries rather than making many small requests
- Monitor your usage in the dashboard to anticipate limit needs