US BLS public API. Anonymous tier (25/day, ≤25 ids, ≤10y) toggle-on. BLS_API_KEY raises caps to 500/day, ≤50/≤20y + unlocks calculations + catalog. - getSeries ⭐ single id + year range - getMultipleSeries ⭐ POST multi, caps validated upfront - findIndustrialSeries ⭐ curated NAICS↔seriesId map (~50 entries, no upstream call) - listSurveys ⭐ all 73 surveys; getSurvey, getPopularSeries, getServiceInfo Differentiator: programmatic NAICS-to-seriesId drifts from BLS docs; BLS exposes no NAICS lookup. Map covers O&G 211, Drilling 213111, Support 213112, Refineries 32411, Pipelines 4861/4862, PPI commodities, state LAUS. upstream quirk: errors hide in HTTP 200 — message[] says "Series X does not exist" while status=REQUEST_SUCCEEDED.
7 methodsFreshness not declaredUS transportation infrastructure — National Transportation Atlas Database. No auth. - searchRailLines (~302K) ⭐ Class I owners (BNSF/UP/CSXT/NS/CN/CPKC), passenger flag - searchPorts (175) ⭐ vessel calls + gross tonnage by coast region - searchLocksAndDams (~196 lock-bearing default; ~92K all dams) ⭐ NID - searchAirports (~19.4K FAA) airports/heliports/seaplane bases - searchIntermodalTerminals (pipeline 1.4K / liquid bulk 640 / rail TOFC 241 / RoRo 84) - getServiceInfo upstream quirks: dams layer uses full state names not codes; pipeline terminals use Y/N/NA on CRUDE_OIL/REFINED; liquid bulk uses 'Y' and most attribute columns are sparse; rail uses 3-digit CNTYFIPS suffix without state prefix.
6 methodsFreshness not declaredUS imports & exports time series — Census Foreign Trade (no auth). 8 endpoints (hs / porths / statehs / naics × imports / exports). searchExports / searchImports filter HS or NAICS + country + month. searchTradeByPort and searchTradeByState slice by US port / state. getTradeBalance fetches both directions in parallel. getCountryCodes is a built-in CTY_CODE↔ISO map (top 30 partners + USMCA/OECD/NATO/APEC). lookupHsCode is a chapter index (27 fuels, 28/29/39 chem, 72/73 steel, 84/85 machinery, 26 ores). upstream quirk: exports use ALL_VAL_MO + E_COMMODITY; imports use GEN_VAL_MO + I_COMMODITY — search dispatches on direction. upstream quirk: country codes are Census Schedule C/D — NOT ISO. Mexico=2010, Canada=1220, China=5700. Optional CENSUS_API_KEY raises the 500/day per-IP cap.
8 methodsFreshness not declaredNOAA CO-OPS — water levels, tide predictions, currents, coastal met. No auth. - searchStations ⭐ NWLON 301 + tidepredictions 3.4K / currentpredictions 4.4K / historicwl 2.9K / watertemp / met / harcon - getStation (expand: datums | sensors | harcon | products) - getWaterLevels ⭐ observed (preliminary + verified). 31-day cap. - getTidePredictions ⭐ hi/lo (365d) or 6-min (31d) / hourly (365d). - getMeteorological ⭐ wind / air_temperature / water_temperature / air_pressure - getServiceInfo upstream quirks: HTTP 200 + body {error:{message}} on bad input — check body. 3 response shapes (water_level, predictions, currents_predictions). Datums product removed — discover via mdapi expand. Long-period stations only support hourly_height/high_low; Great Lakes accepts IGLD.
6 methodsFreshness not declaredFederal disaster declarations (1953-present, ~70K rows), NFIP flood-insurance claims (~2.7M anonymized claims back to 1973), Public Assistance funded project details (~898K), and IPAWS archived public emergency alerts (~4.8M) from FEMA. Pivot a hurricane disasterNumber to the funded projects awarded for response, or a county to its NFIP claim history. Toggle on and use — no setup needed.
5 methodsFreshness not declaredUS Army Corps of Engineers public datasets. No auth. - searchDams (NID, ~91k dams via bulk CSV, 24h cache) - getRegulatoryDistrict (point lookup → 1 of 39 districts for Section 404 routing) - searchLevees, searchLocksAndDams, searchNavigationFacilities, searchFUDS, searchCorpsProjects - getWetlandRegion (point lookup → wetland supplement region) - getReservoirStatus (CWMS — current pool % for flood/conservation/total) Federal scope: dams, levees, locks, navigation, defense cleanup, civil works projects, reservoir pool levels, wetland-rule supplements. IENC layers have no state/county columns — use bbox or near. CWMS reservoirs and Corps projects also lack STATE; state filters fall back to bbox or district mapping.
10 methodsFreshness not declaredFederal spending transparency — every prime award since FY2008 (Treasury/OMB). No auth. - searchAwards ⭐ filter recipient, NAICS, agency, place - getAwardById ⭐ full record by generated_internal_id - searchByRecipient ⭐ recipient-name fuzzy wrapper - searchByNaics ⭐ NAICS (oil-svcs 21 / 2111 / 213111) - searchByAgency by toptier_code (089 DOE, 097 DoD) - getRecipientById profile (-C/-P/-R suffix) - autocompleteRecipient fuzzy name -> hits - getServiceInfo taxonomy + agencies + NAICS upstream quirk: award_type_codes MUST be a single group per call (mixed groups → 422). Pass awardTypeGroup (contracts | idvs | grants | loans | direct_payments | other_financial_assistance); handler rejects mixed groups. upstream quirk: limit caps at 100; page 1-indexed; time_period floor 2007-10-01.
8 methodsFreshness not declaredUSGS MRDS + USMIN — global mineral deposits + US mine-feature points (no auth). Upstream (MapServer WFS 2.0.0): - /services/wfs/mrds — ms:mrds (~304K worldwide deposits) - /services/wfs/usmin — ms:points + ms:polygons (US only) Rich per-record JSON: /mrds/json/{dep_id} returns 26+ subtables (commodities, materials, ages, ore body, production, references, rocks). Filters: commodity (CU/AU/AG/FE/LI/U/REE/PGE…), country (FIPS), US state, dev_stat (Past Producer/Producer/Occurrence/Prospect/Plant/Raw Prospect), bbox. §0 quirks: CQL_FILTER silently ignored by MapServer — handler emits OGC FILTER= XML (fes:Filter). fips_code stored with literal "f" prefix (fCI / f06065). code_list space-separated with leading space.
6 methodsFreshness not declared
Knowledge
Know your data sources.
The public data contract for every source PatchOps exposes over MCP: provenance, freshness, coverage, caveats, and per-method schemas. Also available as JSON at /api/knowledge/data-sources.
tag: federal