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 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 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 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: naics