Rate Limits
Naturalead enforces multiple rate limiting tiers to ensure fair usage and platform stability. All rate limits use a sliding window of 60 seconds.Rate limit tiers
How tiers stack
A single request may count against multiple tiers simultaneously:- Global — always applies (based on IP)
- API Key — applies when using API key auth
- Sync — applies only to lead sync endpoints (in addition to API key limit)
- Account — applies when account is resolved (bounds total across all keys)
The account limit (2,000/min) bounds total traffic regardless of how many API keys exist. Even if you have 10 keys, each at 500/min, the account total cannot exceed 2,000/min.
Response headers
All responses include rate limit headers following the IETF draft-7 standard:Rate limit exceeded response
When a rate limit is exceeded, the API returns429 Too Many Requests:
Best practices
Implement exponential backoff
When you receive a429, wait for the Retry-After header value before retrying:
Monitor your usage
CheckRateLimit-Remaining headers proactively to throttle before hitting limits.