API Rate Limits

Understand API rate limits by plan and how to handle rate-limited responses.

Rate Limit Overview

API rate limits protect the platform and ensure fair usage. Limits are applied per API key and vary by plan.

Limits by Plan

PlanRequests / HourRequests / Day
Essential1001,000
Professional5005,000
Agencies2,00020,000
EnterpriseCustomCustom

Rate Limit Headers

Every API response includes rate limit information in the headers:

X-RateLimit-Limit: 500
X-RateLimit-Remaining: 487
X-RateLimit-Reset: 1705312800
  • X-RateLimit-Limit: Maximum requests per hour
  • X-RateLimit-Remaining: Requests remaining in the current window
  • X-RateLimit-Reset: Unix timestamp when the limit resets

When You Exceed the Limit

If you exceed your rate limit, the API returns a 429 Too Many Requests response:

{
  "error": "rate_limit_exceeded",
  "message": "You have exceeded your rate limit. Please retry after 2025-01-15T11:00:00Z.",
  "retry_after": 120
}

Best Practices

  • Implement exponential backoff when you receive a 429
  • Cache API responses where possible
  • Use webhooks instead of polling for real-time updates
  • Monitor your rate limit headers to stay within bounds