Skip to content

Document plan-tiered daily limits for the Government and Research Indexes - #1601

Open
KrisOei wants to merge 5 commits into
mainfrom
kris/gov-daily-limit-docs
Open

KrisOei wants to merge 5 commits into
mainfrom
kris/gov-daily-limit-docs

Conversation

@KrisOei

@KrisOei KrisOei commented Oct 15, 2026 •

Copy link
Copy Markdown
Contributor

Documents the daily call limits on the free Government Index and Research Index, now sized by plan.

Plan Calls per index per day
Free, Hobby, Standard (and keyless, per IP) 1,000
Growth 2,000
Scale, Enterprise Unlimited
  • rate-limits.mdx: the "Government and Research Indexes" section is now the one place for the numbers. It covers:
    • the plan table, and keyless counted per IP;
    • which routes count toward each index, including Alexandria batches;
    • the 00:00 UTC reset, and how soon an upgrade takes effect;
    • a sample 429 body with limit, used, resetsAt and upgradeUrl, and how to tell it from a per-minute 429.
  • features/gov.mdx, features/research.mdx, api-reference/endpoint/gov-search.mdx and features/alexandria.mdx each have one sentence on the limit and link to that section.

Merge order

Merge after firecrawl/firecrawl#5160 is deployed. Until then, production still runs the flat 500-a-day gov limit, and research has no limit.

Show me

flowchart LR
    A["Gov guide and endpoint docs"] --> C["Daily-limit guide"]
    B["Research and Alexandria docs"] --> C
    C --> D["Plan tiers and counted routes"]
    C --> E["UTC reset and 429 response"]
Loading

Documentation only; API enforcement is delivered separately in firecrawl/firecrawl#5160.

@mintlify

mintlify Bot commented Oct 15, 2026 •

Copy link
Copy Markdown
Contributor

Preview deployment for your docs. Learn more about Mintlify Previews.

Project Status Preview Updated
firecrawl 🟢 Ready View Preview Oct 22, 2026, 4:34 PM

💡 Tip: Enable Automations to automatically generate PRs for you.

Kris Oei and others added 5 commits October 22, 2026 09:30
Each team can make 500 Government Index calls per UTC day, shared across
/search/gov, the gov category on /search and the Government Index provider,
with each call in a provider batch counted. Requests past the cap return 429
with Retry-After.
…exes

The rate limits page now covers both free indexes: 1,000 calls a day on
Free, Hobby and Standard, 2,000 on Growth, unlimited on Scale and
Enterprise. It lists what counts toward each index, shows the 429 body
and its fields, and explains how to tell it from a per-minute limit. The
gov, research, gov search and Alexandria pages link to it.
…tely

Drop the offer of extra calls on the current plan, which support cannot grant, and say that calls which still fit in the remaining limit are admitted before the reset.
Invalid requests and replayed Alexandria requests do not use the daily index limit; calls that reach the index count even when it errors.
A Government Index request the index itself rejects with 400 has already
been counted, so say which rejections are free.

This branch was successfully deployed

1 active deployment
staging — a9189b09 Deployed Oct 22, 2026 by mintlify[bot]
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant