openbb-bls

library1.3.1pypypi✓ verified 80d ago

OpenBB BLS is an extension for the OpenBB Platform that provides access to the Bureau of Labor Statistics (BLS) Public Data API. It allows users to retrieve economic data such as CPI, unemployment rates, and other labor statistics. The current version is 1.3.1, released under a permissive license, with updates aligned with the OpenBB Platform's release cadence.

analytics

pip install openbb-bls

INSTALL

IMPORT

SIG · OPENBB-BLS

openbb-bls

analyticspythonv1.3.1

harness data pending

Install & Compatibility

Where this runs

No compatibility data collected yet for this library.

Code

Verified usage

Verified import paths — ran on the pinned version, not inferred.

BlsSearchFetcher

✓ from openbb_bls import BlsSearchFetcher

✗ from openbb_bls import BLS

BlsSeriesFetcher

✓ from openbb_bls import BlsSeriesFetcher

✗ from openbb_bls import BLS

Provider

✓ from openbb_bls import Provider

✗ from openbb_bls import BLS

Initialize BLS provider with API key and fetch a series. The API key is optional for some endpoints but recommended.

from openbb_bls import BLS bls = BLS(api_key=os.environ.get('BLS_API_KEY', '')) # Fetch series (e.g., CPI for All Urban Consumers) data = bls.get_series('CUUR0000SA0', start_year=2020, end_year=2023) print(data.head())

Debug

Known issues

deprecatedThe old openbb package (<=3.x) used a different extension pattern; openbb-bls is only compatible with OpenBB v4+.

fix

Use openbb-bls>=1.0.0 with openbb>=4.0.0.

affects: <=3.x

gotchaBLS API requires a registration key for full access; without a key, API calls may be rate-limited or blocked.

fix

Register at https://data.bls.gov/registration/ and set the BLS_API_KEY environment variable.

affects: all

gotchaSeries IDs are case-sensitive and must match BLS's exact format (e.g., 'CUUR0000SA0' not 'cuur0000sa0').

fix

Use the exact series ID as listed on BLS website; often all uppercase.

affects: all

gotchaBLS API has a maximum of 25 years per request and 500 series per request. Exceeding these limits will cause errors.

fix

Batch requests into chunks of 25 years and 500 series at a time.

affects: all

Upgrade

Version history

1.3.1latest on PyPI · released May 26, 2026

Audit

Dependencies

openbb-corerequiredRequired for OpenBB platform integration

Agent activity

35 hits · last 30 days

node

Amazon

OpenAI (training)

Resources

No resource links recorded.