A Python library for the Bureau of Labor Statistics API.
Branch | Status |
---|---|
Master | |
Dev |
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 undergoing very rapid development. Look for new features in the near future, and report bugs at https://github.com/OliverSherouse/bls/issues.