Government publications establish legal and administrative facts; official statistics and audited datasets establish outcomes; peer-reviewed methods estimate counterfactual effects. Commercial data may supplement, but a member of the public must be able to audit every headline claim from public sources. Each dataset carries a structured source profile.
Inventory rendered live from @gii/sources — 24 profiles.
Profiles by evidence tier
The hierarchy is a rule about what may establish what: journalism can surface a decision but never establishes the controlling text or the causal estimate.
- official statistics1563%
- authoritative decision938%
24 profiles in total · The hierarchy
Profiles feeding each impact domain
A source usually feeds more than one domain, so these sum past the inventory size. A domain with thin coverage is a domain whose outcomes are hard to observe.
30 profile-domain links in total · The inventory
Source hierarchy#
| Tier | Role |
|---|---|
| 1. authoritative decision | Authoritative government decision records. |
| 2. official statistics | Official statistics and administrative data. |
| 3. peer evaluation | Reproducible peer-reviewed or independent evaluations. |
| 4. audited third party | Audited third-party and sector data. |
| 5. commercial | Optional commercial datasets with disclosed restrictions. |
| 6. journalism stakeholder | Journalism, stakeholder statements, and advocacy — for discovery, context, or claims requiring verification. |
News coverage never establishes the controlling legal text or the causal estimate; stakeholder data keep the publisher, incentives, methods, sample, and limitations visible.
Source profiles#
Each authoritative decision, authority, or outcome source, and what it feeds into the pipeline:
| Source | Tier | Feeds | Access |
|---|---|---|---|
| Congress.gov API Library of Congress | authoritative decision | LEG-CONG | documented api · registration key |
| GovInfo API and bulk data U.S. Government Publishing Office | authoritative decision | LEG-CONG, JUD-SCOTUS, JUD-COA, JUD-DIST | documented api · registration key |
| Federal Register API Office of the Federal Register (NARA) / GPO | authoritative decision | EXE-PRES, EXE-AGY | documented api · no key |
| Regulations.gov API U.S. General Services Administration | authoritative decision | EXE-AGY, IND-REG | documented api · api key |
| eCFR API Office of the Federal Register / GPO | authoritative decision | EXE-AGY | documented api · no key vintage-sensitive |
| RegInfo.gov / Unified Agenda Office of Information and Regulatory Affairs (OMB) / GSA | authoritative decision | EXE-AGY, IND-REG | official bulk · no key |
| Supreme Court opinions & orders (U.S. Reports) Supreme Court of the United States / GPO (U.S. Reports) | authoritative decision | JUD-SCOTUS | official bulk · no key vintage-sensitive |
| CourtListener REST API Free Law Project (nonprofit) | authoritative decision | JUD-SCOTUS, JUD-COA, JUD-DIST | documented api · token |
| Federal Reserve (FOMC & data) Board of Governors of the Federal Reserve System | authoritative decision | FED-MON, us_economy | structured feed · registration key vintage-sensitive |
| Congressional Budget Office Congressional Budget Office | official statistics | LEG-CONG, us_economy | official bulk · no key vintage-sensitive |
| Bureau of Labor Statistics Public Data API Bureau of Labor Statistics | official statistics | people_households, us_economy, private_enterprise | documented api · registration key vintage-sensitive |
| Bureau of Economic Analysis Data API Bureau of Economic Analysis | official statistics | us_economy, international_trade | documented api · registration key vintage-sensitive |
| Census Bureau APIs U.S. Census Bureau | official statistics | people_households, private_enterprise, international_trade | documented api · registration key vintage-sensitive |
| Treasury Fiscal Data API U.S. Department of the Treasury (Bureau of the Fiscal Service) | official statistics | us_economy, public_entities | documented api · no key |
| USAspending API U.S. Department of the Treasury (Bureau of the Fiscal Service) | official statistics | INTG-IMPL, public_entities, nonprofits | documented api · no key |
| USITC DataWeb U.S. International Trade Commission | official statistics | international_trade | documented api · token vintage-sensitive |
| IRS Statistics of Income & Form 990 data Internal Revenue Service | official statistics | people_households, nonprofits | official bulk · no key |
| SEC EDGAR APIs U.S. Securities and Exchange Commission | official statistics | private_enterprise | documented api · no key |
| CMS Data API (data.cms.gov) Centers for Medicare & Medicaid Services | official statistics | people_households, public_entities | documented api · no key vintage-sensitive |
| OpenFEMA API Federal Emergency Management Agency | official statistics | public_entities, people_households | documented api · no key |
| U.S. Department of Labor API U.S. Department of Labor | official statistics | people_households, private_enterprise | documented api · registration key vintage-sensitive |
| FRED API Federal Reserve Bank of St. Louis | official statistics | us_economy | documented api · api key vintage-sensitive |
| U.S. Energy Information Administration API v2 U.S. Energy Information Administration | official statistics | us_economy, people_households, private_enterprise | documented api · registration key vintage-sensitive |
| HUD USER API U.S. Department of Housing and Urban Development (PD&R) | official statistics | people_households, public_entities | documented api · token |
Retrieval preference#
The ingestion order prefers the most structured, official, reproducible access available; scraping is a last resort under terms, robots, rate limits, and legal review:
- Documented API.
- Official bulk download.
- RSS, sitemap, or other structured official feed.
- Stable structured HTML or document extraction.
- Scraping as a last resort — with terms, robots, rate limits, change monitoring, and legal review.
Official does not mean error-free: statistical products may be revised, so first-release and latest-vintage values are both retained where revision sensitivity matters, and the vintage actually used is cited.
Machine-readable at GET /api/v1/sources (with ?origin=/?domain=/?tier= filters) or gii sources. The source-adapter framework that consumes these profiles is @gii/adapters; live ingestion follows once connectors and credentials are provisioned.