Rate Limits
Learn about our rate limiting policies, quota management, and how to handle rate limit responses gracefully.
Rate Limit Policies
Free Plan
1,000
requests/hour
Perfect for testing and small projects
Starter Plan
10,000
requests/hour
Great for growing applications
Business Plan
100,000
requests/hour
For high-volume applications
Quota Management
Understanding Your Limits
Rate limits are applied per API key and reset every hour. You can monitor your usage in the dashboard.
X-RateLimit-Limit: 1000
X-RateLimit-Remaining: 850
X-RateLimit-Reset: 1640995200
Checking Your Usage
Monitor your API usage through response headers or the dashboard.
curl -I -H "Authorization: Bearer YOUR_API_KEY" \
https://api.pricesentry.io/v1/products
Response Headers
X-RateLimit-Limit
Your hourly request limit
X-RateLimit-Limit: 1000
X-RateLimit-Remaining
Requests remaining in current hour
X-RateLimit-Remaining: 850
X-RateLimit-Reset
Unix timestamp when limits reset
X-RateLimit-Reset: 1640995200
Handling Rate Limits
429 Too Many Requests
Rate limit exceeded response
{
"error": "Rate limit exceeded",
"status": 429,
"retry_after": 60,
"limit": 1000,
"remaining": 0,
"reset": 1640995200
}
Best Practices
How to handle rate limits gracefully
1. Implement Exponential Backoff
When you hit a rate limit, wait before retrying and increase the wait time exponentially.
2. Monitor Usage
Track your API usage and implement alerts when you approach limits.
3. Cache Responses
Cache API responses to reduce the number of requests you need to make.
4. Batch Requests
Combine multiple operations into single requests when possible.