Understand request rate limits and how to handle API throttling effectively.
Ideal for small-scale applications and testing.
Upgrade Plan →Balanced plan for medium-size applications.
Upgrade Plan →Custom rate limits for high-volume API consumers.
Contact Sales →The maximum number of requests per interval.
Requests remaining in the current time window.
Seconds to wait before resuming requests after rate limit.
async function safeRequest(url) {
const response = await fetch(url);
// Check rate limit status
const remaining = response.headers.get('X-RateLimit-Remaining');
if (remaining < 100) {
const retryAfter = response.headers.get('Retry-After') || 5;
console.warn(`Approaching rate limit. Retrying in ${retryAfter} seconds.`);
}
if (response.status === 429) {
const retryAfter = 10; // Default fallback
if (response.headers.has('Retry-After')) {
retryAfter = parseInt(response.headers.get('Retry-After'));
}
console.log(`Rate limited! Retrying in ${retryAfter} seconds...`);
await new Promise(r => setTimeout(r, retryAfter * 1000));
return safeRequest(url); // Retry after delay
}
return response.json();
}
Always track X-RateLimit-Remaining
in your application to anticipate limits.
When rate-limited, use exponential backoff with jitter for retries.
Our support team is available for questions about rate limits or API usage.
Enterprise plans provide higher limits and custom quotas. Contact for enterprise options.
Requests will receive 429 Too Many Requests
with Retry-After
in seconds.
Requests are counted in a 60-second sliding window unless otherwise specified for your tier.