Rate Limits

MisarSEO rate limits per user, per route. Each route has its own independent fixed window — spending your budget on keyword research does not affect your crawl budget.

Exceeding a limit returns 429 with code RATE_LIMITED and a Retry-After header in seconds.

Limits by route

Routes with no rate limit

These are cheap reads or utility endpoints and are not throttled. They are still subject to plan quotas.

• GET /seo/projects
• GET /seo/projects/:projectId
• GET /seo/crawl/:jobId/status
• GET /seo/keywords/saved
• GET /seo/rank-tracking/configs
• GET /seo/rank-tracking/keywords
• GET /seo/ai/brand-lookup/:jobId/status
• GET /seo/gsc/connect
• GET /api/health
• GET, POST, DELETE /api/keys
• POST /seo/citations

Plan quotas are separate

A 429 can also mean a plan quota, not a request-rate limit:

Always read code before deciding whether to retry.

Handling

async function withRetry(run: () => Promise<Response>, attempts = 3) {
  for (let i = 0; i < attempts; i++) {
    const res = await run();
    if (res.status !== 429) return res;

    const body = await res.clone().json().catch(() => ({}));
    // Waiting never clears a plan quota.
    if (body.code === "PLAN_LIMIT_REACHED") return res;

    const wait = Number(res.headers.get("Retry-After") ?? 5);
    await new Promise((r) => setTimeout(r, wait * 1000));
  }
  return run();
}

See Errors for the full code table.