--- type: "firecrawl-provider" description: "About 16 million pages from US federal, state, county and city government sites: statutes and code sections, regulations, zoning and municipal ordinances, permits, licences and fee schedules, court filings, tax forms, procurement and agency guidance, searched as one index, with the laws and cases each page cites." use_when: "Pages of US federal, state, county and city government sites, searched as one index: statutes and code sections, regulations, zoning and municipal ordinances, business licences, permits and fee schedules, court filings, tax forms, procurement notices and agency guidance." categories: "Public records" capabilities: 1 credits_per_call: 0 --- # Government Index on Firecrawl Alexandria About 16 million pages from US federal, state, county and city government sites: statutes and code sections, regulations, zoning and municipal ordinances, permits, licences and fee schedules, court filings, tax forms, procurement and agency guidance, searched as one index, with the laws and cases each page cites. - Categories: Public records - Category index: [Public records category](https://firecrawl.dev/alexandria/agents/categories/public-records) - Provider key: `firecrawl-gov-index` - Access: Firecrawl credits - Cost: 0 credits per call ## More - [Human guide](https://firecrawl.dev/app/alexandria/firecrawl-gov-index) - [OpenAPI spec](https://firecrawl.dev/alexandria/agents/providers/firecrawl-gov-index/openapi.json) ## 1. Choose this provider when Pages of US federal, state, county and city government sites, searched as one index: statutes and code sections, regulations, zoning and municipal ordinances, business licences, permits and fee schedules, court filings, tax forms, procurement notices and agency guidance. ## 2. Minimal request Call `POST https://api.firecrawl.dev/v2/scrape` with `{ alexandria: { provider, capability, options } }`. For a batch, send `{ alexandria: [...] }` with up to 10 calls. ```json { "provider": "firecrawl-gov-index", "capability": "search", "options": { "query": "", "top_k": 10, "full_content": false } } ``` ## 3. Add provider options Use only the options needed for the task: - `query` (string, required): What to find, in plain words or the words a page would use: 'form 1040 instructions 2025', 'Travis County food truck permit'. Name the agency, state or city when the caller does. Example: `` - `top_k` (number): Pages to return, 1 to 10. Default 10. Example: `10` - `domain` (string): Restrict results to one site, for example irs.gov or texas.gov. Example: `` - `full_content` (boolean): Also return each page's main text as content. Default false. Tens of kilobytes per page; enable only when the pages will be read rather than cited. Example: `false` - `cites` (string): Keep only pages that cite this law or case. A printed citation such as '42 U.S.C. § 1983', '40 CFR part 60', '88 FR 1234', 'Pub. L. 111-148' or '5 U.S. 137', or an id from a result's cites or cited_as such as 'us:usc:42:1983'. Finds the rules, guidance and decisions that apply or interpret a provision. Example: `` - `jurisdiction` (string): Keep only pages of one jurisdiction: 'us' for federal, 'us-' plus a state's or territory's two-letter code, for example 'us-ca' or 'us-dc'. Example: `` - `court` (string): Keep only pages on one federal court's site, by CourtListener court id, for example 'scotus', 'ca9' or 'nysd'. Example: `` - `year_from` (number): Keep only pages published or filed in this year or later, not by crawl time (updated_at). Pages with no known date are left out. Example: `1000` - `year_to` (number): Keep only pages published or filed in this year or earlier, not by crawl time (updated_at). Pages with no known date are left out. Example: `1000` ## 4. Request through your preferred interface ### JavaScript ```javascript const result = await firecrawl.scrape({ alexandria: { provider: "firecrawl-gov-index", capability: "search", options: { query: "", top_k: 10, full_content: false, }, }, }); ``` ### Python ```python result = firecrawl.scrape_alexandria({ "provider": "firecrawl-gov-index", "capability": "search", "options": { "query": "", "top_k": 10, "full_content": False } }) ``` ### cURL ```sh curl https://api.firecrawl.dev/v2/scrape \ -H "Authorization: Bearer $FIRECRAWL_API_KEY" \ -H "Content-Type: application/json" \ -d '{ "alexandria": { "provider": "firecrawl-gov-index", "capability": "search", "options": { "query": "", "top_k": 10, "full_content": false } } }' ``` ### CLI ```sh firecrawl scrape 'firecrawl-gov-index/search' \ --options '{"query":"","top_k":10,"full_content":false}' ``` ### MCP Call the FCX MCP retrieve tool with this object: ```json { "provider": "firecrawl-gov-index", "capability": "search", "options": { "query": "", "top_k": 10, "full_content": false } } ``` Ask for only the returned fields needed by the task. ## 5. Full request shape ```json { "provider": "firecrawl-gov-index", "capability": "search", "options": { "query": "", "top_k": 10, "full_content": false } } ``` ## 6. Response data The response includes `success`, `provider`, `capability`, `creditsCost` and `data`. This example shows the provider payload in `data`: ```json { "data": [ { "url": "", "title": "", "snippet": "<snippet>", "updated_at": 0, "lang": "<lang>", "content": "<content>", "cites": [], "cited_as": [], "jurisdiction": "<jurisdiction>", "court": "<court>" } ] } ``` ## API reference-derived contract The following capability contract is generated from the same normalized Alexandria API reference exposed in the API spec. ### Search government pages - Capability: `search` - Description: Matching government pages, best first, each with its URL, title, a snippet around the match, and where known the laws and cases it cites and its jurisdiction. - Instructions: Use first for any US government, legal, tax, court, permit, statute, regulation, grant or procurement question, before web search: what a city's zoning or planning code allows at an address, which business licence, permit, inspection or fee a city or county requires to open a shop, restaurant, food truck or mobile service, the text of a state code section or municipal ordinance, the official page for a form or program, or the regulations, guidance and decisions that cite a statute (set cites). One call searches about 16 million official pages and returns URLs to cite or scrape. For the structured record behind a page (a SAM.gov notice, a Federal Register document, a bill) use that source's own provider. - Cost: 0 credits per call - Capability file: [Search government pages](https://firecrawl.dev/alexandria/agents/providers/firecrawl-gov-index/search) Accepted options: - `query` (string, required): What to find, in plain words or the words a page would use: 'form 1040 instructions 2025', 'Travis County food truck permit'. Name the agency, state or city when the caller does. Example: `<query>` - `top_k` (number): Pages to return, 1 to 10. Default 10. Example: `10` - `domain` (string): Restrict results to one site, for example irs.gov or texas.gov. Example: `<domain>` - `full_content` (boolean): Also return each page's main text as content. Default false. Tens of kilobytes per page; enable only when the pages will be read rather than cited. Example: `false` - `cites` (string): Keep only pages that cite this law or case. A printed citation such as '42 U.S.C. § 1983', '40 CFR part 60', '88 FR 1234', 'Pub. L. 111-148' or '5 U.S. 137', or an id from a result's cites or cited_as such as 'us:usc:42:1983'. Finds the rules, guidance and decisions that apply or interpret a provision. Example: `<cites>` - `jurisdiction` (string): Keep only pages of one jurisdiction: 'us' for federal, 'us-' plus a state's or territory's two-letter code, for example 'us-ca' or 'us-dc'. Example: `<jurisdiction>` - `court` (string): Keep only pages on one federal court's site, by CourtListener court id, for example 'scotus', 'ca9' or 'nysd'. Example: `<court>` - `year_from` (number): Keep only pages published or filed in this year or later, not by crawl time (updated_at). Pages with no known date are left out. Example: `1000` - `year_to` (number): Keep only pages published or filed in this year or earlier, not by crawl time (updated_at). Pages with no known date are left out. Example: `1000` Response schema example: ```json { "data": [ { "url": "<url>", "title": "<title>", "snippet": "<snippet>", "updated_at": 0, "lang": "<lang>", "content": "<content>", "cites": [], "cited_as": [], "jurisdiction": "<jurisdiction>", "court": "<court>" } ] } ```