data-analyst-mcp 0.0.0-stage → 0.3.0
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/README.md +262 -3
- package/dist/adapters/_acf_tidy.d.ts +18 -0
- package/dist/adapters/_acf_tidy.js +432 -0
- package/dist/adapters/_acf_tidy.js.map +1 -0
- package/dist/adapters/_actuaries_read.d.ts +38 -0
- package/dist/adapters/_actuaries_read.js +728 -0
- package/dist/adapters/_actuaries_read.js.map +1 -0
- package/dist/adapters/_census_micro.d.ts +70 -0
- package/dist/adapters/_census_micro.js +622 -0
- package/dist/adapters/_census_micro.js.map +1 -0
- package/dist/adapters/_census_util.d.ts +40 -0
- package/dist/adapters/_census_util.js +275 -0
- package/dist/adapters/_census_util.js.map +1 -0
- package/dist/adapters/_dol_states.d.ts +6 -0
- package/dist/adapters/_dol_states.js +58 -0
- package/dist/adapters/_dol_states.js.map +1 -0
- package/dist/adapters/_govinfo_entities.d.ts +4 -0
- package/dist/adapters/_govinfo_entities.js +6 -0
- package/dist/adapters/_govinfo_entities.js.map +1 -0
- package/dist/adapters/_govinfo_json.d.ts +13 -0
- package/dist/adapters/_govinfo_json.js +107 -0
- package/dist/adapters/_govinfo_json.js.map +1 -0
- package/dist/adapters/_govinfo_py.d.ts +22 -0
- package/dist/adapters/_govinfo_py.js +272 -0
- package/dist/adapters/_govinfo_py.js.map +1 -0
- package/dist/adapters/_govinfo_xml.d.ts +22 -0
- package/dist/adapters/_govinfo_xml.js +233 -0
- package/dist/adapters/_govinfo_xml.js.map +1 -0
- package/dist/adapters/_hud_excel.d.ts +2 -0
- package/dist/adapters/_hud_excel.js +166 -0
- package/dist/adapters/_hud_excel.js.map +1 -0
- package/dist/adapters/_omb_grid.d.ts +17 -0
- package/dist/adapters/_omb_grid.js +132 -0
- package/dist/adapters/_omb_grid.js.map +1 -0
- package/dist/adapters/_omb_util.d.ts +40 -0
- package/dist/adapters/_omb_util.js +192 -0
- package/dist/adapters/_omb_util.js.map +1 -0
- package/dist/adapters/_usaspending_state.d.ts +6 -0
- package/dist/adapters/_usaspending_state.js +54 -0
- package/dist/adapters/_usaspending_state.js.map +1 -0
- package/dist/adapters/_usda-fna_book.d.ts +59 -0
- package/dist/adapters/_usda-fna_book.js +869 -0
- package/dist/adapters/_usda-fna_book.js.map +1 -0
- package/dist/adapters/_usda-fna_pdf.d.ts +20 -0
- package/dist/adapters/_usda-fna_pdf.js +361 -0
- package/dist/adapters/_usda-fna_pdf.js.map +1 -0
- package/dist/adapters/_usda-outlook_read.d.ts +70 -0
- package/dist/adapters/_usda-outlook_read.js +362 -0
- package/dist/adapters/_usda-outlook_read.js.map +1 -0
- package/dist/adapters/acf.d.ts +3 -0
- package/dist/adapters/acf.js +187 -0
- package/dist/adapters/acf.js.map +1 -0
- package/dist/adapters/actuaries.d.ts +3 -0
- package/dist/adapters/actuaries.js +293 -0
- package/dist/adapters/actuaries.js.map +1 -0
- package/dist/adapters/bts.d.ts +3 -0
- package/dist/adapters/bts.js +26 -0
- package/dist/adapters/bts.js.map +1 -0
- package/dist/adapters/census-geocoder.d.ts +10 -0
- package/dist/adapters/census-geocoder.js +47 -0
- package/dist/adapters/census-geocoder.js.map +1 -0
- package/dist/adapters/census.d.ts +17 -0
- package/dist/adapters/census.js +983 -0
- package/dist/adapters/census.js.map +1 -0
- package/dist/adapters/cfpb.d.ts +7 -0
- package/dist/adapters/cfpb.js +348 -0
- package/dist/adapters/cfpb.js.map +1 -0
- package/dist/adapters/clinical-trials.d.ts +3 -0
- package/dist/adapters/clinical-trials.js +135 -0
- package/dist/adapters/clinical-trials.js.map +1 -0
- package/dist/adapters/cms.d.ts +3 -0
- package/dist/adapters/cms.js +292 -0
- package/dist/adapters/cms.js.map +1 -0
- package/dist/adapters/college-scorecard.d.ts +3 -0
- package/dist/adapters/college-scorecard.js +122 -0
- package/dist/adapters/college-scorecard.js.map +1 -0
- package/dist/adapters/congress.d.ts +33 -0
- package/dist/adapters/congress.js +589 -0
- package/dist/adapters/congress.js.map +1 -0
- package/dist/adapters/dhs-ohss.d.ts +13 -0
- package/dist/adapters/dhs-ohss.js +598 -0
- package/dist/adapters/dhs-ohss.js.map +1 -0
- package/dist/adapters/doj-news.d.ts +7 -0
- package/dist/adapters/doj-news.js +286 -0
- package/dist/adapters/doj-news.js.map +1 -0
- package/dist/adapters/dol.d.ts +4 -0
- package/dist/adapters/dol.js +634 -0
- package/dist/adapters/dol.js.map +1 -0
- package/dist/adapters/eia.d.ts +15 -0
- package/dist/adapters/eia.js +456 -0
- package/dist/adapters/eia.js.map +1 -0
- package/dist/adapters/epa-aqs.d.ts +3 -0
- package/dist/adapters/epa-aqs.js +357 -0
- package/dist/adapters/epa-aqs.js.map +1 -0
- package/dist/adapters/epa.d.ts +3 -0
- package/dist/adapters/epa.js +298 -0
- package/dist/adapters/epa.js.map +1 -0
- package/dist/adapters/fbi.d.ts +3 -0
- package/dist/adapters/fbi.js +192 -0
- package/dist/adapters/fbi.js.map +1 -0
- package/dist/adapters/fda.d.ts +5 -0
- package/dist/adapters/fda.js +184 -0
- package/dist/adapters/fda.js.map +1 -0
- package/dist/adapters/fdic.d.ts +4 -0
- package/dist/adapters/fdic.js +95 -0
- package/dist/adapters/fdic.js.map +1 -0
- package/dist/adapters/fec.d.ts +3 -0
- package/dist/adapters/fec.js +142 -0
- package/dist/adapters/fec.js.map +1 -0
- package/dist/adapters/fed-board.d.ts +12 -0
- package/dist/adapters/fed-board.js +581 -0
- package/dist/adapters/fed-board.js.map +1 -0
- package/dist/adapters/federal-register.d.ts +11 -0
- package/dist/adapters/federal-register.js +43 -0
- package/dist/adapters/federal-register.js.map +1 -0
- package/dist/adapters/fhfa.d.ts +3 -0
- package/dist/adapters/fhfa.js +253 -0
- package/dist/adapters/fhfa.js.map +1 -0
- package/dist/adapters/fsa.d.ts +9 -0
- package/dist/adapters/fsa.js +335 -0
- package/dist/adapters/fsa.js.map +1 -0
- package/dist/adapters/govinfo.d.ts +30 -0
- package/dist/adapters/govinfo.js +636 -0
- package/dist/adapters/govinfo.js.map +1 -0
- package/dist/adapters/gsa-calc.d.ts +10 -0
- package/dist/adapters/gsa-calc.js +318 -0
- package/dist/adapters/gsa-calc.js.map +1 -0
- package/dist/adapters/hud.d.ts +3 -0
- package/dist/adapters/hud.js +200 -0
- package/dist/adapters/hud.js.map +1 -0
- package/dist/adapters/index.d.ts +3 -0
- package/dist/adapters/index.js +25 -0
- package/dist/adapters/index.js.map +1 -0
- package/dist/adapters/irs-soi.d.ts +6 -0
- package/dist/adapters/irs-soi.js +576 -0
- package/dist/adapters/irs-soi.js.map +1 -0
- package/dist/adapters/naep.d.ts +15 -0
- package/dist/adapters/naep.js +341 -0
- package/dist/adapters/naep.js.map +1 -0
- package/dist/adapters/nhtsa.d.ts +10 -0
- package/dist/adapters/nhtsa.js +239 -0
- package/dist/adapters/nhtsa.js.map +1 -0
- package/dist/adapters/nih.d.ts +5 -0
- package/dist/adapters/nih.js +196 -0
- package/dist/adapters/nih.js.map +1 -0
- package/dist/adapters/noaa.d.ts +3 -0
- package/dist/adapters/noaa.js +148 -0
- package/dist/adapters/noaa.js.map +1 -0
- package/dist/adapters/nrel.d.ts +3 -0
- package/dist/adapters/nrel.js +186 -0
- package/dist/adapters/nrel.js.map +1 -0
- package/dist/adapters/nws.d.ts +3 -0
- package/dist/adapters/nws.js +119 -0
- package/dist/adapters/nws.js.map +1 -0
- package/dist/adapters/omb.d.ts +15 -0
- package/dist/adapters/omb.js +517 -0
- package/dist/adapters/omb.js.map +1 -0
- package/dist/adapters/open-payments.d.ts +5 -0
- package/dist/adapters/open-payments.js +149 -0
- package/dist/adapters/open-payments.js.map +1 -0
- package/dist/adapters/pbgc.d.ts +13 -0
- package/dist/adapters/pbgc.js +283 -0
- package/dist/adapters/pbgc.js.map +1 -0
- package/dist/adapters/philfed.d.ts +12 -0
- package/dist/adapters/philfed.js +59 -0
- package/dist/adapters/philfed.js.map +1 -0
- package/dist/adapters/regulations.d.ts +6 -0
- package/dist/adapters/regulations.js +58 -0
- package/dist/adapters/regulations.js.map +1 -0
- package/dist/adapters/sec.d.ts +13 -0
- package/dist/adapters/sec.js +504 -0
- package/dist/adapters/sec.js.map +1 -0
- package/dist/adapters/senate-lobbying.d.ts +3 -0
- package/dist/adapters/senate-lobbying.js +181 -0
- package/dist/adapters/senate-lobbying.js.map +1 -0
- package/dist/adapters/snapqc.d.ts +32 -0
- package/dist/adapters/snapqc.js +701 -0
- package/dist/adapters/snapqc.js.map +1 -0
- package/dist/adapters/treasury-yields.d.ts +3 -0
- package/dist/adapters/treasury-yields.js +170 -0
- package/dist/adapters/treasury-yields.js.map +1 -0
- package/dist/adapters/usaspending.d.ts +3 -0
- package/dist/adapters/usaspending.js +340 -0
- package/dist/adapters/usaspending.js.map +1 -0
- package/dist/adapters/usda-fna.d.ts +7 -0
- package/dist/adapters/usda-fna.js +707 -0
- package/dist/adapters/usda-fna.js.map +1 -0
- package/dist/adapters/usda-fooddata.d.ts +3 -0
- package/dist/adapters/usda-fooddata.js +101 -0
- package/dist/adapters/usda-fooddata.js.map +1 -0
- package/dist/adapters/usda-nass.d.ts +3 -0
- package/dist/adapters/usda-nass.js +108 -0
- package/dist/adapters/usda-nass.js.map +1 -0
- package/dist/adapters/usda-outlook.d.ts +12 -0
- package/dist/adapters/usda-outlook.js +696 -0
- package/dist/adapters/usda-outlook.js.map +1 -0
- package/dist/adapters/usgs.d.ts +9 -0
- package/dist/adapters/usgs.js +265 -0
- package/dist/adapters/usgs.js.map +1 -0
- package/dist/adapters/usitc.d.ts +18 -0
- package/dist/adapters/usitc.js +170 -0
- package/dist/adapters/usitc.js.map +1 -0
- package/dist/adapters/uspto.d.ts +3 -0
- package/dist/adapters/uspto.js +47 -0
- package/dist/adapters/uspto.js.map +1 -0
- package/dist/adapters/world-bank.d.ts +3 -0
- package/dist/adapters/world-bank.js +163 -0
- package/dist/adapters/world-bank.js.map +1 -0
- package/dist/analysis/cite.d.ts +31 -0
- package/dist/analysis/cite.js +229 -0
- package/dist/analysis/cite.js.map +1 -0
- package/dist/analysis/combine.d.ts +27 -0
- package/dist/analysis/combine.js +198 -0
- package/dist/analysis/combine.js.map +1 -0
- package/dist/analysis/compute.d.ts +62 -0
- package/dist/analysis/compute.js +583 -0
- package/dist/analysis/compute.js.map +1 -0
- package/dist/analysis/expr.d.ts +69 -0
- package/dist/analysis/expr.js +780 -0
- package/dist/analysis/expr.js.map +1 -0
- package/dist/analysis/factfmt.d.ts +16 -0
- package/dist/analysis/factfmt.js +187 -0
- package/dist/analysis/factfmt.js.map +1 -0
- package/dist/analysis/facts.d.ts +63 -0
- package/dist/analysis/facts.js +355 -0
- package/dist/analysis/facts.js.map +1 -0
- package/dist/analysis/handoff.d.ts +58 -0
- package/dist/analysis/handoff.js +208 -0
- package/dist/analysis/handoff.js.map +1 -0
- package/dist/analysis/pyfmt.d.ts +16 -0
- package/dist/analysis/pyfmt.js +156 -0
- package/dist/analysis/pyfmt.js.map +1 -0
- package/dist/analysis/rerun.d.ts +13 -0
- package/dist/analysis/rerun.js +125 -0
- package/dist/analysis/rerun.js.map +1 -0
- package/dist/analysis/table.d.ts +18 -0
- package/dist/analysis/table.js +109 -0
- package/dist/analysis/table.js.map +1 -0
- package/dist/analysis/tools.d.ts +67 -0
- package/dist/analysis/tools.js +217 -0
- package/dist/analysis/tools.js.map +1 -0
- package/dist/analysis/write_table.d.ts +13 -0
- package/dist/analysis/write_table.js +59 -0
- package/dist/analysis/write_table.js.map +1 -0
- package/dist/bin/cli.d.ts +10 -0
- package/dist/bin/cli.js +177 -0
- package/dist/bin/cli.js.map +1 -0
- package/dist/core/cache.d.ts +14 -0
- package/dist/core/cache.js +90 -0
- package/dist/core/cache.js.map +1 -0
- package/dist/core/context.d.ts +12 -0
- package/dist/core/context.js +15 -0
- package/dist/core/context.js.map +1 -0
- package/dist/core/env.d.ts +14 -0
- package/dist/core/env.js +52 -0
- package/dist/core/env.js.map +1 -0
- package/dist/core/generic-rest.d.ts +61 -0
- package/dist/core/generic-rest.js +639 -0
- package/dist/core/generic-rest.js.map +1 -0
- package/dist/core/http.d.ts +120 -0
- package/dist/core/http.js +514 -0
- package/dist/core/http.js.map +1 -0
- package/dist/core/keys.d.ts +43 -0
- package/dist/core/keys.js +174 -0
- package/dist/core/keys.js.map +1 -0
- package/dist/core/manual.d.ts +41 -0
- package/dist/core/manual.js +218 -0
- package/dist/core/manual.js.map +1 -0
- package/dist/core/package.d.ts +58 -0
- package/dist/core/package.js +228 -0
- package/dist/core/package.js.map +1 -0
- package/dist/core/packs.d.ts +139 -0
- package/dist/core/packs.js +173 -0
- package/dist/core/packs.js.map +1 -0
- package/dist/core/policy.d.ts +69 -0
- package/dist/core/policy.js +189 -0
- package/dist/core/policy.js.map +1 -0
- package/dist/core/py.d.ts +40 -0
- package/dist/core/py.js +171 -0
- package/dist/core/py.js.map +1 -0
- package/dist/core/routing.d.ts +10 -0
- package/dist/core/routing.js +39 -0
- package/dist/core/routing.js.map +1 -0
- package/dist/core/tabular.d.ts +21 -0
- package/dist/core/tabular.js +229 -0
- package/dist/core/tabular.js.map +1 -0
- package/dist/deep/_bea_api.d.ts +102 -0
- package/dist/deep/_bea_api.js +457 -0
- package/dist/deep/_bea_api.js.map +1 -0
- package/dist/deep/_bea_fetch.d.ts +151 -0
- package/dist/deep/_bea_fetch.js +1274 -0
- package/dist/deep/_bea_fetch.js.map +1 -0
- package/dist/deep/_bea_util.d.ts +14 -0
- package/dist/deep/_bea_util.js +156 -0
- package/dist/deep/_bea_util.js.map +1 -0
- package/dist/deep/_bls_api.d.ts +84 -0
- package/dist/deep/_bls_api.js +231 -0
- package/dist/deep/_bls_api.js.map +1 -0
- package/dist/deep/_bls_ids.d.ts +43 -0
- package/dist/deep/_bls_ids.js +188 -0
- package/dist/deep/_bls_ids.js.map +1 -0
- package/dist/deep/_bls_lib.d.ts +61 -0
- package/dist/deep/_bls_lib.js +442 -0
- package/dist/deep/_bls_lib.js.map +1 -0
- package/dist/deep/_fred_api.d.ts +148 -0
- package/dist/deep/_fred_api.js +545 -0
- package/dist/deep/_fred_api.js.map +1 -0
- package/dist/deep/_fred_pack.d.ts +162 -0
- package/dist/deep/_fred_pack.js +1027 -0
- package/dist/deep/_fred_pack.js.map +1 -0
- package/dist/deep/_fred_py.d.ts +40 -0
- package/dist/deep/_fred_py.js +199 -0
- package/dist/deep/_fred_py.js.map +1 -0
- package/dist/deep/_ipums_bundle.d.ts +29 -0
- package/dist/deep/_ipums_bundle.js +194 -0
- package/dist/deep/_ipums_bundle.js.map +1 -0
- package/dist/deep/_ipums_ddi.d.ts +23 -0
- package/dist/deep/_ipums_ddi.js +162 -0
- package/dist/deep/_ipums_ddi.js.map +1 -0
- package/dist/deep/_opm_io.d.ts +26 -0
- package/dist/deep/_opm_io.js +383 -0
- package/dist/deep/_opm_io.js.map +1 -0
- package/dist/deep/_opm_parquet.d.ts +31 -0
- package/dist/deep/_opm_parquet.js +744 -0
- package/dist/deep/_opm_parquet.js.map +1 -0
- package/dist/deep/_opm_py.d.ts +6 -0
- package/dist/deep/_opm_py.js +74 -0
- package/dist/deep/_opm_py.js.map +1 -0
- package/dist/deep/_treasury_api.d.ts +48 -0
- package/dist/deep/_treasury_api.js +221 -0
- package/dist/deep/_treasury_api.js.map +1 -0
- package/dist/deep/_treasury_context.d.ts +34 -0
- package/dist/deep/_treasury_context.js +142 -0
- package/dist/deep/_treasury_context.js.map +1 -0
- package/dist/deep/_treasury_lib.d.ts +109 -0
- package/dist/deep/_treasury_lib.js +686 -0
- package/dist/deep/_treasury_lib.js.map +1 -0
- package/dist/deep/bea.d.ts +3 -0
- package/dist/deep/bea.js +248 -0
- package/dist/deep/bea.js.map +1 -0
- package/dist/deep/bls.d.ts +3 -0
- package/dist/deep/bls.js +220 -0
- package/dist/deep/bls.js.map +1 -0
- package/dist/deep/fred.d.ts +3 -0
- package/dist/deep/fred.js +325 -0
- package/dist/deep/fred.js.map +1 -0
- package/dist/deep/ipums.d.ts +59 -0
- package/dist/deep/ipums.js +744 -0
- package/dist/deep/ipums.js.map +1 -0
- package/dist/deep/opm.d.ts +56 -0
- package/dist/deep/opm.js +1033 -0
- package/dist/deep/opm.js.map +1 -0
- package/dist/deep/treasury.d.ts +3 -0
- package/dist/deep/treasury.js +218 -0
- package/dist/deep/treasury.js.map +1 -0
- package/dist/envelope.d.ts +47 -0
- package/dist/envelope.js +88 -0
- package/dist/envelope.js.map +1 -0
- package/dist/index.d.ts +277 -0
- package/dist/index.js +106 -0
- package/dist/index.js.map +1 -0
- package/dist/remote/app.d.ts +21 -0
- package/dist/remote/app.js +218 -0
- package/dist/remote/app.js.map +1 -0
- package/dist/remote/oauth.d.ts +14 -0
- package/dist/remote/oauth.js +90 -0
- package/dist/remote/oauth.js.map +1 -0
- package/dist/remote/pages.d.ts +8 -0
- package/dist/remote/pages.js +56 -0
- package/dist/remote/pages.js.map +1 -0
- package/dist/remote/sign.d.ts +4 -0
- package/dist/remote/sign.js +40 -0
- package/dist/remote/sign.js.map +1 -0
- package/dist/remote/store.d.ts +31 -0
- package/dist/remote/store.js +129 -0
- package/dist/remote/store.js.map +1 -0
- package/dist/report/audit_answer.d.ts +94 -0
- package/dist/report/audit_answer.js +1349 -0
- package/dist/report/audit_answer.js.map +1 -0
- package/dist/report/audit_report.d.ts +23 -0
- package/dist/report/audit_report.js +637 -0
- package/dist/report/audit_report.js.map +1 -0
- package/dist/report/build_report.d.ts +27 -0
- package/dist/report/build_report.js +1168 -0
- package/dist/report/build_report.js.map +1 -0
- package/dist/report/method_audit.d.ts +47 -0
- package/dist/report/method_audit.js +710 -0
- package/dist/report/method_audit.js.map +1 -0
- package/dist/report/policyset.d.ts +50 -0
- package/dist/report/policyset.js +421 -0
- package/dist/report/policyset.js.map +1 -0
- package/dist/report/py.d.ts +58 -0
- package/dist/report/py.js +311 -0
- package/dist/report/py.js.map +1 -0
- package/dist/report/scan_secrets.d.ts +21 -0
- package/dist/report/scan_secrets.js +234 -0
- package/dist/report/scan_secrets.js.map +1 -0
- package/dist/report/style_check.d.ts +29 -0
- package/dist/report/style_check.js +173 -0
- package/dist/report/style_check.js.map +1 -0
- package/dist/report/tools.d.ts +87 -0
- package/dist/report/tools.js +167 -0
- package/dist/report/tools.js.map +1 -0
- package/dist/server.d.ts +5 -0
- package/dist/server.js +246 -0
- package/dist/server.js.map +1 -0
- package/dist/session.d.ts +47 -0
- package/dist/session.js +107 -0
- package/dist/session.js.map +1 -0
- package/dist/toolkit.d.ts +21 -0
- package/dist/toolkit.js +2 -0
- package/dist/toolkit.js.map +1 -0
- package/dist/tools.d.ts +299 -0
- package/dist/tools.js +491 -0
- package/dist/tools.js.map +1 -0
- package/guide/WORKFLOW.md +134 -0
- package/guide/assets/disclaimer.txt +1 -0
- package/guide/assets/download_data.ps1 +162 -0
- package/guide/assets/download_data.sh +143 -0
- package/guide/assets/report_template.html +597 -0
- package/guide/references/report_patterns.md +199 -0
- package/guide/references/routing.md +171 -0
- package/guide/references/style_guide.md +398 -0
- package/package.json +56 -6
- package/packs/acf/endpoints.json +114 -0
- package/packs/acf/policy.json +104 -0
- package/packs/acf/source.md +138 -0
- package/packs/actuaries/endpoints.json +82 -0
- package/packs/actuaries/policy.json +109 -0
- package/packs/actuaries/source.md +137 -0
- package/packs/bea/assets/download_bea.ps1 +182 -0
- package/packs/bea/assets/download_bea.sh +144 -0
- package/packs/bea/docs/bea_api.md +461 -0
- package/packs/bea/docs/datasets.md +157 -0
- package/packs/bea/docs/report_patterns.md +112 -0
- package/packs/bea/policy.json +170 -0
- package/packs/bea/source.md +152 -0
- package/packs/bls/assets/download_bls.ps1 +152 -0
- package/packs/bls/assets/download_bls.sh +167 -0
- package/packs/bls/docs/analysis_patterns.md +108 -0
- package/packs/bls/docs/bls_api.md +73 -0
- package/packs/bls/docs/series_ids.md +149 -0
- package/packs/bls/policy.json +238 -0
- package/packs/bls/series_ids.json +1375 -0
- package/packs/bls/source.md +156 -0
- package/packs/bts/endpoints.json +347 -0
- package/packs/bts/policy.json +94 -0
- package/packs/bts/source.md +97 -0
- package/packs/cdc/endpoints.json +197 -0
- package/packs/cdc/policy.json +83 -0
- package/packs/cdc/source.md +74 -0
- package/packs/census/endpoints.json +99 -0
- package/packs/census/policy.json +238 -0
- package/packs/census/source.md +304 -0
- package/packs/census-geocoder/endpoints.json +70 -0
- package/packs/census-geocoder/policy.json +80 -0
- package/packs/census-geocoder/source.md +53 -0
- package/packs/cfpb/endpoints.json +327 -0
- package/packs/cfpb/policy.json +119 -0
- package/packs/cfpb/source.md +96 -0
- package/packs/clinical-trials/endpoints.json +167 -0
- package/packs/clinical-trials/policy.json +84 -0
- package/packs/clinical-trials/source.md +82 -0
- package/packs/cms/endpoints.json +69 -0
- package/packs/cms/policy.json +96 -0
- package/packs/cms/source.md +112 -0
- package/packs/college-scorecard/endpoints.json +253 -0
- package/packs/college-scorecard/policy.json +106 -0
- package/packs/college-scorecard/source.md +92 -0
- package/packs/congress/endpoints.json +1701 -0
- package/packs/congress/policy.json +117 -0
- package/packs/congress/source.md +190 -0
- package/packs/dhs-ohss/endpoints.json +66 -0
- package/packs/dhs-ohss/policy.json +107 -0
- package/packs/dhs-ohss/source.md +120 -0
- package/packs/doj-news/endpoints.json +59 -0
- package/packs/doj-news/policy.json +96 -0
- package/packs/doj-news/source.md +99 -0
- package/packs/dol/endpoints.json +818 -0
- package/packs/dol/policy.json +135 -0
- package/packs/dol/source.md +181 -0
- package/packs/eia/endpoints.json +718 -0
- package/packs/eia/policy.json +112 -0
- package/packs/eia/source.md +112 -0
- package/packs/epa/endpoints.json +292 -0
- package/packs/epa/policy.json +99 -0
- package/packs/epa/source.md +99 -0
- package/packs/epa-aqs/endpoints.json +174 -0
- package/packs/epa-aqs/policy.json +96 -0
- package/packs/epa-aqs/source.md +97 -0
- package/packs/fbi/endpoints.json +1842 -0
- package/packs/fbi/policy.json +118 -0
- package/packs/fbi/source.md +108 -0
- package/packs/fda/endpoints.json +238 -0
- package/packs/fda/policy.json +121 -0
- package/packs/fda/source.md +117 -0
- package/packs/fdic/endpoints.json +417 -0
- package/packs/fdic/policy.json +83 -0
- package/packs/fdic/source.md +92 -0
- package/packs/fec/endpoints.json +708 -0
- package/packs/fec/policy.json +93 -0
- package/packs/fec/source.md +90 -0
- package/packs/fed-board/endpoints.json +89 -0
- package/packs/fed-board/policy.json +136 -0
- package/packs/fed-board/source.md +118 -0
- package/packs/federal-register/endpoints.json +143 -0
- package/packs/federal-register/policy.json +86 -0
- package/packs/federal-register/source.md +98 -0
- package/packs/fema/endpoints.json +646 -0
- package/packs/fema/policy.json +103 -0
- package/packs/fema/source.md +103 -0
- package/packs/fhfa/endpoints.json +105 -0
- package/packs/fhfa/policy.json +109 -0
- package/packs/fhfa/source.md +108 -0
- package/packs/fred/assets/download_fred.ps1 +122 -0
- package/packs/fred/assets/download_fred.sh +123 -0
- package/packs/fred/docs/analysis_patterns.md +124 -0
- package/packs/fred/docs/fred_api.md +94 -0
- package/packs/fred/docs/series.md +188 -0
- package/packs/fred/policy.json +253 -0
- package/packs/fred/source.md +142 -0
- package/packs/fsa/endpoints.json +150 -0
- package/packs/fsa/policy.json +99 -0
- package/packs/fsa/source.md +102 -0
- package/packs/govinfo/endpoints.json +520 -0
- package/packs/govinfo/policy.json +116 -0
- package/packs/govinfo/source.md +241 -0
- package/packs/gsa-calc/endpoints.json +93 -0
- package/packs/gsa-calc/policy.json +97 -0
- package/packs/gsa-calc/source.md +108 -0
- package/packs/hud/endpoints.json +147 -0
- package/packs/hud/policy.json +84 -0
- package/packs/hud/source.md +97 -0
- package/packs/ipums/assets/download_ipums.ps1 +215 -0
- package/packs/ipums/assets/download_ipums.sh +192 -0
- package/packs/ipums/docs/ipums_api.md +67 -0
- package/packs/ipums/docs/report_patterns.md +117 -0
- package/packs/ipums/docs/variables.md +284 -0
- package/packs/ipums/lib/fetch_text.json +112 -0
- package/packs/ipums/policy.json +215 -0
- package/packs/ipums/source.md +169 -0
- package/packs/irs-soi/endpoints.json +114 -0
- package/packs/irs-soi/policy.json +107 -0
- package/packs/irs-soi/source.md +124 -0
- package/packs/medicaid/endpoints.json +412 -0
- package/packs/medicaid/policy.json +108 -0
- package/packs/medicaid/source.md +136 -0
- package/packs/naep/endpoints.json +217 -0
- package/packs/naep/policy.json +100 -0
- package/packs/naep/source.md +120 -0
- package/packs/nhtsa/endpoints.json +132 -0
- package/packs/nhtsa/policy.json +93 -0
- package/packs/nhtsa/source.md +109 -0
- package/packs/nih/endpoints.json +453 -0
- package/packs/nih/policy.json +86 -0
- package/packs/nih/source.md +108 -0
- package/packs/noaa/endpoints.json +432 -0
- package/packs/noaa/policy.json +95 -0
- package/packs/noaa/source.md +88 -0
- package/packs/nrel/endpoints.json +328 -0
- package/packs/nrel/policy.json +96 -0
- package/packs/nrel/source.md +91 -0
- package/packs/nws/endpoints.json +272 -0
- package/packs/nws/policy.json +82 -0
- package/packs/nws/source.md +81 -0
- package/packs/nyfed/endpoints.json +80 -0
- package/packs/nyfed/policy.json +92 -0
- package/packs/nyfed/source.md +89 -0
- package/packs/omb/endpoints.json +460 -0
- package/packs/omb/policy.json +106 -0
- package/packs/omb/source.md +130 -0
- package/packs/open-payments/endpoints.json +298 -0
- package/packs/open-payments/policy.json +101 -0
- package/packs/open-payments/source.md +99 -0
- package/packs/opm/assets/download_opm.ps1 +125 -0
- package/packs/opm/assets/download_opm.sh +85 -0
- package/packs/opm/docs/fields.md +184 -0
- package/packs/opm/docs/opm_api.md +71 -0
- package/packs/opm/docs/report_patterns.md +83 -0
- package/packs/opm/lib/data_dictionary.csv +73 -0
- package/packs/opm/policy.json +142 -0
- package/packs/opm/source.md +137 -0
- package/packs/pbgc/endpoints.json +483 -0
- package/packs/pbgc/policy.json +94 -0
- package/packs/pbgc/source.md +95 -0
- package/packs/philfed/endpoints.json +85 -0
- package/packs/philfed/policy.json +94 -0
- package/packs/philfed/source.md +125 -0
- package/packs/port.json +287 -0
- package/packs/regulations/endpoints.json +288 -0
- package/packs/regulations/policy.json +86 -0
- package/packs/regulations/source.md +84 -0
- package/packs/sec/endpoints.json +237 -0
- package/packs/sec/policy.json +86 -0
- package/packs/sec/source.md +101 -0
- package/packs/senate-lobbying/endpoints.json +554 -0
- package/packs/senate-lobbying/policy.json +99 -0
- package/packs/senate-lobbying/source.md +100 -0
- package/packs/snapqc/endpoints.json +1426 -0
- package/packs/snapqc/policy.json +92 -0
- package/packs/snapqc/source.md +96 -0
- package/packs/treasury/catalog.json +2267 -0
- package/packs/treasury/docs/api_guide.md +245 -0
- package/packs/treasury/docs/datasets.md +56 -0
- package/packs/treasury/docs/report_patterns.md +126 -0
- package/packs/treasury/policy.json +159 -0
- package/packs/treasury/source.md +165 -0
- package/packs/treasury-yields/endpoints.json +226 -0
- package/packs/treasury-yields/policy.json +86 -0
- package/packs/treasury-yields/source.md +80 -0
- package/packs/usaspending/endpoints.json +1316 -0
- package/packs/usaspending/policy.json +109 -0
- package/packs/usaspending/source.md +103 -0
- package/packs/usda-fna/endpoints.json +427 -0
- package/packs/usda-fna/policy.json +133 -0
- package/packs/usda-fna/source.md +217 -0
- package/packs/usda-fooddata/endpoints.json +181 -0
- package/packs/usda-fooddata/policy.json +94 -0
- package/packs/usda-fooddata/source.md +105 -0
- package/packs/usda-nass/endpoints.json +324 -0
- package/packs/usda-nass/policy.json +95 -0
- package/packs/usda-nass/source.md +85 -0
- package/packs/usda-outlook/endpoints.json +86 -0
- package/packs/usda-outlook/policy.json +109 -0
- package/packs/usda-outlook/source.md +144 -0
- package/packs/usgs/endpoints.json +313 -0
- package/packs/usgs/policy.json +95 -0
- package/packs/usgs/source.md +96 -0
- package/packs/usitc/endpoints.json +74 -0
- package/packs/usitc/policy.json +111 -0
- package/packs/usitc/source.md +90 -0
- package/packs/uspto/endpoints.json +141 -0
- package/packs/uspto/policy.json +95 -0
- package/packs/uspto/source.md +101 -0
- package/packs/va/endpoints.json +414 -0
- package/packs/va/policy.json +101 -0
- package/packs/va/source.md +129 -0
- package/packs/world-bank/endpoints.json +122 -0
- package/packs/world-bank/policy.json +101 -0
- package/packs/world-bank/source.md +93 -0
|
@@ -0,0 +1,157 @@
|
|
|
1
|
+
# Choosing BEA data: datasets, tables, lines and concepts
|
|
2
|
+
|
|
3
|
+
Read §1 to pick the dataset, §2 for verified tables and lines, §3 for the concepts that decide whether a
|
|
4
|
+
number is right. Confirm names before you download with `request_schema`: `search: "<words>"` (NIPA titles, no key),
|
|
5
|
+
`search: "lines <NIPA table>"` (line numbers and series codes, no key), and with a key
|
|
6
|
+
`search: "values Regional TableName"` or `search: "Regional <words>"`. Line numbers can change at
|
|
7
|
+
comprehensive updates, so select NIPA series by table + line *and* check the description or series code.
|
|
8
|
+
|
|
9
|
+
## Contents
|
|
10
|
+
1. Which dataset answers which question
|
|
11
|
+
2. Verified tables and lines
|
|
12
|
+
3. Concepts that change the answer
|
|
13
|
+
4. Geography notes (states, counties, metro areas)
|
|
14
|
+
5. Benchmarks: BEA's own numbers to check against
|
|
15
|
+
|
|
16
|
+
## 1. Which dataset answers which question
|
|
17
|
+
|
|
18
|
+
| Question | Dataset (spec `dataset`) | Typical tables | Bulk (no key)? |
|
|
19
|
+
|---|---|---|---|
|
|
20
|
+
| GDP growth, components, contributions, prices (national) | `NIPA` | T10101, T10102, T10104-T10106, T10111, T11706 | yes |
|
|
21
|
+
| Personal income, saving rate, PCE, PCE inflation | `NIPA` | T20100 (A/Q), T20600 (M), T20804/T20805/T20806/T20807 (M) | yes |
|
|
22
|
+
| GDP and income per capita | `NIPA` | T70100: line 1 GDP per capita (current dollars), line 10 real GDP per capita (chained 2017 dollars), line 3 personal income; descriptions repeat ("Gross domestic product" on lines 1 and 10; "Current dollars"/"Chained (2017) dollars" under disposable personal income on lines 4 and 12): select by line or series code (RC current, RX real). Annual values are annual GDP over annual population, not the mean of the quarterly ratios | yes |
|
|
23
|
+
| Shares of GDP (consumption, investment, government purchases, net exports) | `NIPA` | T10110 (percent of GDP, as BEA publishes it); T10105 lines 22-26 for government consumption and gross investment levels | yes |
|
|
24
|
+
| Government receipts, spending, deficits (NIPA basis) | `NIPA` | T30100 (total), T30200 (federal), T30300 (state and local); total spending includes transfers, so "government's share of GDP" as purchases is T10110 / T10105 lines 22-26, not Table 3.1 | yes |
|
|
25
|
+
| Corporate profits, saving and investment, trade in the NIPAs | `NIPA` | T61600D, T50100, T40100 | yes |
|
|
26
|
+
| Detailed PCE, inventories, auto sales (lower quality) | `NIUnderlyingDetail` | U20305, U20405, U70205S | no: API (the flat files hold only the U-table lines shared with published tables) |
|
|
27
|
+
| State GDP, by industry, real and nominal | `Regional` | SAGDP2 (current $), SAGDP9 (real), SAGDP11 (contributions), SQGDP9 (quarterly real) | yes |
|
|
28
|
+
| State personal income, per capita income, population | `Regional` | SAINC1 (summary), SAINC4 (components), SQINC1 (quarterly), SAINC5N (earnings by industry) | yes |
|
|
29
|
+
| State PCE, price levels (RPPs), real personal income | `Regional` | SAPCE1-SAPCE4, SARPP, SARPI | yes |
|
|
30
|
+
| County income and GDP | `Regional` | CAINC1, CAINC4, CAINC5N, CAINC30, CAGDP2, CAGDP9 | yes |
|
|
31
|
+
| Metro-area price parities | `Regional` | MARPP | yes |
|
|
32
|
+
| Value added, gross output by industry (national) | `GDPbyIndustry` with workbook codes (`"table": "TVA105"`) | TVA105 value added, TVA106 real value added, TVA101 real growth, TVA102 contributions to real GDP growth, TVA110 shares of GDP; TGO1xx gross output; A and Q | yes (public workbooks) |
|
|
33
|
+
| Same, detail the workbooks lack (Industry filters, UnderlyingGDPbyIndustry) | `GDPbyIndustry` / `UnderlyingGDPbyIndustry` (`params`: TableID, Frequency, Year, Industry) | list with the search `values GDPbyIndustry TableID` | no: API |
|
|
34
|
+
| Trade balance, current account, by country | `ITA` (`params`: Indicator, AreaOrCountry, Frequency, Year) | Indicator BalGds (goods balance); list others with the search `values ITA Indicator` | no: API (keyless: the current account balance is NIPA T4030B line 50 "Balance on current account, ITAs" in the bulk files, or FRED `IEABC` (quarterly); T4030B can keep an older ITA vintage for some years (2010-2012 differ by a few hundred million): check against IEABC; trade balances: the FRED pack's monthly series BOPGSTB, BOPGTB, BOPSTB, EXPCH/IMPCH; see fred `docs/series.md`) |
|
|
35
|
+
| Services trade by type and country | `IntlServTrade` | TypeOfService, TradeDirection, AreaOrCountry | no: API |
|
|
36
|
+
| Net international investment position | `IIP` | TypeOfInvestment, Component | no: API (keyless: the FRED pack's `IIPUSNETIQ` quarterly / `IIPUSNETIA` annual net position) |
|
|
37
|
+
| Foreign direct investment, multinationals | `MNE` | DirectionOfInvestment, Classification | no: API |
|
|
38
|
+
| Capital stock, depreciation | `FixedAssets` | FAAt201 (see the search `values FixedAssets TableName`) | no: API |
|
|
39
|
+
| Input-output use and make tables | `InputOutput` | TableID 56 (see the search `values InputOutput TableID`) | no: API |
|
|
40
|
+
|
|
41
|
+
Things BEA does not publish, so say so rather than improvise: GDP forecasts (BEA publishes history only; CBO, the
|
|
42
|
+
Federal Reserve and private forecasters project), monthly GDP, unemployment and jobs (BLS), CPI (BLS; BEA's measure is
|
|
43
|
+
the PCE price index), federal budget data on a fiscal-year basis (Treasury, OMB, CBO).
|
|
44
|
+
|
|
45
|
+
## 2. Verified tables and lines
|
|
46
|
+
|
|
47
|
+
NIPA lines below were checked against SeriesRegister.txt (September 2026 release). "SAAR" = seasonally adjusted at
|
|
48
|
+
annual rates.
|
|
49
|
+
|
|
50
|
+
| Table | Line | Series | What it is | Unit |
|
|
51
|
+
|---|---|---|---|---|
|
|
52
|
+
| T10101 | 1 | A191RL | Real GDP, percent change from preceding period | percent, annual rate (Q is annualized) |
|
|
53
|
+
| T10101 | 2 | DPCERL | Real PCE, percent change | percent, annual rate |
|
|
54
|
+
| T10102 | 1+ | — | Contributions to percent change in real GDP | percentage points |
|
|
55
|
+
| T10104 | 1 | — | GDP price index | index, 2017 = 100 |
|
|
56
|
+
| T10105 | 1 / 2 / 7 / 15 / 22 | A191RC / DPCERC / A006RC / A019RC / A822RC | GDP / PCE / investment / net exports / government, current dollars | millions of dollars (unit_mult 6), SAAR for Q |
|
|
57
|
+
| T10106 | 1 | A191RX | Real GDP | millions of chained 2017 dollars, SAAR for Q |
|
|
58
|
+
| T10111 | 1 | A191RO | Real GDP, percent change from the same quarter a year ago | percent |
|
|
59
|
+
| T11706 | 1 / 2 / 3 | A191RX / A261RX / LB000009 | Real GDP / real GDI / average of GDP and GDI | chained 2017 dollars |
|
|
60
|
+
| T20100 | 1 / 27 / 37 / 35 / 40 | A065RC / A067RC / A067RX / A072RC / B230RC | Personal income / disposable personal income / real DPI / saving rate / population (thousands) | millions; percent; thousands |
|
|
61
|
+
| T20600 | 1 / 35 | A065RC / A072RC | Monthly personal income / saving rate | SAAR millions; percent |
|
|
62
|
+
| T20600 | 37 / 43 | A067RX / A067RM | Monthly real disposable personal income / its percent change from the preceding month (not annualized) | chained-dollar SAAR millions; percent |
|
|
63
|
+
| T20804 | 1 / 25 | DPCERG / DPCCRG | PCE price index / core PCE price index (excluding food and energy), monthly | index, 2017 = 100 |
|
|
64
|
+
| T20807 | 1 / 25 | DPCERGM / DPCCRGM | PCE / core PCE prices, percent change from the preceding month | percent, **not annualized** |
|
|
65
|
+
| T20811 | 32 / 37 | BPCERO / BPCCRO | PCE / core PCE prices, percent change from the month one year ago (the 12-month inflation rate; the table's title says "Real PCE", lines 1-31 are quantities) | percent |
|
|
66
|
+
| T70100 | 1 / 3 | A939RC / A792RC | GDP per capita / personal income per capita, current dollars | dollars |
|
|
67
|
+
|
|
68
|
+
GDP-by-industry workbook tables (checked in ValueAdded.xlsx, September 2026): line 1 = gross domestic product,
|
|
69
|
+
line 2 = private industries, then NAICS sectors and subsectors (indentation kept in `dims`). TVA105 is in millions of
|
|
70
|
+
dollars; TVA106 in millions of chained 2017 dollars and has an extra "Not allocated by industry" line, so line numbers
|
|
71
|
+
differ between tables: match industries by description and order. Duplicate names (for example "General
|
|
72
|
+
government" under federal and under state and local) are told apart by line number within a table.
|
|
73
|
+
|
|
74
|
+
Regional lines (checked in the bulk files' `definition.xml` or the API guide):
|
|
75
|
+
|
|
76
|
+
| Table | Line | What it is | Unit |
|
|
77
|
+
|---|---|---|---|
|
|
78
|
+
| SAGDP2 / SQGDP2 | 1 = all-industry total, 2 = private industries, then NAICS sectors | GDP, current dollars | millions of current dollars |
|
|
79
|
+
| SAGDP9 / SQGDP9 | same lines as SAGDP2 | Real GDP | millions of chained 2017 dollars |
|
|
80
|
+
| SAINC1 / SQINC1 / CAINC1 | 1 = personal income, 2 = population, 3 = per capita personal income | income (millions for states, thousands for counties); people; dollars |
|
|
81
|
+
| SAINC4 / CAINC4 | 10 = personal income, 20 = population, 30 = per capita personal income; other lines are components | as above |
|
|
82
|
+
| SARPP / MARPP | 1 = all items RPP | index, U.S. = 100; published about a year after state income (in October 2026 the latest RPPs and SARPI are for 2024): for the latest income year, say which RPP year you used |
|
|
83
|
+
|
|
84
|
+
API table names sometimes carry an `N` suffix (`SAGDP9N`, `SAGDP2N`); the bulk files drop it. `fetch` accepts either.
|
|
85
|
+
|
|
86
|
+
## 3. Concepts that change the answer
|
|
87
|
+
|
|
88
|
+
- **Nominal vs. real.** Current-dollar series include price changes; chained-dollar (real) series remove them. Growth
|
|
89
|
+
"of the economy" means real GDP unless the user says otherwise. Real values are in chained 2017 dollars (the reference
|
|
90
|
+
year since the 2023 comprehensive update; check `unit` in the data).
|
|
91
|
+
- **Chained dollars do not add.** Real components do not sum to real GDP, and real state GDP does not sum to real U.S.
|
|
92
|
+
GDP. Compute shares from current-dollar values, and use BEA's published contributions (T10102, SAGDP11) for what
|
|
93
|
+
drove growth, never differences of chained-dollar components.
|
|
94
|
+
- **Annual rates.** Quarterly and monthly dollar levels are SAAR: a quarter's value is what the year would total at
|
|
95
|
+
that pace. Average the quarters for an annual figure; do not add them.
|
|
96
|
+
- **Growth measures differ.** BEA's headline quarterly growth is the change from the preceding quarter at a compound
|
|
97
|
+
annual rate (T10101). Alternatives: year-over-year (T10111), fourth quarter over fourth quarter, and annual average
|
|
98
|
+
over annual average (the annual line of T10101). They can differ by more than a percentage point in turning years,
|
|
99
|
+
so name the measure in every exhibit and sentence. For multi-year spans ("since 2019"), report the cumulative
|
|
100
|
+
change and the average annual rate; the two order areas identically, so the choice to test as a sensitivity is
|
|
101
|
+
the start and end period, above all a base year inside a recession or other shock.
|
|
102
|
+
- **Price measures.** The PCE price index (T20804) is the Federal Reserve's inflation target measure; the GDP price
|
|
103
|
+
index (T10104) covers all domestic production. Core PCE excludes food and energy.
|
|
104
|
+
- **Per capita.** Use BEA's per capita lines when they exist (T70100, SAINC1 line 3); otherwise divide by population
|
|
105
|
+
in the same table (T20100 line 40 is in thousands). State per capita income in real terms needs RPPs (SARPI).
|
|
106
|
+
BEA publishes no real GDP per capita by state: divide SAGDP9 line 1 (millions of chained 2017 dollars) by
|
|
107
|
+
SAINC1 line 2 (resident population, same vintage). The U.S. row computed this way sits a little above
|
|
108
|
+
T70100 line 10, whose population includes the armed forces overseas: say so when comparing.
|
|
109
|
+
- **Vintage.** BEA serves only its latest estimates. GDP has advance, second and third estimates each quarter,
|
|
110
|
+
annual updates every September (revising several years) and comprehensive updates about every five years. Record
|
|
111
|
+
the release in Data and Methods ("estimates as released on September 30, 2026"), and do not compare a number from an
|
|
112
|
+
old publication with today's estimate without saying that revisions may explain the difference. Old vintages:
|
|
113
|
+
https://apps.bea.gov/histdata/ (not through the API). Next releases: https://www.bea.gov/news/schedule.
|
|
114
|
+
- **Suppressed cells.** Regional and industry tables use `(D)` (suppressed to avoid disclosure), `(NA)`, `(NM)`,
|
|
115
|
+
`(L)` and others. They are not zeros. A ranking or total that needs a suppressed cell must say so or drop the area.
|
|
116
|
+
- **Calendar years.** All BEA annual data are calendar years, including federal government spending in the NIPAs
|
|
117
|
+
(unlike budget data, which use fiscal years). NIPA government spending also differs from budget outlays in concept.
|
|
118
|
+
- **Industry classification.** Regional and GDP-by-industry data use NAICS. Long state series by industry begin in
|
|
119
|
+
1997 (SIC-based data before that are not comparable).
|
|
120
|
+
|
|
121
|
+
## 4. Geography notes
|
|
122
|
+
|
|
123
|
+
- `geo_fips`: `00000` = United States; `SS000` = states (`06000` California); `91000`-`98000` = BEA regions;
|
|
124
|
+
five-digit county FIPS (`06037` Los Angeles County).
|
|
125
|
+
- Independent cities are their own county-level areas: "Baltimore (Independent City), MD" is 24510, "Baltimore,
|
|
126
|
+
MD" is Baltimore County (24005); Virginia's independent cities are often combined with a county
|
|
127
|
+
("Albemarle + Charlottesville"). Match by FIPS, not by name.
|
|
128
|
+
- County tables (CAINC*) and state tables (SAINC*) come out on different schedules: from late September to
|
|
129
|
+
early December the state table carries the newer annual revision, so a county's state row in CAINC1 and the
|
|
130
|
+
same state in SAINC1 can differ. Compare a county with its state from the same table.
|
|
131
|
+
- `geo_fips: "STATE"` returns the 50 states, the District of Columbia and the U.S. total. Say whether D.C. is
|
|
132
|
+
included in rankings ("the 50 states and the District of Columbia").
|
|
133
|
+
- In the state GDP tables (SAGDP*), the U.S. row is national GDP (it matched NIPA T10106 line 1 to rounding in the
|
|
134
|
+
September 2026 vintage); the *sum of the states* is what differs, because it leaves out federal military and
|
|
135
|
+
civilian activity overseas and uses different source data (BEA footnote 1, in `notes.csv`). For other tables, read
|
|
136
|
+
the table's footnotes in `notes.csv` before comparing a state total with a NIPA figure. Compare states with the U.S.
|
|
137
|
+
figure from the same table.
|
|
138
|
+
- **Metro areas:** since February 2026 BEA no longer produces GDP or personal income for metropolitan statistical
|
|
139
|
+
areas, micropolitan areas, metropolitan divisions, combined areas or metro/nonmetro portions. For a metro estimate,
|
|
140
|
+
sum the component counties' current-dollar values (county-to-MSA delineations:
|
|
141
|
+
https://apps.bea.gov/regional/geography.htm; BEA's tool: https://github.com/us-bea/bea_geo_aggregator), say that
|
|
142
|
+
it is an aggregation of county data, and do not sum chained-dollar values. Older metro estimates are in
|
|
143
|
+
https://apps.bea.gov/histdata/. MSA price parities (MARPP) are still published.
|
|
144
|
+
|
|
145
|
+
## 5. Benchmarks
|
|
146
|
+
|
|
147
|
+
Compute what you can from levels and check it against BEA's own published numbers (fetch the
|
|
148
|
+
published table too and compare); any mismatch beyond rounding means a selection or method error:
|
|
149
|
+
- real GDP growth from T10106 levels vs. T10101 line 1 (quarterly, annualized) or the annual line;
|
|
150
|
+
- year-over-year growth vs. T10111;
|
|
151
|
+
- monthly PCE inflation from T20804 (plain monthly change) vs. T20807, and 12-month inflation
|
|
152
|
+
vs. T20811 lines 32 / 37;
|
|
153
|
+
- the U.S. row of SAGDP9 / SAGDP2 vs. NIPA T10106 / T10105 line 1 levels (they match within a few million dollars; a free
|
|
154
|
+
check that the state table, line and units were read right);
|
|
155
|
+
- shares of GDP from T10105 current dollars vs. the "percent of GDP" figures in BEA releases.
|
|
156
|
+
Also compare the headline number with the latest BEA news release (https://www.bea.gov/news) and say in Data and
|
|
157
|
+
Methods whether it matches.
|
|
@@ -0,0 +1,112 @@
|
|
|
1
|
+
# Report patterns for BEA data products
|
|
2
|
+
|
|
3
|
+
Use this file to shape both the analysis and the product. The aim is something a careful reviewer would
|
|
4
|
+
recognize: precise measures (real or nominal, which growth rate, which release), a lead summary with
|
|
5
|
+
numbers, numbered exhibits that each carry notes and a source line, data shipped alongside, and
|
|
6
|
+
limitations stated plainly.
|
|
7
|
+
|
|
8
|
+
## Typical questions and how they are framed
|
|
9
|
+
|
|
10
|
+
These recur in work by statistical and policy agencies (BEA itself, CBO, the Federal Reserve, CRS, GAO,
|
|
11
|
+
state budget offices, research institutes), so there is usually a precedent to follow and benchmark against.
|
|
12
|
+
|
|
13
|
+
- **How fast is the economy growing?** (NIPA T10101, T10106, T10102). Measures: real GDP growth, quarterly
|
|
14
|
+
at an annual rate and annual; contributions of consumer spending, investment, government and net exports
|
|
15
|
+
(from T10102, not computed). Headline style: "Real GDP increased at an annual rate of 2.2 percent in the
|
|
16
|
+
second quarter of 2026, according to BEA's third estimate." Name the estimate (advance, second, third) and
|
|
17
|
+
compare with the previous quarter and the prior-year average.
|
|
18
|
+
- **Inflation by BEA's measure** (T20804, T20807; T10104 for GDP prices). PCE and core PCE price indexes,
|
|
19
|
+
12-month changes for monthly data; compare with the Federal Reserve's 2 percent objective only as a fact,
|
|
20
|
+
not advice.
|
|
21
|
+
- **Household income and saving** (T20100, T20600, T70100). Personal income, disposable personal income in
|
|
22
|
+
real terms, the saving rate, per capita amounts. Distinguish personal income (includes transfers and
|
|
23
|
+
employer contributions) from household money income in Census surveys.
|
|
24
|
+
- **Which states (or counties) are growing fastest?** (SAGDP9, SQGDP9, SAINC1, CAINC1). Real GDP growth or
|
|
25
|
+
per capita income by state, ranked; regional patterns (BEA regions); industry drivers (SAGDP11
|
|
26
|
+
contributions, SAGDP2 shares). Report the U.S. figure from the same table, say whether D.C. is included,
|
|
27
|
+
and note (D) suppressions.
|
|
28
|
+
- **Industry structure** (GDPbyIndustry; SAGDP2 by state). Value added shares of GDP in current dollars;
|
|
29
|
+
real growth by industry; long series start in 1997 (NAICS).
|
|
30
|
+
- **Trade and international position** (ITA, IntlServTrade, IIP). Goods and services balances by country,
|
|
31
|
+
current account as a share of GDP (use T10105 for GDP).
|
|
32
|
+
- **Government in the economy** (T30100-T30300). Receipts, expenditures, net saving on a NIPA, calendar-year
|
|
33
|
+
basis; explain how it differs from budget (fiscal-year) data when the reader may compare them.
|
|
34
|
+
- **Cost of living across places** (SARPP, MARPP, SARPI). Regional price parities (U.S. = 100) and real
|
|
35
|
+
personal income; say that RPPs compare price levels across places in one year, not changes over time.
|
|
36
|
+
|
|
37
|
+
## Conventions to follow
|
|
38
|
+
|
|
39
|
+
**Measures and definitions**
|
|
40
|
+
- Real values in chained (2017) dollars; current-dollar values in nominal terms; say which in every exhibit
|
|
41
|
+
subtitle ("Billions of chained 2017 dollars", "Percent change at an annual rate").
|
|
42
|
+
- Growth rates: name the measure (quarter at an annual rate, year over year, Q4 over Q4, annual average).
|
|
43
|
+
- Shares of GDP or of the U.S. total: current dollars only.
|
|
44
|
+
- Per capita: BEA's published per capita lines first; otherwise the population line of the same table.
|
|
45
|
+
- Rankings: say how many areas are ranked and what happens with suppressed values or ties.
|
|
46
|
+
|
|
47
|
+
**Accuracy**
|
|
48
|
+
- Every computed growth rate or share that BEA also publishes is checked against BEA's number
|
|
49
|
+
(fetched alongside), and the check is reported in Data and Methods.
|
|
50
|
+
- The vintage: the release date and estimate (for example "the third estimate for the second quarter of 2026,
|
|
51
|
+
released September 25, 2026", or "state GDP as released on September 30, 2026") is in the notes page and
|
|
52
|
+
in Data and Methods; the products say estimates are subject to revision.
|
|
53
|
+
- No sampling error is attached to BEA estimates, so there are no standard errors and no "statistically
|
|
54
|
+
different". Describe differences by size; for small differences, note that revisions are often of that size
|
|
55
|
+
(find and cite BEA's latest revision study, published in the *Survey of Current Business*, for the typical
|
|
56
|
+
size of revisions to the measure at hand), and say so instead of overinterpreting.
|
|
57
|
+
- Do not attribute causes beyond what the accounts show. "Growth was led by consumer spending" is a
|
|
58
|
+
contribution fact; "because of tariffs" is not something BEA data establish.
|
|
59
|
+
|
|
60
|
+
**Publication structure (mirrored in `build_report`, `"mode": "report"`)**
|
|
61
|
+
|
|
62
|
+
The default layout, the **exhibit chartbook**, runs in this order:
|
|
63
|
+
1. **Cover:** "Month Year", the title (with the period for trend reports), and a hero chart that has its own title and unit label.
|
|
64
|
+
2. **At a Glance** (one page of about 300–420 words):
|
|
65
|
+
- one framing paragraph saying what was examined, the population, the period and the dimensions;
|
|
66
|
+
- 3–5 bullets, each opening with a **bold lead phrase.** that names a section, followed by 2–4 sentences with the key numbers.
|
|
67
|
+
3. **Contents:** the Introduction subsections, each section with an "Exhibits a–b" sub-line, the appendixes, and About This Document when there is one.
|
|
68
|
+
4. **List of Exhibits:** grouped under section headings, each entry "N. Title, years".
|
|
69
|
+
5. **Notes About This Report** (also titled "Notes" or "Notes and Definitions"). Short unnumbered paragraphs covering:
|
|
70
|
+
- calendar years;
|
|
71
|
+
- "Numbers in the text and exhibits may not add up to totals because of rounding.";
|
|
72
|
+
- real vs. nominal, the chained-dollar reference year, seasonal adjustment at annual rates;
|
|
73
|
+
- the data source, tables and vintage (release date), and that BEA revises its estimates;
|
|
74
|
+
- key definitions (the growth measure, per capita, the areas covered);
|
|
75
|
+
- recession shading, if any;
|
|
76
|
+
- where the data are posted.
|
|
77
|
+
6. **Introduction** (or "Summary and Introduction"):
|
|
78
|
+
- a lead paragraph with the headline numbers;
|
|
79
|
+
- question-style subheadings, one per section ("Which States Grew Fastest?");
|
|
80
|
+
- closing subsections such as "How Are Growth Rates Measured?", "What Data Were Used?" and, when updating earlier work, "What Is New in This Report?".
|
|
81
|
+
7. **Thematic sections** (2–5, unnumbered):
|
|
82
|
+
- Each opens on a full-width page with 1–3 summary paragraphs.
|
|
83
|
+
- Then comes **one exhibit per page**: "Exhibit N." with a title-case title ending in ", 1998 to 2018", a unit label above the chart, and 2–4 narrative paragraphs beside it (levels, changes, comparisons, "(see Exhibit 5)").
|
|
84
|
+
- Below the chart: the data source line ("Data source: `<organization>`, using data from …", or "Data source: Analyst calculations using data from …" when no organization is named), then the notes, then lettered notes ("a.").
|
|
85
|
+
8. **Appendix A: Data and Methods** (or "Appendix: Estimating …"): data and vintage, tables and lines, definitions, computations, checks against BEA's published figures, revisions and limitations. Sometimes followed by **Appendix B: Definitions**, an alphabetical glossary.
|
|
86
|
+
9. **About This Document** (optional), in this order:
|
|
87
|
+
- who requested it, or what question prompted it;
|
|
88
|
+
- who prepared it, with what data and tools;
|
|
89
|
+
- the reviewers, if any;
|
|
90
|
+
- the date.
|
|
91
|
+
10. **Footnotes** are numbered in each part (restarting in each section), and cite publications as: Organization, *Title* (Month Year), URL.
|
|
92
|
+
|
|
93
|
+
Other variants, not built by `build_report`:
|
|
94
|
+
- **Long-form**:
|
|
95
|
+
- a Summary with Figure S-1 / Table S-1;
|
|
96
|
+
- "Chapter N:" sections in two-column prose with embedded "Figure 1-1." / "Table 2-3.";
|
|
97
|
+
- Boxes;
|
|
98
|
+
- a List of Tables and Figures at the back.
|
|
99
|
+
- **Hybrid**: full-width pages each with a heading, a paragraph and unnumbered charts; sources pooled in an appendix.
|
|
100
|
+
- Use `"mode": "paper"` when a prose-led product is wanted.
|
|
101
|
+
|
|
102
|
+
|
|
103
|
+
**Reading PDFs from sites that block scripts:** some publishers refuse scripts and the in-app browser (HTTP 403, bot-check slider). Fetch `https://web.archive.org/web/<year>/<full pdf url>` and extract the text with pypdf. If the plain year URL returns HTML, use a CDX timestamp with `id_` (for example `https://web.archive.org/web/20240430034127id_/<url>`). Cite the original URL.
|
|
104
|
+
|
|
105
|
+
**Data files:** `data/bea_data.csv`, `data/notes.csv`, `data/request.json` and each exhibit's CSV ship with the report, so every number can be traced. BEA data are public domain, so the replication package includes the data.
|
|
106
|
+
|
|
107
|
+
**Chart forms**
|
|
108
|
+
- Trends over time: line charts with at most 4–5 series; quarterly growth rates as columns (positive and negative bars read better than a line).
|
|
109
|
+
- Levels and growth together: two exhibits, not a dual axis.
|
|
110
|
+
- Group comparisons at a point in time (states, industries): horizontal bars sorted by value; for all 50 states plus D.C., a sorted bar chart or a table, with the U.S. value marked in the notes or as its own bar.
|
|
111
|
+
- Composition (contributions to growth, shares of GDP): stacked columns, with the total shown as its own series or in the text.
|
|
112
|
+
- No dual axes, no pie charts, no 3-D. Maps need a library the builder does not have; use sorted bars.
|
|
@@ -0,0 +1,170 @@
|
|
|
1
|
+
{
|
|
2
|
+
"id": "bea",
|
|
3
|
+
"title": "Bureau of Economic Analysis (BEA) Data API and bulk files",
|
|
4
|
+
"agency": "U.S. Bureau of Economic Analysis",
|
|
5
|
+
"depth": "deep",
|
|
6
|
+
"domains": [
|
|
7
|
+
"economy",
|
|
8
|
+
"national accounts",
|
|
9
|
+
"income",
|
|
10
|
+
"regional economy",
|
|
11
|
+
"international trade"
|
|
12
|
+
],
|
|
13
|
+
"keywords": [
|
|
14
|
+
"gdp",
|
|
15
|
+
"real gdp",
|
|
16
|
+
"gross domestic product",
|
|
17
|
+
"personal income",
|
|
18
|
+
"per capita income",
|
|
19
|
+
"pce",
|
|
20
|
+
"personal consumption expenditures",
|
|
21
|
+
"pce inflation",
|
|
22
|
+
"core pce",
|
|
23
|
+
"saving rate",
|
|
24
|
+
"corporate profits",
|
|
25
|
+
"nipa",
|
|
26
|
+
"state gdp",
|
|
27
|
+
"county income",
|
|
28
|
+
"regional price parities",
|
|
29
|
+
"rpp",
|
|
30
|
+
"gdp by industry",
|
|
31
|
+
"value added",
|
|
32
|
+
"gross output",
|
|
33
|
+
"trade balance",
|
|
34
|
+
"current account",
|
|
35
|
+
"international transactions",
|
|
36
|
+
"investment position",
|
|
37
|
+
"foreign direct investment",
|
|
38
|
+
"multinational",
|
|
39
|
+
"fixed assets",
|
|
40
|
+
"input-output",
|
|
41
|
+
"services trade",
|
|
42
|
+
"gdi",
|
|
43
|
+
"share of gdp", "wages per full-time equivalent", "compensation per employee",
|
|
44
|
+
"percent of gdp",
|
|
45
|
+
"gdp deflator"
|
|
46
|
+
],
|
|
47
|
+
"questions": [
|
|
48
|
+
"real GDP growth by quarter",
|
|
49
|
+
"which states grew fastest",
|
|
50
|
+
"per capita personal income by state",
|
|
51
|
+
"core PCE inflation",
|
|
52
|
+
"personal saving rate",
|
|
53
|
+
"GDP by industry",
|
|
54
|
+
"U.S. goods trade balance with China",
|
|
55
|
+
"county personal income"
|
|
56
|
+
],
|
|
57
|
+
"homepage": "https://www.bea.gov/",
|
|
58
|
+
"terms_url": "https://apps.bea.gov/API/_pdf/bea_api_tos.pdf",
|
|
59
|
+
"auth": {
|
|
60
|
+
"env": "BEA_API_KEY",
|
|
61
|
+
"required": "required",
|
|
62
|
+
"placement": "query",
|
|
63
|
+
"param": "UserID",
|
|
64
|
+
"prefix": "",
|
|
65
|
+
"home": "bea",
|
|
66
|
+
"signup_url": "https://apps.bea.gov/API/signup/",
|
|
67
|
+
"echoes_key": true,
|
|
68
|
+
"key_only": [
|
|
69
|
+
"ITA, IIP, MNE, IntlServTrade, IntlServSTA, InputOutput, FixedAssets and UnderlyingGDPbyIndustry datasets",
|
|
70
|
+
"GDPbyIndustry API TableIDs and Industry filters (the TVA/TGO/TII workbook tables need no key)",
|
|
71
|
+
"Regional metro, micropolitan, port and division areas (MSA, MIC, PORT, DIV, CSA)",
|
|
72
|
+
"live metadata lookups (request_schema searches for parameter values, parameters and datasets)"
|
|
73
|
+
],
|
|
74
|
+
"extra": {},
|
|
75
|
+
"demo_key": null
|
|
76
|
+
},
|
|
77
|
+
"limits": {
|
|
78
|
+
"rps": 1.33,
|
|
79
|
+
"burst": 1,
|
|
80
|
+
"requests_per_min": 100,
|
|
81
|
+
"daily_quota": null,
|
|
82
|
+
"errors_per_min": 30,
|
|
83
|
+
"bytes_per_min": 100000000,
|
|
84
|
+
"max_rows": null
|
|
85
|
+
},
|
|
86
|
+
"routes": {
|
|
87
|
+
"api": {
|
|
88
|
+
"base": "https://apps.bea.gov/api/data",
|
|
89
|
+
"probe": "https://apps.bea.gov/api/data?method=GETDATASETLIST&ResultFormat=JSON",
|
|
90
|
+
"hosts": [
|
|
91
|
+
"apps.bea.gov"
|
|
92
|
+
]
|
|
93
|
+
},
|
|
94
|
+
"bulk": {
|
|
95
|
+
"base": "https://apps.bea.gov/",
|
|
96
|
+
"probe": "https://apps.bea.gov/national/Release/TXT/TablesRegister.txt",
|
|
97
|
+
"hosts": [
|
|
98
|
+
"apps.bea.gov"
|
|
99
|
+
]
|
|
100
|
+
},
|
|
101
|
+
"manual": {
|
|
102
|
+
"how": "Call manual_bundle: manual_download/ holds download_data.sh and download_data.ps1 (one script each: public bulk files without a key, API replies with the key asked for on the user's own computer and removed from every reply) and INSTRUCTIONS.md with the same links and curl steps. Upload the files unchanged, then call ingest."
|
|
103
|
+
}
|
|
104
|
+
},
|
|
105
|
+
"cache": {
|
|
106
|
+
"mode": "persistent",
|
|
107
|
+
"ttl_hours": 24,
|
|
108
|
+
"why": "BEA's bulk files (NIPA flat files 12-37 MB, Regional zips up to 50 MB, GDP-by-industry workbooks) are public domain and change only at releases: they are kept in <cache_root>/bea/bulk and revalidated by Last-Modified on every use; API metadata (table and line lists) is cached for a day. GetData replies are not cached (data/bea/ is reused per run)."
|
|
109
|
+
},
|
|
110
|
+
"redistribution": {
|
|
111
|
+
"mode": "allowed",
|
|
112
|
+
"why": "BEA data are U.S. government works in the public domain (17 U.S.C. 105); BEA asks to be cited as the source, and the API terms require the attribution notice and forbid implying endorsement."
|
|
113
|
+
},
|
|
114
|
+
"notices": [
|
|
115
|
+
"This product uses the Bureau of Economic Analysis (BEA) Data API but is not endorsed or certified by BEA."
|
|
116
|
+
],
|
|
117
|
+
"retention": null,
|
|
118
|
+
"citation": "U.S. Bureau of Economic Analysis, {dataset} (accessed {retrieved_long}).",
|
|
119
|
+
"audit_hooks": [
|
|
120
|
+
{
|
|
121
|
+
"id": "bea_api_notice",
|
|
122
|
+
"kind": "require_text",
|
|
123
|
+
"when_route": ["api"],
|
|
124
|
+
"any": [
|
|
125
|
+
"not endorsed or certified by BEA"
|
|
126
|
+
],
|
|
127
|
+
"why": "BEA's API terms of service require this notice in any product that uses the API (data/bea/README.md says when the API was used)."
|
|
128
|
+
}
|
|
129
|
+
],
|
|
130
|
+
"clarify": [
|
|
131
|
+
"Real or nominal? Growth \"of GDP\" is real (chained 2017 dollars); dollar shares need nominal (current dollars).",
|
|
132
|
+
"Which growth measure: quarterly at an annual rate (BEA's headline), year over year, fourth quarter over fourth quarter, or annual average? They differ by a point or more in turning years.",
|
|
133
|
+
"Geography: the nation, the 50 states and D.C., counties, or metro areas (BEA stopped metro GDP and income in 2026)? Per capita or price-adjusted (RPPs)?",
|
|
134
|
+
"Vintage: BEA serves only its latest estimates; when updating an earlier product, the old numbers came from an older vintage."
|
|
135
|
+
],
|
|
136
|
+
"formats": [
|
|
137
|
+
"json",
|
|
138
|
+
"csv",
|
|
139
|
+
"txt",
|
|
140
|
+
"zip",
|
|
141
|
+
"xlsx"
|
|
142
|
+
],
|
|
143
|
+
"use_instead": [
|
|
144
|
+
{
|
|
145
|
+
"question": "CPI, jobs, unemployment, wages by occupation",
|
|
146
|
+
"source": "bls",
|
|
147
|
+
"terms": [
|
|
148
|
+
"CPI",
|
|
149
|
+
"OEWS"
|
|
150
|
+
],
|
|
151
|
+
"why": "BLS produces these."
|
|
152
|
+
},
|
|
153
|
+
{
|
|
154
|
+
"question": "Budget data by fiscal year",
|
|
155
|
+
"source": "treasury",
|
|
156
|
+
"terms": [
|
|
157
|
+
"Monthly Treasury Statement"
|
|
158
|
+
],
|
|
159
|
+
"why": "Treasury Fiscal Data."
|
|
160
|
+
},
|
|
161
|
+
{
|
|
162
|
+
"question": "Market interest rates",
|
|
163
|
+
"source": "treasury-yields",
|
|
164
|
+
"terms": [
|
|
165
|
+
"par yield"
|
|
166
|
+
],
|
|
167
|
+
"why": "Daily Treasury yields."
|
|
168
|
+
}
|
|
169
|
+
]
|
|
170
|
+
}
|
|
@@ -0,0 +1,152 @@
|
|
|
1
|
+
# Bureau of Economic Analysis (BEA) Data API and bulk files
|
|
2
|
+
Depth: deep. Key: required (BEA_API_KEY) for the API; the bulk route needs none. U.S. national accounts
|
|
3
|
+
(GDP, income, PCE and its prices, saving, profits, government), state and county GDP and income, regional
|
|
4
|
+
price parities, GDP by industry, trade and international accounts, multinationals, fixed assets, input-output.
|
|
5
|
+
|
|
6
|
+
## When to use
|
|
7
|
+
- GDP and its growth, contributions, prices and deflators; personal income, disposable income, saving rate;
|
|
8
|
+
PCE and core PCE price indexes (the Federal Reserve's inflation measure); corporate profits; NIPA
|
|
9
|
+
government receipts and spending (calendar years); GDP and personal income by state and county; per capita
|
|
10
|
+
income; RPPs; value added and gross output by industry; goods and services trade balances by country;
|
|
11
|
+
current account; investment position; direct investment; capital stocks.
|
|
12
|
+
- Not here: CPI, jobs, unemployment, wages by occupation (bls); budget data by fiscal year (treasury);
|
|
13
|
+
market interest rates (treasury-yields; fred); forecasts (BEA publishes history only); monthly GDP.
|
|
14
|
+
- The deliverable decides the work: data only (download, short preview, stop), an answer (compute with
|
|
15
|
+
`compute`, answer with the numbers, measure and vintage), or a report (`guide`'s report steps).
|
|
16
|
+
|
|
17
|
+
## Endpoints and datasets
|
|
18
|
+
One API endpoint (`https://apps.bea.gov/api/data`, GET, key in `UserID`), 13 datasets. Bulk files serve
|
|
19
|
+
the most used ones without a key and count against no limit.
|
|
20
|
+
|
|
21
|
+
| `dataset` | What | Spec keys | Bulk (no key)? |
|
|
22
|
+
|---|---|---|---|
|
|
23
|
+
| `NIPA` | national accounts tables `T10101` ... (titles: `request_schema` search) | `table`, `frequency` A/Q/M, `years`, `line_code` | yes (NIPA flat files) |
|
|
24
|
+
| `NIUnderlyingDetail` | detail tables `U20305` ... (lower quality) | same | no (flat files hold only shared lines) |
|
|
25
|
+
| `FixedAssets` | `FAAt101` ... annual | `table`, `years` | no |
|
|
26
|
+
| `Regional` | state `SA*`/`SQ*`, county `CA*`, metro `MA*` tables | `table`, `line_code`, `geo_fips`, `years` | yes for STATE, COUNTY, postal code (its counties), FIPS lists, MARPP |
|
|
27
|
+
| `GDPbyIndustry` | workbook codes `TVA101`-`TVA113`, `TGO1xx`, `TII1xx` | `table`, `frequency` A/Q, `years` | yes (public workbooks) |
|
|
28
|
+
| `GDPbyIndustry` (API) | `TableID` 1, 5, 6, 25 ...; `Industry` filters | `params` | no |
|
|
29
|
+
| `UnderlyingGDPbyIndustry`, `ITA`, `IIP`, `IntlServTrade`, `IntlServSTA`, `MNE`, `InputOutput` | see `request_schema` with `names: ["<name>"]` | `params` (raw API names) | no |
|
|
30
|
+
|
|
31
|
+
Verified lines (September 2026 vintage): T10101 line 1 real GDP percent change (annual rate); T10106 line 1
|
|
32
|
+
real GDP (millions of chained 2017 dollars, SAAR); T10105 line 1 nominal GDP; T10111 line 1 year-over-year
|
|
33
|
+
real GDP change; T10102 contributions; T20100 lines 1/27/37/35/40 personal income / DPI / real DPI / saving
|
|
34
|
+
rate / population (annual and quarterly only: monthly values are in T20600, whose line numbers differ, so
|
|
35
|
+
check them with the search `lines T20600`; a table is monthly only when its title says so, and the bulk route refuses
|
|
36
|
+
frequency M for any other table); T20804 lines 1/25 PCE / core PCE price index (monthly; published changes: T20807 month over month, not
|
|
37
|
+
annualized, T20811 lines 32/37 over 12 months); T70100 lines 1/3 GDP and income
|
|
38
|
+
per capita (BEA divides by unrounded population: real GDP over T70100's population, published in thousands,
|
|
39
|
+
can miss the published per-capita level by just over 0.5 dollars; allow for that rounding in the benchmark and
|
|
40
|
+
say so). Federal civilian wages per FTE (T60600D) jump in 2024-2025: Deferred Resignation staff on paid
|
|
41
|
+
administrative leave stayed on the payroll while BEA cut the quantity of federal labor (FAQ 1479,
|
|
42
|
+
bea.gov/help/faq/1479): never read those years as federal pay raises; use OPM pay or the GS raise. Regional: SAGDP2/SAGDP9 line 1 all-industry total (current / chained 2017 dollars); SAINC1 and
|
|
43
|
+
CAINC1 lines 1/2/3 personal income / population / per capita income; SAINC4/CAINC4 lines 10/20/30; SARPP
|
|
44
|
+
and MARPP line 1 all-items RPP. API names may carry an `N` (`SAGDP9N`); the bulk files drop it: both work.
|
|
45
|
+
BEA marks nothing as preliminary in the data, but the latest quarter or year of every table is an early
|
|
46
|
+
estimate that BEA will revise: register facts from it with `preliminary: true` in `facts` and say so. A year that has
|
|
47
|
+
been through an annual update (published at the end of September) is revised, not early: say "subject to
|
|
48
|
+
revision at the next annual update" instead.
|
|
49
|
+
More tables, the question-to-table map and concepts: `docs/datasets.md`. API parameters, response quirks,
|
|
50
|
+
error codes and limits: `docs/bea_api.md`. Report conventions: `docs/report_patterns.md`.
|
|
51
|
+
|
|
52
|
+
Discovery with `request_schema` (no key unless noted): `search: "real gross domestic product"` (NIPA titles
|
|
53
|
+
and workbook tables), `search: "Regional income"` (the first word names the dataset; API datasets need a key),
|
|
54
|
+
`search: "lines T10106"` (lines and series codes), `names: ["ITA"]` (required parameters, rules, spec keys,
|
|
55
|
+
and with a key BEA's current parameters); with a key (cached a day): `search: "values Regional TableName"`,
|
|
56
|
+
`search: "values Regional LineCode TableName=SAINC1"`. `source_brief` lists the 13 datasets.
|
|
57
|
+
|
|
58
|
+
## Spec examples
|
|
59
|
+
```json
|
|
60
|
+
{"description": "Real GDP growth, national and by state, 2019 to 2025",
|
|
61
|
+
"requests": [
|
|
62
|
+
{"id": "gdp_pct", "dataset": "NIPA", "table": "T10101", "line_code": 1, "frequency": "Q", "years": "2019-2025"},
|
|
63
|
+
{"id": "gdp_real", "dataset": "NIPA", "table": "T10106", "line_code": 1, "frequency": "Q", "years": "2019-2025"},
|
|
64
|
+
{"id": "state_real", "dataset": "Regional", "table": "SAGDP9", "line_code": 1, "geo_fips": "STATE", "years": "2019-2025"},
|
|
65
|
+
{"id": "va_ind", "dataset": "GDPbyIndustry", "table": "TVA105", "frequency": "A", "years": "2024-2025"}]}
|
|
66
|
+
```
|
|
67
|
+
```json
|
|
68
|
+
{"description": "Per capita personal income, two counties, last five years",
|
|
69
|
+
"requests": [{"id": "cty_pi", "dataset": "Regional", "table": "CAINC1", "line_code": [1, 3],
|
|
70
|
+
"geo_fips": ["06037", "17031"], "years": "LAST5"}]}
|
|
71
|
+
```
|
|
72
|
+
```json
|
|
73
|
+
{"description": "U.S. goods trade balance with China (needs a key)",
|
|
74
|
+
"requests": [{"id": "ita", "dataset": "ITA",
|
|
75
|
+
"params": {"Indicator": "BalGds", "AreaOrCountry": "China", "Frequency": "A", "Year": "2023,2024"}}]}
|
|
76
|
+
```
|
|
77
|
+
`years`: `"2019-2025"`, a list, `"ALL"` or `"LAST5"`; `line_code`: a number, list or `"ALL"` (NIPA: BEA
|
|
78
|
+
sends the whole table and the rows are filtered); `geo_fips`: `STATE`, `COUNTY`, a postal code (its
|
|
79
|
+
counties), FIPS codes (`"06"` = `06000`). Keys a dataset does not use are reported in the result's notes. When a growth
|
|
80
|
+
rate is computed from levels, also request BEA's published percent change so it can be checked.
|
|
81
|
+
|
|
82
|
+
## Data format and traps
|
|
83
|
+
`fetch` writes `data/bea/`: `bea_data.csv` (tidy: `request_id, dataset, table, line, series_code,
|
|
84
|
+
description, geo_fips, geo_name, geo_level, industry, time_period, date, year, subperiod, frequency, value,
|
|
85
|
+
flag, unit, metric, unit_mult, note_ref, dims`), `notes.csv` (BEA's footnotes: units, reference year, what
|
|
86
|
+
the U.S. row means, flag codes), `request.json` (calls without the key, bulk files, route, vintage,
|
|
87
|
+
checksums) and `README.md`. Read the README and `notes.csv` before analysing (the NIPA bulk files carry no
|
|
88
|
+
footnotes: on the `bulk` route `notes.csv` has only the pack's own note; read a table's footnotes on its
|
|
89
|
+
apps.bea.gov page, or fetch it through the API with a key). `line` holds BEA's line numbers, which can carry
|
|
90
|
+
letters: match lines exactly (as text, or with `series_code`), never by integer order.
|
|
91
|
+
- **Units:** `value` is as BEA prints it; base units = value x 10^`unit_mult` (`compute` `derive`:
|
|
92
|
+
`value * pow(10, unit_mult)`).
|
|
93
|
+
Check `unit` and `metric` (current dollars, chained dollars, index, percent change) for every series.
|
|
94
|
+
- **Special values** `(D)` suppressed, `(NA)` not available, `(NM)` not meaningful, `(L)` under $50,000 or 10
|
|
95
|
+
jobs, `(S)`, `(X)`, `(*)` (MNE: rounds to zero): `value` is empty and the code is in `flag`. Never a zero;
|
|
96
|
+
list the rows with a `flag` and drop or footnote the area.
|
|
97
|
+
- **No sums of chained dollars**, of components or of states; shares from current dollars; drivers of growth
|
|
98
|
+
from BEA's contributions tables (T10102, SAGDP11). SAAR levels are averaged, not added, for annual values.
|
|
99
|
+
- **Growth measures differ** by a point or more: quarterly at a compound annual rate (BEA's headline:
|
|
100
|
+
(level / previous level)^4 - 1), year over year (T10111), Q4 over Q4, annual average; "since <year>":
|
|
101
|
+
cumulative change and the average annual rate. Name the measure everywhere; show the alternatives as a
|
|
102
|
+
sensitivity.
|
|
103
|
+
- **Check against BEA's published numbers** (docs/datasets.md section 5): growth
|
|
104
|
+
from T10106 levels vs T10101; the U.S. row of SAGDP9 vs T10106 line 1. A mismatch beyond rounding is an
|
|
105
|
+
error; a difference from an older release is a revision (compare dates with the vintage in README.md).
|
|
106
|
+
- **Vintage:** BEA serves only its latest estimates (advance, second, third; annual updates each September;
|
|
107
|
+
comprehensive updates every five years). Record the release date; old vintages are at apps.bea.gov/histdata.
|
|
108
|
+
- **Geography:** every row has `geo_level` (nation, region, state, county, msa); a COUNTY bulk download also
|
|
109
|
+
holds state and U.S. rows: filter before summing. `STATE` = 50 states + D.C. + U.S. (say whether D.C. is
|
|
110
|
+
ranked). Since February 2026 BEA no longer produces GDP or personal income for metro areas: sum component
|
|
111
|
+
counties' current-dollar values and say so. Rank on unrounded values; name near-ties.
|
|
112
|
+
- **Calendar years** everywhere (NIPA federal spending too, unlike fiscal-year budget data). NIPA line
|
|
113
|
+
numbers change at comprehensive updates: check the description or series code, not only the line.
|
|
114
|
+
GDP-by-industry line numbers differ between tables (TVA106 has an extra line): match by description.
|
|
115
|
+
- **No standard errors** exist for BEA estimates: never "statistically different".
|
|
116
|
+
- Analysis: build growth rates, shares and comparisons with `compute` on `data/bea/bea_data.csv`, and check each
|
|
117
|
+
headline against the published table.
|
|
118
|
+
|
|
119
|
+
## Access
|
|
120
|
+
- **Key** `BEA_API_KEY` (free, https://apps.bea.gov/API/signup/; BEA emails it and it works only after the
|
|
121
|
+
activation link is clicked). Found, in order, in the environment, `BEA_API_KEY_FILE`, keys.json, Claude Code
|
|
122
|
+
settings.json and `~/.bea/api_key`; the user stores it with `npx -y data-analyst-mcp setup bea` in their own
|
|
123
|
+
terminal. Never ask for the key in chat. BEA puts it in the URL and echoes it in every
|
|
124
|
+
reply: the server scrubs both (the key and the USERID echo); never build your own API URLs.
|
|
125
|
+
- **Limits** per key: 100 requests, 100 MB and 30 errors a minute; going over blocks the key for a minute to
|
|
126
|
+
an hour (HTTP 429, never retried). The client spaces calls 0.75 s, waits before crossing 100 MB a minute,
|
|
127
|
+
stops after 30 errors a minute or 10 in a run, validates table and line names against cached metadata
|
|
128
|
+
first, and checks dataset parameter rules offline (`invalid_request`), so errors are not spent.
|
|
129
|
+
- **Routes** (`route` in the result): `reuse_existing` (`data/bea/` already holds the request; `force: true`
|
|
130
|
+
downloads again), `api` (key works), `bulk` (no usable key and every request is in the bulk files: NIPA
|
|
131
|
+
flat files, state and county zips, GDP-by-industry workbooks; same latest estimates; the spec's
|
|
132
|
+
`"prefer": "bulk"` forces it, `"prefer": "api"` never falls back). A key BEA rejects or has locked out falls
|
|
133
|
+
back to the bulk files when they hold every request. Errors: `key_missing` (no key and a request needs the
|
|
134
|
+
API: the user runs `npx -y data-analyst-mcp setup bea`, or `manual_bundle`), `key_rejected`,
|
|
135
|
+
`rate_limited`, `agency_rejected` (fix the spec; never loop: errors count against the key) and
|
|
136
|
+
`agency_unavailable` (BEA unreachable; never invent or recall data). Bulk files are cached in
|
|
137
|
+
`<cache_root>/bea/bulk` (`DATA_ANALYST_CACHE` sets the root) and revalidated by Last-Modified; NIPA files are
|
|
138
|
+
12-37 MB, county zips up to 50 MB.
|
|
139
|
+
- **Manual download:** `manual_bundle` writes `manual_download/`: `INSTRUCTIONS.md` with the links, and
|
|
140
|
+
`download_data.sh` (macOS, Linux) and `download_data.ps1` (Windows), one-command scripts that download the
|
|
141
|
+
public files and ask for the key with hidden input only when an API request needs it. Send both scripts and
|
|
142
|
+
INSTRUCTIONS.md, and give the one command for the user's system (`user_commands`). BEA repeats the key inside
|
|
143
|
+
API replies: `ingest` removes it. Then `ingest` with the uploaded files or their folder (on a hosted server,
|
|
144
|
+
`files: ["uploads"]`). Say in the methods that the files were downloaded by hand.
|
|
145
|
+
|
|
146
|
+
## Citation and terms
|
|
147
|
+
"U.S. Bureau of Economic Analysis, <tables>, <route> (accessed <date>)." The exact line is in
|
|
148
|
+
`data/bea/README.md`; include the release (vintage) when it matters. Source line: "Analyst calculations using
|
|
149
|
+
data from the Bureau of Economic Analysis." BEA data are public domain: redistribution allowed (data files
|
|
150
|
+
may ship in a replication package). Products that use the API must show: "This product uses the Bureau of
|
|
151
|
+
Economic Analysis (BEA) Data API but is not endorsed or certified by BEA." (the API terms' wording) Do not
|
|
152
|
+
imply BEA endorsement.
|