Rate Limits

HTTP/1.1 429 Too Many Requests
Retry-After: 1800
X-RateLimit-Limit: 500
X-RateLimit-Remaining: 0
X-RateLimit-Reset: 1784293200
X-RateLimit-Window: 3600

{
  "error": true,
  "message": "Rate limit exceeded. Please try again later.",
  "code": 429,
  "details": {
    "retry_after": 1800,
    "limit": 500,
    "reset_time": "2026-07-17T11:00:00+00:00"
  }
}

async function requestWithRateLimitRetry(url, options) {
  const response = await fetch(url, options);

  if (response.status !== 429) return response;

  const retryAfter = Number(response.headers.get('Retry-After') || 1);
  const jitter = Math.floor(Math.random() * 1000);
  await new Promise(resolve => setTimeout(resolve, retryAfter * 1000 + jitter));

  return fetch(url, options);
}