data-analyst-mcp 0.0.0-stage → 0.3.1

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.
Files changed (640) hide show
  1. package/README.md +261 -2
  2. package/dist/adapters/_acf_tidy.d.ts +18 -0
  3. package/dist/adapters/_acf_tidy.js +432 -0
  4. package/dist/adapters/_acf_tidy.js.map +1 -0
  5. package/dist/adapters/_actuaries_read.d.ts +38 -0
  6. package/dist/adapters/_actuaries_read.js +728 -0
  7. package/dist/adapters/_actuaries_read.js.map +1 -0
  8. package/dist/adapters/_census_micro.d.ts +70 -0
  9. package/dist/adapters/_census_micro.js +622 -0
  10. package/dist/adapters/_census_micro.js.map +1 -0
  11. package/dist/adapters/_census_util.d.ts +40 -0
  12. package/dist/adapters/_census_util.js +275 -0
  13. package/dist/adapters/_census_util.js.map +1 -0
  14. package/dist/adapters/_dol_states.d.ts +6 -0
  15. package/dist/adapters/_dol_states.js +58 -0
  16. package/dist/adapters/_dol_states.js.map +1 -0
  17. package/dist/adapters/_govinfo_entities.d.ts +4 -0
  18. package/dist/adapters/_govinfo_entities.js +6 -0
  19. package/dist/adapters/_govinfo_entities.js.map +1 -0
  20. package/dist/adapters/_govinfo_json.d.ts +13 -0
  21. package/dist/adapters/_govinfo_json.js +107 -0
  22. package/dist/adapters/_govinfo_json.js.map +1 -0
  23. package/dist/adapters/_govinfo_py.d.ts +22 -0
  24. package/dist/adapters/_govinfo_py.js +272 -0
  25. package/dist/adapters/_govinfo_py.js.map +1 -0
  26. package/dist/adapters/_govinfo_xml.d.ts +22 -0
  27. package/dist/adapters/_govinfo_xml.js +233 -0
  28. package/dist/adapters/_govinfo_xml.js.map +1 -0
  29. package/dist/adapters/_hud_excel.d.ts +2 -0
  30. package/dist/adapters/_hud_excel.js +166 -0
  31. package/dist/adapters/_hud_excel.js.map +1 -0
  32. package/dist/adapters/_omb_grid.d.ts +17 -0
  33. package/dist/adapters/_omb_grid.js +132 -0
  34. package/dist/adapters/_omb_grid.js.map +1 -0
  35. package/dist/adapters/_omb_util.d.ts +40 -0
  36. package/dist/adapters/_omb_util.js +192 -0
  37. package/dist/adapters/_omb_util.js.map +1 -0
  38. package/dist/adapters/_usaspending_state.d.ts +6 -0
  39. package/dist/adapters/_usaspending_state.js +54 -0
  40. package/dist/adapters/_usaspending_state.js.map +1 -0
  41. package/dist/adapters/_usda-fna_book.d.ts +59 -0
  42. package/dist/adapters/_usda-fna_book.js +869 -0
  43. package/dist/adapters/_usda-fna_book.js.map +1 -0
  44. package/dist/adapters/_usda-fna_pdf.d.ts +20 -0
  45. package/dist/adapters/_usda-fna_pdf.js +361 -0
  46. package/dist/adapters/_usda-fna_pdf.js.map +1 -0
  47. package/dist/adapters/_usda-outlook_read.d.ts +70 -0
  48. package/dist/adapters/_usda-outlook_read.js +362 -0
  49. package/dist/adapters/_usda-outlook_read.js.map +1 -0
  50. package/dist/adapters/acf.d.ts +3 -0
  51. package/dist/adapters/acf.js +187 -0
  52. package/dist/adapters/acf.js.map +1 -0
  53. package/dist/adapters/actuaries.d.ts +3 -0
  54. package/dist/adapters/actuaries.js +293 -0
  55. package/dist/adapters/actuaries.js.map +1 -0
  56. package/dist/adapters/bts.d.ts +3 -0
  57. package/dist/adapters/bts.js +26 -0
  58. package/dist/adapters/bts.js.map +1 -0
  59. package/dist/adapters/census-geocoder.d.ts +10 -0
  60. package/dist/adapters/census-geocoder.js +47 -0
  61. package/dist/adapters/census-geocoder.js.map +1 -0
  62. package/dist/adapters/census.d.ts +17 -0
  63. package/dist/adapters/census.js +983 -0
  64. package/dist/adapters/census.js.map +1 -0
  65. package/dist/adapters/cfpb.d.ts +7 -0
  66. package/dist/adapters/cfpb.js +348 -0
  67. package/dist/adapters/cfpb.js.map +1 -0
  68. package/dist/adapters/clinical-trials.d.ts +3 -0
  69. package/dist/adapters/clinical-trials.js +135 -0
  70. package/dist/adapters/clinical-trials.js.map +1 -0
  71. package/dist/adapters/cms.d.ts +3 -0
  72. package/dist/adapters/cms.js +292 -0
  73. package/dist/adapters/cms.js.map +1 -0
  74. package/dist/adapters/college-scorecard.d.ts +3 -0
  75. package/dist/adapters/college-scorecard.js +122 -0
  76. package/dist/adapters/college-scorecard.js.map +1 -0
  77. package/dist/adapters/congress.d.ts +33 -0
  78. package/dist/adapters/congress.js +589 -0
  79. package/dist/adapters/congress.js.map +1 -0
  80. package/dist/adapters/dhs-ohss.d.ts +13 -0
  81. package/dist/adapters/dhs-ohss.js +598 -0
  82. package/dist/adapters/dhs-ohss.js.map +1 -0
  83. package/dist/adapters/doj-news.d.ts +7 -0
  84. package/dist/adapters/doj-news.js +286 -0
  85. package/dist/adapters/doj-news.js.map +1 -0
  86. package/dist/adapters/dol.d.ts +4 -0
  87. package/dist/adapters/dol.js +634 -0
  88. package/dist/adapters/dol.js.map +1 -0
  89. package/dist/adapters/eia.d.ts +15 -0
  90. package/dist/adapters/eia.js +456 -0
  91. package/dist/adapters/eia.js.map +1 -0
  92. package/dist/adapters/epa-aqs.d.ts +3 -0
  93. package/dist/adapters/epa-aqs.js +357 -0
  94. package/dist/adapters/epa-aqs.js.map +1 -0
  95. package/dist/adapters/epa.d.ts +3 -0
  96. package/dist/adapters/epa.js +298 -0
  97. package/dist/adapters/epa.js.map +1 -0
  98. package/dist/adapters/fbi.d.ts +3 -0
  99. package/dist/adapters/fbi.js +192 -0
  100. package/dist/adapters/fbi.js.map +1 -0
  101. package/dist/adapters/fda.d.ts +5 -0
  102. package/dist/adapters/fda.js +184 -0
  103. package/dist/adapters/fda.js.map +1 -0
  104. package/dist/adapters/fdic.d.ts +4 -0
  105. package/dist/adapters/fdic.js +95 -0
  106. package/dist/adapters/fdic.js.map +1 -0
  107. package/dist/adapters/fec.d.ts +3 -0
  108. package/dist/adapters/fec.js +142 -0
  109. package/dist/adapters/fec.js.map +1 -0
  110. package/dist/adapters/fed-board.d.ts +12 -0
  111. package/dist/adapters/fed-board.js +581 -0
  112. package/dist/adapters/fed-board.js.map +1 -0
  113. package/dist/adapters/federal-register.d.ts +11 -0
  114. package/dist/adapters/federal-register.js +43 -0
  115. package/dist/adapters/federal-register.js.map +1 -0
  116. package/dist/adapters/fhfa.d.ts +3 -0
  117. package/dist/adapters/fhfa.js +253 -0
  118. package/dist/adapters/fhfa.js.map +1 -0
  119. package/dist/adapters/fsa.d.ts +9 -0
  120. package/dist/adapters/fsa.js +335 -0
  121. package/dist/adapters/fsa.js.map +1 -0
  122. package/dist/adapters/govinfo.d.ts +30 -0
  123. package/dist/adapters/govinfo.js +636 -0
  124. package/dist/adapters/govinfo.js.map +1 -0
  125. package/dist/adapters/gsa-calc.d.ts +10 -0
  126. package/dist/adapters/gsa-calc.js +318 -0
  127. package/dist/adapters/gsa-calc.js.map +1 -0
  128. package/dist/adapters/hud.d.ts +3 -0
  129. package/dist/adapters/hud.js +200 -0
  130. package/dist/adapters/hud.js.map +1 -0
  131. package/dist/adapters/index.d.ts +3 -0
  132. package/dist/adapters/index.js +25 -0
  133. package/dist/adapters/index.js.map +1 -0
  134. package/dist/adapters/irs-soi.d.ts +6 -0
  135. package/dist/adapters/irs-soi.js +576 -0
  136. package/dist/adapters/irs-soi.js.map +1 -0
  137. package/dist/adapters/naep.d.ts +15 -0
  138. package/dist/adapters/naep.js +341 -0
  139. package/dist/adapters/naep.js.map +1 -0
  140. package/dist/adapters/nhtsa.d.ts +10 -0
  141. package/dist/adapters/nhtsa.js +239 -0
  142. package/dist/adapters/nhtsa.js.map +1 -0
  143. package/dist/adapters/nih.d.ts +5 -0
  144. package/dist/adapters/nih.js +196 -0
  145. package/dist/adapters/nih.js.map +1 -0
  146. package/dist/adapters/noaa.d.ts +3 -0
  147. package/dist/adapters/noaa.js +148 -0
  148. package/dist/adapters/noaa.js.map +1 -0
  149. package/dist/adapters/nrel.d.ts +3 -0
  150. package/dist/adapters/nrel.js +186 -0
  151. package/dist/adapters/nrel.js.map +1 -0
  152. package/dist/adapters/nws.d.ts +3 -0
  153. package/dist/adapters/nws.js +119 -0
  154. package/dist/adapters/nws.js.map +1 -0
  155. package/dist/adapters/omb.d.ts +15 -0
  156. package/dist/adapters/omb.js +517 -0
  157. package/dist/adapters/omb.js.map +1 -0
  158. package/dist/adapters/open-payments.d.ts +5 -0
  159. package/dist/adapters/open-payments.js +149 -0
  160. package/dist/adapters/open-payments.js.map +1 -0
  161. package/dist/adapters/pbgc.d.ts +13 -0
  162. package/dist/adapters/pbgc.js +283 -0
  163. package/dist/adapters/pbgc.js.map +1 -0
  164. package/dist/adapters/philfed.d.ts +12 -0
  165. package/dist/adapters/philfed.js +59 -0
  166. package/dist/adapters/philfed.js.map +1 -0
  167. package/dist/adapters/regulations.d.ts +6 -0
  168. package/dist/adapters/regulations.js +58 -0
  169. package/dist/adapters/regulations.js.map +1 -0
  170. package/dist/adapters/sec.d.ts +13 -0
  171. package/dist/adapters/sec.js +504 -0
  172. package/dist/adapters/sec.js.map +1 -0
  173. package/dist/adapters/senate-lobbying.d.ts +3 -0
  174. package/dist/adapters/senate-lobbying.js +181 -0
  175. package/dist/adapters/senate-lobbying.js.map +1 -0
  176. package/dist/adapters/snapqc.d.ts +32 -0
  177. package/dist/adapters/snapqc.js +701 -0
  178. package/dist/adapters/snapqc.js.map +1 -0
  179. package/dist/adapters/treasury-yields.d.ts +3 -0
  180. package/dist/adapters/treasury-yields.js +170 -0
  181. package/dist/adapters/treasury-yields.js.map +1 -0
  182. package/dist/adapters/usaspending.d.ts +3 -0
  183. package/dist/adapters/usaspending.js +340 -0
  184. package/dist/adapters/usaspending.js.map +1 -0
  185. package/dist/adapters/usda-fna.d.ts +7 -0
  186. package/dist/adapters/usda-fna.js +707 -0
  187. package/dist/adapters/usda-fna.js.map +1 -0
  188. package/dist/adapters/usda-fooddata.d.ts +3 -0
  189. package/dist/adapters/usda-fooddata.js +101 -0
  190. package/dist/adapters/usda-fooddata.js.map +1 -0
  191. package/dist/adapters/usda-nass.d.ts +3 -0
  192. package/dist/adapters/usda-nass.js +108 -0
  193. package/dist/adapters/usda-nass.js.map +1 -0
  194. package/dist/adapters/usda-outlook.d.ts +12 -0
  195. package/dist/adapters/usda-outlook.js +696 -0
  196. package/dist/adapters/usda-outlook.js.map +1 -0
  197. package/dist/adapters/usgs.d.ts +9 -0
  198. package/dist/adapters/usgs.js +265 -0
  199. package/dist/adapters/usgs.js.map +1 -0
  200. package/dist/adapters/usitc.d.ts +18 -0
  201. package/dist/adapters/usitc.js +170 -0
  202. package/dist/adapters/usitc.js.map +1 -0
  203. package/dist/adapters/uspto.d.ts +3 -0
  204. package/dist/adapters/uspto.js +47 -0
  205. package/dist/adapters/uspto.js.map +1 -0
  206. package/dist/adapters/world-bank.d.ts +3 -0
  207. package/dist/adapters/world-bank.js +163 -0
  208. package/dist/adapters/world-bank.js.map +1 -0
  209. package/dist/analysis/cite.d.ts +31 -0
  210. package/dist/analysis/cite.js +229 -0
  211. package/dist/analysis/cite.js.map +1 -0
  212. package/dist/analysis/combine.d.ts +27 -0
  213. package/dist/analysis/combine.js +198 -0
  214. package/dist/analysis/combine.js.map +1 -0
  215. package/dist/analysis/compute.d.ts +62 -0
  216. package/dist/analysis/compute.js +583 -0
  217. package/dist/analysis/compute.js.map +1 -0
  218. package/dist/analysis/expr.d.ts +69 -0
  219. package/dist/analysis/expr.js +780 -0
  220. package/dist/analysis/expr.js.map +1 -0
  221. package/dist/analysis/factfmt.d.ts +16 -0
  222. package/dist/analysis/factfmt.js +187 -0
  223. package/dist/analysis/factfmt.js.map +1 -0
  224. package/dist/analysis/facts.d.ts +63 -0
  225. package/dist/analysis/facts.js +355 -0
  226. package/dist/analysis/facts.js.map +1 -0
  227. package/dist/analysis/handoff.d.ts +58 -0
  228. package/dist/analysis/handoff.js +208 -0
  229. package/dist/analysis/handoff.js.map +1 -0
  230. package/dist/analysis/pyfmt.d.ts +16 -0
  231. package/dist/analysis/pyfmt.js +156 -0
  232. package/dist/analysis/pyfmt.js.map +1 -0
  233. package/dist/analysis/rerun.d.ts +13 -0
  234. package/dist/analysis/rerun.js +125 -0
  235. package/dist/analysis/rerun.js.map +1 -0
  236. package/dist/analysis/table.d.ts +18 -0
  237. package/dist/analysis/table.js +109 -0
  238. package/dist/analysis/table.js.map +1 -0
  239. package/dist/analysis/tools.d.ts +67 -0
  240. package/dist/analysis/tools.js +217 -0
  241. package/dist/analysis/tools.js.map +1 -0
  242. package/dist/analysis/write_table.d.ts +13 -0
  243. package/dist/analysis/write_table.js +59 -0
  244. package/dist/analysis/write_table.js.map +1 -0
  245. package/dist/bin/cli.d.ts +10 -0
  246. package/dist/bin/cli.js +177 -0
  247. package/dist/bin/cli.js.map +1 -0
  248. package/dist/core/cache.d.ts +14 -0
  249. package/dist/core/cache.js +90 -0
  250. package/dist/core/cache.js.map +1 -0
  251. package/dist/core/context.d.ts +12 -0
  252. package/dist/core/context.js +15 -0
  253. package/dist/core/context.js.map +1 -0
  254. package/dist/core/env.d.ts +14 -0
  255. package/dist/core/env.js +52 -0
  256. package/dist/core/env.js.map +1 -0
  257. package/dist/core/generic-rest.d.ts +61 -0
  258. package/dist/core/generic-rest.js +639 -0
  259. package/dist/core/generic-rest.js.map +1 -0
  260. package/dist/core/http.d.ts +120 -0
  261. package/dist/core/http.js +514 -0
  262. package/dist/core/http.js.map +1 -0
  263. package/dist/core/keys.d.ts +43 -0
  264. package/dist/core/keys.js +174 -0
  265. package/dist/core/keys.js.map +1 -0
  266. package/dist/core/manual.d.ts +41 -0
  267. package/dist/core/manual.js +218 -0
  268. package/dist/core/manual.js.map +1 -0
  269. package/dist/core/package.d.ts +58 -0
  270. package/dist/core/package.js +228 -0
  271. package/dist/core/package.js.map +1 -0
  272. package/dist/core/packs.d.ts +139 -0
  273. package/dist/core/packs.js +173 -0
  274. package/dist/core/packs.js.map +1 -0
  275. package/dist/core/policy.d.ts +69 -0
  276. package/dist/core/policy.js +189 -0
  277. package/dist/core/policy.js.map +1 -0
  278. package/dist/core/py.d.ts +40 -0
  279. package/dist/core/py.js +171 -0
  280. package/dist/core/py.js.map +1 -0
  281. package/dist/core/routing.d.ts +10 -0
  282. package/dist/core/routing.js +39 -0
  283. package/dist/core/routing.js.map +1 -0
  284. package/dist/core/tabular.d.ts +21 -0
  285. package/dist/core/tabular.js +229 -0
  286. package/dist/core/tabular.js.map +1 -0
  287. package/dist/deep/_bea_api.d.ts +102 -0
  288. package/dist/deep/_bea_api.js +457 -0
  289. package/dist/deep/_bea_api.js.map +1 -0
  290. package/dist/deep/_bea_fetch.d.ts +151 -0
  291. package/dist/deep/_bea_fetch.js +1274 -0
  292. package/dist/deep/_bea_fetch.js.map +1 -0
  293. package/dist/deep/_bea_util.d.ts +14 -0
  294. package/dist/deep/_bea_util.js +156 -0
  295. package/dist/deep/_bea_util.js.map +1 -0
  296. package/dist/deep/_bls_api.d.ts +84 -0
  297. package/dist/deep/_bls_api.js +231 -0
  298. package/dist/deep/_bls_api.js.map +1 -0
  299. package/dist/deep/_bls_ids.d.ts +43 -0
  300. package/dist/deep/_bls_ids.js +188 -0
  301. package/dist/deep/_bls_ids.js.map +1 -0
  302. package/dist/deep/_bls_lib.d.ts +61 -0
  303. package/dist/deep/_bls_lib.js +442 -0
  304. package/dist/deep/_bls_lib.js.map +1 -0
  305. package/dist/deep/_fred_api.d.ts +148 -0
  306. package/dist/deep/_fred_api.js +545 -0
  307. package/dist/deep/_fred_api.js.map +1 -0
  308. package/dist/deep/_fred_pack.d.ts +162 -0
  309. package/dist/deep/_fred_pack.js +1027 -0
  310. package/dist/deep/_fred_pack.js.map +1 -0
  311. package/dist/deep/_fred_py.d.ts +40 -0
  312. package/dist/deep/_fred_py.js +199 -0
  313. package/dist/deep/_fred_py.js.map +1 -0
  314. package/dist/deep/_ipums_bundle.d.ts +29 -0
  315. package/dist/deep/_ipums_bundle.js +194 -0
  316. package/dist/deep/_ipums_bundle.js.map +1 -0
  317. package/dist/deep/_ipums_ddi.d.ts +23 -0
  318. package/dist/deep/_ipums_ddi.js +162 -0
  319. package/dist/deep/_ipums_ddi.js.map +1 -0
  320. package/dist/deep/_opm_io.d.ts +26 -0
  321. package/dist/deep/_opm_io.js +383 -0
  322. package/dist/deep/_opm_io.js.map +1 -0
  323. package/dist/deep/_opm_parquet.d.ts +31 -0
  324. package/dist/deep/_opm_parquet.js +744 -0
  325. package/dist/deep/_opm_parquet.js.map +1 -0
  326. package/dist/deep/_opm_py.d.ts +6 -0
  327. package/dist/deep/_opm_py.js +74 -0
  328. package/dist/deep/_opm_py.js.map +1 -0
  329. package/dist/deep/_treasury_api.d.ts +48 -0
  330. package/dist/deep/_treasury_api.js +221 -0
  331. package/dist/deep/_treasury_api.js.map +1 -0
  332. package/dist/deep/_treasury_context.d.ts +34 -0
  333. package/dist/deep/_treasury_context.js +142 -0
  334. package/dist/deep/_treasury_context.js.map +1 -0
  335. package/dist/deep/_treasury_lib.d.ts +109 -0
  336. package/dist/deep/_treasury_lib.js +686 -0
  337. package/dist/deep/_treasury_lib.js.map +1 -0
  338. package/dist/deep/bea.d.ts +3 -0
  339. package/dist/deep/bea.js +248 -0
  340. package/dist/deep/bea.js.map +1 -0
  341. package/dist/deep/bls.d.ts +3 -0
  342. package/dist/deep/bls.js +220 -0
  343. package/dist/deep/bls.js.map +1 -0
  344. package/dist/deep/fred.d.ts +3 -0
  345. package/dist/deep/fred.js +325 -0
  346. package/dist/deep/fred.js.map +1 -0
  347. package/dist/deep/ipums.d.ts +59 -0
  348. package/dist/deep/ipums.js +744 -0
  349. package/dist/deep/ipums.js.map +1 -0
  350. package/dist/deep/opm.d.ts +56 -0
  351. package/dist/deep/opm.js +1033 -0
  352. package/dist/deep/opm.js.map +1 -0
  353. package/dist/deep/treasury.d.ts +3 -0
  354. package/dist/deep/treasury.js +218 -0
  355. package/dist/deep/treasury.js.map +1 -0
  356. package/dist/envelope.d.ts +47 -0
  357. package/dist/envelope.js +88 -0
  358. package/dist/envelope.js.map +1 -0
  359. package/dist/index.d.ts +277 -0
  360. package/dist/index.js +106 -0
  361. package/dist/index.js.map +1 -0
  362. package/dist/remote/app.d.ts +21 -0
  363. package/dist/remote/app.js +218 -0
  364. package/dist/remote/app.js.map +1 -0
  365. package/dist/remote/oauth.d.ts +14 -0
  366. package/dist/remote/oauth.js +90 -0
  367. package/dist/remote/oauth.js.map +1 -0
  368. package/dist/remote/pages.d.ts +8 -0
  369. package/dist/remote/pages.js +56 -0
  370. package/dist/remote/pages.js.map +1 -0
  371. package/dist/remote/sign.d.ts +4 -0
  372. package/dist/remote/sign.js +40 -0
  373. package/dist/remote/sign.js.map +1 -0
  374. package/dist/remote/store.d.ts +31 -0
  375. package/dist/remote/store.js +129 -0
  376. package/dist/remote/store.js.map +1 -0
  377. package/dist/report/audit_answer.d.ts +94 -0
  378. package/dist/report/audit_answer.js +1349 -0
  379. package/dist/report/audit_answer.js.map +1 -0
  380. package/dist/report/audit_report.d.ts +23 -0
  381. package/dist/report/audit_report.js +637 -0
  382. package/dist/report/audit_report.js.map +1 -0
  383. package/dist/report/build_report.d.ts +27 -0
  384. package/dist/report/build_report.js +1168 -0
  385. package/dist/report/build_report.js.map +1 -0
  386. package/dist/report/method_audit.d.ts +47 -0
  387. package/dist/report/method_audit.js +716 -0
  388. package/dist/report/method_audit.js.map +1 -0
  389. package/dist/report/policyset.d.ts +50 -0
  390. package/dist/report/policyset.js +421 -0
  391. package/dist/report/policyset.js.map +1 -0
  392. package/dist/report/py.d.ts +58 -0
  393. package/dist/report/py.js +311 -0
  394. package/dist/report/py.js.map +1 -0
  395. package/dist/report/scan_secrets.d.ts +24 -0
  396. package/dist/report/scan_secrets.js +265 -0
  397. package/dist/report/scan_secrets.js.map +1 -0
  398. package/dist/report/style_check.d.ts +29 -0
  399. package/dist/report/style_check.js +173 -0
  400. package/dist/report/style_check.js.map +1 -0
  401. package/dist/report/tools.d.ts +87 -0
  402. package/dist/report/tools.js +167 -0
  403. package/dist/report/tools.js.map +1 -0
  404. package/dist/server.d.ts +5 -0
  405. package/dist/server.js +247 -0
  406. package/dist/server.js.map +1 -0
  407. package/dist/session.d.ts +47 -0
  408. package/dist/session.js +107 -0
  409. package/dist/session.js.map +1 -0
  410. package/dist/toolkit.d.ts +21 -0
  411. package/dist/toolkit.js +2 -0
  412. package/dist/toolkit.js.map +1 -0
  413. package/dist/tools.d.ts +299 -0
  414. package/dist/tools.js +491 -0
  415. package/dist/tools.js.map +1 -0
  416. package/guide/WORKFLOW.md +134 -0
  417. package/guide/assets/disclaimer.txt +1 -0
  418. package/guide/assets/download_data.ps1 +162 -0
  419. package/guide/assets/download_data.sh +143 -0
  420. package/guide/assets/report_template.html +597 -0
  421. package/guide/references/report_patterns.md +199 -0
  422. package/guide/references/routing.md +171 -0
  423. package/guide/references/style_guide.md +398 -0
  424. package/package.json +54 -4
  425. package/packs/acf/endpoints.json +114 -0
  426. package/packs/acf/policy.json +104 -0
  427. package/packs/acf/source.md +138 -0
  428. package/packs/actuaries/endpoints.json +82 -0
  429. package/packs/actuaries/policy.json +109 -0
  430. package/packs/actuaries/source.md +137 -0
  431. package/packs/bea/assets/download_bea.ps1 +182 -0
  432. package/packs/bea/assets/download_bea.sh +144 -0
  433. package/packs/bea/docs/bea_api.md +461 -0
  434. package/packs/bea/docs/datasets.md +157 -0
  435. package/packs/bea/docs/report_patterns.md +112 -0
  436. package/packs/bea/policy.json +170 -0
  437. package/packs/bea/source.md +152 -0
  438. package/packs/bls/assets/download_bls.ps1 +152 -0
  439. package/packs/bls/assets/download_bls.sh +167 -0
  440. package/packs/bls/docs/analysis_patterns.md +108 -0
  441. package/packs/bls/docs/bls_api.md +73 -0
  442. package/packs/bls/docs/series_ids.md +149 -0
  443. package/packs/bls/policy.json +238 -0
  444. package/packs/bls/series_ids.json +1375 -0
  445. package/packs/bls/source.md +156 -0
  446. package/packs/bts/endpoints.json +347 -0
  447. package/packs/bts/policy.json +94 -0
  448. package/packs/bts/source.md +97 -0
  449. package/packs/cdc/endpoints.json +197 -0
  450. package/packs/cdc/policy.json +83 -0
  451. package/packs/cdc/source.md +74 -0
  452. package/packs/census/endpoints.json +99 -0
  453. package/packs/census/policy.json +238 -0
  454. package/packs/census/source.md +304 -0
  455. package/packs/census-geocoder/endpoints.json +70 -0
  456. package/packs/census-geocoder/policy.json +80 -0
  457. package/packs/census-geocoder/source.md +53 -0
  458. package/packs/cfpb/endpoints.json +327 -0
  459. package/packs/cfpb/policy.json +119 -0
  460. package/packs/cfpb/source.md +96 -0
  461. package/packs/clinical-trials/endpoints.json +167 -0
  462. package/packs/clinical-trials/policy.json +84 -0
  463. package/packs/clinical-trials/source.md +82 -0
  464. package/packs/cms/endpoints.json +69 -0
  465. package/packs/cms/policy.json +96 -0
  466. package/packs/cms/source.md +112 -0
  467. package/packs/college-scorecard/endpoints.json +253 -0
  468. package/packs/college-scorecard/policy.json +106 -0
  469. package/packs/college-scorecard/source.md +92 -0
  470. package/packs/congress/endpoints.json +1701 -0
  471. package/packs/congress/policy.json +117 -0
  472. package/packs/congress/source.md +190 -0
  473. package/packs/dhs-ohss/endpoints.json +66 -0
  474. package/packs/dhs-ohss/policy.json +107 -0
  475. package/packs/dhs-ohss/source.md +120 -0
  476. package/packs/doj-news/endpoints.json +59 -0
  477. package/packs/doj-news/policy.json +96 -0
  478. package/packs/doj-news/source.md +99 -0
  479. package/packs/dol/endpoints.json +818 -0
  480. package/packs/dol/policy.json +135 -0
  481. package/packs/dol/source.md +181 -0
  482. package/packs/eia/endpoints.json +718 -0
  483. package/packs/eia/policy.json +112 -0
  484. package/packs/eia/source.md +112 -0
  485. package/packs/epa/endpoints.json +292 -0
  486. package/packs/epa/policy.json +99 -0
  487. package/packs/epa/source.md +99 -0
  488. package/packs/epa-aqs/endpoints.json +174 -0
  489. package/packs/epa-aqs/policy.json +96 -0
  490. package/packs/epa-aqs/source.md +97 -0
  491. package/packs/fbi/endpoints.json +1842 -0
  492. package/packs/fbi/policy.json +118 -0
  493. package/packs/fbi/source.md +108 -0
  494. package/packs/fda/endpoints.json +238 -0
  495. package/packs/fda/policy.json +121 -0
  496. package/packs/fda/source.md +117 -0
  497. package/packs/fdic/endpoints.json +417 -0
  498. package/packs/fdic/policy.json +83 -0
  499. package/packs/fdic/source.md +92 -0
  500. package/packs/fec/endpoints.json +708 -0
  501. package/packs/fec/policy.json +93 -0
  502. package/packs/fec/source.md +90 -0
  503. package/packs/fed-board/endpoints.json +89 -0
  504. package/packs/fed-board/policy.json +136 -0
  505. package/packs/fed-board/source.md +118 -0
  506. package/packs/federal-register/endpoints.json +143 -0
  507. package/packs/federal-register/policy.json +86 -0
  508. package/packs/federal-register/source.md +98 -0
  509. package/packs/fema/endpoints.json +646 -0
  510. package/packs/fema/policy.json +103 -0
  511. package/packs/fema/source.md +103 -0
  512. package/packs/fhfa/endpoints.json +105 -0
  513. package/packs/fhfa/policy.json +109 -0
  514. package/packs/fhfa/source.md +108 -0
  515. package/packs/fred/assets/download_fred.ps1 +122 -0
  516. package/packs/fred/assets/download_fred.sh +123 -0
  517. package/packs/fred/docs/analysis_patterns.md +124 -0
  518. package/packs/fred/docs/fred_api.md +94 -0
  519. package/packs/fred/docs/series.md +188 -0
  520. package/packs/fred/policy.json +253 -0
  521. package/packs/fred/source.md +142 -0
  522. package/packs/fsa/endpoints.json +150 -0
  523. package/packs/fsa/policy.json +99 -0
  524. package/packs/fsa/source.md +102 -0
  525. package/packs/govinfo/endpoints.json +520 -0
  526. package/packs/govinfo/policy.json +116 -0
  527. package/packs/govinfo/source.md +241 -0
  528. package/packs/gsa-calc/endpoints.json +93 -0
  529. package/packs/gsa-calc/policy.json +97 -0
  530. package/packs/gsa-calc/source.md +108 -0
  531. package/packs/hud/endpoints.json +147 -0
  532. package/packs/hud/policy.json +84 -0
  533. package/packs/hud/source.md +97 -0
  534. package/packs/ipums/assets/download_ipums.ps1 +215 -0
  535. package/packs/ipums/assets/download_ipums.sh +192 -0
  536. package/packs/ipums/docs/ipums_api.md +67 -0
  537. package/packs/ipums/docs/report_patterns.md +117 -0
  538. package/packs/ipums/docs/variables.md +284 -0
  539. package/packs/ipums/lib/fetch_text.json +112 -0
  540. package/packs/ipums/policy.json +215 -0
  541. package/packs/ipums/source.md +169 -0
  542. package/packs/irs-soi/endpoints.json +114 -0
  543. package/packs/irs-soi/policy.json +107 -0
  544. package/packs/irs-soi/source.md +124 -0
  545. package/packs/medicaid/endpoints.json +412 -0
  546. package/packs/medicaid/policy.json +108 -0
  547. package/packs/medicaid/source.md +136 -0
  548. package/packs/naep/endpoints.json +217 -0
  549. package/packs/naep/policy.json +100 -0
  550. package/packs/naep/source.md +120 -0
  551. package/packs/nhtsa/endpoints.json +132 -0
  552. package/packs/nhtsa/policy.json +93 -0
  553. package/packs/nhtsa/source.md +109 -0
  554. package/packs/nih/endpoints.json +453 -0
  555. package/packs/nih/policy.json +86 -0
  556. package/packs/nih/source.md +108 -0
  557. package/packs/noaa/endpoints.json +432 -0
  558. package/packs/noaa/policy.json +95 -0
  559. package/packs/noaa/source.md +88 -0
  560. package/packs/nrel/endpoints.json +328 -0
  561. package/packs/nrel/policy.json +96 -0
  562. package/packs/nrel/source.md +91 -0
  563. package/packs/nws/endpoints.json +272 -0
  564. package/packs/nws/policy.json +82 -0
  565. package/packs/nws/source.md +81 -0
  566. package/packs/nyfed/endpoints.json +80 -0
  567. package/packs/nyfed/policy.json +92 -0
  568. package/packs/nyfed/source.md +89 -0
  569. package/packs/omb/endpoints.json +460 -0
  570. package/packs/omb/policy.json +106 -0
  571. package/packs/omb/source.md +130 -0
  572. package/packs/open-payments/endpoints.json +298 -0
  573. package/packs/open-payments/policy.json +101 -0
  574. package/packs/open-payments/source.md +99 -0
  575. package/packs/opm/assets/download_opm.ps1 +125 -0
  576. package/packs/opm/assets/download_opm.sh +85 -0
  577. package/packs/opm/docs/fields.md +184 -0
  578. package/packs/opm/docs/opm_api.md +71 -0
  579. package/packs/opm/docs/report_patterns.md +83 -0
  580. package/packs/opm/lib/data_dictionary.csv +73 -0
  581. package/packs/opm/policy.json +142 -0
  582. package/packs/opm/source.md +137 -0
  583. package/packs/pbgc/endpoints.json +483 -0
  584. package/packs/pbgc/policy.json +94 -0
  585. package/packs/pbgc/source.md +95 -0
  586. package/packs/philfed/endpoints.json +85 -0
  587. package/packs/philfed/policy.json +94 -0
  588. package/packs/philfed/source.md +125 -0
  589. package/packs/port.json +287 -0
  590. package/packs/regulations/endpoints.json +288 -0
  591. package/packs/regulations/policy.json +86 -0
  592. package/packs/regulations/source.md +84 -0
  593. package/packs/sec/endpoints.json +237 -0
  594. package/packs/sec/policy.json +86 -0
  595. package/packs/sec/source.md +101 -0
  596. package/packs/senate-lobbying/endpoints.json +554 -0
  597. package/packs/senate-lobbying/policy.json +99 -0
  598. package/packs/senate-lobbying/source.md +100 -0
  599. package/packs/snapqc/endpoints.json +1426 -0
  600. package/packs/snapqc/policy.json +92 -0
  601. package/packs/snapqc/source.md +96 -0
  602. package/packs/treasury/catalog.json +2267 -0
  603. package/packs/treasury/docs/api_guide.md +245 -0
  604. package/packs/treasury/docs/datasets.md +56 -0
  605. package/packs/treasury/docs/report_patterns.md +126 -0
  606. package/packs/treasury/policy.json +159 -0
  607. package/packs/treasury/source.md +170 -0
  608. package/packs/treasury-yields/endpoints.json +226 -0
  609. package/packs/treasury-yields/policy.json +86 -0
  610. package/packs/treasury-yields/source.md +80 -0
  611. package/packs/usaspending/endpoints.json +1316 -0
  612. package/packs/usaspending/policy.json +109 -0
  613. package/packs/usaspending/source.md +103 -0
  614. package/packs/usda-fna/endpoints.json +427 -0
  615. package/packs/usda-fna/policy.json +133 -0
  616. package/packs/usda-fna/source.md +217 -0
  617. package/packs/usda-fooddata/endpoints.json +181 -0
  618. package/packs/usda-fooddata/policy.json +94 -0
  619. package/packs/usda-fooddata/source.md +105 -0
  620. package/packs/usda-nass/endpoints.json +324 -0
  621. package/packs/usda-nass/policy.json +95 -0
  622. package/packs/usda-nass/source.md +85 -0
  623. package/packs/usda-outlook/endpoints.json +86 -0
  624. package/packs/usda-outlook/policy.json +109 -0
  625. package/packs/usda-outlook/source.md +144 -0
  626. package/packs/usgs/endpoints.json +313 -0
  627. package/packs/usgs/policy.json +95 -0
  628. package/packs/usgs/source.md +96 -0
  629. package/packs/usitc/endpoints.json +74 -0
  630. package/packs/usitc/policy.json +111 -0
  631. package/packs/usitc/source.md +90 -0
  632. package/packs/uspto/endpoints.json +141 -0
  633. package/packs/uspto/policy.json +95 -0
  634. package/packs/uspto/source.md +101 -0
  635. package/packs/va/endpoints.json +414 -0
  636. package/packs/va/policy.json +101 -0
  637. package/packs/va/source.md +129 -0
  638. package/packs/world-bank/endpoints.json +122 -0
  639. package/packs/world-bank/policy.json +101 -0
  640. package/packs/world-bank/source.md +93 -0
@@ -0,0 +1,238 @@
1
+ {
2
+ "id": "census",
3
+ "title": "Census Bureau Data API (ACS, decennial census, population estimates, SIPP, economic indicators, international trade, government finances)",
4
+ "agency": "U.S. Census Bureau",
5
+ "depth": "standard",
6
+ "domains": [
7
+ "demographics",
8
+ "population",
9
+ "income",
10
+ "housing",
11
+ "poverty",
12
+ "education",
13
+ "program participation",
14
+ "international trade",
15
+ "state and local government finance",
16
+ "economic indicators",
17
+ "survey microdata"
18
+ ],
19
+ "keywords": [
20
+ "census",
21
+ "acs",
22
+ "american community survey",
23
+ "population",
24
+ "median household income",
25
+ "household income",
26
+ "poverty",
27
+ "poverty rate",
28
+ "median home value",
29
+ "home value",
30
+ "rent",
31
+ "median rent",
32
+ "housing",
33
+ "homeownership",
34
+ "renters",
35
+ "education attainment",
36
+ "bachelor's degree",
37
+ "age",
38
+ "median age",
39
+ "race",
40
+ "hispanic",
41
+ "language",
42
+ "commute",
43
+ "health insurance",
44
+ "uninsured",
45
+ "county",
46
+ "counties",
47
+ "zip code",
48
+ "zcta",
49
+ "tract",
50
+ "city",
51
+ "place",
52
+ "decennial",
53
+ "2020 census",
54
+ "population estimates",
55
+ "per capita",
56
+ "per 1,000 residents",
57
+ "per 100,000 residents",
58
+ "per resident",
59
+ "demographic profile",
60
+ "state profile",
61
+ "pums",
62
+ "acs pums",
63
+ "public use microdata",
64
+ "census microdata",
65
+ "microdata",
66
+ "replicate weights",
67
+ "cps microdata",
68
+ "current population survey",
69
+ "asec",
70
+ "march supplement",
71
+ "cps basic monthly",
72
+ "custom tabulations",
73
+ "sipp",
74
+ "survey of income and program participation",
75
+ "program participation",
76
+ "month to month income",
77
+ "income dynamics",
78
+ "snap participation",
79
+ "ssi",
80
+ "health coverage spells",
81
+ "assets and debts",
82
+ "retail sales",
83
+ "housing starts",
84
+ "building permits",
85
+ "construction spending",
86
+ "economic indicators",
87
+ "qtax",
88
+ "state and local tax revenue",
89
+ "state tax collections",
90
+ "government finances",
91
+ "state and local government spending",
92
+ "public pensions",
93
+ "pension assets",
94
+ "imports",
95
+ "exports",
96
+ "international trade",
97
+ "hs code",
98
+ "customs duty",
99
+ "tariff revenue",
100
+ "trade deficit",
101
+ "household pulse",
102
+ "pulse survey",
103
+ "household hardship",
104
+ "difficulty paying expenses",
105
+ "food scarcity",
106
+ "unable to pay energy bill",
107
+ "homeownership rate",
108
+ "vacancy rate",
109
+ "rental vacancy rate",
110
+ "homeowner vacancy rate"
111
+ ],
112
+ "questions": [
113
+ "median household income by county in a state",
114
+ "poverty rate by state",
115
+ "population of a city",
116
+ "median home value and rent in a county",
117
+ "share of adults with a bachelor's degree by state",
118
+ "population for per-capita calculations",
119
+ "month-to-month income and program participation from SIPP",
120
+ "custom tabulation from ACS PUMS with replicate-weight standard errors (uninsured adults by age and income in a state)",
121
+ "custom tabulation from one CPS month, or one CPS ASEC year with replicate-weight standard errors (poverty, income, insurance)",
122
+ "monthly retail sales or housing starts",
123
+ "quarterly state and local tax revenue by state (QTAX)",
124
+ "state and local government revenue, spending and debt by state",
125
+ "imports from a country by HS chapter and the duty calculated on them",
126
+ "share of adults with difficulty paying usual household expenses (Household Pulse)",
127
+ "quarterly homeownership rate and rental vacancy rate"
128
+ ],
129
+ "homepage": "https://www.census.gov/data/developers.html",
130
+ "terms_url": "https://www.census.gov/data/developers/about/terms-of-service.html",
131
+ "auth": {
132
+ "env": "CENSUS_API_KEY",
133
+ "required": "required",
134
+ "placement": "query",
135
+ "param": "key",
136
+ "prefix": "",
137
+ "home": "census",
138
+ "signup_url": "https://api.census.gov/data/key_signup.html",
139
+ "echoes_key": false,
140
+ "key_only": []
141
+ },
142
+ "limits": {
143
+ "rps": 3,
144
+ "burst": 10,
145
+ "max_rows": 500000
146
+ },
147
+ "routes": {
148
+ "api": {
149
+ "base": "https://api.census.gov/data",
150
+ "probe": "https://api.census.gov/data/2020/dec/pl/variables/NAME.json",
151
+ "hosts": [
152
+ "api.census.gov",
153
+ "www2.census.gov"
154
+ ]
155
+ },
156
+ "manual": {
157
+ "how": "Open each link in manual_download/INSTRUCTIONS.md in a browser after replacing {API_KEY} with your own free Census key (https://api.census.gov/data/key_signup.html), or run download_data.sh / download_data.ps1 (one command; asks for the key with hidden input); save each JSON file under the name shown and upload it, then call ingest. Without the bundle: on https://data.census.gov search the table (e.g. B19013), choose the geography and year, and use Download Table (CSV); upload it and say it is a data.census.gov export (its layout differs: one estimate and one margin-of-error column per geography)."
158
+ }
159
+ },
160
+ "cache": {
161
+ "mode": "persistent",
162
+ "ttl_hours": 720,
163
+ "why": "Only API metadata is cached on disk (variables.json lists for request_schema searches and the dataset discovery checks behind 'latest'); it changes once a release. Data queries are never cached: data/ is reused within a run."
164
+ },
165
+ "redistribution": {
166
+ "mode": "allowed",
167
+ "why": "Census Bureau statistics are U.S. government works in the public domain (17 U.S.C. 105); the Census Data API Terms of Service require the notice that the product uses the API but is not endorsed or certified by the Census Bureau."
168
+ },
169
+ "notices": [
170
+ "This product uses the Census Bureau Data API but is not endorsed or certified by the Census Bureau."
171
+ ],
172
+ "retention": null,
173
+ "citation": "U.S. Census Bureau, {dataset}, Census Data API (api.census.gov), retrieved {retrieved_long}.",
174
+ "audit_hooks": [
175
+ {
176
+ "id": "census_moe",
177
+ "kind": "require_text",
178
+ "any": [
179
+ "margin of error",
180
+ "moe"
181
+ ],
182
+ "why": "ACS figures are survey estimates; a report must give or discuss their margins of error (90% level) before comparing places or years."
183
+ }
184
+ ],
185
+ "clarify": [
186
+ "ACS 1-year (latest single year, only areas of 65,000+ people) or 5-year (all areas, pooled over five years, less current)? Do not compare a 1-year with a 5-year estimate.",
187
+ "Report estimates alone or with margins of error (90%), and test differences for significance? Small areas often have large margins.",
188
+ "Which geography vintage? County and place boundaries and codes change (Connecticut planning regions replaced counties from ACS 2022); 5-year estimates use the boundaries of their final year."
189
+ ],
190
+ "formats": [
191
+ "json"
192
+ ],
193
+ "use_instead": [
194
+ {
195
+ "question": "Monthly unemployment and payroll jobs",
196
+ "source": "bls",
197
+ "terms": [
198
+ "unemployment",
199
+ "CES"
200
+ ],
201
+ "why": "BLS produces both."
202
+ },
203
+ {
204
+ "question": "GDP and personal income by state",
205
+ "source": "bea",
206
+ "terms": [
207
+ "personal income"
208
+ ],
209
+ "why": "BEA regional accounts."
210
+ },
211
+ {
212
+ "question": "Microdata series harmonized across decades, ASEC standard errors before 2005, NHIS, MEPS or historical censuses",
213
+ "source": "ipums",
214
+ "terms": [
215
+ "NHIS",
216
+ "MEPS",
217
+ "harmonized"
218
+ ],
219
+ "why": "IPUMS codes each variable the same way across years and carries ASEC replicate weights for every year; ACS PUMS and single CPS files (ASEC replicates from 2005) come from this pack."
220
+ },
221
+ {
222
+ "question": "International comparisons",
223
+ "source": "world-bank",
224
+ "terms": [
225
+ "World Development Indicators"
226
+ ],
227
+ "why": "World Bank indicators across countries."
228
+ },
229
+ {
230
+ "question": "Federal spending by state",
231
+ "source": "usaspending",
232
+ "terms": [
233
+ "obligations"
234
+ ],
235
+ "why": "USAspending awards by place of performance."
236
+ }
237
+ ]
238
+ }
@@ -0,0 +1,304 @@
1
+ # Census Bureau Data API (ACS, decennial census, population estimates, ACS PUMS, CPS and SIPP microdata, economic indicators, trade, government finances)
2
+ Depth: standard. Key: required (CENSUS_API_KEY). American Community Survey 1-year and 5-year estimates,
3
+ 2020 and 2010 decennial census counts, population estimates, County Business Patterns and the Economic
4
+ Census, for the nation, states, counties, places, tracts and ZIP code areas; person microdata: ACS PUMS (with
5
+ replicate weights), CPS basic monthly and ASEC, SIPP person-months;
6
+ time series of monthly economic indicators, imports and exports by commodity, and state and local government
7
+ taxes, finances and pensions; quarterly homeownership and vacancy rates (HVS); the experimental Household Pulse
8
+ Survey (2020-2024).
9
+
10
+ ## When to use
11
+ - Population, age, race and Hispanic origin, household income, per capita income, poverty, home values,
12
+ rents, tenure, education, health insurance, commuting, language, for any U.S. geography; state or
13
+ county profiles; population denominators for per-capita figures (federal spending, deaths, energy use).
14
+ - Custom tabulations the published tables do not give, from recent person microdata (Census codes, weighted
15
+ by the pack's added weights): ACS PUMS (`acs1_pums`, `acs5_pums`; 2004 on, states and PUMAs, standard errors
16
+ from PWGTP1-80), one CPS basic month (`<YYYY>/cps/basic/<mon>`, 1989 on: labor force, hours, weekly earnings)
17
+ or one CPS ASEC year (`cps_asec`, 1992 on: income, poverty, insurance of the previous year; standard errors
18
+ from 2005 on, with Census's 160 replicate weights).
19
+ - Month-to-month income, program participation (SNAP, SSI, Medicaid, unemployment benefits), health
20
+ coverage spells, assets and debts of the same people over time: SIPP microdata (`sipp`), national
21
+ estimates weighted by the pack.
22
+ - Monthly retail sales, housing starts, construction spending; quarterly state and local tax revenue
23
+ (QTAX) and public pension assets; annual state and local government revenue, spending, debt, state tax
24
+ collections and pension systems; monthly imports and exports by HS commodity and country, with the duty
25
+ calculated on imports (tariff revenue by product or country).
26
+ - Homeownership rate and rental and homeowner vacancy rates, quarterly, for the nation (`eits_homeownership`).
27
+ - Household hardship from the Household Pulse Survey, April 2020 to September 2024: difficulty paying usual
28
+ household expenses, food scarcity, unable to pay an energy bill, likelihood of eviction or foreclosure, price
29
+ worries (`pulse` for 2024, `pulse_covid` for 2020-2023), for the nation, states and metros.
30
+ - Not here: monthly unemployment and jobs (bls), GDP and personal income by state (bea); microdata with codes
31
+ harmonized across years, CPI99, spouse or parent traits, CPS panels, ASEC standard errors before 2005,
32
+ years before 2004 (ACS) or 1989 (CPS), NHIS, MEPS, ATUS and historical censuses (ipums); international comparisons (world-bank), federal spending
33
+ by state (usaspending, which ships stale population figures: use this pack for the denominator).
34
+ Household Pulse from 2025 on (HTOPS: census.gov tables and public-use files only, not on the API) and HVS
35
+ rates by region, state or metro (census.gov/housing/hvs/data/rates.html): published tables, not covered.
36
+
37
+ ## Endpoints and datasets
38
+ | Endpoint | Returns | Key parameters |
39
+ |---|---|---|
40
+ | `query` | one row per geography; ACS estimates with their margins of error | `dataset`, `get`, `for`, `in`, `ucgid`, or `state` / `county` / `place` / `zcta` names; predicates such as `YEAR`, `HISP` |
41
+ | `group_variables` | every variable of a table: code, label, concept | `dataset`, `group` (B19013, S1701, DP03, P1) |
42
+ | `groups` | every table of a dataset | `dataset` |
43
+
44
+ Datasets (catalog aliases; `latest/...` resolves to the newest vintage the API serves, checked each run):
45
+ `acs5` latest/acs/acs5 (2024 = 2020-2024, all geographies), `acs1` latest/acs/acs1 (2024; areas of
46
+ 65,000+), `acs5_subject` / `acs1_subject` (S tables: rates and medians), `acs5_profile` /
47
+ `acs1_profile` (DP02-DP05; percent estimates end in PE), `acs1_supplemental` (acsse, areas 20,000+),
48
+ `dec_pl_2020` 2020/dec/pl, `dec_dhc_2020`, `dec_dp_2020`, `dec_sf1_2010`, `pep_charv` latest/pep/charv
49
+ (vintage 2023 is the newest on the API in October 2026; for the latest vintage without a Census key use FRED
50
+ `<ST>POP`, e.g. `MDPOP`, resident population in thousands as of July 1, or Census's NST-EST xlsx; for
51
+ every county, a fred `regional` request with any county population series and `region_type: county`
52
+ returns the national cross-section for one date, to filter by state FIPS),
53
+ `pep_population_2021` 2021/pep/population (POP_2020, POP_2021; states and above only),
54
+ `pep_population_2019` (2010-2019, down to places), `cbp` 2023/cbp,
55
+ `ecnbasic_2022`, `sipp` latest/sipp (SIPP microdata; 2022-2025 on the API, one per calendar year).
56
+ Microdata (one row per person; see the PUMS and CPS trap below): `acs1_pums` latest/acs/acs1/pums (2004-2024),
57
+ `acs5_pums` latest/acs/acs5/pums (2009-2024), `acs1_pumspr` (Puerto Rico), `cps_asec` latest/cps/asec/mar
58
+ (1992-2026, survey year: income is for the year before), CPS basic monthly `<YYYY>/cps/basic/<jan..dec>`
59
+ (1989-2026).
60
+ Time series (no vintage in the path; select periods with `time`): `eits_retail` timeseries/eits/marts,
61
+ `eits_housing_starts` timeseries/eits/resconst, `eits_construction` timeseries/eits/vip, `eits_qtax`
62
+ timeseries/eits/qtax, `eits_pensions` timeseries/eits/qpr, `eits_homeownership` timeseries/eits/hv (other indicators: timeseries/eits/m3, mtis,
63
+ mrts, ftd, bfs, qfr, qss), `trade_imports_hs` / `trade_exports_hs` timeseries/intltrade/imports|exports/hs
64
+ (also .../naics, .../statehs, .../porths, .../enduse), `govs_finances` timeseries/govslocalfin (2017-2024),
65
+ `govs_state_finances` timeseries/govsstatefin (1967-2024), `govs_state_tax` timeseries/govsstatetax
66
+ (2016-2025), `govs_pensions` timeseries/govspension (2012-2025); every dataset: https://api.census.gov/data/timeseries.json.
67
+ Household Pulse (experimental): `pulse` timeseries/hhpulse (Phase 4, 2024 cycles 01-09, one row per
68
+ `MEASURE_NAME`), `pulse_covid` timeseries/hps (2020-2023 weeks 01-63, one column set per measure).
69
+ Any path works (`2019/acs/acs1`, `2023/acs/acs5/subject`).
70
+ Common variables: B01003_001E population, B01002_001E median age, B19013_001E median household income,
71
+ B19301_001E per capita income, B17001_002E below poverty (universe B17001_001E), S1701_C03_001E poverty
72
+ rate, B25077_001E median home value, B25064_001E median gross rent, B15003_022E bachelor's degree
73
+ (universe B15003_001E), B23025_005E unemployed (labor force B23025_003E), P1_001N 2020 count.
74
+ Find others: `request_schema` search `"median household income"` (latest ACS 5-year) or
75
+ `"2020/dec/pl: total population"`; then `group_variables` for the whole table.
76
+
77
+ ## Spec examples
78
+ ```json
79
+ {"description": "Median household income, Maryland counties, latest ACS 5-year",
80
+ "requests": [{"name": "md_county_income", "endpoint": "query",
81
+ "params": {"dataset": "acs5", "get": "NAME,B19013_001E", "for": "county:*", "state": "Maryland"}}]}
82
+ ```
83
+ ```json
84
+ {"description": "Home value and rent in Montgomery County MD; population of Baltimore city",
85
+ "requests": [{"name": "montgomery_housing", "endpoint": "query",
86
+ "params": {"dataset": "acs5", "get": ["NAME", "B25077_001E", "B25064_001E"], "state": "MD", "county": "Montgomery"}},
87
+ {"name": "baltimore_pop", "endpoint": "query",
88
+ "params": {"dataset": "acs5", "get": "NAME,B01003_001E", "state": "MD", "place": "Baltimore"}}]}
89
+ ```
90
+ ```json
91
+ {"description": "Poverty rate by state, ACS 1-year 2024, and the 2020 Census count",
92
+ "requests": [{"name": "poverty_2024", "endpoint": "query",
93
+ "params": {"dataset": "2024/acs/acs1/subject", "get": "NAME,S1701_C03_001E", "for": "state:*"}},
94
+ {"name": "pop_2020", "endpoint": "query",
95
+ "params": {"dataset": "dec_pl_2020", "get": "NAME,P1_001N", "for": "state:*"}}]}
96
+ ```
97
+
98
+ ```json
99
+ {"description": "Share of people without health coverage in December, SIPP 2024 (weighted by WPFINWGT)",
100
+ "requests": [{"name": "sipp_coverage_dec", "endpoint": "query",
101
+ "params": {"dataset": "2024/sipp", "get": "TAGE,RHLTHMTH,TPTOTINC", "MONTHCODE": "12"}}]}
102
+ ```
103
+
104
+ ```json
105
+ {"description": "Uninsured rate, Maryland, ACS 2024 1-year PUMS with replicate weights; CPS September 2026",
106
+ "requests": [{"name": "md_pums", "endpoint": "query",
107
+ "params": {"dataset": "2024/acs/acs1/pums", "get": "AGEP,HICOV,RELSHIPP,ESR,PINCP", "state": "MD",
108
+ "replicates": true}},
109
+ {"name": "cps_sep", "endpoint": "query",
110
+ "params": {"dataset": "2026/cps/basic/sep", "get": "PRTAGE,PEMLR,PRCITSHP", "PRTAGE": "25:54"}}]}
111
+ ```
112
+
113
+ ```json
114
+ {"description": "Retail sales, 2026 to date; customs duty on imports from China, August 2026, by HS chapter",
115
+ "requests": [{"name": "retail_2026", "endpoint": "query",
116
+ "params": {"dataset": "eits_retail", "get": "cell_value,data_type_code,category_code,seasonally_adj,time_slot_id,error_data",
117
+ "for": "us:*", "time": "2026"}},
118
+ {"name": "china_duty_2026_08", "endpoint": "query",
119
+ "params": {"dataset": "trade_imports_hs", "get": "CTY_NAME,I_COMMODITY,GEN_VAL_MO,CON_VAL_MO,DUT_VAL_MO,CAL_DUT_MO",
120
+ "CTY_CODE": "5700", "COMM_LVL": "HS2", "time": "2026-08"}}]}
121
+ ```
122
+ ```json
123
+ {"description": "State and local government finances by state, 2024",
124
+ "requests": [{"name": "govfin_2024", "endpoint": "query",
125
+ "params": {"dataset": "govs_finances", "get": "AGG_DESC,GOVTYPE,AMOUNT,AMOUNT_CV", "for": "state:*", "time": "2024"}}]}
126
+ ```
127
+
128
+ ```json
129
+ {"description": "Adults with difficulty paying usual household expenses, nation, every 2024 Pulse cycle; homeownership rate 2025",
130
+ "requests": [{"name": "pulse_expense_2024", "endpoint": "query",
131
+ "params": {"dataset": "pulse", "get": "MEASURE_NAME,MEASURE_LABEL,RATE,RATE_MOE,TOTAL,UNIVERSE,CYCLE,PHASE,COL_START_DATE,COL_END_DATE",
132
+ "for": "us:*", "time": "2024", "MEASURE_NAME": "EXPENSE"}},
133
+ {"name": "homeownership_2025", "endpoint": "query",
134
+ "params": {"dataset": "eits_homeownership", "get": "cell_value,data_type_code,category_code,seasonally_adj,time_slot_id,geo_level_code,error_data",
135
+ "for": "us:*", "time": "2025", "category_code": "RATE"}}]}
136
+ ```
137
+
138
+ ## Data format and traps
139
+ - Margins of error: every ACS `...E` estimate is fetched with its `...M` margin of error (`...PE` with
140
+ `...PM`), each in its own column, at the 90% confidence level. They are never dropped (`moe: false`
141
+ is refused). Standard error = MOE / 1.645. Two estimates differ significantly only if
142
+ |a - b| > 1.645 * sqrt(SE_a^2 + SE_b^2); say so before ranking small areas.
143
+ - Special values (any number <= -1,000,000) are not data: -666666666 (estimate not computable),
144
+ -999999999 (N, too few cases), -888888888 (X, not applicable), -222222222 and -333333333 (MOE not
145
+ computable), -555555555 (controlled estimate: treat the MOE as zero). The pack writes an empty cell
146
+ and a `<column>_flag` column with the meaning; JSON nulls (no data for the geography) are flagged too.
147
+ - Top-coding: median home value 2000001 means $2,000,000 or more; median gross rent 2001, 3501 or 4001
148
+ means $2,000, $3,500 or $4,000 or more (by year). The value stays, with a flag. Medians in an open
149
+ interval are not exact; the group() call returns the EA annotation (median+, median-).
150
+ - Values arrive as text, exactly as published; NAME reads "Montgomery County, Maryland". Geography
151
+ code columns (state, county, place, tract) are strings with leading zeros: keep them as text.
152
+ - 1-year vs 5-year: 1-year (normally released each September for the prior year; the 2025 release was not on the API on 2026-10-20) covers only areas of 65,000+
153
+ and has no tracts, block groups or ZCTAs; 5-year (normally each December) covers all areas but pools
154
+ five years. Never compare a 1-year with a 5-year figure, and do not compare overlapping 5-year
155
+ periods (2019-2023 vs 2020-2024). No standard 2020 ACS 1-year release exists (experimental only).
156
+ - Dollars are inflation-adjusted to the last year of the period (2024 dollars for 2020-2024); adjust
157
+ before comparing releases. Universes differ by table (households vs population for whom poverty is
158
+ determined): use the table's total as the denominator.
159
+ - Geography vintage: codes and boundaries change. Connecticut uses nine planning regions (county codes
160
+ 110-190) instead of its eight counties from ACS 2022 on. Name resolution uses the dataset's own NAME
161
+ list when a key is set, else the Census 2020 reference files (noted in the output; they lack the CT
162
+ planning regions). Ambiguous names (Baltimore County vs Baltimore city) are refused with choices; a
163
+ place name prefers the incorporated place over a CDP of the same name.
164
+ - A query whose geography matches nothing returns HTTP 204 (reported as no rows). At most 50 variables
165
+ per call, margins of error included: split larger requests. ZCTAs (`zcta`) do not nest in states.
166
+ - 2020 Census counts below the state level carry differential-privacy noise; decennial variables end
167
+ in N and have no MOE. Population estimates (pep) are revised every vintage: name the vintage.
168
+ - PEP coverage on the API (checked 2026-10-22): pep/charv exists only as vintage 2023 (nation, state,
169
+ county, metro areas; no places); 2021/pep/population has states and above only; 2019/pep/population is
170
+ the last API vintage with place and county subdivision estimates. Vintages 2022 and 2024-2025 (county
171
+ and city/town totals for 2022-2025) are not on the API: use the Census estimates files at
172
+ https://www.census.gov/programs-surveys/popest/data/tables.html (manual download) and name the vintage.
173
+ - SIPP (`sipp`, `20XX/sipp`): public-use microdata, one row per person per reference month (MONTHCODE
174
+ 1-12). The reference year is the calendar year before the file's label: `2024/sipp` was collected in
175
+ 2024 about January-December 2023; say "2023" for its figures. Filter MONTHCODE (12 = December) for a
176
+ point in time, or average the months for the year. The pack always adds SSUID, PNUM (person = SSUID + PNUM), MONTHCODE and
177
+ WPFINWGT, the person weight: every estimate is weighted by WPFINWGT, never a row count. No geography but
178
+ `state`, which filters TST_INTV (state of the interview address); SIPP is designed for national estimates.
179
+ -9 means NA or missing in most variables: drop it before summing. Standard errors need the replicate
180
+ weights, which are not on the API (bulk file `rw<YYYY>_csv.zip`, REPWGT1-REPWGT240, at
181
+ https://www2.census.gov/programs-surveys/sipp/data/datasets/<YYYY>/; method in the year's user guide); without them
182
+ give the point estimate and say no standard error was computed. Variable names and codes:
183
+ `request_schema` search `"<YYYY>/sipp: health insurance"` or the dataset's variables.json. The bulk primary file
184
+ (`pu<YYYY>_csv.zip`, about 100 MB) has every variable, for a manual download.
185
+ - ACS PUMS and CPS microdata (`acs1_pums`, `acs5_pums`, `cps_asec`, `<YYYY>/cps/basic/<mon>`): one row per
186
+ person, values and codes exactly as published, with `<request>_codebook.csv` (every code's label, the
187
+ variable's suggested weight). The pack adds the keys and weights: ACS SERIALNO, SPORDER, PWGTP (persons), WGTP
188
+ (households: SPORDER 1 with RELSHIPP 20); ASEC H_SEQ, A_LINENO, PERIDNUM, MARSUPWT, HSUP_WGT; basic HRHHID,
189
+ HRHHID2, PULINENO, PWSSWGT (final weight), PWCMPWGT (composite: employment levels that match BLS). For hourly
190
+ and weekly earnings in a basic month, request PWORWGT (outgoing rotation groups, HRMIS 4 and 8). Every estimate
191
+ is weighted, never a row count. Filters are upper-case variable predicates (`"AGEP": "25:54"`, `"HICOV": 2`),
192
+ repeated on every call; geography: `state`, or `for: "public use microdata area:*"` with a state (ACS);
193
+ no state = the nation (ACS fetched state by state, 51 calls, about 2 minutes for the 3.4 million persons).
194
+ `replicates: true` adds PWGTP1-80 for ACS (`"household"`: WGTP1-80, `"both"`); columns past 50 come in
195
+ further calls joined on the keys. For the ASEC (2005 on) it adds PH_SEQ and PPPOS and joins PWWGT1-160 from
196
+ Census's replicate weight file (CPS_ASEC_ASCII_REPWGT_<year> on www2.census.gov, about 70 MB, no key), after
197
+ two gates: the file's weight sums equal the totals its SAS layout states, and every person's PWWGT0 equals
198
+ MARSUPWT (2020: the 2020-based file is tried when the main one does not match). Census's replicate standard error
199
+ is sqrt(4/80 * sum of squared replicate differences), MOE = 1.645 * SE (this server does not compute it; see
200
+ Analysis below). Checked 2026-11-04 with that method: Maryland's 2024 uninsured rate in the civilian
201
+ noninstitutionalized population from PUMS was 6.26 +/- 0.32 percent, published S2701 6.3 +/- 0.3; the nation
202
+ 8.19 vs 8.2.
203
+ - Universe: published insurance and labor tables use the civilian noninstitutionalized population
204
+ (drop RELSHIPP 37, the institutionalized group quarters population, and ESR 4-5, armed forces). Codes below zero or 0 often mean N/A (PINCP -19999 under 15, ESR 0 under 16): read the codebook.
205
+ - Dollars: ACS amounts need ADJINC (ADJHSG for housing costs), which the pack adds when a dollar variable asks
206
+ for it: value * ADJINC / 1,000,000 is in the survey year's dollars, as the published tables are. PUMS is a
207
+ subsample of the full ACS: a PUMS figure differs slightly from the published table (inside its MOE);
208
+ publish your figure as your own calculation and benchmark it against the table.
209
+ - CPS: ASEC income, poverty (PERLIS) and full-year insurance (COV) refer to the previous calendar year; NOW_COV
210
+ is coverage at the interview. Census's method for standard errors: weight MARSUPWT with replicates
211
+ PWWGT1-160, SE = sqrt(4/160 * sum of squared differences); household estimates on householders only, with
212
+ HSUP_WGT and the same replicates. Checked 2026-11-04 with that method: 2025 official poverty from the 2026 ASEC was
213
+ 34,505 thousand +/- 909 and 10.2 +/- 0.3 percent (PERLIS 1 among PERLIS != -1), P60-290 Table 1 34,510 +/- 909
214
+ and 10.2 +/- 0.3. Before 2005 there is no replicate file: use the ipums pack.
215
+ The API's 2020 and 2021 ASEC weights are the 2010-Census-based ones (their PWWGT0 matched the main replicate
216
+ file, checked 2026-11-04); Census advises its 2020-based weights to compare those years with 2022 on, and
217
+ they are not on the API: say which weights a 2020-2021 comparison uses.
218
+ ASEC files before 2001 take no state geography on the API (HTTP 500): fetch the nation and filter on the
219
+ file's state variable, or use ipums. Older files lack some keys and weights (HRHHID2 before 2004, PERIDNUM
220
+ in early ASECs): the pack leaves them out and says so. CPS basic monthly has no replicate weights at all; month-to-month person links need HRHHID, HRHHID2 and
221
+ PULINENO with care (ipums CPSIDP links them). CPS codes differ from ACS codes (PEMLR, PRCITSHP, A_HGA /
222
+ PEEDUCA): recode each survey from its own codebook.
223
+ - Analysis: build tables with `compute`. This server has no PUMS recode helpers or replicate-weight standard
224
+ errors yet: say which weight you used, and that standard errors were not computed.
225
+ - Time series (`timeseries/...`): give `time` (`2026`, `2026-08`, `2026-Q2`, or `from 2024-01 to 2026-08`).
226
+ Economic indicators (eits) return one row per code combination: `category_code` (industry or tax type),
227
+ `data_type_code` (level, percent change, ...), `seasonally_adj` (yes/no), `time_slot_id`, `error_data` (yes =
228
+ the row is a margin or standard error, not an estimate). The codes are not in the API's metadata: run one
229
+ narrow query and read the codes that come back, or the program's definitions page (census.gov/econ/currentdata),
230
+ then filter on them; never sum across data types or adjustment flags. Monthly indicators are revised (advance,
231
+ preliminary, revised): say which release. Units: retail and construction $ millions, housing units in
232
+ thousands, QTAX `CELL_VALUE` $ millions (variables.json labels say so); government finances `AMOUNT` $ thousands
233
+ with a coefficient of variation `AMOUNT_CV` (percent, sample-based local figures). Government finance years are
234
+ each government's fiscal year, not the calendar year. International trade: values in dollars; `GEN_VAL_MO`
235
+ general imports vs `CON_VAL_MO` imports for consumption; `CAL_DUT_MO` is the duty calculated on imports for
236
+ consumption (an estimate of duty owed, not Treasury's customs receipts); `COMM_LVL` HS2/HS4/HS6/HS10 must be
237
+ fixed or totals double-count; `CTY_CODE` country codes (5700 China, 2010 Mexico, 1220 Canada); it takes no
238
+ for= geography; `SUMMARY_LVL` CGP rows are country groups, not countries (drop them before summing).
239
+ - Household Pulse (`pulse`, `pulse_covid`) is an experimental data product: an online survey of adults 18+ in
240
+ housing units, contacted by e-mail and text, with weighted response rates of 4.7 to 7.3 percent at the end
241
+ (7.3 percent in week 63, October 2023; 4.7 percent in Phase 4.2 cycle 09, September 2024; each period's Source
242
+ and Accuracy statement, census.gov/programs-surveys/household-pulse-survey/technical-documentation.html). Say so
243
+ with every figure. `pulse` (timeseries/hhpulse) is long: one row per `MEASURE_NAME` (13 measures: EXPENSE,
244
+ FOODSCARCE, ENERGYBILL, EVICTFOR, PRICEINCR, PRICEWORRY, LONELY, ...), `CYCLE` and geography; filter
245
+ `MEASURE_NAME` and `CYCLE`. It holds `time=2024` only (Phase 4.0 cycles 01-03, 4.1 04-07, 4.2 08-09, January 9 to
246
+ September 16, 2024); `time=2025` returns no rows. `pulse_covid` (timeseries/hps) is wide: `<M>_RATE`,
247
+ `<M>_RT_MOE`, `<M>_TOTAL`, `<M>_MOE`, `<M>_UNIV` per collection `WEEK` (01-63, April 2020 to October 2023; from
248
+ Phase 2 a "week" is a two-week collection period). Questions came and went, so a measure is empty in weeks
249
+ that did not ask it (EXPENSE is empty in weeks 01-12, first asked in week 13, August 2020). The survey ended on 2024-09-16 and continued from 2025 inside HTOPS,
250
+ whose tables are not on the API.
251
+ `RATE` is the percent of `UNIVERSE` (`TOTAL` / `UNIVERSE`; EXPENSE, 2024 cycle 09: 87,697,083 / 236,337,862 =
252
+ 37.1), not of `UNITS_TOTAL` (all adults). Report `RATE_MOE` (`<M>_RT_MOE`) with every rate; Census uses
253
+ 90 percent confidence intervals for Pulse, but the API does not state the level of its margins. State margins
254
+ are several times the national one (cycle 09 EXPENSE: Maryland 34.3 +/- 3.4, nation 37.1 +/- 0.7): test a
255
+ difference against both margins before calling it one. Do not splice `pulse_covid` and `pulse` into one series
256
+ or compare across phases without saying the question set and contact frame changed (Phase 4.2 added prepaid
257
+ wireless numbers, "potentially impacting comparability with previous cycles", Phase 4.2 User Notes).
258
+ - HVS (`eits_homeownership`, timeseries/eits/hv) is quarterly (`time=2025-Q3`), from the CPS: `category_code`
259
+ RATE has `data_type_code` HOR (homeownership rate, not seasonally adjusted), SAHOR (seasonally adjusted,
260
+ `seasonally_adj` yes), RVR (rental vacancy rate), HVR (homeowner vacancy rate), and E_HOR, E_RVR, E_HVR
261
+ (`error_data` yes: the 90 percent margin of error in percentage points, e.g. 0.5 for HOR); category ESTIMATE
262
+ holds the housing inventory in thousands (TOTAL, OCC, OWNOCC, RNTOCC, VACANT, RENT, SALE, SEASON, ...). Never
263
+ mix HOR and SAHOR in one series. The API has the nation only; the release's Table 4 is the benchmark (2025
264
+ HOR 65.1, 65.0, 65.3, 65.7 matched the API on 2026-11-03). Fourth quarter 2025 rests on November and December
265
+ only: October 2025 was not collected during the lapse in federal funding (release footnote); say so when it
266
+ is used.
267
+ - Key: since 2026-05-12 every data query needs a key; the API redirects keyless queries to a "Missing
268
+ Key" page, which the pack reports as a key error. Metadata (variables, discovery) still answer
269
+ without a key.
270
+
271
+ ## Access
272
+ Key required: free at https://api.census.gov/data/key_signup.html (an e-mail with an activation link).
273
+ With no key stored, fetch fails with `key_missing`: the user stores one with `npx -y data-analyst-mcp setup
274
+ census` in their own terminal (never in chat); where the server cannot reach the API, the error suggests
275
+ `manual_bundle`. Limits are not published; the pack sends at most 3 requests a second. Manual route:
276
+ `manual_bundle` writes `manual_download/INSTRUCTIONS.md`, which lists one JSON link per request with
277
+ `{API_KEY}` to replace in the browser (or one command runs download_data.sh / .ps1, which asks for the key with
278
+ hidden input); upload the files, then `ingest`. Without the bundle:
279
+ https://data.census.gov, search the table (B19013), set geography and year, Download Table > CSV, and
280
+ upload it saying it is a data.census.gov export (one estimate and one MOE column per geography; `ingest`
281
+ reads it long: label, geography, measure, value). Its table JSON (data.census.gov/api/access/data/table, no
282
+ key) is read too, keeping the spec's `get` variables and their MOEs: one table per file, so give each table its
283
+ own request and save its JSON as `<request name>.json` (e.g. `...table?id=ACSDT1Y2024.B25031&g=310XX00US<CBSA code>`
284
+ for a metro area; worked keyless on 2026-10-22).
285
+ Keyless, for a published ACS detailed table (a benchmark): the table-based summary file, one pipe-delimited
286
+ file per table, e.g. https://www2.census.gov/programs-surveys/acs/summary_file/2024/table-based-SF/data/1YRData/acsdt1y2024-b08013.dat
287
+ (5-year: 5YRData/acsdt5y...); geography ids are in the same folder's documentation. Subject and profile
288
+ tables (S2801, DP02) without a key: https://data.census.gov/api/access/data/table?id=ACSST1Y2024.S2801&g=010XX00US$0400000
289
+ returns the table JSON (all states); `ingest` reads it (it is a benchmark: file it under `published/`
290
+ when no census fetch was made).
291
+ Keyless, for state population totals (PEP): the fred pack's `<ST>POP` series (thousands, July 1) come with
292
+ no key at all, through its keyless graph route, with the usual data/fred/ dictionary and provenance. They
293
+ are annual and can lag a new Census vintage by weeks: compare the latest year with the Census release
294
+ before using them, and name the vintage. (A cross-section of every county through fred `regional` needs a
295
+ FRED key.) A Census estimates file (popest tables) that is still needed is a published table: save it under
296
+ `published/` with `source_url` and `accessed` on every row, never straight into `data/census/`.
297
+
298
+ ## Citation and terms
299
+ "U.S. Census Bureau, <dataset, e.g. 2020-2024 American Community Survey 5-year estimates, table
300
+ B19013; 2024 American Community Survey 1-year Public Use Microdata Sample; or 2024 Survey of Income and Program
301
+ Participation, public-use file>, Census Data API, retrieved <date>." Microdata estimates are your own: "Analyst
302
+ calculations using the 2024 ACS 1-year PUMS." Public domain. Required notice (Terms of Service): "This
303
+ product uses the Census Bureau Data API but is not endorsed or certified by the Census Bureau."
304
+ Redistribution allowed. Metadata (variables lists) is cached on disk for 30 days; data are not.
@@ -0,0 +1,70 @@
1
+ {
2
+ "base_url": "https://geocoding.geo.census.gov/geocoder",
3
+ "timeout": 30,
4
+ "endpoints": {
5
+ "address": {
6
+ "path": "/geographies/onelineaddress",
7
+ "method": "GET",
8
+ "description": "An address to its match(es): matched address, longitude and latitude, and the GEOID and NAME of every census geography it falls in (state, county, tract, block, place, congressional and legislative districts, ...). One row per match; no row when the address does not match.",
9
+ "params": {
10
+ "address": {"required": true, "desc": "one-line address, e.g. \"1600 Pennsylvania Ave NW, Washington, DC 20500\""},
11
+ "benchmark": {"desc": "address-range benchmark (default Public_AR_Current; list: the benchmarks endpoint)"},
12
+ "vintage": {"desc": "geography vintage (default Current_Current; e.g. Census2020_Current, ACS2025_Current; list: the vintages endpoint)"},
13
+ "layers": {"desc": "optional: which geography layers, by id or name (default: the vintage's standard set)"}
14
+ },
15
+ "defaults": {"benchmark": "Public_AR_Current", "vintage": "Current_Current", "format": "json"},
16
+ "records": "result.addressMatches",
17
+ "paging": {"type": "none"},
18
+ "flatten": false,
19
+ "missing": [""]
20
+ },
21
+ "address_location": {
22
+ "path": "/locations/onelineaddress",
23
+ "method": "GET",
24
+ "description": "An address to its match(es) with coordinates and the TIGER line it lies on, without geographies (faster).",
25
+ "params": {
26
+ "address": {"required": true, "desc": "one-line address"},
27
+ "benchmark": {"desc": "address-range benchmark (default Public_AR_Current)"}
28
+ },
29
+ "defaults": {"benchmark": "Public_AR_Current", "format": "json"},
30
+ "records": "result.addressMatches",
31
+ "paging": {"type": "none"},
32
+ "flatten": false,
33
+ "missing": [""]
34
+ },
35
+ "coordinates": {
36
+ "path": "/geographies/coordinates",
37
+ "method": "GET",
38
+ "description": "A point to the GEOID and NAME of every census geography it falls in. One row.",
39
+ "params": {
40
+ "x": {"required": true, "desc": "longitude, decimal degrees (negative west)"},
41
+ "y": {"required": true, "desc": "latitude, decimal degrees"},
42
+ "benchmark": {"desc": "default Public_AR_Current"},
43
+ "vintage": {"desc": "default Current_Current"},
44
+ "layers": {"desc": "optional: which geography layers"}
45
+ },
46
+ "defaults": {"benchmark": "Public_AR_Current", "vintage": "Current_Current", "format": "json"},
47
+ "records": "result",
48
+ "paging": {"type": "none"},
49
+ "flatten": false,
50
+ "missing": [""]
51
+ },
52
+ "benchmarks": {
53
+ "path": "/benchmarks",
54
+ "method": "GET",
55
+ "description": "The address-range benchmarks the geocoder serves (name, description, default).",
56
+ "params": {},
57
+ "records": "benchmarks",
58
+ "paging": {"type": "none"}
59
+ },
60
+ "vintages": {
61
+ "path": "/vintages",
62
+ "method": "GET",
63
+ "description": "The geography vintages available for a benchmark.",
64
+ "params": {"benchmark": {"required": true, "desc": "a benchmark name, e.g. Public_AR_Current"}},
65
+ "records": "vintages",
66
+ "paging": {"type": "none"}
67
+ }
68
+ },
69
+ "catalog": {}
70
+ }