Rate limits & quotas

Usage is governed by two limits: a monthly quota (per plan) and an hourly rate limit. Both are enforced per API key.

Limit headers#

Every response carries your current usage so you can throttle proactively:

X-RateLimit-Limit: 50000
X-RateLimit-Remaining: 48766
X-RateLimit-Reset: 1751328000
X-Plan: pro

• X-RateLimit-Limit — your monthly quota.
• X-RateLimit-Remaining — calls left this period.
• X-RateLimit-Reset — Unix time when the window resets.
• X-Plan — your current plan code.

When you hit a limit#

Exceeding the hourly rate limit or monthly quota returns 429 Too Many Requests with the reset time. Calls to /me do not count against your quota.

{
  "success": false,
  "error": "Monthly quota exceeded",
  "plan": "free",
  "limit": 1000,
  "resetAt": "2026-07-01T00:00:00.000Z"
}