Rate Limits
Understanding API rate limits and usage quotas.
Pricing Plans
Rate limits and daily call allowances vary by plan:
| Plan | Price | Daily Calls | Support |
|---|---|---|---|
| Free | $0/month | 1,000 calls/day | No credit card |
| Starter | $19/month | 50,000 calls/day | Email support |
| Pro | $49/month | 500,000 calls/day | Priority support |
| Enterprise | $199/month | Unlimited | Slack support |
Need more? View pricing plans →
Rate Limit Headers
Every API response includes headers to help you track your rate limit usage:
X-RateLimit-LimitYour daily request limit based on your plan.
X-RateLimit-RemainingThe number of requests remaining for the current day.
X-RateLimit-ResetUnix timestamp when the daily limit resets (midnight UTC).
Rate Limit Exceeded
When you exceed your daily limit, the API returns a 429 Too Many Requests status:
json
{
"error": "rate_limit_exceeded",
"message": "Daily limit reached. Upgrade at localityapi.com/pricing",
"reset_at": "2026-05-29T00:00:00Z"
}The reset_at field indicates when your limit will reset. Consider upgrading your plan if you consistently hit rate limits.
Best Practices
- Cache responses — Store results locally to reduce API calls for repeated queries.
- Implement exponential backoff — When you receive a 429, wait and retry with increasing delays.
- Monitor usage — Check the rate limit headers to track your usage and avoid hitting limits.
- Debounce autocomplete — For real-time search, debounce requests by 200-300ms to reduce calls.