Educational Materials

Interface to the Bureau of Labor Statistics API

Arnoud Buzing

Author

Arnoud Buzing

Title

Interface to the Bureau of Labor Statistics API

Description

Programmatic access to BLS data

Bureau of Labor Statistics

Data API Functions

by Arnoud Buzing

◼

Access to the BLS API is free, but requires registration to obtain a registration access key.

◼

All functions in this notebook use an access key to make requests.

◼

This access key should be stored as a SystemCredential as follows:

SystemCredential["BLS"]="your-access-key";

Tools


Surveys

◼

A survey is the top level type of statistic that the BLS collects.

◼

All surveys have a two letter code.

All Surveys

In[]:=

AllSurveys[]:=Dataset[URLReadJSON["https://api.bls.gov/publicAPI/v2/surveys"]["Results","survey"]]

Example usage:

In[]:=

AllSurveys[]

Out[]=

survey_abbreviation	survey_name
AP	Consumer Price Index - Average Price Data
BD	Business Employment Dynamics
BG	Collective Bargaining Agreements-State and Local Government
BP	Collective Bargaining Agreements-Private Sector
CC	Employer Costs for Employee Compensation
CD	Nonfatal cases involving days away from work: selected characteristics
CE	Employment, Hours, and Earnings from the Current Employment Statistics survey (National)
CF	Census of Fatal Occupational Injuries
CH	Nonfatal cases involving days away from work: selected characteristics (2003 - 2010)
CI	Employment Cost Index
CM	Employer Costs for Employee Compensation
CS	Nonfatal cases involving days away from work: selected characteristics (2011 forward)
CU	Consumer Price Index - All Urban Consumers
CW	Consumer Price Index - Urban Wage Earners and Clerical Workers
CX	Consumer Expenditure Survey
EB	Employee Benefits Survey
EC	Employment Cost Index
EE	National Employment, Hours, and Earnings
EI	Import/Export Price Indexes
EN	Quarterly Census of Employment and Wages
rows 1–20 of 66

Single Survey


Series

◼

Series contain the actual data for a survey.

◼

Series IDs start with a survey code.

◼

After the survey code is an alpha-numerical identifier that is explained here. There are many available identifiers and they are explained in detail in the following locations:

◼

https://www.bls.gov/developers/api_FAQs.htm#signatures3

◼

https://www.bls.gov/help/hlpforma.htm

Popular Series


Single Series


Multiple Series


Cite this as: Arnoud Buzing, "Interface to the Bureau of Labor Statistics API" from the Notebook Archive (2021), https://notebookarchive.org/2021-09-1fy2rtc

Bureau of Labor Statistics

Tools

Surveys

All Surveys

Single Survey

Series

Popular Series

Single Series

Multiple Series

Tools


Single Survey


Popular Series


Single Series


Multiple Series
