Rate Limits

API rate limits ensure fair usage and platform stability.

Rate Limits by Tier

TierRequests/MinuteScans/MonthProjects
Starter10102
Pro60505
Business30020020

Rate Limit Headers

Every API response includes rate limit information in the headers:

HeaderDescription
X-RateLimit-LimitMaximum requests per window
X-RateLimit-RemainingRemaining requests in current window
X-RateLimit-ResetUnix timestamp when window resets
X-RateLimit-TierYour subscription tier

Rate Limit Exceeded

When you exceed the rate limit, the API returns a 429 status:

HTTP/1.1 429 Too Many Requests
X-RateLimit-Limit: 60
X-RateLimit-Remaining: 0
X-RateLimit-Reset: 1705318800
Retry-After: 45

{
  "success": false,
  "error": {
    "code": "RATE_LIMITED",
    "message": "Rate limit exceeded. Limit: 60 requests per minute (pro tier)",
    "details": {
      "retryAfter": 45,
      "tier": "pro",
      "limit": 60
    }
  }
}

Best Practices

  • Implement exponential backoff when receiving 429 errors
  • Batch API requests where possible instead of individual calls
  • Cache GET responses where appropriate
  • Monitor the X-RateLimit-Remaining header proactively