rate_limited

The message text is shown in the example below.

When it happens

More than 600 requests in a minute for one API key (or one signed-in user).

Example

{
  "error": {
    "type": "rate_limit_error",
    "code": "rate_limited",
    "message": "Too many requests. Retry shortly.",
    "param": null,
    "request_id": "req_6f1c2a9e0b7d4c3a8e5f1b2d",
    "retry_after": 12,
    "retry_after_seconds": 12
  }
}

How to fix it

• Wait Retry-After seconds, then retry with jitter.
• Smooth bursts with a client-side queue.
• Move bulk work to batches, which do not count against this limit.

Detect it in code

err = resp.json().get("error", {})
if resp.status_code == 429 and err.get("code") == "rate_limited":
    delay = err.get("retry_after") or 2
    time.sleep(delay)  # then retry

const { error } = await res.json()
if (res.status === 429 && error?.code === 'rate_limited') {
  await sleep((error.retry_after ?? 2) * 1000) // then retry
}

Related

• All error codes
• Rate limits and retries
• Rate-limit headers