Skip to content


Switch branches/tags

Name already in use

A tag already exists with the provided branch name. Many Git commands accept both tag and branch names, so creating this branch may cause unexpected behavior. Are you sure you want to create this branch?

Latest commit


Git stats


Failed to load latest commit information.
Latest commit message
Commit time


A Python library for the Bureau of Labor Statistics API.

Branch Status
master master branch status
dev dev branch status

Use the function get_series() to retrieve data. get_series() has four arguments: a series id or sequence of series ids, a start year, an end year, and an optional API key.

It is highly recommended that you register for an API key with BLS. You can supply the key to the library by passing it to get_series() or by setting an environment variable called BLS_API_KEY.

The timespan returned by the get_series() function depends on whether you specify startyear, endyear, api or some combination thereof, as shown in the table below:

startyear endyear api result
no no no BLS default (last 3 years)
yes no no Ten years starting from startyear or until present
no yes no Ten years ending with endyear
yes yes no startyear through endyear if ten years or fewer else error
no no yes BLS default (last 3 years)
yes no yes startyear through present
no yes yes Twenty years ending with endyear
yes yes yes startyear through endyear

bls is under development. Look for new features in the near future, and report bugs at