Back to home

Rate Limits

Understand API rate limits

Rate Limits

To ensure fair usage and system stability, we implement rate limits.

Rate Limit Tiers

  • Web requests: 100 requests per minute per user
  • API key requests: 1000 requests per minute per key

Rate Limit Headers

Rate limit information is included in every API response:

  • X-RateLimit-Limit: Maximum requests allowed in the current window
  • X-RateLimit-Remaining: Number of requests remaining in the current window
  • X-RateLimit-Reset: Unix timestamp when the rate limit resets

Handling Rate Limits

When you exceed the rate limit, you'll receive a 429 Too Many Requests response. Wait until the reset time before making additional requests.

Best Practices

  • Implement exponential backoff when hitting rate limits
  • Cache responses when possible
  • Use webhooks for real-time updates instead of polling
    Rate Limits | Competitor Watch Docs | Competitor Watch