data-analyst-mcp 0.3.0 → 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 (153) hide show
  1. package/README.md +262 -262
  2. package/dist/report/method_audit.js +7 -1
  3. package/dist/report/method_audit.js.map +1 -1
  4. package/dist/report/scan_secrets.d.ts +4 -1
  5. package/dist/report/scan_secrets.js +36 -5
  6. package/dist/report/scan_secrets.js.map +1 -1
  7. package/dist/server.d.ts +1 -1
  8. package/dist/server.js +3 -2
  9. package/dist/server.js.map +1 -1
  10. package/guide/WORKFLOW.md +134 -134
  11. package/guide/assets/disclaimer.txt +1 -1
  12. package/guide/assets/download_data.ps1 +162 -162
  13. package/guide/assets/report_template.html +597 -597
  14. package/guide/references/routing.md +171 -171
  15. package/guide/references/style_guide.md +398 -398
  16. package/package.json +56 -56
  17. package/packs/acf/endpoints.json +114 -114
  18. package/packs/acf/policy.json +104 -104
  19. package/packs/actuaries/endpoints.json +82 -82
  20. package/packs/actuaries/policy.json +109 -109
  21. package/packs/bea/assets/download_bea.ps1 +182 -182
  22. package/packs/bea/docs/bea_api.md +461 -461
  23. package/packs/bea/docs/datasets.md +157 -157
  24. package/packs/bea/docs/report_patterns.md +112 -112
  25. package/packs/bea/policy.json +170 -170
  26. package/packs/bea/source.md +152 -152
  27. package/packs/bls/assets/download_bls.ps1 +152 -152
  28. package/packs/bls/docs/analysis_patterns.md +108 -108
  29. package/packs/bls/docs/bls_api.md +73 -73
  30. package/packs/bls/docs/series_ids.md +149 -149
  31. package/packs/bls/policy.json +238 -238
  32. package/packs/bts/endpoints.json +346 -346
  33. package/packs/bts/policy.json +94 -94
  34. package/packs/cdc/endpoints.json +197 -197
  35. package/packs/cdc/policy.json +83 -83
  36. package/packs/census/endpoints.json +99 -99
  37. package/packs/cfpb/endpoints.json +326 -326
  38. package/packs/cfpb/policy.json +119 -119
  39. package/packs/clinical-trials/endpoints.json +166 -166
  40. package/packs/clinical-trials/policy.json +84 -84
  41. package/packs/cms/endpoints.json +69 -69
  42. package/packs/cms/policy.json +96 -96
  43. package/packs/college-scorecard/endpoints.json +252 -252
  44. package/packs/college-scorecard/policy.json +106 -106
  45. package/packs/congress/endpoints.json +1701 -1701
  46. package/packs/congress/policy.json +117 -117
  47. package/packs/dhs-ohss/endpoints.json +66 -66
  48. package/packs/dhs-ohss/policy.json +107 -107
  49. package/packs/doj-news/endpoints.json +59 -59
  50. package/packs/doj-news/policy.json +96 -96
  51. package/packs/dol/endpoints.json +817 -817
  52. package/packs/dol/policy.json +135 -135
  53. package/packs/eia/endpoints.json +717 -717
  54. package/packs/eia/policy.json +112 -112
  55. package/packs/epa/endpoints.json +291 -291
  56. package/packs/epa/policy.json +99 -99
  57. package/packs/epa-aqs/endpoints.json +173 -173
  58. package/packs/epa-aqs/policy.json +96 -96
  59. package/packs/fbi/endpoints.json +1841 -1841
  60. package/packs/fbi/policy.json +118 -118
  61. package/packs/fda/endpoints.json +237 -237
  62. package/packs/fda/policy.json +121 -121
  63. package/packs/fdic/endpoints.json +416 -416
  64. package/packs/fdic/policy.json +83 -83
  65. package/packs/fec/endpoints.json +707 -707
  66. package/packs/fec/policy.json +93 -93
  67. package/packs/fed-board/endpoints.json +89 -89
  68. package/packs/fed-board/policy.json +136 -136
  69. package/packs/federal-register/endpoints.json +143 -143
  70. package/packs/federal-register/policy.json +86 -86
  71. package/packs/fema/endpoints.json +645 -645
  72. package/packs/fema/policy.json +103 -103
  73. package/packs/fhfa/endpoints.json +105 -105
  74. package/packs/fhfa/policy.json +109 -109
  75. package/packs/fred/assets/download_fred.ps1 +122 -122
  76. package/packs/fred/docs/analysis_patterns.md +124 -124
  77. package/packs/fred/docs/fred_api.md +94 -94
  78. package/packs/fred/docs/series.md +188 -188
  79. package/packs/fred/policy.json +253 -253
  80. package/packs/fsa/endpoints.json +150 -150
  81. package/packs/fsa/policy.json +99 -99
  82. package/packs/govinfo/endpoints.json +519 -519
  83. package/packs/gsa-calc/endpoints.json +93 -93
  84. package/packs/gsa-calc/policy.json +97 -97
  85. package/packs/hud/endpoints.json +146 -146
  86. package/packs/hud/policy.json +84 -84
  87. package/packs/ipums/docs/report_patterns.md +117 -117
  88. package/packs/irs-soi/endpoints.json +114 -114
  89. package/packs/irs-soi/policy.json +107 -107
  90. package/packs/medicaid/endpoints.json +412 -412
  91. package/packs/medicaid/policy.json +108 -108
  92. package/packs/naep/endpoints.json +217 -217
  93. package/packs/naep/policy.json +100 -100
  94. package/packs/nhtsa/endpoints.json +132 -132
  95. package/packs/nhtsa/policy.json +93 -93
  96. package/packs/nih/endpoints.json +452 -452
  97. package/packs/nih/policy.json +86 -86
  98. package/packs/noaa/endpoints.json +431 -431
  99. package/packs/noaa/policy.json +95 -95
  100. package/packs/nrel/endpoints.json +327 -327
  101. package/packs/nrel/policy.json +96 -96
  102. package/packs/nws/endpoints.json +271 -271
  103. package/packs/nws/policy.json +82 -82
  104. package/packs/nyfed/endpoints.json +80 -80
  105. package/packs/nyfed/policy.json +92 -92
  106. package/packs/omb/endpoints.json +460 -460
  107. package/packs/omb/policy.json +106 -106
  108. package/packs/open-payments/endpoints.json +297 -297
  109. package/packs/open-payments/policy.json +101 -101
  110. package/packs/opm/assets/download_opm.ps1 +125 -125
  111. package/packs/opm/docs/fields.md +184 -184
  112. package/packs/opm/docs/opm_api.md +71 -71
  113. package/packs/opm/docs/report_patterns.md +83 -83
  114. package/packs/opm/lib/data_dictionary.csv +73 -73
  115. package/packs/pbgc/endpoints.json +483 -483
  116. package/packs/pbgc/policy.json +94 -94
  117. package/packs/philfed/endpoints.json +85 -85
  118. package/packs/philfed/policy.json +94 -94
  119. package/packs/regulations/endpoints.json +287 -287
  120. package/packs/regulations/policy.json +86 -86
  121. package/packs/sec/endpoints.json +236 -236
  122. package/packs/sec/policy.json +86 -86
  123. package/packs/senate-lobbying/endpoints.json +553 -553
  124. package/packs/senate-lobbying/policy.json +99 -99
  125. package/packs/snapqc/endpoints.json +1426 -1426
  126. package/packs/snapqc/policy.json +92 -92
  127. package/packs/treasury/catalog.json +2267 -2267
  128. package/packs/treasury/docs/api_guide.md +245 -245
  129. package/packs/treasury/docs/datasets.md +56 -56
  130. package/packs/treasury/docs/report_patterns.md +126 -126
  131. package/packs/treasury/policy.json +159 -159
  132. package/packs/treasury/source.md +170 -165
  133. package/packs/treasury-yields/endpoints.json +226 -226
  134. package/packs/treasury-yields/policy.json +86 -86
  135. package/packs/usaspending/endpoints.json +1315 -1315
  136. package/packs/usaspending/policy.json +109 -109
  137. package/packs/usda-fna/policy.json +133 -133
  138. package/packs/usda-fooddata/endpoints.json +180 -180
  139. package/packs/usda-fooddata/policy.json +94 -94
  140. package/packs/usda-nass/endpoints.json +323 -323
  141. package/packs/usda-nass/policy.json +95 -95
  142. package/packs/usda-outlook/endpoints.json +86 -86
  143. package/packs/usda-outlook/policy.json +109 -109
  144. package/packs/usgs/endpoints.json +313 -313
  145. package/packs/usgs/policy.json +95 -95
  146. package/packs/usitc/endpoints.json +74 -74
  147. package/packs/usitc/policy.json +111 -111
  148. package/packs/uspto/endpoints.json +141 -141
  149. package/packs/uspto/policy.json +95 -95
  150. package/packs/va/endpoints.json +414 -414
  151. package/packs/va/policy.json +101 -101
  152. package/packs/world-bank/endpoints.json +122 -122
  153. package/packs/world-bank/policy.json +101 -101
@@ -1,149 +1,149 @@
1
- # Series IDs
2
-
3
- A wrong series ID is the most common silent error: the number exists, it is just not the number the
4
- user asked about. Before downloading, call `request_schema` for bls with the search `describe <ID> ...` and read
5
- the title, the seasonal adjustment and the dimensions back against the request.
6
-
7
- Contents: 1. How IDs are built · 2. Verified common series · 3. Finding an ID you do not know · 4. ID builders
8
-
9
- ## 1. How IDs are built
10
- The first two letters name the survey; for most surveys the third is **S** (seasonally adjusted) or
11
- **U** (not seasonally adjusted). Full formats: https://www.bls.gov/help/hlpforma.htm.
12
-
13
- | Prefix | Survey | Structure (after the prefix and S/U) |
14
- |---|---|---|
15
- | LN | Current Population Survey (household survey) | 8-digit series code, e.g. `LNS14000000` |
16
- | CE | Current Employment Statistics (payroll survey), national | 8-digit industry + 2-digit data type (`01` employment, thousands; `02` avg weekly hours; `03` avg hourly earnings; `08` AHE production and nonsupervisory; `11` avg weekly earnings; `13` real AHE, 1982-84 dollars (CPI-U); `32` real AHE of production and nonsupervisory employees (CPI-W)) |
17
- | SM | CES state and metro | 2-digit state FIPS + 5-digit area + 8-digit industry + 2-digit data type |
18
- | CU / CW / SU | CPI-U / CPI-W / chained CPI-U | `R` (monthly) or `S` (semiannual) + 4-char area (`0000` U.S. city average, `S49A` Los Angeles ...) + item (`SA0` all items, `SA0L1E` less food and energy, `SAF1` food, `SAF11` food at home, `SEFV` food away from home, `SA0E` energy, `SAH1` shelter, `SEHA` rent, `SEHC` owners' equivalent rent, `SETB01` gasoline, `SAM` medical care, `SAM2` medical care services, `SETE` motor vehicle insurance, `SETA02` used cars and trucks, `SAS` services) |
19
- | WP / PC | PPI commodities and final demand / industries | `WPSFD4` final demand SA, `WPUFD4` NSA |
20
- | JT | JOLTS | 6-digit industry + 2-digit state + 5-digit area + 2-char size class + 2-char element (`JO` openings, `HI` hires, `QU` quits, `TS` total separations, `LD` layoffs) + `L` level (thousands) or `R` rate |
21
- | LA | Local Area Unemployment Statistics | 2-char area type (`ST` state, `MT` metro, `CN` county) + 13-digit area code + 2-digit measure (`03` rate, `04` unemployed, `05` employed, `06` labor force) |
22
- | EN | QCEW | `U` + area (5) + data type (1) + size (1) + ownership (1) + industry code as written, not padded (`10` = all industries, or the NAICS code): `ENU2403110110` = Montgomery County MD, federal government employment [checked 2026-10-22] |
23
- | OE | OEWS (annual, period A01) | area type + area + industry + occupation (SOC) + data type |
24
- | CI | Employment Cost Index (quarterly) | `CI` + S/U + owner (`1` civilian, `2` private industry, `3` state and local government) + `0` + component (`1` total compensation, `2` wages and salaries, `3` benefits) + `0000000000` + `I` index or `A` 12-month percent change (NSA; BLS's headline 12-month changes): `CIU2020000000000A` private wages and salaries, `CIU3020000000000A` state and local (titles read back from data.bls.gov on 2026-10-21) |
25
- | PR | Productivity and costs (quarterly) | `PRS85006092` nonfarm business labor productivity, percent change at annual rate; `PRS85006112` unit labor costs; indexes 2017=100 (for growth since a date): `PRS85006093` productivity, `PRS85006103` hourly compensation, `PRS85006153` real hourly compensation, `PRS85006173` labor share, `PRS85006143` output price deflator |
26
- | LE | CPS usual weekly earnings (quarterly) | `LEU0252881500` median weekly earnings, full-time wage and salary workers |
27
-
28
- ## 2. Verified common series ✔ (returned data on 2026-10-19; labels checked against the BLS series titles on 2026-10-21)
29
- | Measure | SA | NSA / other |
30
- |---|---|---|
31
- | Unemployment rate (U-3), 16+ | `LNS14000000` | `LNU04000000` |
32
- | U-6 rate | `LNS13327709` | |
33
- | Labor force participation rate | `LNS11300000` | |
34
- | Employment-population ratio | `LNS12300000` | |
35
- | Participation rate, ages 25 to 54 | `LNS11300060` | |
36
- | Employment-population ratio, ages 25 to 54 (total; men `LNS12300061`, women `LNS12300062`) | `LNS12300060` | |
37
- | Employed / unemployed, levels (thousands) | `LNS12000000` / `LNS13000000` | |
38
- | Unemployment rate: men 16+, women 16+ | `LNS14000001`, `LNS14000002` | |
39
- | Unemployment rate: White, Black, Hispanic, Asian | `LNS14000003`, `LNS14000006` (from 1972), `LNS14000009` (from 1973), `LNS14032183` (from 2000) | `LNU04000003`, `LNU04000006`, `LNU04000009`, `LNU04032183` |
40
- | Unemployment rate, ages 16 to 24 / 16 to 19 / 20 to 24 | `LNS14024887` / `LNS14000012` / `LNS14000036` | `LNU04024887` (16 to 24) |
41
- | Unemployment rate by education, 25 and over: less than high school / high school, no college / some college or associate / bachelor's and higher | `LNS14027659` / `LNS14027660` / `LNS14027689` / `LNS14027662` (from 1992) | `LNU04027659` ... (same suffixes) |
42
- | Total nonfarm payrolls (thousands) | `CES0000000001` | `CEU0000000001` |
43
- | Total private / government / manufacturing payrolls | `CES0500000001` / `CES9000000001` / `CES3000000001` | |
44
- | Average hourly earnings, all private employees | `CES0500000003` | |
45
- | AHE, production and nonsupervisory | `CES0500000008` | |
46
- | Real AHE (1982-84 dollars) | `CES0500000013` | |
47
- | Average weekly hours, private | `CES0500000002` | |
48
- | CPI-U all items (1982-84=100) | `CUSR0000SA0` | `CUUR0000SA0` |
49
- | CPI-U less food and energy (core) | `CUSR0000SA0L1E` | `CUUR0000SA0L1E` |
50
- | CPI-U food / energy / shelter / gasoline | | `CUUR0000SAF1` / `CUUR0000SA0E` / `CUUR0000SAH1` / `CUUR0000SETB01` |
51
- | CPI-W, chained CPI-U (C-CPI-U is revised for 10 to 12 months: "Interim") | | `CWUR0000SA0`, `SUUR0000SA0` |
52
- | CPI-U, Los Angeles area | | `CUURS49ASA0` |
53
- | CPI-U, metro areas | | see the area table below |
54
- | PPI final demand | `WPSFD4` | `WPUFD4` |
55
- | Job openings (thousands) / rate | `JTS000000000000000JOL` / `JTS000000000000000JOR` | |
56
- | Hires rate / quits rate | `JTS000000000000000HIR` / `JTS000000000000000QUR` | |
57
- | State unemployment rate (California) | `LASST060000000000003` | `LAUST060000000000003` |
58
- | ECI, total compensation, civilian: index / 12-month change | `CIS1010000000000I` | `CIU1010000000000A` |
59
- | Nonfarm business labor productivity / unit labor costs | `PRS85006092` / `PRS85006112` | |
60
- | Median usual weekly earnings, full-time (current / 1982-84 dollars) | `LES1252881500` / `LES1252881600` (the news release headline) | `LEU0252881500` / `LEU0252881600` |
61
- | OEWS, all occupations, U.S., annual mean wage | | `OEUN000000000000000000004` (annual, latest year only) |
62
-
63
- State codes in LA and SM IDs are FIPS codes (`06` California, `36` New York, `48` Texas ...). For other
64
- states, change the two digits and confirm with the `request_schema` search `describe <ID>`.
65
-
66
- ## 3. Finding an ID you do not know
67
- 1. Build it from the structure in §1 and confirm it with the `request_schema` search `describe <ID>`, or build it
68
- with a spec `build` entry (§4): a missing title means
69
- the ID does not exist (not for OEWS: data.bls.gov has no catalog page for OE IDs, so the search decodes
70
- them from their layout and says so; a wrong OEWS ID shows up as a series with no data at fetch time).
71
- 2. Search tools for the user or the browser: https://data.bls.gov/dataQuery/find (keyword search),
72
- https://beta.bls.gov/dataQuery/search, the survey's "Databases, Tables & Calculators" page, or the
73
- series list behind each table in a BLS news release.
74
- 3. Never guess an ID from memory and download it without reading its title; never report a number from a series
75
- whose title you have not read.
76
-
77
- ## 4. ID builders (`"build"` in the spec; the `request_schema` search `build {json}` previews the IDs)
78
- Every
79
- pattern below returned data from the API on 2026-10-20 for Maryland / Baltimore County / SOC 15-1252.
80
-
81
- | Builder | Arguments | ID pattern | Example |
82
- |---|---|---|---|
83
- | `laus` (state) | `state` (MD, 24, Maryland), `measure`, `seasonal` S/U | `LA` + S/U + `ST` + FIPS + 11 zeros + measure | `LASST240000000000003` |
84
- | `laus` (county) | `county` (5-digit FIPS), `measure` | `LAUCN` + FIPS + 8 zeros + measure (NSA only) | `LAUCN240050000000003` |
85
- | `ces_state` | `state`, `industry` (8 digits), `datatype` (01 employment), `seasonal` | `SM` + S/U + FIPS + `00000` + industry + datatype | `SMS24000000000000001` |
86
- | `state` | `state` | LAUS rate, employment, labor force (SA) + CES total nonfarm | 4 IDs |
87
- | `oews` | `occupation` (SOC `15-1252`), `measure`, `state` (optional) | `OEU` + `N0000000` or `S`+FIPS+`00000` + `000000` + SOC + datatype | `OEUN000000000000015125213` |
88
- | `jolts` | `industry` (code, name, comma list or `all`), `measure`, `rate` (default true), `seasonal` | `JT` + S/U + industry + `000000000` + element + `R`/`L` | `JTS720000000000000QUR` |
89
-
90
- LAUS measures: `unemployment_rate` 03, `unemployment` 04, `employment` 05, `labor_force` 06. OEWS
91
- measures: `employment` 01, `hourly_mean_wage` 03, `annual_mean_wage` 04, `hourly_median_wage` 08,
92
- `annual_10th_percentile_wage` 11, `annual_median_wage` 13, `annual_90th_percentile_wage` 15.
93
- JOLTS measures: `job_openings` JO, `hires` HI, `total_separations` TS, `quits` QU, `layoffs` LD,
94
- `other_separations` OS. JOLTS industry codes (national; the irregular ones end in 099): 000000 total
95
- nonfarm, 100000 total private, 110099 mining and logging, 230000 construction, 300000 manufacturing
96
- (320000 durable, 340000 nondurable), 400000 trade, transportation and utilities (420000 wholesale, 440000
97
- retail, 480099 transportation, warehousing and utilities), 510000 information, 510099 financial activities
98
- (520000 finance and insurance, 530000 real estate), 540099 professional and business services, 600000
99
- private education and health (610000 educational services, 620000 health care and social assistance),
100
- 700000 leisure and hospitality (710000 arts, 720000 accommodation and food), 810000 other services, 900000
101
- government (910000 federal, 920000 state and local, 923000 state and local education, 929000 state and local
102
- excluding education). All 28 quits-rate IDs were read back from data.bls.gov on 2026-10-21. OEWS is
103
- annual (period `A01`) and the API returns only the latest survey year (2025 on 2026-10-20: SOC 15-1252
104
- annual median wage $135,980 U.S., $138,680 Maryland); a request for the current year adds a "No Data
105
- Available" message, not an error. County LAUS lags the state data by a month.
106
-
107
- Common ID mix-ups (titles checked on data.bls.gov on 2026-10-20): U-6 is `LNS13327709`;
108
- `LNS13023621` is "(Seas) Unemployment Level - Job Losers" (thousands). `WPUFD4` is PPI final demand (not
109
- "finished goods"); `WPUFD49104` is final demand less foods and energy (not "finished consumer foods");
110
- `CES6562000003` covers health care and social assistance. Prefix `EI` is not the Employment Cost
111
- Index; `EI` is import/export prices and the ECI is `CI`.
112
-
113
- ## Union membership (CPS annual averages, `LU`)
114
- `LUU0204899600` is the union membership rate (percent of employed wage and salary workers), United States;
115
- the last two digits are the state FIPS code (`LUU0204899615` Hawaii, `LUU0204899646` South Dakota).
116
- Annual only (period A01); BLS publishes no state standard errors, and 2025 values are 11-month averages
117
- (October 2025 not collected). BLS's Union Members news release, Table 5, lists every state.
118
-
119
- ## Metro-area CPI-U (all items, NSA; IDs checked 2026-10-22)
120
- Only New York, Chicago and Los Angeles are priced monthly; the others every other month (odd months: Jan,
121
- Mar ...; even months: Feb, Apr ...), so "the latest" month differs by area and the off months come back
122
- empty (`n_missing`/`absent_periods` count them). Compare 12-month changes at each area's own latest month
123
- (match each month to the same month a year earlier by date, not by row) and say which month each is. BLS's news release Table 4 lists them all.
124
-
125
- | Series | Area | Priced |
126
- |---|---|---|
127
- | `CUURS11ASA0` | Boston-Cambridge-Newton | odd |
128
- | `CUURS12ASA0` | New York-Newark-Jersey City | monthly |
129
- | `CUURS12BSA0` | Philadelphia-Camden-Wilmington | even |
130
- | `CUURS23ASA0` | Chicago-Naperville-Elgin | monthly |
131
- | `CUURS23BSA0` | Detroit-Warren-Dearborn | even |
132
- | `CUURS24ASA0` | Minneapolis-St. Paul-Bloomington | odd |
133
- | `CUURS24BSA0` | St. Louis | even |
134
- | `CUURS35ASA0` | Washington-Arlington-Alexandria | odd |
135
- | `CUURS35BSA0` | Miami-Fort Lauderdale-West Palm Beach | even |
136
- | `CUURS35CSA0` | Atlanta-Sandy Springs-Roswell | even |
137
- | `CUURS35DSA0` | Tampa-St. Petersburg-Clearwater | odd |
138
- | `CUURS35ESA0` | Baltimore-Columbia-Towson | even |
139
- | `CUURS37ASA0` | Dallas-Fort Worth-Arlington | odd |
140
- | `CUURS37BSA0` | Houston-The Woodlands-Sugar Land | even |
141
- | `CUURS48ASA0` | Phoenix-Mesa-Scottsdale | even |
142
- | `CUURS48BSA0` | Denver-Aurora-Lakewood | odd |
143
- | `CUURS49ASA0` | Los Angeles-Long Beach-Anaheim | monthly |
144
- | `CUURS49BSA0` | San Francisco-Oakland-Hayward | even |
145
- | `CUURS49CSA0` | Riverside-San Bernardino-Ontario | odd |
146
- | `CUURS49DSA0` | Seattle-Tacoma-Bellevue | even |
147
- | `CUURS49ESA0` | San Diego-Carlsbad | odd |
148
- | `CUURS49FSA0` | Urban Hawaii | odd |
149
- | `CUURS49GSA0` | Urban Alaska | even |
1
+ # Series IDs
2
+
3
+ A wrong series ID is the most common silent error: the number exists, it is just not the number the
4
+ user asked about. Before downloading, call `request_schema` for bls with the search `describe <ID> ...` and read
5
+ the title, the seasonal adjustment and the dimensions back against the request.
6
+
7
+ Contents: 1. How IDs are built · 2. Verified common series · 3. Finding an ID you do not know · 4. ID builders
8
+
9
+ ## 1. How IDs are built
10
+ The first two letters name the survey; for most surveys the third is **S** (seasonally adjusted) or
11
+ **U** (not seasonally adjusted). Full formats: https://www.bls.gov/help/hlpforma.htm.
12
+
13
+ | Prefix | Survey | Structure (after the prefix and S/U) |
14
+ |---|---|---|
15
+ | LN | Current Population Survey (household survey) | 8-digit series code, e.g. `LNS14000000` |
16
+ | CE | Current Employment Statistics (payroll survey), national | 8-digit industry + 2-digit data type (`01` employment, thousands; `02` avg weekly hours; `03` avg hourly earnings; `08` AHE production and nonsupervisory; `11` avg weekly earnings; `13` real AHE, 1982-84 dollars (CPI-U); `32` real AHE of production and nonsupervisory employees (CPI-W)) |
17
+ | SM | CES state and metro | 2-digit state FIPS + 5-digit area + 8-digit industry + 2-digit data type |
18
+ | CU / CW / SU | CPI-U / CPI-W / chained CPI-U | `R` (monthly) or `S` (semiannual) + 4-char area (`0000` U.S. city average, `S49A` Los Angeles ...) + item (`SA0` all items, `SA0L1E` less food and energy, `SAF1` food, `SAF11` food at home, `SEFV` food away from home, `SA0E` energy, `SAH1` shelter, `SEHA` rent, `SEHC` owners' equivalent rent, `SETB01` gasoline, `SAM` medical care, `SAM2` medical care services, `SETE` motor vehicle insurance, `SETA02` used cars and trucks, `SAS` services) |
19
+ | WP / PC | PPI commodities and final demand / industries | `WPSFD4` final demand SA, `WPUFD4` NSA |
20
+ | JT | JOLTS | 6-digit industry + 2-digit state + 5-digit area + 2-char size class + 2-char element (`JO` openings, `HI` hires, `QU` quits, `TS` total separations, `LD` layoffs) + `L` level (thousands) or `R` rate |
21
+ | LA | Local Area Unemployment Statistics | 2-char area type (`ST` state, `MT` metro, `CN` county) + 13-digit area code + 2-digit measure (`03` rate, `04` unemployed, `05` employed, `06` labor force) |
22
+ | EN | QCEW | `U` + area (5) + data type (1) + size (1) + ownership (1) + industry code as written, not padded (`10` = all industries, or the NAICS code): `ENU2403110110` = Montgomery County MD, federal government employment [checked 2026-10-22] |
23
+ | OE | OEWS (annual, period A01) | area type + area + industry + occupation (SOC) + data type |
24
+ | CI | Employment Cost Index (quarterly) | `CI` + S/U + owner (`1` civilian, `2` private industry, `3` state and local government) + `0` + component (`1` total compensation, `2` wages and salaries, `3` benefits) + `0000000000` + `I` index or `A` 12-month percent change (NSA; BLS's headline 12-month changes): `CIU2020000000000A` private wages and salaries, `CIU3020000000000A` state and local (titles read back from data.bls.gov on 2026-10-21) |
25
+ | PR | Productivity and costs (quarterly) | `PRS85006092` nonfarm business labor productivity, percent change at annual rate; `PRS85006112` unit labor costs; indexes 2017=100 (for growth since a date): `PRS85006093` productivity, `PRS85006103` hourly compensation, `PRS85006153` real hourly compensation, `PRS85006173` labor share, `PRS85006143` output price deflator |
26
+ | LE | CPS usual weekly earnings (quarterly) | `LEU0252881500` median weekly earnings, full-time wage and salary workers |
27
+
28
+ ## 2. Verified common series ✔ (returned data on 2026-10-19; labels checked against the BLS series titles on 2026-10-21)
29
+ | Measure | SA | NSA / other |
30
+ |---|---|---|
31
+ | Unemployment rate (U-3), 16+ | `LNS14000000` | `LNU04000000` |
32
+ | U-6 rate | `LNS13327709` | |
33
+ | Labor force participation rate | `LNS11300000` | |
34
+ | Employment-population ratio | `LNS12300000` | |
35
+ | Participation rate, ages 25 to 54 | `LNS11300060` | |
36
+ | Employment-population ratio, ages 25 to 54 (total; men `LNS12300061`, women `LNS12300062`) | `LNS12300060` | |
37
+ | Employed / unemployed, levels (thousands) | `LNS12000000` / `LNS13000000` | |
38
+ | Unemployment rate: men 16+, women 16+ | `LNS14000001`, `LNS14000002` | |
39
+ | Unemployment rate: White, Black, Hispanic, Asian | `LNS14000003`, `LNS14000006` (from 1972), `LNS14000009` (from 1973), `LNS14032183` (from 2000) | `LNU04000003`, `LNU04000006`, `LNU04000009`, `LNU04032183` |
40
+ | Unemployment rate, ages 16 to 24 / 16 to 19 / 20 to 24 | `LNS14024887` / `LNS14000012` / `LNS14000036` | `LNU04024887` (16 to 24) |
41
+ | Unemployment rate by education, 25 and over: less than high school / high school, no college / some college or associate / bachelor's and higher | `LNS14027659` / `LNS14027660` / `LNS14027689` / `LNS14027662` (from 1992) | `LNU04027659` ... (same suffixes) |
42
+ | Total nonfarm payrolls (thousands) | `CES0000000001` | `CEU0000000001` |
43
+ | Total private / government / manufacturing payrolls | `CES0500000001` / `CES9000000001` / `CES3000000001` | |
44
+ | Average hourly earnings, all private employees | `CES0500000003` | |
45
+ | AHE, production and nonsupervisory | `CES0500000008` | |
46
+ | Real AHE (1982-84 dollars) | `CES0500000013` | |
47
+ | Average weekly hours, private | `CES0500000002` | |
48
+ | CPI-U all items (1982-84=100) | `CUSR0000SA0` | `CUUR0000SA0` |
49
+ | CPI-U less food and energy (core) | `CUSR0000SA0L1E` | `CUUR0000SA0L1E` |
50
+ | CPI-U food / energy / shelter / gasoline | | `CUUR0000SAF1` / `CUUR0000SA0E` / `CUUR0000SAH1` / `CUUR0000SETB01` |
51
+ | CPI-W, chained CPI-U (C-CPI-U is revised for 10 to 12 months: "Interim") | | `CWUR0000SA0`, `SUUR0000SA0` |
52
+ | CPI-U, Los Angeles area | | `CUURS49ASA0` |
53
+ | CPI-U, metro areas | | see the area table below |
54
+ | PPI final demand | `WPSFD4` | `WPUFD4` |
55
+ | Job openings (thousands) / rate | `JTS000000000000000JOL` / `JTS000000000000000JOR` | |
56
+ | Hires rate / quits rate | `JTS000000000000000HIR` / `JTS000000000000000QUR` | |
57
+ | State unemployment rate (California) | `LASST060000000000003` | `LAUST060000000000003` |
58
+ | ECI, total compensation, civilian: index / 12-month change | `CIS1010000000000I` | `CIU1010000000000A` |
59
+ | Nonfarm business labor productivity / unit labor costs | `PRS85006092` / `PRS85006112` | |
60
+ | Median usual weekly earnings, full-time (current / 1982-84 dollars) | `LES1252881500` / `LES1252881600` (the news release headline) | `LEU0252881500` / `LEU0252881600` |
61
+ | OEWS, all occupations, U.S., annual mean wage | | `OEUN000000000000000000004` (annual, latest year only) |
62
+
63
+ State codes in LA and SM IDs are FIPS codes (`06` California, `36` New York, `48` Texas ...). For other
64
+ states, change the two digits and confirm with the `request_schema` search `describe <ID>`.
65
+
66
+ ## 3. Finding an ID you do not know
67
+ 1. Build it from the structure in §1 and confirm it with the `request_schema` search `describe <ID>`, or build it
68
+ with a spec `build` entry (§4): a missing title means
69
+ the ID does not exist (not for OEWS: data.bls.gov has no catalog page for OE IDs, so the search decodes
70
+ them from their layout and says so; a wrong OEWS ID shows up as a series with no data at fetch time).
71
+ 2. Search tools for the user or the browser: https://data.bls.gov/dataQuery/find (keyword search),
72
+ https://beta.bls.gov/dataQuery/search, the survey's "Databases, Tables & Calculators" page, or the
73
+ series list behind each table in a BLS news release.
74
+ 3. Never guess an ID from memory and download it without reading its title; never report a number from a series
75
+ whose title you have not read.
76
+
77
+ ## 4. ID builders (`"build"` in the spec; the `request_schema` search `build {json}` previews the IDs)
78
+ Every
79
+ pattern below returned data from the API on 2026-10-20 for Maryland / Baltimore County / SOC 15-1252.
80
+
81
+ | Builder | Arguments | ID pattern | Example |
82
+ |---|---|---|---|
83
+ | `laus` (state) | `state` (MD, 24, Maryland), `measure`, `seasonal` S/U | `LA` + S/U + `ST` + FIPS + 11 zeros + measure | `LASST240000000000003` |
84
+ | `laus` (county) | `county` (5-digit FIPS), `measure` | `LAUCN` + FIPS + 8 zeros + measure (NSA only) | `LAUCN240050000000003` |
85
+ | `ces_state` | `state`, `industry` (8 digits), `datatype` (01 employment), `seasonal` | `SM` + S/U + FIPS + `00000` + industry + datatype | `SMS24000000000000001` |
86
+ | `state` | `state` | LAUS rate, employment, labor force (SA) + CES total nonfarm | 4 IDs |
87
+ | `oews` | `occupation` (SOC `15-1252`), `measure`, `state` (optional) | `OEU` + `N0000000` or `S`+FIPS+`00000` + `000000` + SOC + datatype | `OEUN000000000000015125213` |
88
+ | `jolts` | `industry` (code, name, comma list or `all`), `measure`, `rate` (default true), `seasonal` | `JT` + S/U + industry + `000000000` + element + `R`/`L` | `JTS720000000000000QUR` |
89
+
90
+ LAUS measures: `unemployment_rate` 03, `unemployment` 04, `employment` 05, `labor_force` 06. OEWS
91
+ measures: `employment` 01, `hourly_mean_wage` 03, `annual_mean_wage` 04, `hourly_median_wage` 08,
92
+ `annual_10th_percentile_wage` 11, `annual_median_wage` 13, `annual_90th_percentile_wage` 15.
93
+ JOLTS measures: `job_openings` JO, `hires` HI, `total_separations` TS, `quits` QU, `layoffs` LD,
94
+ `other_separations` OS. JOLTS industry codes (national; the irregular ones end in 099): 000000 total
95
+ nonfarm, 100000 total private, 110099 mining and logging, 230000 construction, 300000 manufacturing
96
+ (320000 durable, 340000 nondurable), 400000 trade, transportation and utilities (420000 wholesale, 440000
97
+ retail, 480099 transportation, warehousing and utilities), 510000 information, 510099 financial activities
98
+ (520000 finance and insurance, 530000 real estate), 540099 professional and business services, 600000
99
+ private education and health (610000 educational services, 620000 health care and social assistance),
100
+ 700000 leisure and hospitality (710000 arts, 720000 accommodation and food), 810000 other services, 900000
101
+ government (910000 federal, 920000 state and local, 923000 state and local education, 929000 state and local
102
+ excluding education). All 28 quits-rate IDs were read back from data.bls.gov on 2026-10-21. OEWS is
103
+ annual (period `A01`) and the API returns only the latest survey year (2025 on 2026-10-20: SOC 15-1252
104
+ annual median wage $135,980 U.S., $138,680 Maryland); a request for the current year adds a "No Data
105
+ Available" message, not an error. County LAUS lags the state data by a month.
106
+
107
+ Common ID mix-ups (titles checked on data.bls.gov on 2026-10-20): U-6 is `LNS13327709`;
108
+ `LNS13023621` is "(Seas) Unemployment Level - Job Losers" (thousands). `WPUFD4` is PPI final demand (not
109
+ "finished goods"); `WPUFD49104` is final demand less foods and energy (not "finished consumer foods");
110
+ `CES6562000003` covers health care and social assistance. Prefix `EI` is not the Employment Cost
111
+ Index; `EI` is import/export prices and the ECI is `CI`.
112
+
113
+ ## Union membership (CPS annual averages, `LU`)
114
+ `LUU0204899600` is the union membership rate (percent of employed wage and salary workers), United States;
115
+ the last two digits are the state FIPS code (`LUU0204899615` Hawaii, `LUU0204899646` South Dakota).
116
+ Annual only (period A01); BLS publishes no state standard errors, and 2025 values are 11-month averages
117
+ (October 2025 not collected). BLS's Union Members news release, Table 5, lists every state.
118
+
119
+ ## Metro-area CPI-U (all items, NSA; IDs checked 2026-10-22)
120
+ Only New York, Chicago and Los Angeles are priced monthly; the others every other month (odd months: Jan,
121
+ Mar ...; even months: Feb, Apr ...), so "the latest" month differs by area and the off months come back
122
+ empty (`n_missing`/`absent_periods` count them). Compare 12-month changes at each area's own latest month
123
+ (match each month to the same month a year earlier by date, not by row) and say which month each is. BLS's news release Table 4 lists them all.
124
+
125
+ | Series | Area | Priced |
126
+ |---|---|---|
127
+ | `CUURS11ASA0` | Boston-Cambridge-Newton | odd |
128
+ | `CUURS12ASA0` | New York-Newark-Jersey City | monthly |
129
+ | `CUURS12BSA0` | Philadelphia-Camden-Wilmington | even |
130
+ | `CUURS23ASA0` | Chicago-Naperville-Elgin | monthly |
131
+ | `CUURS23BSA0` | Detroit-Warren-Dearborn | even |
132
+ | `CUURS24ASA0` | Minneapolis-St. Paul-Bloomington | odd |
133
+ | `CUURS24BSA0` | St. Louis | even |
134
+ | `CUURS35ASA0` | Washington-Arlington-Alexandria | odd |
135
+ | `CUURS35BSA0` | Miami-Fort Lauderdale-West Palm Beach | even |
136
+ | `CUURS35CSA0` | Atlanta-Sandy Springs-Roswell | even |
137
+ | `CUURS35DSA0` | Tampa-St. Petersburg-Clearwater | odd |
138
+ | `CUURS35ESA0` | Baltimore-Columbia-Towson | even |
139
+ | `CUURS37ASA0` | Dallas-Fort Worth-Arlington | odd |
140
+ | `CUURS37BSA0` | Houston-The Woodlands-Sugar Land | even |
141
+ | `CUURS48ASA0` | Phoenix-Mesa-Scottsdale | even |
142
+ | `CUURS48BSA0` | Denver-Aurora-Lakewood | odd |
143
+ | `CUURS49ASA0` | Los Angeles-Long Beach-Anaheim | monthly |
144
+ | `CUURS49BSA0` | San Francisco-Oakland-Hayward | even |
145
+ | `CUURS49CSA0` | Riverside-San Bernardino-Ontario | odd |
146
+ | `CUURS49DSA0` | Seattle-Tacoma-Bellevue | even |
147
+ | `CUURS49ESA0` | San Diego-Carlsbad | odd |
148
+ | `CUURS49FSA0` | Urban Hawaii | odd |
149
+ | `CUURS49GSA0` | Urban Alaska | even |