Skip to main content

Rate Limits & Retention

Your requests per minute (RPM) and data retention window depend on your subscription plan. The API enforces these limits to ensure fair usage and service reliability.

Response Headers​

Every API response includes rate limit headers:

X-RateLimit-Limit: 100
X-RateLimit-Remaining: 98
X-RateLimit-Reset: 23
HeaderDescription
X-RateLimit-LimitMaximum requests allowed per window
X-RateLimit-RemainingRequests remaining in current window
X-RateLimit-ResetSeconds until the rate limit window resets

Handling Rate Limits​

When you exceed the rate limit, you'll receive a 429 Too Many Requests response.

Best practices:

  1. Check X-RateLimit-Remaining before making requests
  2. Implement exponential backoff on 429 responses
  3. Add delays between batch requests: sleep 1 in bash, time.sleep(1) in Python
  4. Cache responses where possible to reduce API calls

Data Retention​

Requests for data outside your plan's retention window are rejected with a 400 Bad Request response. Check your plan's retention limits in the dashboard under Settings → Usage.

Time Parameters​

All time parameters use ISO 8601 format:

2024-01-15T14:30:00Z

Timestamps must fall within your plan's retention window.