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.
- package/README.md +262 -262
- package/dist/report/method_audit.js +7 -1
- package/dist/report/method_audit.js.map +1 -1
- package/dist/report/scan_secrets.d.ts +4 -1
- package/dist/report/scan_secrets.js +36 -5
- package/dist/report/scan_secrets.js.map +1 -1
- package/dist/server.d.ts +1 -1
- package/dist/server.js +3 -2
- package/dist/server.js.map +1 -1
- package/guide/WORKFLOW.md +134 -134
- package/guide/assets/disclaimer.txt +1 -1
- package/guide/assets/download_data.ps1 +162 -162
- package/guide/assets/report_template.html +597 -597
- package/guide/references/routing.md +171 -171
- package/guide/references/style_guide.md +398 -398
- package/package.json +56 -56
- package/packs/acf/endpoints.json +114 -114
- package/packs/acf/policy.json +104 -104
- package/packs/actuaries/endpoints.json +82 -82
- package/packs/actuaries/policy.json +109 -109
- package/packs/bea/assets/download_bea.ps1 +182 -182
- package/packs/bea/docs/bea_api.md +461 -461
- package/packs/bea/docs/datasets.md +157 -157
- package/packs/bea/docs/report_patterns.md +112 -112
- package/packs/bea/policy.json +170 -170
- package/packs/bea/source.md +152 -152
- package/packs/bls/assets/download_bls.ps1 +152 -152
- package/packs/bls/docs/analysis_patterns.md +108 -108
- package/packs/bls/docs/bls_api.md +73 -73
- package/packs/bls/docs/series_ids.md +149 -149
- package/packs/bls/policy.json +238 -238
- package/packs/bts/endpoints.json +346 -346
- package/packs/bts/policy.json +94 -94
- package/packs/cdc/endpoints.json +197 -197
- package/packs/cdc/policy.json +83 -83
- package/packs/census/endpoints.json +99 -99
- package/packs/cfpb/endpoints.json +326 -326
- package/packs/cfpb/policy.json +119 -119
- package/packs/clinical-trials/endpoints.json +166 -166
- package/packs/clinical-trials/policy.json +84 -84
- package/packs/cms/endpoints.json +69 -69
- package/packs/cms/policy.json +96 -96
- package/packs/college-scorecard/endpoints.json +252 -252
- package/packs/college-scorecard/policy.json +106 -106
- package/packs/congress/endpoints.json +1701 -1701
- package/packs/congress/policy.json +117 -117
- package/packs/dhs-ohss/endpoints.json +66 -66
- package/packs/dhs-ohss/policy.json +107 -107
- package/packs/doj-news/endpoints.json +59 -59
- package/packs/doj-news/policy.json +96 -96
- package/packs/dol/endpoints.json +817 -817
- package/packs/dol/policy.json +135 -135
- package/packs/eia/endpoints.json +717 -717
- package/packs/eia/policy.json +112 -112
- package/packs/epa/endpoints.json +291 -291
- package/packs/epa/policy.json +99 -99
- package/packs/epa-aqs/endpoints.json +173 -173
- package/packs/epa-aqs/policy.json +96 -96
- package/packs/fbi/endpoints.json +1841 -1841
- package/packs/fbi/policy.json +118 -118
- package/packs/fda/endpoints.json +237 -237
- package/packs/fda/policy.json +121 -121
- package/packs/fdic/endpoints.json +416 -416
- package/packs/fdic/policy.json +83 -83
- package/packs/fec/endpoints.json +707 -707
- package/packs/fec/policy.json +93 -93
- package/packs/fed-board/endpoints.json +89 -89
- package/packs/fed-board/policy.json +136 -136
- package/packs/federal-register/endpoints.json +143 -143
- package/packs/federal-register/policy.json +86 -86
- package/packs/fema/endpoints.json +645 -645
- package/packs/fema/policy.json +103 -103
- package/packs/fhfa/endpoints.json +105 -105
- package/packs/fhfa/policy.json +109 -109
- package/packs/fred/assets/download_fred.ps1 +122 -122
- package/packs/fred/docs/analysis_patterns.md +124 -124
- package/packs/fred/docs/fred_api.md +94 -94
- package/packs/fred/docs/series.md +188 -188
- package/packs/fred/policy.json +253 -253
- package/packs/fsa/endpoints.json +150 -150
- package/packs/fsa/policy.json +99 -99
- package/packs/govinfo/endpoints.json +519 -519
- package/packs/gsa-calc/endpoints.json +93 -93
- package/packs/gsa-calc/policy.json +97 -97
- package/packs/hud/endpoints.json +146 -146
- package/packs/hud/policy.json +84 -84
- package/packs/ipums/docs/report_patterns.md +117 -117
- package/packs/irs-soi/endpoints.json +114 -114
- package/packs/irs-soi/policy.json +107 -107
- package/packs/medicaid/endpoints.json +412 -412
- package/packs/medicaid/policy.json +108 -108
- package/packs/naep/endpoints.json +217 -217
- package/packs/naep/policy.json +100 -100
- package/packs/nhtsa/endpoints.json +132 -132
- package/packs/nhtsa/policy.json +93 -93
- package/packs/nih/endpoints.json +452 -452
- package/packs/nih/policy.json +86 -86
- package/packs/noaa/endpoints.json +431 -431
- package/packs/noaa/policy.json +95 -95
- package/packs/nrel/endpoints.json +327 -327
- package/packs/nrel/policy.json +96 -96
- package/packs/nws/endpoints.json +271 -271
- package/packs/nws/policy.json +82 -82
- package/packs/nyfed/endpoints.json +80 -80
- package/packs/nyfed/policy.json +92 -92
- package/packs/omb/endpoints.json +460 -460
- package/packs/omb/policy.json +106 -106
- package/packs/open-payments/endpoints.json +297 -297
- package/packs/open-payments/policy.json +101 -101
- package/packs/opm/assets/download_opm.ps1 +125 -125
- package/packs/opm/docs/fields.md +184 -184
- package/packs/opm/docs/opm_api.md +71 -71
- package/packs/opm/docs/report_patterns.md +83 -83
- package/packs/opm/lib/data_dictionary.csv +73 -73
- package/packs/pbgc/endpoints.json +483 -483
- package/packs/pbgc/policy.json +94 -94
- package/packs/philfed/endpoints.json +85 -85
- package/packs/philfed/policy.json +94 -94
- package/packs/regulations/endpoints.json +287 -287
- package/packs/regulations/policy.json +86 -86
- package/packs/sec/endpoints.json +236 -236
- package/packs/sec/policy.json +86 -86
- package/packs/senate-lobbying/endpoints.json +553 -553
- package/packs/senate-lobbying/policy.json +99 -99
- package/packs/snapqc/endpoints.json +1426 -1426
- package/packs/snapqc/policy.json +92 -92
- package/packs/treasury/catalog.json +2267 -2267
- package/packs/treasury/docs/api_guide.md +245 -245
- package/packs/treasury/docs/datasets.md +56 -56
- package/packs/treasury/docs/report_patterns.md +126 -126
- package/packs/treasury/policy.json +159 -159
- package/packs/treasury/source.md +170 -165
- package/packs/treasury-yields/endpoints.json +226 -226
- package/packs/treasury-yields/policy.json +86 -86
- package/packs/usaspending/endpoints.json +1315 -1315
- package/packs/usaspending/policy.json +109 -109
- package/packs/usda-fna/policy.json +133 -133
- package/packs/usda-fooddata/endpoints.json +180 -180
- package/packs/usda-fooddata/policy.json +94 -94
- package/packs/usda-nass/endpoints.json +323 -323
- package/packs/usda-nass/policy.json +95 -95
- package/packs/usda-outlook/endpoints.json +86 -86
- package/packs/usda-outlook/policy.json +109 -109
- package/packs/usgs/endpoints.json +313 -313
- package/packs/usgs/policy.json +95 -95
- package/packs/usitc/endpoints.json +74 -74
- package/packs/usitc/policy.json +111 -111
- package/packs/uspto/endpoints.json +141 -141
- package/packs/uspto/policy.json +95 -95
- package/packs/va/endpoints.json +414 -414
- package/packs/va/policy.json +101 -101
- package/packs/world-bank/endpoints.json +122 -122
- 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 |
|