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.

Need Higher Limits?

Upgrade your plan to get higher rate limits and additional features.