Rate Limits
ExplainThis limits how often you can call the service. This keeps things fast and fair for everyone. Your plan tier sets the exact quotas.
Free
- Requests per day:50
- Code size limit:100,000 characters
- Monthly tokens:1,000
Pro
- Requests per day:1,000
- Code size limit:100,000 characters
- Monthly tokens:10,000
Enterprise
- Requests per day:10,000 (custom options available)
- Code size limit:100,000 characters
- Monthly tokens:100,000 included
Throttle Responses
When you exceed the threshold, the service returns HTTP 429. The response may include a Retry-After header. It tells you how many seconds to wait before trying again.
What this means: If you send too many requests, the server will pause your access for a short time. Check the Retry-After header to know exactly when you can try again.
Usage Best Practices
Implement Retries
If you get throttled, use exponential backoff. Start with a 1-second wait, then double it after each retry.
In other words, if you send too many requests, the server asks you to wait before trying again — and each time you retry too quickly, the wait gets longer (1 s, 2 s, 4 s, 8 s…).
Cache Responses
Save responses locally when you can. This cuts down on repeat calls. Store frequently used results so you stay well within your quota.
Throttle Response
If you go over your quota, the service returns a 429 status code. The response body tells you when you can try again. Here is what it looks like:
What this means: This JSON block is what your code will receive. Use the reset_at timestamp to know the exact moment you can send your next request.
{
"error": {
"code": "rate_limit_exceeded",
"message": "Rate limit exceeded. Please try again in 60 seconds.",
"reset_at": "2024-03-15T10:00:00Z"
}
}Raising Your Request Quotas
Need higher throughput? Here are your options:
- Upgrade your plan from the subscription settings page
- Batch several requests into one call to use fewer quota slots
- Spread your requests out so you stay within your limits
- Cache results to cut down on repeat calls
For full request and response details, check out our endpoint reference.