Initial BLS data reference and DC/MD/VA unemployment dashboard

Includes:
- API v1/v2 documentation, endpoints, request/response schemas
- Complete survey catalog (60 surveys, live-fetched from API)
- Series ID decode tables: LAUS, CES, SM, QCEW, OES, JOLTS, CPI, PPI
- QCEW quarterly (47 fields) and annual (43 fields) CSV schemas
- dc_md_va_unemployment.py: pulls 16 LAUS series for DC/MD/VA + DC MSA
- Example API response and 5-year CSV output

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
This commit is contained in:
2026-06-16 11:03:14 -04:00
commit 2b9d3e6d68
9 changed files with 3218 additions and 0 deletions

289
surveys.json Normal file
View File

@ -0,0 +1,289 @@
{
"status": "REQUEST_SUCCEEDED",
"responseTime": 12,
"message": [],
"Results": {
"survey": [
{
"survey_abbreviation": "AP",
"survey_name": "Consumer Price Index - Average Price Data"
},
{
"survey_abbreviation": "BD",
"survey_name": "Business Employment Dynamics"
},
{
"survey_abbreviation": "BG",
"survey_name": "Collective Bargaining Agreements-State and Local Government"
},
{
"survey_abbreviation": "BP",
"survey_name": "Collective Bargaining Agreements-Private Sector"
},
{
"survey_abbreviation": "CA",
"survey_name": "Biennial Nonfatal Case and Demographic numbers and rates: selected characteristics"
},
{
"survey_abbreviation": "CB",
"survey_name": "Biennial Nonfatal Case and Demographic numbers and rates: selected characteristics"
},
{
"survey_abbreviation": "CC",
"survey_name": "Employer Costs for Employee Compensation"
},
{
"survey_abbreviation": "CD",
"survey_name": "Nonfatal cases involving days away from work: selected characteristics"
},
{
"survey_abbreviation": "CE",
"survey_name": "Employment, Hours, and Earnings from the Current Employment Statistics survey (National)"
},
{
"survey_abbreviation": "CF",
"survey_name": "Census of Fatal Occupational Injuries"
},
{
"survey_abbreviation": "CH",
"survey_name": "Nonfatal cases involving days away from work: selected characteristics (2003 - 2010)"
},
{
"survey_abbreviation": "CI",
"survey_name": "Employment Cost Index"
},
{
"survey_abbreviation": "CM",
"survey_name": "Employer Costs for Employee Compensation"
},
{
"survey_abbreviation": "CS",
"survey_name": "Nonfatal cases involving days away from work: selected characteristics (2011 forward)"
},
{
"survey_abbreviation": "CU",
"survey_name": "Consumer Price Index - All Urban Consumers"
},
{
"survey_abbreviation": "CW",
"survey_name": "Consumer Price Index - Urban Wage Earners and Clerical Workers"
},
{
"survey_abbreviation": "CX",
"survey_name": "Consumer Expenditure Survey"
},
{
"survey_abbreviation": "EB",
"survey_name": "Employee Benefits Survey"
},
{
"survey_abbreviation": "EC",
"survey_name": "Employment Cost Index"
},
{
"survey_abbreviation": "EE",
"survey_name": "National Employment, Hours, and Earnings"
},
{
"survey_abbreviation": "EI",
"survey_name": "Import/Export Price Indexes"
},
{
"survey_abbreviation": "EN",
"survey_name": "Quarterly Census of Employment and Wages"
},
{
"survey_abbreviation": "EP",
"survey_name": "Employment Projections by Industry"
},
{
"survey_abbreviation": "EW",
"survey_name": "Quarterly Census of Employment and Wages (SIC)"
},
{
"survey_abbreviation": "FA",
"survey_name": "Census of Fatal Occupational Injuries (2023 forward)"
},
{
"survey_abbreviation": "FI",
"survey_name": "Census of Fatal Occupational Injuries (2003 - 2010)"
},
{
"survey_abbreviation": "FM",
"survey_name": "Marital and family labor force statistics from the Current Population Survey"
},
{
"survey_abbreviation": "FW",
"survey_name": "Census of Fatal Occupational Injuries (2011-2022)"
},
{
"survey_abbreviation": "GG",
"survey_name": "Green Goods and Services"
},
{
"survey_abbreviation": "GP",
"survey_name": "Geographic Profile"
},
{
"survey_abbreviation": "HC",
"survey_name": "Nonfatal cases involving days away from work: Selected Characteristics (2002)"
},
{
"survey_abbreviation": "HS",
"survey_name": "Occupational injuries and illnesses: industry data (pre-1989)"
},
{
"survey_abbreviation": "II",
"survey_name": "Occupational injuries and illnesses: industry data"
},
{
"survey_abbreviation": "IN",
"survey_name": "International Labor Comparison"
},
{
"survey_abbreviation": "IP",
"survey_name": "Industry Productivity"
},
{
"survey_abbreviation": "IS",
"survey_name": "Occupational injuries and illnesses industry data"
},
{
"survey_abbreviation": "JL",
"survey_name": "Job Openings and Labor Turnover Survey"
},
{
"survey_abbreviation": "JT",
"survey_name": "Job Openings and Labor Turnover Survey"
},
{
"survey_abbreviation": "KV",
"survey_name": "Veterans Supplement data from the Current Population Survey"
},
{
"survey_abbreviation": "LA",
"survey_name": "Local Area Unemployment Statistics"
},
{
"survey_abbreviation": "LE",
"survey_name": "Weekly and hourly earnings data from the Current Population Survey"
},
{
"survey_abbreviation": "LF",
"survey_name": "Labor Force Statistics from the Current Population Survey (SIC)"
},
{
"survey_abbreviation": "LI",
"survey_name": "Consumer Price Index - Department Store Inventory Price Index"
},
{
"survey_abbreviation": "LN",
"survey_name": "Labor Force Statistics from the Current Population Survey"
},
{
"survey_abbreviation": "LU",
"survey_name": "Union affiliation data from the Current Population Survey"
},
{
"survey_abbreviation": "ML",
"survey_name": "Mass Layoff Statistics"
},
{
"survey_abbreviation": "MP",
"survey_name": "Major Sector Total Factor Productivity"
},
{
"survey_abbreviation": "MU",
"survey_name": "Consumer Price Index - All Urban Consumers (Old Series)"
},
{
"survey_abbreviation": "MW",
"survey_name": "Consumer Price Index - Urban Wage Earners and Clerical Workers (Old Series)"
},
{
"survey_abbreviation": "NB",
"survey_name": "National Compensation Survey-Benefits"
},
{
"survey_abbreviation": "NC",
"survey_name": "National Compensation Survey"
},
{
"survey_abbreviation": "ND",
"survey_name": "Producer Price Index Industry Data"
},
{
"survey_abbreviation": "NW",
"survey_name": "National Compensation Survey"
},
{
"survey_abbreviation": "OE",
"survey_name": "Occupational Employment and Wage Statistics"
},
{
"survey_abbreviation": "OR",
"survey_name": "Occupational Requirements"
},
{
"survey_abbreviation": "PC",
"survey_name": "Producer Price Index Industry Data"
},
{
"survey_abbreviation": "PD",
"survey_name": "Producer Price Index - Discontinued (SIC)"
},
{
"survey_abbreviation": "PF",
"survey_name": "Federal Government Productivity Index"
},
{
"survey_abbreviation": "PI",
"survey_name": "Industry Productivity Index"
},
{
"survey_abbreviation": "PR",
"survey_name": "Major Sector Productivity and Costs"
},
{
"survey_abbreviation": "SA",
"survey_name": "State and Area Employment, Hours, and Earnings (SIC)"
},
{
"survey_abbreviation": "SH",
"survey_name": "Occupational injuries and illnesses: industry data (1989-2001)"
},
{
"survey_abbreviation": "SI",
"survey_name": "Occupational injuries and illnesses: industry data (2002)"
},
{
"survey_abbreviation": "SM",
"survey_name": "State and Area Employment, Hours, and Earnings"
},
{
"survey_abbreviation": "SU",
"survey_name": "Consumer Price Index - Chained Consumer Price Index"
},
{
"survey_abbreviation": "TU",
"survey_name": "American Time Use"
},
{
"survey_abbreviation": "WD",
"survey_name": "Producer Price Index Commodity-Discontinued Series"
},
{
"survey_abbreviation": "WM",
"survey_name": "Wage Modeling"
},
{
"survey_abbreviation": "WP",
"survey_name": "Producer Price Index-Commodities"
},
{
"survey_abbreviation": "WS",
"survey_name": "Work Stoppage Data"
}
]
}
}