§ Rate limits

How fast you can call.

Limits are per-IP for anonymous traffic and per-user for Clerk-authed traffic. Every response includes x-rate-limit-remaining; 429s carry Retry-After in seconds.

Free tier (anonymous)

EndpointLimitWindow
POST /api/v1/ask30 req60s per IP
POST /api/v1/research5 req5 min per IP
POST /api/v1/sources/propose3 req1 hr per IP
GET /api/v1/sources120 req60s per IP
GET /api/v1/sources/healthedge-cached 60s—

Paid tier (Clerk Bearer or API key)

EndpointPro limitTeam limitEnterprise
POST /api/v1/ask120 req / 60s600 req / 60scustom
POST /api/v1/research20 / 24h100 / 24hcustom
POST /api/v1/follow200 / day1000 / daycustom
POST /api/v1/sources/{id}/sweep1 / source / hr1 / source / hrcustom

Tier mapping is governed by Stripe; see /pricing for the ladder. Soft-nudge banner shows when you cross 80% of a window; hard 429 only at 100%.

Headers on every response