Rate Limits

API usage limits based on your subscription plan.

Limits by Plan

Rate Limit Headers

Every API response includes these headers:

X-RateLimit-Remaining: 95
X-RateLimit-Reset: 1706200000

• X-RateLimit-Remaining — Calls left today
• X-RateLimit-Reset — Unix timestamp when limits reset

When You Hit the Limit

{
  "success": false,
  "error": "Daily API limit reached. Upgrade your plan for more requests.",
  "code": "RATE_LIMIT_EXCEEDED"
}

HTTP Status: 429 Too Many Requests

Premium APIs

These endpoints require Developer or Pro plan:

Free users attempting these will receive:

{
  "success": false,
  "error": "This API is only available for Pro and Developer plans.",
  "code": "PREMIUM_REQUIRED"
}

HTTP Status: 403 Forbidden

Best Practices

1. Cache responses — Reduce unnecessary calls
2. Use webhooks — Instead of polling
3. Batch requests — Where possible
4. Monitor usage — Check remaining calls

Upgrading

Need more API calls? Upgrade your plan.

See also: API Overview