Share via


Bureau of Labor Statistics (Independent Publisher) (Preview)

Access Bureau of Labor Statistics (BLS) datasets including time series, popular series, survey lists, and survey metadata. Provides economic indicators such as employment, inflation, wages, and more.

This connector is available in the following products and regions:

Service Class Regions
Copilot Studio Premium All Power Automate regions except the following:
     -   US Government (GCC)
     -   US Government (GCC High)
     -   China Cloud operated by 21Vianet
     -   US Department of Defense (DoD)
Logic Apps Standard All Logic Apps regions except the following:
     -   Azure Government regions
     -   Azure China regions
     -   US Department of Defense (DoD)
Power Apps Premium All Power Apps regions except the following:
     -   US Government (GCC)
     -   US Government (GCC High)
     -   China Cloud operated by 21Vianet
     -   US Department of Defense (DoD)
Power Automate Premium All Power Automate regions except the following:
     -   US Government (GCC)
     -   US Government (GCC High)
     -   China Cloud operated by 21Vianet
     -   US Department of Defense (DoD)
Contact
Name Bureau of Labor Statistics Developers
URL https://www.bls.gov/developers/
Email webmaster@bls.gov
Connector Metadata
Publisher krautrocker
Website https://www.bls.gov/developers/
Privacy policy https://www.bls.gov/bls/bls-privacy.htm
Categories Finance

Bureau of Labor Statistics (BLS) API Connector

The Bureau of Labor Statistics (BLS) API provides public access to U.S. labor market and economic data. With this connector, you can query survey metadata and retrieve time series data from BLS datasets directly in Power Platform.

Publisher: Dan Romano

Prerequisites

You must have a valid BLS API key. While some endpoints are available without a key, most advanced features (catalog metadata, calculations, annual averages, aspects) require one.

Supported Operations

Surveys

  • Get All Surveys
    Retrieve metadata for all BLS surveys.

  • Get Survey Metadata
    Retrieve metadata for a specific survey using its abbreviation (e.g., CPS, CES).

Series

  • Get Single Series
    Retrieve data for a single series ID. Example: CUUR0000SA0 (Consumer Price Index, All Urban Consumers, U.S. city average, All items).

  • Get Multiple Series
    Retrieve data for one or more series by posting a list of series IDs and optional parameters (start year, end year, catalog, calculations, annual averages, aspects).

  • Get Popular Series
    Retrieve the most requested BLS series.

Obtaining Credentials

  1. Go to the BLS API registration page.
  2. Submit your email address to receive an API key.
  3. Use this key as the registrationkey query parameter when calling API endpoints.

Known Issues and Limitations

  • The BLS API occasionally returns Results as either an object or an array, depending on the request. The connector normalizes this using a schemaless definition to avoid runtime errors in Power Platform.
  • Rate limits apply. If you exceed the threshold, you may receive a 429 Too Many Requests error.
  • Some series IDs require specific survey knowledge; consult the BLS survey documentation for details.

Further Reading

Creating a connection

The connector supports the following authentication types:

Default Parameters for creating connection. All regions Not shareable

Default

Applicable: All regions

Parameters for creating connection.

This is not shareable connection. If the power app is shared with another user, another user will be prompted to create new connection explicitly.

Name Type Description Required
apikey securestring The apikey for this api True

Throttling Limits

Name Calls Renewal Period
API calls per connection 100 60 seconds

Actions

Get All Surveys

Retrieve a list of all available BLS surveys.

Get Multiple Series Data

Retrieve data for one or more BLS series IDs in a single request.

Get Popular Series

Retrieve data for commonly accessed BLS series IDs.

Get Single Series Data

Retrieve data for a single BLS series ID with optional parameters.

Get Survey Metadata

Retrieve metadata for a specific BLS survey.

Get All Surveys

Retrieve a list of all available BLS surveys.

Returns

response
object

Get Multiple Series Data

Retrieve data for one or more BLS series IDs in a single request.

Parameters

Name Key Required Type Description
Series IDs
seriesid True array of string

One or more BLS series IDs.

Start Year
startyear string

First year of data to retrieve (YYYY).

End Year
endyear string

Last year of data to retrieve (YYYY).

Include Catalog Info
catalog boolean

Set to true to include catalog metadata.

Include Calculations
calculations boolean

Set to true to include net and percent changes.

Include Annual Averages
annualaverage boolean

Set to true to include annual averages.

Include Aspects
aspects boolean

Set to true to include aspects metadata.

Returns

response
object

Retrieve data for commonly accessed BLS series IDs.

Returns

response
object

Get Single Series Data

Retrieve data for a single BLS series ID with optional parameters.

Parameters

Name Key Required Type Description
Series ID
series_id True string

A single BLS series ID (e.g., LAUCN040010000000005).

Start Year
startyear string

First year of data to retrieve (YYYY).

End Year
endyear string

Last year of data to retrieve (YYYY).

Include Catalog Info
catalog boolean

Set to true to include catalog metadata.

Include Calculations
calculations boolean

Set to true to include net and percent changes.

Include Annual Averages
annualaverage boolean

Set to true to include annual averages.

Include Aspects
aspects boolean

Set to true to include aspects metadata.

Returns

response
object

Get Survey Metadata

Retrieve metadata for a specific BLS survey.

Parameters

Name Key Required Type Description
Survey ID
survey_id True string

Abbreviation of the survey (e.g., CPS, CES).

Returns

response
object

Definitions

object

This is the type 'object'.