Rate limits

How often you can call the API.

Each API key can make up to 120 requests a minute. That’s plenty for normal use — it’s just there so one key can’t overwhelm things.

Every response tells you where you stand, with these headers:

• X-RateLimit-Limit — how many requests you get per minute.
• X-RateLimit-Remaining — how many you have left right now.
• X-RateLimit-Reset — when the count resets, as a Unix timestamp.

If you go over

You’ll get a 429 response with a Retry-After header telling you how many seconds to wait:

{
  "error": {
    "code": "rate_limited",
    "message": "rate limit exceeded",
    "request_id": "…"
  }
}

Wait that long, then try again. Here’s a small helper that does the waiting for you:

async function callWithBackoff(request) {
  for (let attempt = 0; attempt < 5; attempt++) {
    const res = await request();
    if (res.status !== 429) return res;

    const wait = Number(res.headers.get("Retry-After") ?? 1) * 1000;
    await new Promise((resolve) => setTimeout(resolve, wait));
  }
  throw new Error("Still rate limited after several tries.");
}

The easiest way to avoid 429s in the first place is to watch X-RateLimit-Remaining and spread big jobs out instead of firing everything at once.