Rate Limits

Limits

Plan	Rate Limit
Starter	100 requests/minute
Growth	100 requests/minute
Scale	100 requests/minute

Headers

Every response includes rate limit headers:

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

Exceeding Limits

When rate limited, the API returns HTTP 429:

{
  "error": "Rate limit exceeded"
}

Wait until the X-RateLimit-Reset timestamp before retrying.

Best Practices

• Cache responses on your server to reduce API calls
• Use the storefront endpoints for public data (they’re edge-cached)
• Batch operations where possible