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,133 @@
|
|
|
1
|
+
{
|
|
2
|
+
"id": "usda-fna",
|
|
3
|
+
"title": "USDA Food and Nutrition Administration: SNAP, WIC and child nutrition program data, SNAP State Options Report and SNAP State Activity Reports",
|
|
4
|
+
"agency": "U.S. Department of Agriculture, Food and Nutrition Administration (formerly Food and Nutrition Service)",
|
|
5
|
+
"depth": "standard",
|
|
6
|
+
"domains": [
|
|
7
|
+
"nutrition assistance",
|
|
8
|
+
"social safety net",
|
|
9
|
+
"state policy",
|
|
10
|
+
"program administration",
|
|
11
|
+
"school meals"
|
|
12
|
+
],
|
|
13
|
+
"keywords": [
|
|
14
|
+
"snap",
|
|
15
|
+
"food stamps",
|
|
16
|
+
"supplemental nutrition assistance program",
|
|
17
|
+
"fns",
|
|
18
|
+
"fna",
|
|
19
|
+
"food and nutrition service",
|
|
20
|
+
"food and nutrition administration",
|
|
21
|
+
"state options",
|
|
22
|
+
"state options report",
|
|
23
|
+
"snap waivers",
|
|
24
|
+
"snap policy options",
|
|
25
|
+
"bbce",
|
|
26
|
+
"broad-based categorical eligibility",
|
|
27
|
+
"abawd",
|
|
28
|
+
"time limit waiver",
|
|
29
|
+
"certification period",
|
|
30
|
+
"simplified reporting",
|
|
31
|
+
"standard utility allowance",
|
|
32
|
+
"employment and training",
|
|
33
|
+
"drug felony",
|
|
34
|
+
"state activity report",
|
|
35
|
+
"snap participation by state",
|
|
36
|
+
"snap issuance",
|
|
37
|
+
"snap benefits by state",
|
|
38
|
+
"emergency allotments",
|
|
39
|
+
"snap administrative costs",
|
|
40
|
+
"fair hearings",
|
|
41
|
+
"snap fraud",
|
|
42
|
+
"trafficking",
|
|
43
|
+
"recipient claims",
|
|
44
|
+
"disqualifications",
|
|
45
|
+
"wic",
|
|
46
|
+
"women infants and children",
|
|
47
|
+
"wic participation",
|
|
48
|
+
"wic food costs",
|
|
49
|
+
"breastfeeding",
|
|
50
|
+
"school lunch",
|
|
51
|
+
"nslp",
|
|
52
|
+
"national school lunch program",
|
|
53
|
+
"school breakfast",
|
|
54
|
+
"sbp",
|
|
55
|
+
"free and reduced price meals",
|
|
56
|
+
"school meals",
|
|
57
|
+
"child nutrition",
|
|
58
|
+
"special milk program",
|
|
59
|
+
"cacfp",
|
|
60
|
+
"child and adult care food program",
|
|
61
|
+
"summer meals",
|
|
62
|
+
"summer food service program",
|
|
63
|
+
"sfsp",
|
|
64
|
+
"snap participation by month",
|
|
65
|
+
"snap households",
|
|
66
|
+
"program data"
|
|
67
|
+
],
|
|
68
|
+
"questions": [
|
|
69
|
+
"which states use broad-based categorical eligibility for SNAP",
|
|
70
|
+
"which states have an ABAWD time limit waiver",
|
|
71
|
+
"the SNAP policy options a state has chosen, compared with another state",
|
|
72
|
+
"SNAP administrative costs by state and the federal share",
|
|
73
|
+
"SNAP participation, issuance and average benefit by state for a fiscal year",
|
|
74
|
+
"SNAP fraud investigations, disqualifications and recipient claims by state",
|
|
75
|
+
"SNAP persons, households and benefits by state for the latest month or each month since FY 2020",
|
|
76
|
+
"WIC participation by state, tribal organization or category (women, infants, children) and WIC food costs",
|
|
77
|
+
"school lunch and breakfast participation, meals served and cash payments by state",
|
|
78
|
+
"national trends in SNAP, WIC, school meals, summer meals and CACFP since 1969"
|
|
79
|
+
],
|
|
80
|
+
"homepage": "https://www.fna.usda.gov/pd/overview",
|
|
81
|
+
"terms_url": "https://www.usda.gov/policies-and-links",
|
|
82
|
+
"auth": {
|
|
83
|
+
"env": null,
|
|
84
|
+
"required": "none",
|
|
85
|
+
"placement": "none",
|
|
86
|
+
"signup_url": null,
|
|
87
|
+
"echoes_key": false
|
|
88
|
+
},
|
|
89
|
+
"limits": {
|
|
90
|
+
"rps": 1,
|
|
91
|
+
"burst": 2,
|
|
92
|
+
"max_rows": 100000
|
|
93
|
+
},
|
|
94
|
+
"routes": {
|
|
95
|
+
"api": {
|
|
96
|
+
"base": "https://www.fna.usda.gov",
|
|
97
|
+
"probe": "https://www.fna.usda.gov/snap/waivers/state-options-report",
|
|
98
|
+
"hosts": [
|
|
99
|
+
"www.fna.usda.gov",
|
|
100
|
+
"fna-bwbufwdzbabpezgc.z01.azurefd.us",
|
|
101
|
+
"publicdashboards.dl.usda.gov"
|
|
102
|
+
]
|
|
103
|
+
},
|
|
104
|
+
"manual": {
|
|
105
|
+
"how": "Open each link in manual_download/INSTRUCTIONS.md in a browser and save the file under the name shown (the PDFs, Excel files and the SNAP zip download; a dashboard .csv link downloads a small CSV), then upload them. Without the links: Program Data Excel tables at https://www.fna.usda.gov/pd/supplemental-nutrition-assistance-program-snap, https://www.fna.usda.gov/pd/wic-program and https://www.fna.usda.gov/pd/child-nutrition-tables; the State Options Report PDFs at https://www.fna.usda.gov/snap/waivers/state-options-report, the SNAP State Activity Reports (PDF, FY 2004-2023) at https://www.fna.usda.gov/pd/snap-state-activity-reports; the dashboard at https://www.fna.usda.gov/data-research/data-visualization/snap/state-options has no download button, so upload the PDF instead."
|
|
106
|
+
}
|
|
107
|
+
},
|
|
108
|
+
"cache": {
|
|
109
|
+
"mode": "run_only",
|
|
110
|
+
"ttl_hours": null,
|
|
111
|
+
"why": "The reports change once a year and the Program Data tables monthly; data/ is reused only within a run."
|
|
112
|
+
},
|
|
113
|
+
"redistribution": {
|
|
114
|
+
"mode": "allowed",
|
|
115
|
+
"why": "Works of the U.S. Department of Agriculture, a federal agency: public domain (17 U.S.C. 105)."
|
|
116
|
+
},
|
|
117
|
+
"notices": [],
|
|
118
|
+
"retention": null,
|
|
119
|
+
"citation": "U.S. Department of Agriculture, Food and Nutrition Administration, {dataset}, fna.usda.gov, retrieved {retrieved_long}.",
|
|
120
|
+
"audit_hooks": [],
|
|
121
|
+
"clarify": [
|
|
122
|
+
"Which State Options Report edition (as-of date)? Options change every year. Default: the latest, the 17th edition (Aug 2025, options in place Oct 1, 2024, FFY 2025).",
|
|
123
|
+
"SNAP issuance with or without emergency allotments (FY 2020-2023)? Default: report both, named separately (the State Activity Reports' total issuance includes them).",
|
|
124
|
+
"All 53 SNAP state agencies (50 states, DC, Guam, Virgin Islands) or the 50 states only? Default: all 53, the reports' own count.",
|
|
125
|
+
"Latest months are preliminary (initial for the newest) and revised later: report the status column with them. Default: use them, labeled.",
|
|
126
|
+
"Program year or federal fiscal year? FNA tables are federal fiscal years (October-September); school year SY 2024-25 is not FY 2025. Default: fiscal years, said so."
|
|
127
|
+
],
|
|
128
|
+
"formats": [
|
|
129
|
+
"csv",
|
|
130
|
+
"pdf",
|
|
131
|
+
"xlsx"
|
|
132
|
+
]
|
|
133
|
+
}
|
|
@@ -0,0 +1,217 @@
|
|
|
1
|
+
# USDA Food and Nutrition Administration: SNAP, WIC and child nutrition program data, SNAP State Options Report and SNAP State Activity Reports
|
|
2
|
+
Depth: standard. Key: none. FNA's Program Data tables cover participation, meals and costs. SNAP, WIC and the child
|
|
3
|
+
nutrition programs (school lunch and breakfast, special milk, CACFP, summer meals) are national from FY 1969 and by
|
|
4
|
+
state for recent years and months. Two SNAP reports cover states:
|
|
5
|
+
- the State Options Report gives each agency's policy options, waivers and projects (editions 1-17, 2002-2025);
|
|
6
|
+
- the State Activity Reports give participation, issuance, admin costs, hearings, fraud and claims (FY 2004-2023).
|
|
7
|
+
|
|
8
|
+
## When to use
|
|
9
|
+
- Participation, meals or costs of SNAP, WIC or the child nutrition programs:
|
|
10
|
+
- national, by year since 1969 (`*_annual`) or by month for the last four fiscal years (`*_monthly`);
|
|
11
|
+
- by state for the last five fiscal years (`*_state`) or the latest three months (`*_latest`);
|
|
12
|
+
- SNAP by state and month from FY 2020 (`snap_state_monthly`);
|
|
13
|
+
- WIC by state agency, tribal organization and month, with participant categories (`wic_agency_monthly`).
|
|
14
|
+
- Which states use an option or waiver (BBCE, ABAWD time limit waiver, simplified reporting, drug felony ban,
|
|
15
|
+
combined application projects ...). One state's choices compared with another's. A state's SNAP administrative
|
|
16
|
+
cost, federal share, cost per case, fair hearings, fraud investigations, disqualifications or claims for
|
|
17
|
+
FY 2019-2023 (tidy rows), or for FY 2004-2018 (page text).
|
|
18
|
+
- Not here:
|
|
19
|
+
- SNAP by state and month before FY 2020 (old .xls files in the same zip; this pack does not read them);
|
|
20
|
+
- characteristics of SNAP households from the Quality Control microdata (snapqcdata.net): snapqc;
|
|
21
|
+
- official payment error rates (PDF charts at https://www.fna.usda.gov/snap/qc/per): not covered;
|
|
22
|
+
- P-EBT and SNAP by county/project area (zips on the SNAP page): not read;
|
|
23
|
+
- poverty and SNAP receipt in household surveys: census (ACS), ipums;
|
|
24
|
+
- federal spending on SNAP by recipient: usaspending.
|
|
25
|
+
- The agency was renamed: the Food and Nutrition Service (FNS) is now the Food and Nutrition Administration (FNA).
|
|
26
|
+
fns.usda.gov redirects to www.fna.usda.gov. The reports up to 2025 still say FNS.
|
|
27
|
+
|
|
28
|
+
## Endpoints and datasets
|
|
29
|
+
Verified live 2026-10-30. One CSV per request.
|
|
30
|
+
|
|
31
|
+
| Endpoint | Returns (one row per) | Key parameters | Coverage |
|
|
32
|
+
|---|---|---|---|
|
|
33
|
+
| `options_by_state` | agency × policy option: `edition, state, state_abbr, policy_option, option_selection, agencies_with_selection, share_of_agencies` | `state` (names or USPS codes, default all 53), `edition` (`16`, `17`, default 17) | policy options only (13-16 per agency); no waivers or projects |
|
|
34
|
+
| `option_states` | agency with a selection: `edition, policy_option, option_selection, state, state_abbr` | `policy` (catalog alias or name, required), `selection` (default: every selection, so each agency once), `edition` | every policy, waiver and project of editions 16-17 |
|
|
35
|
+
| `options_report` | PDF page: `edition, edition_label, page, state, text` | `edition` (1-17), `state` (keeps that agency's profile pages; editions 16-17), `pages` | all 17 editions; PDF: not read on this server (see Access) |
|
|
36
|
+
| `activity_tables` | value: `report_fy, table, table_number, table_title, page, state, state_abbr, row_type, measure, data_fy, value, value_num, value_flag` | `fiscal_year` (2019-2023, one or a list), `tables` (keys below, default all), `state` | FY 2019-2023; PDF: not read on this server (see Access) |
|
|
37
|
+
| `activity_report` | PDF page: `report_fy, page, table_title, text` | `fiscal_year` (2004-2023), `pages` | every year; national summary and rankings; PDF: not read on this server (see Access) |
|
|
38
|
+
| `program_table` | value: `table, table_title, data_as_of, state, state_abbr, agency, row_type, period, period_type, fiscal_year, measure, unit, value, value_num, value_flag, status, footnote` | `table` (catalog key, required), `state` (state tables only), `fiscal_year` | 34 FNA Program Data tables (below); updated monthly |
|
|
39
|
+
| `snap_state_monthly` | value, same columns | `fiscal_year` (2020 onward, one or a list), `state` | SNAP households, persons, benefits, benefit per household / person by state, FNA region and U.S., each month and the fiscal year |
|
|
40
|
+
| `wic_agency_monthly` | value, same columns | `fiscal_year` (2022 onward, one a request), `measures` (default `participants_total`; `all`), `state` | WIC by state agency, tribal organization and region, each month and the fiscal year |
|
|
41
|
+
|
|
42
|
+
- `program_table` keys (`request_schema` with `search` finds them with descriptions):
|
|
43
|
+
- SNAP: `snap_annual` (FY 1969-), `snap_monthly`, and by state for the latest three months
|
|
44
|
+
`snap_persons_latest`, `snap_households_latest`, `snap_benefits_latest`;
|
|
45
|
+
- WIC: `wic_annual` (FY 1974-), `wic_monthly`; by state for five fiscal years `wic_participation_state`,
|
|
46
|
+
`wic_food_costs_state`, `wic_avg_food_cost_state`, `wic_nsa_costs_state`; and `wic_participation_latest`;
|
|
47
|
+
- child nutrition, national: `nslp_annual`, `sbp_annual`, `smp_annual`, `cacfp_annual`, `sfsp_annual`,
|
|
48
|
+
`school_meals_costs` (cash and commodities, FY 1969-), `nslp_monthly`, `sbp_monthly`, `cacfp_monthly`;
|
|
49
|
+
- child nutrition, by state for five fiscal years: `nslp_participation_state`, `nslp_lunches_state`,
|
|
50
|
+
`nslp_cash_state`, `nslp_commodities_state`, `sbp_participation_state`, `sbp_breakfasts_state`,
|
|
51
|
+
`sbp_cash_state`, `smp_half_pints_state`, `cacfp_attendance_state`, `cacfp_meals_state`, `cacfp_cash_state`,
|
|
52
|
+
`sfsp_attendance_state`, `sfsp_meals_state`, `sfsp_cash_state`; latest three months:
|
|
53
|
+
`nslp_participation_latest`, `sbp_participation_latest`.
|
|
54
|
+
- `wic_agency_monthly` measures: `pregnant_women`, `women_fully_breastfeeding`, `women_partially_breastfeeding`,
|
|
55
|
+
`breastfeeding_women_total`, `postpartum_women`, `women_total`, `infants_fully_breastfed`,
|
|
56
|
+
`infants_partially_breastfed`, `infants_fully_formula_fed`, `infants_total`, `children`, `participants_total`,
|
|
57
|
+
`avg_food_cost_per_person`, `food_costs`, `rebates`, `nsa_costs` (fiscal-year total only).
|
|
58
|
+
|
|
59
|
+
- The catalog also holds the policies (`request_schema` with `search: "waiver"`). Each entry has an alias, the
|
|
60
|
+
exact dashboard name and its selections. Examples:
|
|
61
|
+
- options: `bbce`, `reporting_requirements`, `certification_period_lengths`, `utility_expenses`,
|
|
62
|
+
`employment_training`, `drug_felony`, `tba`, `abawd_exemptions`;
|
|
63
|
+
- waivers: `abawd_waiver`, `telephonic_signature_waiver`, `on_demand_interview_waiver`, `early_denial_waiver`;
|
|
64
|
+
- projects: `cap`, `esap`, `smd`.
|
|
65
|
+
- `activity_tables` table keys:
|
|
66
|
+
- participation: `participation_issuance` (FY 2019 only), `average_benefit`, `emergency_allotments`
|
|
67
|
+
(FY 2021-2023), `households_by_benefit_type`, `persons_by_benefit_type`, `issuance_by_benefit_type`;
|
|
68
|
+
- costs: `admin_costs`, `covid_admin_funding` (FY 2021), `admin_costs_per_case`,
|
|
69
|
+
`federal_admin_costs_per_case` (FY 2019-2020), `federal_selected_costs`, `federal_adp_costs`,
|
|
70
|
+
`federal_cert_costs_per_case`;
|
|
71
|
+
- fair hearings and fraud: `fair_hearings`, `adh`, `fraud_investigations`, `prosecutions`, `disqualifications`;
|
|
72
|
+
- claims: `claims_established_dollars`, `claims_established_count`, `claims_collected_by_type`,
|
|
73
|
+
`claims_collected_by_method`;
|
|
74
|
+
- multi-year comparisons, each value with its own `data_fy`: `persons_multiyear`, `households_multiyear`,
|
|
75
|
+
`issuance_multiyear` (three years), `federal_costs_multiyear`, `federal_costs_per_case_multiyear`,
|
|
76
|
+
`federal_cert_costs_multiyear`, `federal_cert_costs_per_case_multiyear`, `fair_hearings_multiyear`,
|
|
77
|
+
`disqualifications_multiyear`, `claims_established_multiyear`, `claims_collected_multiyear` (two years).
|
|
78
|
+
- State-level persons, households and total issuance for FY 2020-2023 are in the `*_multiyear` tables. The
|
|
79
|
+
single-year participation table exists only in FY 2019.
|
|
80
|
+
|
|
81
|
+
## Spec examples
|
|
82
|
+
```json
|
|
83
|
+
{"description": "Which SNAP agencies use BBCE and have an ABAWD time limit waiver (17th edition)",
|
|
84
|
+
"requests": [{"name": "bbce", "endpoint": "option_states", "params": {"policy": "bbce"}},
|
|
85
|
+
{"name": "abawd_waiver", "endpoint": "option_states", "params": {"policy": "abawd_waiver"}}]}
|
|
86
|
+
```
|
|
87
|
+
```json
|
|
88
|
+
{"description": "Texas and California SNAP policy options, and Texas's full profile with waivers (PDF)",
|
|
89
|
+
"requests": [{"name": "tx_ca", "endpoint": "options_by_state", "params": {"state": ["TX", "CA"]}},
|
|
90
|
+
{"name": "tx_profile", "endpoint": "options_report", "params": {"edition": 17, "state": "TX"}}]}
|
|
91
|
+
```
|
|
92
|
+
```json
|
|
93
|
+
{"description": "SNAP administrative costs and households by state, FY 2022-2023",
|
|
94
|
+
"requests": [{"name": "sar", "endpoint": "activity_tables",
|
|
95
|
+
"params": {"fiscal_year": [2022, 2023], "tables": ["admin_costs", "admin_costs_per_case"]}}]}
|
|
96
|
+
```
|
|
97
|
+
The `options_report` and `activity_tables` requests above read PDFs, which this server cannot read yet: `fetch`
|
|
98
|
+
refuses them with `not_supported` (see Access).
|
|
99
|
+
|
|
100
|
+
```json
|
|
101
|
+
{"description": "SNAP persons by state and month FY 2025-2026 (TX, CA); school lunch participation by state; WIC children by agency FY 2025",
|
|
102
|
+
"requests": [{"name": "snap_tx_ca", "endpoint": "snap_state_monthly", "params": {"fiscal_year": [2025, 2026], "state": ["TX", "CA"]}},
|
|
103
|
+
{"name": "nslp", "endpoint": "program_table", "params": {"table": "nslp_participation_state"}},
|
|
104
|
+
{"name": "wic_children", "endpoint": "wic_agency_monthly", "params": {"fiscal_year": 2025, "measures": ["children", "participants_total"]}}]}
|
|
105
|
+
```
|
|
106
|
+
|
|
107
|
+
## Data format and traps
|
|
108
|
+
Program Data tables (`program_table`, `snap_state_monthly`, `wic_agency_monthly`; verified 2026-10-30):
|
|
109
|
+
- **Fiscal years.** Every period is a federal fiscal year (October-September) or a month (`period` 2026-07,
|
|
110
|
+
`fiscal_year` 2026 for Oct 2025-Sep 2026). A school year (SY 2024-25) is not FY 2025. `period_type` says which.
|
|
111
|
+
- **Units differ by table.** Read `unit` on every row:
|
|
112
|
+
- the national annual tables are in thousands or millions (SNAP participation in thousands, costs in millions);
|
|
113
|
+
- state and monthly tables are in units;
|
|
114
|
+
- shares are fractions (0-1) in the monthly tables but percent in the annual tables;
|
|
115
|
+
- participation is a monthly average (SNAP, WIC), a 9-month school-year average (NSLP, SBP: summer months
|
|
116
|
+
excluded) or July average daily attendance (SFSP).
|
|
117
|
+
- **Fiscal-year rows of a year in progress are partial.** `snap_monthly` "FY 2026" averages Oct-Jul; a
|
|
118
|
+
`snap_state_monthly` FY total averages the months reported (later months print `--`).
|
|
119
|
+
- **status**: `initial` (the newest month), `preliminary` (the month before, or a year the workbook calls
|
|
120
|
+
preliminary), else empty. Recent months are revised; label them. The WIC agency workbooks call every year
|
|
121
|
+
"preliminary", even FY 2025, which the listing page calls final.
|
|
122
|
+
- **row_type** separates what must not be summed together:
|
|
123
|
+
- `state`: a state or territory (DC, GU, VI, PR, AS, MP); `dod`: Department of Defense schools;
|
|
124
|
+
- `total`: the printed TOTAL; `national`: U.S. rows of the national tables; `region`: FNA regions;
|
|
125
|
+
- WIC by state (`wic_*_state`, `wic_participation_latest`): the `state` row is the state total. Its parts
|
|
126
|
+
(state agency, Indian tribal organizations) are `sub_agency` rows with the part's name in `agency`;
|
|
127
|
+
- WIC by agency (`wic_agency_monthly`): `state_agency` is the state agency alone, without the tribes (Arizona
|
|
128
|
+
146,899 vs 157,533 with them, FY 2025), and `tribal_org` rows carry their state's code.
|
|
129
|
+
- Drop totals, regions and sub-agencies before summing states. The pack checks agency sums against the printed
|
|
130
|
+
totals and notes any difference.
|
|
131
|
+
- **Missing values**: `--` (none or not reported), `blank` (an empty cell), `#DIV/0!` (a spreadsheet error), or a
|
|
132
|
+
footnote mark such as `1]` (e.g. reduced-price meals included with free before 1971). `value_flag` holds them;
|
|
133
|
+
a flag is never a zero. `footnote` holds marks printed beside a year or value (`1982 3]`: Puerto Rico left SNAP).
|
|
134
|
+
- **Puerto Rico, American Samoa and the Northern Marianas** get Nutrition Assistance Grants, not SNAP: their SNAP
|
|
135
|
+
rows are `--`.
|
|
136
|
+
- **The pack never relabels a header.** `wic_participation_latest` labels its middle column with the year before
|
|
137
|
+
(in every release still online, 27wilatest-5 to -10, May-October 2026: "June 2025" over June 2026 values). The
|
|
138
|
+
pack drops the column, names it and marks the request incomplete. Read that month from `wic_agency_monthly`
|
|
139
|
+
instead. Releases -5 to -9 also print "Data as of" a year early (September 11, 2025 for 2026). When "Data as of"
|
|
140
|
+
precedes the table's own latest data, a note says so; `data_as_of` stays as printed, so cite the release by file
|
|
141
|
+
name and retrieval date rather than that date. Any table whose columns no longer match their labels in
|
|
142
|
+
endpoints.json fails with "expected layout"; values in hidden columns (`nslp_monthly`, `cacfp_monthly`) are skipped.
|
|
143
|
+
- **File names change.** Each workbook name carries a release number (`snap-persons-10.xlsx`). The pack reads the
|
|
144
|
+
current name from the listing page; a table missing there fails rather than falling back.
|
|
145
|
+
|
|
146
|
+
SNAP State Options Report and State Activity Reports:
|
|
147
|
+
- **Editions are not fiscal years.** The 17th edition (Aug 2025) gives options in place on Oct 1, 2024, from the
|
|
148
|
+
FFY 2025 State Plans. The 16th edition (Jun 2024) is from the FFY 2024 plans. Name the edition with every count.
|
|
149
|
+
- **Names change between editions.** Option and selection wording changes from one edition to the next (16th
|
|
150
|
+
"Child support income expense deduction", 17th "Deducted from income"; "entire" vs "whole" household), and
|
|
151
|
+
options come and go in the dashboard: self-employment income and the two noncitizen-income options are 16th
|
|
152
|
+
only; Pledge States, SNAP E&T and nine waivers are 17th only (verified 2026-10-30; the catalog descriptions
|
|
153
|
+
say which). For an option missing from an edition's dashboard, read that edition's PDF. Match by meaning, say so, and never splice editions silently.
|
|
154
|
+
- **53 state agencies, not 50 states**: the 50 states, DC, Guam (GU) and the Virgin Islands (VI). The reports' "all
|
|
155
|
+
States" means 53. `agencies_with_selection` and `share_of_agencies` are national counts across the 53
|
|
156
|
+
(the share is a fraction), repeated on each agency's row, not a value for that agency.
|
|
157
|
+
- **Several selections per agency**: Certification Period Lengths gives one row per length offered
|
|
158
|
+
("4,6,12" in `options_by_state`), so states can add up to more than 53.
|
|
159
|
+
- **The dashboard is not an API.** The pack checks every exported row against the policy, selection and edition
|
|
160
|
+
asked for: an unknown value makes the dashboard fall back to its default view. If FNA republishes the
|
|
161
|
+
dashboard, the view path changes. The error says so; read that edition's PDF instead
|
|
162
|
+
(link from `manual_bundle`; this server does not read it, see Access).
|
|
163
|
+
- **activity_tables values** are as printed. `value_num` drops `$ , %`. `value_flag` keeps codes: `N/A` (not
|
|
164
|
+
applicable, e.g. no cash issuance), `-`/`--` (none or not reported), `blank` (not printed; a footnote may say
|
|
165
|
+
the data are missing, e.g. DC claims FY 2021). A flag is never a zero.
|
|
166
|
+
- Units: dollars, monthly-average persons or households, counts, and percent (`percent_upheld`,
|
|
167
|
+
`*_percent_change`).
|
|
168
|
+
- Each table also has `row_type = us_total` rows, the printed U.S. line. Drop them before summing agencies.
|
|
169
|
+
- **The pack checks each table against the PDF.**
|
|
170
|
+
- A table is kept only if its values line up with its columns and the column labels appear in the printed
|
|
171
|
+
header.
|
|
172
|
+
- A table that fails is dropped, and the fetch reports it as incomplete with the page to read with
|
|
173
|
+
`activity_report`.
|
|
174
|
+
- Agency sums are compared with the printed U.S. total, and the fetch notes any difference. Known published
|
|
175
|
+
differences: FY 2020 emergency-allotment persons and households (the U.S. figure is about 60% of the agency
|
|
176
|
+
sum), FY 2021 cash participation, and the FY 2022 state and federal shares of admin costs (about 0.6%).
|
|
177
|
+
- Report such a difference; do not fix it.
|
|
178
|
+
- **Emergency allotments** (pandemic supplements, ended after Feb 2023) are in issuance for FY 2020-2023. The
|
|
179
|
+
reports exclude P-EBT, Disaster SNAP and replacements of stolen benefits.
|
|
180
|
+
- **100% federal funding.** ARPA (FY 2021-2023) and CAA 2021 paid 100% federal administrative funding on top of
|
|
181
|
+
the usual 50% share: `arpa_funding` (FY 2022-2023 admin_costs) and `covid_admin_funding` (FY 2021).
|
|
182
|
+
- **Mislabeled headers in the source.** The FY 2019-2021 persons multi-year tables print "Households
|
|
183
|
+
Participating" in their column headers. The table title (persons) is right; the pack labels by title.
|
|
184
|
+
- **Single-year vs multi-year.** A value can appear in a single-year table and again in a later report's
|
|
185
|
+
multi-year table. They agree where checked (persons, households, issuance, federal costs, FY 2019-2023). Use one
|
|
186
|
+
source per figure.
|
|
187
|
+
|
|
188
|
+
## Access
|
|
189
|
+
- No key. Hosts:
|
|
190
|
+
- www.fna.usda.gov: the Program Data listing pages and workbooks, and the PDFs (files redirect to
|
|
191
|
+
fna-bwbufwdzbabpezgc.z01.azurefd.us);
|
|
192
|
+
- publicdashboards.dl.usda.gov: the Tableau dashboard's CSV exports.
|
|
193
|
+
- Plain scripted requests are answered (verified 2026-10-30). The pack sends one request a second.
|
|
194
|
+
`options_by_state` makes one call per two agencies (27 calls for all 53); `option_states` makes one per selection.
|
|
195
|
+
A Program Data request makes two calls (the listing page, then the 15-230 KB workbook);
|
|
196
|
+
`snap_state_monthly` downloads the 1.6 MB SNAP zip once per request.
|
|
197
|
+
- The PDF endpoints (`options_report`, `activity_tables`, `activity_report`) need a PDF text reader, which this
|
|
198
|
+
server does not have: `fetch` and `ingest` refuse them with `not_supported`. The State Options rows come from
|
|
199
|
+
`options_by_state` / `option_states` (no PDF); for a report page, give the user the PDF link from `manual_bundle`.
|
|
200
|
+
The dashboard and Program Data endpoints are not affected.
|
|
201
|
+
- Manual: `manual_bundle` writes `manual_download/INSTRUCTIONS.md`, which lists every file. Each PDF is a direct
|
|
202
|
+
download; each dashboard `.csv` link downloads a small CSV. Save under the name shown and upload; `ingest` parses
|
|
203
|
+
the CSVs and workbooks the same way as `fetch`.
|
|
204
|
+
The Program Data links name the release seen on 2026-10-30 (`-10`). If one is gone, download that table's
|
|
205
|
+
Excel file from its listing page. Uploads are checked by content (title row, fiscal year), not by name.
|
|
206
|
+
Without the bundle:
|
|
207
|
+
- Program Data: https://www.fna.usda.gov/pd/supplemental-nutrition-assistance-program-snap,
|
|
208
|
+
https://www.fna.usda.gov/pd/wic-program, https://www.fna.usda.gov/pd/child-nutrition-tables
|
|
209
|
+
- State Options Report PDFs: https://www.fna.usda.gov/snap/waivers/state-options-report
|
|
210
|
+
- State Activity Reports: https://www.fna.usda.gov/pd/snap-state-activity-reports
|
|
211
|
+
- The dashboard (https://www.fna.usda.gov/data-research/data-visualization/snap/state-options) has no download
|
|
212
|
+
button.
|
|
213
|
+
|
|
214
|
+
## Citation and terms
|
|
215
|
+
U.S. Department of Agriculture, Food and Nutrition Administration, SNAP State Options Report, 17th edition (or SNAP
|
|
216
|
+
State Activity Report, FY <year>; or Program Data: <table title>, data as of <data_as_of>), fna.usda.gov, retrieved
|
|
217
|
+
<date>. Name the edition (and its as-of date), the report year or the data-as-of date with every number. Public domain (works of a federal agency, 17 U.S.C. 105); redistribution allowed.
|
|
@@ -0,0 +1,181 @@
|
|
|
1
|
+
{
|
|
2
|
+
"base_url": "https://api.nal.usda.gov/fdc/v1",
|
|
3
|
+
"retry_html_400": 3,
|
|
4
|
+
"endpoints": {
|
|
5
|
+
"search": {
|
|
6
|
+
"path": "/foods/search",
|
|
7
|
+
"method": "GET",
|
|
8
|
+
"description": "Foods matching a query (200 a page), with their nutrients.",
|
|
9
|
+
"params": {
|
|
10
|
+
"query": {
|
|
11
|
+
"required": true,
|
|
12
|
+
"desc": "search words, e.g. cheddar cheese; supports +word, -word, \"phrases\" and field queries such as foodCategory:\"Cheese\" or +foodCategory:\"Cheese\" +ingredients:\"annatto\" (quote a value of several words; spell category names exactly as FDC does)"
|
|
13
|
+
},
|
|
14
|
+
"dataType": {
|
|
15
|
+
"desc": "Foundation, SR Legacy, Survey (FNDDS), Branded, Experimental (list or comma text)"
|
|
16
|
+
},
|
|
17
|
+
"brandOwner": {
|
|
18
|
+
"desc": "Branded foods only: brand owner name"
|
|
19
|
+
},
|
|
20
|
+
"sortBy": {
|
|
21
|
+
"desc": "dataType.keyword, lowercaseDescription.keyword, fdcId, publishedDate"
|
|
22
|
+
},
|
|
23
|
+
"sortOrder": {
|
|
24
|
+
"desc": "asc or desc"
|
|
25
|
+
}
|
|
26
|
+
},
|
|
27
|
+
"records": "foods",
|
|
28
|
+
"total": "totalHits",
|
|
29
|
+
"paging": {
|
|
30
|
+
"type": "page",
|
|
31
|
+
"page_param": "pageNumber",
|
|
32
|
+
"size_param": "pageSize",
|
|
33
|
+
"size": 200,
|
|
34
|
+
"start": 1
|
|
35
|
+
},
|
|
36
|
+
"max_rows": 10000,
|
|
37
|
+
"missing": [
|
|
38
|
+
""
|
|
39
|
+
],
|
|
40
|
+
"flatten": true
|
|
41
|
+
},
|
|
42
|
+
"food": {
|
|
43
|
+
"path": "/food/{fdcId}",
|
|
44
|
+
"method": "GET",
|
|
45
|
+
"description": "One food by FDC id, with every nutrient (format full) or the main ones (abridged).",
|
|
46
|
+
"params": {
|
|
47
|
+
"fdcId": {
|
|
48
|
+
"in": "path",
|
|
49
|
+
"required": true,
|
|
50
|
+
"desc": "FoodData Central id, e.g. 328637"
|
|
51
|
+
},
|
|
52
|
+
"format": {
|
|
53
|
+
"desc": "full (default) or abridged",
|
|
54
|
+
"enum": [
|
|
55
|
+
"full",
|
|
56
|
+
"abridged"
|
|
57
|
+
]
|
|
58
|
+
},
|
|
59
|
+
"nutrients": {
|
|
60
|
+
"desc": "nutrient NUMBERS to keep, e.g. 203,204,208 (protein, fat, energy)"
|
|
61
|
+
}
|
|
62
|
+
},
|
|
63
|
+
"records": "",
|
|
64
|
+
"paging": {
|
|
65
|
+
"type": "none"
|
|
66
|
+
},
|
|
67
|
+
"max_rows": 1,
|
|
68
|
+
"missing": [
|
|
69
|
+
""
|
|
70
|
+
],
|
|
71
|
+
"flatten": true
|
|
72
|
+
},
|
|
73
|
+
"foods": {
|
|
74
|
+
"path": "/foods",
|
|
75
|
+
"method": "GET",
|
|
76
|
+
"description": "Up to 20 foods by FDC id in one call (the documented maximum; the API silently drops ids past 50).",
|
|
77
|
+
"params": {
|
|
78
|
+
"fdcIds": {
|
|
79
|
+
"required": true,
|
|
80
|
+
"desc": "comma-separated FDC ids, or a list; the pack refuses more than 20 (the API silently drops extra ids)"
|
|
81
|
+
},
|
|
82
|
+
"format": {
|
|
83
|
+
"desc": "abridged (default here) or full",
|
|
84
|
+
"enum": [
|
|
85
|
+
"full",
|
|
86
|
+
"abridged"
|
|
87
|
+
]
|
|
88
|
+
},
|
|
89
|
+
"nutrients": {
|
|
90
|
+
"desc": "nutrient numbers to keep, e.g. 203,204,208"
|
|
91
|
+
}
|
|
92
|
+
},
|
|
93
|
+
"defaults": {
|
|
94
|
+
"format": "abridged"
|
|
95
|
+
},
|
|
96
|
+
"records": "",
|
|
97
|
+
"paging": {
|
|
98
|
+
"type": "none"
|
|
99
|
+
},
|
|
100
|
+
"max_rows": 20,
|
|
101
|
+
"missing": [
|
|
102
|
+
""
|
|
103
|
+
],
|
|
104
|
+
"flatten": true
|
|
105
|
+
},
|
|
106
|
+
"list": {
|
|
107
|
+
"path": "/foods/list",
|
|
108
|
+
"method": "GET",
|
|
109
|
+
"description": "Every food of a data type, paged (abridged nutrients).",
|
|
110
|
+
"params": {
|
|
111
|
+
"dataType": {
|
|
112
|
+
"desc": "Foundation, SR Legacy, Survey (FNDDS), Branded"
|
|
113
|
+
},
|
|
114
|
+
"sortBy": {
|
|
115
|
+
"desc": "dataType.keyword, lowercaseDescription.keyword, fdcId, publishedDate"
|
|
116
|
+
},
|
|
117
|
+
"sortOrder": {
|
|
118
|
+
"desc": "asc or desc"
|
|
119
|
+
}
|
|
120
|
+
},
|
|
121
|
+
"records": "",
|
|
122
|
+
"paging": {
|
|
123
|
+
"type": "page",
|
|
124
|
+
"page_param": "pageNumber",
|
|
125
|
+
"size_param": "pageSize",
|
|
126
|
+
"size": 200,
|
|
127
|
+
"start": 1
|
|
128
|
+
},
|
|
129
|
+
"max_rows": 20000,
|
|
130
|
+
"missing": [
|
|
131
|
+
""
|
|
132
|
+
],
|
|
133
|
+
"flatten": true
|
|
134
|
+
}
|
|
135
|
+
},
|
|
136
|
+
"catalog": {
|
|
137
|
+
"foundation": {
|
|
138
|
+
"id": "Foundation",
|
|
139
|
+
"name": "Foundation Foods",
|
|
140
|
+
"description": "Minimally processed foods with analytical nutrient values and metadata (dataType Foundation)",
|
|
141
|
+
"endpoint": "search"
|
|
142
|
+
},
|
|
143
|
+
"sr_legacy": {
|
|
144
|
+
"id": "SR Legacy",
|
|
145
|
+
"name": "SR Legacy",
|
|
146
|
+
"description": "USDA National Nutrient Database for Standard Reference, final 2018 release (dataType SR Legacy)",
|
|
147
|
+
"endpoint": "search"
|
|
148
|
+
},
|
|
149
|
+
"survey_fndds": {
|
|
150
|
+
"id": "Survey (FNDDS)",
|
|
151
|
+
"name": "Food and Nutrient Database for Dietary Studies",
|
|
152
|
+
"description": "Foods as eaten in What We Eat in America / NHANES (dataType Survey (FNDDS))",
|
|
153
|
+
"endpoint": "search"
|
|
154
|
+
},
|
|
155
|
+
"branded": {
|
|
156
|
+
"id": "Branded",
|
|
157
|
+
"name": "Global Branded Food Products Database",
|
|
158
|
+
"description": "Label data for branded products from manufacturers (dataType Branded; the largest set)",
|
|
159
|
+
"endpoint": "search"
|
|
160
|
+
}
|
|
161
|
+
},
|
|
162
|
+
"nutrient_numbers": {
|
|
163
|
+
"208": "Energy (kcal)",
|
|
164
|
+
"203": "Protein (g)",
|
|
165
|
+
"204": "Total lipid (fat) (g)",
|
|
166
|
+
"205": "Carbohydrate, by difference (g)",
|
|
167
|
+
"269": "Total sugars (g)",
|
|
168
|
+
"291": "Fiber, total dietary (g)",
|
|
169
|
+
"307": "Sodium, Na (mg)",
|
|
170
|
+
"301": "Calcium, Ca (mg)",
|
|
171
|
+
"303": "Iron, Fe (mg)",
|
|
172
|
+
"306": "Potassium, K (mg)",
|
|
173
|
+
"601": "Cholesterol (mg)",
|
|
174
|
+
"606": "Fatty acids, total saturated (g)",
|
|
175
|
+
"605": "Fatty acids, total trans (g)",
|
|
176
|
+
"401": "Vitamin C (mg)",
|
|
177
|
+
"320": "Vitamin A, RAE (ug)",
|
|
178
|
+
"328": "Vitamin D (D2 + D3) (ug)",
|
|
179
|
+
"255": "Water (g)"
|
|
180
|
+
}
|
|
181
|
+
}
|
|
@@ -0,0 +1,94 @@
|
|
|
1
|
+
{
|
|
2
|
+
"id": "usda-fooddata",
|
|
3
|
+
"title": "USDA FoodData Central",
|
|
4
|
+
"agency": "U.S. Department of Agriculture, Agricultural Research Service",
|
|
5
|
+
"depth": "standard",
|
|
6
|
+
"domains": [
|
|
7
|
+
"nutrition",
|
|
8
|
+
"food",
|
|
9
|
+
"health",
|
|
10
|
+
"agriculture"
|
|
11
|
+
],
|
|
12
|
+
"keywords": [
|
|
13
|
+
"nutrition",
|
|
14
|
+
"nutrient",
|
|
15
|
+
"nutrients",
|
|
16
|
+
"calories",
|
|
17
|
+
"protein",
|
|
18
|
+
"fat",
|
|
19
|
+
"sugar",
|
|
20
|
+
"sodium",
|
|
21
|
+
"fiber",
|
|
22
|
+
"vitamin",
|
|
23
|
+
"mineral",
|
|
24
|
+
"food composition",
|
|
25
|
+
"fooddata central",
|
|
26
|
+
"fdc",
|
|
27
|
+
"branded food",
|
|
28
|
+
"sr legacy",
|
|
29
|
+
"fndds",
|
|
30
|
+
"foundation foods",
|
|
31
|
+
"ingredients",
|
|
32
|
+
"serving size"
|
|
33
|
+
],
|
|
34
|
+
"questions": [
|
|
35
|
+
"calories and protein in a food",
|
|
36
|
+
"sodium content of branded products",
|
|
37
|
+
"compare nutrients of several foods",
|
|
38
|
+
"vitamin content per 100 grams",
|
|
39
|
+
"nutrients of foods as eaten in NHANES (FNDDS)"
|
|
40
|
+
],
|
|
41
|
+
"homepage": "https://fdc.nal.usda.gov/",
|
|
42
|
+
"terms_url": "https://fdc.nal.usda.gov/api-guide",
|
|
43
|
+
"auth": {
|
|
44
|
+
"env": "DATA_GOV_API_KEY",
|
|
45
|
+
"required": "optional",
|
|
46
|
+
"placement": "query",
|
|
47
|
+
"param": "api_key",
|
|
48
|
+
"home": "data-gov",
|
|
49
|
+
"signup_url": "https://fdc.nal.usda.gov/api-key-signup",
|
|
50
|
+
"echoes_key": false,
|
|
51
|
+
"key_only": [
|
|
52
|
+
"more than a few requests an hour (DEMO_KEY limits; a free key allows 1,000 an hour)"
|
|
53
|
+
],
|
|
54
|
+
"demo_key": "DEMO_KEY"
|
|
55
|
+
},
|
|
56
|
+
"limits": {
|
|
57
|
+
"rps": 2,
|
|
58
|
+
"burst": 4,
|
|
59
|
+
"max_rows": 200000
|
|
60
|
+
},
|
|
61
|
+
"routes": {
|
|
62
|
+
"api": {
|
|
63
|
+
"base": "https://api.nal.usda.gov/fdc/v1",
|
|
64
|
+
"probe": "https://api.nal.usda.gov/fdc/v1/foods/search?query=apple&pageSize=1",
|
|
65
|
+
"hosts": [
|
|
66
|
+
"api.nal.usda.gov"
|
|
67
|
+
]
|
|
68
|
+
},
|
|
69
|
+
"manual": {
|
|
70
|
+
"how": "Open the links in INSTRUCTIONS.md (they carry DEMO_KEY, which works in a browser for a few requests; replace it with your own api.data.gov key if refused), save each under the shown name and upload. For whole data types download CSV or JSON from https://fdc.nal.usda.gov/download-datasets, or search https://fdc.nal.usda.gov/food-search and download a food's data."
|
|
71
|
+
}
|
|
72
|
+
},
|
|
73
|
+
"cache": {
|
|
74
|
+
"mode": "run_only",
|
|
75
|
+
"ttl_hours": null,
|
|
76
|
+
"why": "Requests are small; FDC publishes new releases of each data type periodically (publishedDate per food). data/ is reused within a run."
|
|
77
|
+
},
|
|
78
|
+
"redistribution": {
|
|
79
|
+
"mode": "allowed",
|
|
80
|
+
"why": "FoodData Central data are in the public domain under CC0 1.0 (https://fdc.nal.usda.gov/api-guide, Licensing); USDA asks that FoodData Central be listed as the source."
|
|
81
|
+
},
|
|
82
|
+
"notices": [],
|
|
83
|
+
"retention": null,
|
|
84
|
+
"citation": "U.S. Department of Agriculture, Agricultural Research Service. FoodData Central: {dataset}. fdc.nal.usda.gov, retrieved {retrieved_long}.",
|
|
85
|
+
"audit_hooks": [],
|
|
86
|
+
"clarify": [
|
|
87
|
+
"Which data type: Foundation (generic foods, analytical values), SR Legacy (generic foods, final 2018 release), Survey (FNDDS, foods as eaten), or Branded (label values of specific products)?",
|
|
88
|
+
"Per 100 g (how FDC reports nutrients) or per serving? Per-serving values need the food's serving size or portion weight."
|
|
89
|
+
],
|
|
90
|
+
"formats": [
|
|
91
|
+
"json",
|
|
92
|
+
"csv"
|
|
93
|
+
]
|
|
94
|
+
}
|