Data API

The BLS Public Data Application Programming Interface (API) is an application designed to allow third party programmers, developers, and organizations to retrieve published historical time series data in JSON data-interchange format. Using Public Data API signatures, users can consume and manipulate raw data from all of the Bureau’s surveys to create a wide range of applications that conform to W3C standards and accepted practices. The BLS Public Data API does not require registration and is open for public use. Sample code is provided for developers and programmers for the most popular languages currently available. Feedback is encouraged and will aid in further enhancement and development of the Bureau’s Public Data API.

Version 2.0 (9/30/2013)

Release Notes:

  • The API returns up to 10 years of data for up to 25 time series.
  • Data is available for all BLS surveys.
  • There is a one day lag between published data and its availability for retrieval from the API. For additional information on release dates and times see the Release Calendar.

Known Limitations:

  • Users must have knowledge of BLS Series IDs to successfully complete a request.
  • There is a maximum of 25 time series in a single request.
  • The API will only return observational values and footnotes. It does not return metadata.
  • The API will not return calculations performed by the BLS.
  • Users may request a maximum of 10 years of data.

Version 1.0 (8/19/2013)

Release Notes:

  • The API returns up to 10 years of data for up to 25 time series.
  • Data is available for all BLS surveys.

Known Limitations:

  • Users must have knowledge of BLS Series IDs to successfully complete a request.
  • There is a maximum of 25 time series in a single request.
  • The API will only return observational values and footnotes. It does not return metadata.
  • The API will not return calculations performed by the BLS.
  • Users may request a maximum of 10 years of data.

For more information about the BLS Public Data API, please visit the BLS Public Data API Developer's site.

 

Last Modified Date: December 6, 2013