Rollout status
Planned means the behavior is specified in these docs so you can design against it, but calling the route today returns
404 and the headers are absent. Pilot means the feature is enabled for selected organizations and may still change; pilot participants are contacted directly.
Migration guide for existing API users
If you integrated before plans launched, here is what changes and what does not.Nothing you rely on today breaks
- Routes, parameters, and response bodies of the six current-data endpoints are unchanged.
- The error envelope keeps
code,message,param, andhelp_url. New fields are additive. - Your existing API keys keep working. No re-issue is required.
Wording change: from “per API key” to “per organization”
Earlier versions of these docs described rate limits as “per API key, per endpoint”. Limits are now defined per organization:- All keys in your organization share one daily quota and one burst limit.
- Official MCP connections draw from the same pool.
- Creating more keys does not create more capacity. If you were relying on multiple keys to multiply throughput, size your usage against a single organization pool and consider Builder.
/v1/updates is unchanged, and is not a change feed
/v1/updates continues to return recently added models within a 1–30 day lookback. It does not report score, ranking, or pricing changes, and has no cursor. The incremental updates API (/v1/changes) is a separate, Builder-and-above feature. Keep using /v1/updates for “what’s new”; move to /v1/changes when you need a durable sync.
Effective dates and grandfathering
- Plan enforcement launches in two steps. First, quota headers appear on responses and usage is measured only; no request is rejected for quota. Then, on an announced date, limits are enforced. Both dates will be added to this page and emailed to the address on your developer account at least 14 days in advance.
- At enforcement, every organization without a subscription is on Community.
- Organizations whose measured usage exceeds Community limits receive a time-limited grace period before enforcement applies to them. Grace is temporary; there is no permanent grandfathering of pre-plan usage levels.
- Attribution requirements for public Community display apply from enforcement. Integrations that already show a source link are eligible for the verified bonus once verification launches.
What to do now
1
Consolidate keys to one organization
If you created keys under several accounts to spread load, pick one organization and migrate to it. Quota follows the organization.
2
Estimate your daily data responses
Count
2xx responses per UTC day. If it is regularly above 500, plan for Builder; above 5,000, contact sales.3
Handle 429 by limit_type
Update your client to read
error.limit_type and reset_at, and to stop polling when the daily quota is exhausted. See Rate limits and headers.4
Add attribution if you display data publicly
Community users showing LLM Stats data publicly need a source link or badge. See Attribution. Doing it now earns the verified bonus as soon as verification launches.
5
Confirm your rights
If you redistribute the data — as a dataset, an API, or inside a paid product — you need a Commercial agreement regardless of volume. See Plans and quotas.
History
Plans and quotas
Documented the three-plan model, organization-level quotas and burst limits, response headers, stable error codes, historical data, bulk snapshots, incremental updates, webhooks, attribution, and embeds ahead of rollout. Corrected the previous “per API key” rate-limit wording to “per organization”. No API behavior changed.