Skip to content

BLS Public Data API

Yayun Liu edited this page Jun 9, 2018 · 9 revisions

BLS Public Data API

https://censusreporter.org/profiles/35000US72850-danbury-ct-metropolitan-necta/

Quick view of the local area unemployment stats

Output

API Key Registry

https://data.bls.gov/registrationEngine/

How to Use the API?

Instructions
Python code samples

Single Series
Use this signature to retrieve data for a single time series for the past three years. Be sure to include the specific series ID at the end of the URL. Parameters are optional.:
HTTP Type: GET
URL (JSON): https://api.bls.gov/publicAPI/v2/timeseries/data/
URL for Excel output: https://api.bls.gov/publicAPI/v2/timeseries/data/.xlsx
Payload: series_id
Example Payload:
LAUCN040010000000005

Multiple Series
Use this signature to retrieve data for more than one timeseries for the past three years. Registered users can include up to 50 series IDs, each separated with a comma, in the body of a request.

HTTP Type: POST
URL (JSON): https://api.bls.gov/publicAPI/v2/timeseries/data/
URL (Excel): https://api.bls.gov/publicAPI/v2/timeseries/data.xlsx
Header: Content-Type= application/json
Payload (JSON): {"seriesid":["Series1",..., "SeriesN"], "startyear":"yearX", "endyear":"yearY",
"catalog":true|false, "calculations":true|false, "annualaverage":true|false,
"registrationkey":"000f4e000f204473bb565256e8eee73e" }
Example Payload:
{"seriesid":["LAUCN040010000000005", "LAUCN040010000000006",
"OEUN000000056--5747213213"]}