Rate Limits

Rate limits are enforced per API key using a KV-based sliding window.

Limits by Tier

Every API response includes rate limit headers:

X-RateLimit-Limit: 100
X-RateLimit-Remaining: 95
X-RateLimit-Reset: 1718800000

Header	Description
`X-RateLimit-Limit`	Maximum requests per minute for your key
`X-RateLimit-Remaining`	Requests remaining in the current window
`X-RateLimit-Reset`	Unix timestamp when the window resets

Daily read limits are tracked per API key and reset at midnight UTC.

Tier	Daily Read Limit
`read_only`	500 reads/day
`read_write`	Unlimited

When you exceed your rate limit, the API returns 429 Too Many Requests:

{
  "error": "rate_limited",
  "message": "Rate limit exceeded. Try again after the reset time.",
  "retry_after": 45
}

Monitor headers — Check X-RateLimit-Remaining before making batch requests
Use idempotency keys — Safe retries without consuming extra quota
Batch operations — Combine multiple items into fewer requests where possible
Upgrade tier — Move from read_only to read_write for higher limits