BLS
US Bureau of Labor Statistics: CPI, PPI, employment and the published timeseries catalogue.
Latest
The newest published print for a set of BLS series, one row each.
/v1/finance:bls/latestParameters
| Name | Type | In | Description |
|---|---|---|---|
| series | string | query | BLS series ids, comma-separated, up to 25. Unregistered use is shared and the API publishes its limits as "Daily query limit 25", "Series per query limit 25" and "Years per query limit 10". Default LNS14000000 (unemployment rate). |
Example response
{"project":"finance:bls", "data": {"count":1, "items": [ {"date":"2026-07-01","value":4.1,"period":"M07","isLatest":true,"seriesId":"LNS14000000","footnotes":[],"periodName":"July" } ], "series": [ "LNS14000000" ],"dataset":"latest","missing":[],"provider":"bls", "resolved": [ "LNS14000000" ] },"timestamp":"2026-08-20T15:02:08Z"}
Errors
- 401Missing or invalid x-api-key
- 404Not found or private
- 429Rate limit or monthly quota reached
Popular Series
The BLS series people ask for most, overall or within one survey.
/v1/finance:bls/popular-seriesParameters
| Name | Type | In | Description |
|---|---|---|---|
| survey | string | query | Two-letter survey code from the `surveys` endpoint, e.g. CU for the Consumer Price Index. Unregistered use is shared and the API publishes its limits as "Daily query limit 25" — this listing spends one of them. Default all surveys. |
Example response
{"project":"finance:bls", "data": {"count":25, "items": [ {"seriesId":"CUUR0000SA0" }, {"seriesId":"LNS14000000" }, {"seriesId":"CES0000000001" }, {"seriesId":"CUUR0000SA0L1E" }, {"seriesId":"WPUFD49104" }, {"seriesId":"CUSR0000SA0" } ],"survey":null,"dataset":"popular-series","provider":"bls" },"timestamp":"2026-08-20T15:02:08Z"}
Errors
- 401Missing or invalid x-api-key
- 404Not found or private
- 429Rate limit or monthly quota reached
Surveys
Every BLS survey programme and its two-letter code.
/v1/finance:bls/surveysParameters
| Name | Type | In | Description |
|---|---|---|---|
| query | string | query | Case-insensitive substring match on the survey name or code. Unregistered use is shared and the API publishes its limits as "Daily query limit 25" — this listing spends one of them. |
Example response
{"project":"finance:bls", "data": {"count":70, "items": [ {"code":"AP","name":"Consumer Price Index - Average Price Data" }, {"code":"BD","name":"Business Employment Dynamics" }, {"code":"BG","name":"Collective Bargaining Agreements-State and Local Government" }, {"code":"BP","name":"Collective Bargaining Agreements-Private Sector" }, {"code":"CA","name":"Biennial Nonfatal Case and Demographic numbers and rates: selected characteristics" }, {"code":"CB","name":"Biennial Nonfatal Case and Demographic numbers and rates: selected characteristics" } ],"query":null,"total":70,"dataset":"surveys","provider":"bls" },"timestamp":"2026-08-20T15:02:08Z"}
Errors
- 401Missing or invalid x-api-key
- 404Not found or private
- 429Rate limit or monthly quota reached
Timeseries Data
Bureau of Labor Statistics observations — CPI, unemployment, payrolls, by series id.
/v1/finance:bls/timeseries-dataParameters
| Name | Type | In | Description |
|---|---|---|---|
| series | string | query | BLS series ids, comma-separated, up to 25. Unregistered use is shared and the API publishes its limits as "Daily query limit 25", "Series per query limit 25" and "Years per query limit 10". Default LNS14000000 (unemployment rate). |
| from | number | query | First year. Defaults to nine years before `to`. |
| to | number | query | Last year. Defaults to the current year. |
| annualAverage | enum | query | Include the annual average row (period M13) alongside the monthly prints. Default false. One of true, false. |
| length | number | query | Observations per series, newest first (default 60, max 500). |
Example response
{"project":"finance:bls", "data": {"to":2026,"from":2020,"count":1, "items": [ {"count":24,"total":85,"seriesId":"CUUR0000SA0", "observations": [ {"date":"2026-07-01","value":333.918,"period":"M07", "aspects": [ {"name":"Historical reference to 12 month % change","value":"S-Mar. 2026" }, {"name":"Relative Importance","value":"100.000" }, {"name":"Relative Importance for previous year","value":"100.000" }, {"name":"Median Standard Error 12 Month Change","value":"0.09" }, {"name":"12 month % change prior to the current month","value":"3.3" } ],"isLatest":true,"footnotes":[],"periodName":"July" }, {"date":"2026-06-01","value":333.952,"period":"M06", "aspects": [ {"name":"Historical reference to 12 month % change","value":"S-Mar. 2026" }, {"name":"Relative Importance","value":"100.000" }, {"name":"Relative Importance for previous year","value":"100.000" }, {"name":"Median Standard Error 12 Month Change","value":"0.09" }, {"name":"12 month % change prior to the current month","value":"3.3" } ],"isLatest":false,"footnotes":[],"periodName":"June" }, {"date":"2026-05-01","value":335.123,"period":"M05", "aspects": [ {"name":"Historical reference to 12 month % change","value":"L-Apr. 2023" }, {"name":"Relative Importance","value":"100.000" }, {"name":"Relative Importance for previous year","value":"100.000" }, {"name":"Median Standard Error 12 Month Change","value":"0.09" }, {"name":"12 month % change prior to the current month","value":"4.9" } ],"isLatest":false,"footnotes":[],"periodName":"May" }, {"date":"2026-04-01","value":333.02,"period":"M04", "aspects": [ {"name":"Historical reference to 12 month % change","value":"L-May 2023" }, {"name":"Relative Importance","value":"100.000" }, {"name":"Relative Importance for previous year","value":"100.000" }, {"name":"Median Standard Error 12 Month Change","value":"0.09" }, {"name":"12 month % change prior to the current month","value":"4.0" } ],"isLatest":false,"footnotes":[],"periodName":"April" }, {"date":"2026-03-01","value":330.213,"period":"M03", "aspects": [ {"name":"Historical reference to 12 month % change","value":"L-May 2024" }, {"name":"Relative Importance","value":"100.000" }, {"name":"Relative Importance for previous year","value":"100.000" }, {"name":"Median Standard Error 12 Month Change","value":"0.09" }, {"name":"12 month % change prior to the current month","value":"3.3" } ],"isLatest":false,"footnotes":[],"periodName":"March" }, {"date":"2026-02-01","value":326.785,"period":"M02", "aspects": [ {"name":"Historical reference to 12 month % change","value":"-" }, {"name":"Relative Importance","value":"100.000" }, {"name":"Relative Importance for previous year","value":"100.000" }, {"name":"Median Standard Error 12 Month Change","value":"0.09" }, {"name":"12 month % change prior to the current month","value":"-" } ],"isLatest":false,"footnotes":[],"periodName":"February" } ] } ], "series": [ "CUUR0000SA0" ],"dataset":"timeseries-data","missing":[],"provider":"bls", "resolved": [ "CUUR0000SA0" ],"annualAverage":true },"timestamp":"2026-08-20T15:02:08Z"}
Errors
- 401Missing or invalid x-api-key
- 404Not found or private
- 429Rate limit or monthly quota reached
Try it
Live request with your key
const data = await client.run( "finance:bls", "latest", { series: "LNS14000000,CUUR0000SA0,CES0000000001" });
BLS
US Bureau of Labor Statistics: CPI, PPI, employment and the published timeseries catalogue.
The newest published print for a set of BLS series, one row each.
/v1/…bls/latestTry it
Parameters
series
string · query · optional
BLS series ids, comma-separated, up to 25. Unregistered use is shared and the API publishes its limits as "Daily query limit 25", "Series per query limit 25" and "Years per query limit 10". Default LNS14000000 (unemployment rate).
Example response
{"project":"finance:bls", "data": {"count":1, "items": [ {"date":"2026-07-01","value":4.1,"period":"M07","isLatest":true,"seriesId":"LNS14000000","footnotes":[],"periodName":"July" } ], "series": [ "LNS14000000" ],"dataset":"latest","missing":[],"provider":"bls", "resolved": [ "LNS14000000" ] },"timestamp":"2026-08-20T15:02:08Z"}
Errors
- 401Missing or invalid x-api-key
- 404Not found or private
- 429Rate limit or monthly quota reached
Code
const data = await client.run( "finance:bls", "latest", { series: "LNS14000000,CUUR0000SA0,CES0000000001" });