Economic statistics U.S. Bureau of Labor Statistics
BLS Public Data API (U.S. labor and price statistics)
Retrieve published US labour and price time series by series identifier from the Bureau of Labor Statistics.
Source review: 2026-10-30 · Imported: 1 November 2026
A practical starting point
What could you build?
An analysis assistant can load unemployment and CPI series into a chart with their release context.
Before you connect
Batch series to conserve the small keyless allowance. Clearly distinguish your calculations from official BLS statistics.
Capabilities & requirements
Dated specifications from the licensed source dataset. “Not published” indicates missing information, rather than confirmed absence.
| Capability | Details and source |
|---|---|
| Status | v1.0 open; v2.0 registered Two versions are live: 1.0 needs no registration, 2.0 needs a free key renewed yearly. No deprecation date is published. Source (external) · Verified 2026-10-30 on https://www.bls.gov/developers/ |
| API key required | No key (v1.0) Keyless GET and POST to /publicAPI/v1 returned REQUEST_SUCCEEDED on 2026-10-30. Source (external) · Verified 2026-10-30 by test request to https://api.bls.gov/publicAPI/v1/timeseries/data/CUUR0000SA0 |
| Free tier | Free Version 1.0 is open for public use; version 2.0 registration is free. Source (external) · Verified 2026-10-30 on https://www.bls.gov/developers/ |
| Rate limit | 25 queries/day keyless; 500 with key 25 series and 10 years per query without a key (50 and 20 with one); 50 requests per 10 seconds for both; HTTP 429 when exceeded. Source (external) · Verified 2026-10-30 on https://www.bls.gov/developers/api_faqs.htm |
| Official MCP server | Not published BLS publishes no MCP server; only the REST API with sample code. Community wrappers exist but are not run by BLS. Source (external) · Not published by vendor: checked 2026-10-30 on https://www.bls.gov/developers/ |
| Official SDK | Sample code only BLS offers sample code (Java, PHP, Python, R, Ruby, SAS, Unix shell and more) but no client SDK. Source (external) · Verified 2026-10-30 on https://www.bls.gov/developers/api_signature.htm |
| Data license / terms | Public domain (cite BLS) Everything BLS publishes is public domain except earlier-copyrighted images; the BLS emblem is a registered trademark. Source (external) · Verified 2026-10-30 on https://www.bls.gov/opub/copyright-information.htm |
| Commercial use allowed | Allowed Public domain material can be used without permission; the API terms ask you to cite the retrieval date and the “cannot vouch” statement. Source (external) · Verified 2026-10-30 on https://www.bls.gov/developers/termsOfService.htm |
| CORS / browser use | Access-Control-Allow-Origin: * on GET Our GET carried ACAO *; an OPTIONS preflight for the JSON POST returned 405, so browser code should use the GET signature. Source (external) · Verified 2026-10-30 by test request to https://api.bls.gov/publicAPI/v1/timeseries/data/CUUR0000SA0 |
| Freshness / coverage | Published series; latest Sept 2026 Values follow BLS release schedules; on 2026-10-30 CPI and unemployment were at September 2026, with October 2025 missing (2025 funding lapse). Source (external) · Verified 2026-10-30 by test request to https://api.bls.gov/publicAPI/v1/timeseries/data/CUUR0000SA0 |
Operational reference
Additional facts and qualifications retained from AgentAPIList’s CC BY 4.0 dataset, with provider references.
Price
Free. BLS says version 1.0 does not require registration and is open for public use; version 2.0 registration is free.
Provider reference (external)API key / auth
None for version 1.0. Our keyless GET and POST on 2026-10-30 returned REQUEST_SUCCEEDED. Version 2.0 needs a registration key sent by email and renewed at least once a year.
Provider reference (external)Rate limit
Version 1.0 (no key): 25 queries a day, 25 series per query, 10 years per query. Version 2.0 (key): 500 queries a day, 50 series, 20 years. Both: 50 requests per 10 seconds; over a limit returns HTTP 429.
Provider reference (external)License / terms
BLS material is in the public domain (cite BLS as the source); the BLS emblem is a registered trademark. The API terms (last modified Aug 30, 2023) ask you to cite the retrieval date, state that BLS.gov cannot vouch for data or analyses after retrieval, and not modify the data while citing BLS.
Provider reference (external)Version 1.0 vs 2.0
Only 2.0 offers net and percent changes, annual averages on request and series catalog descriptions. Our keyless call to the v2 URL also returned data, but BLS documents v2 as registration-only, so do not rely on it.
Provider reference (external)Data gap to expect
October 2025 values come back as "-" with the footnote “Data unavailable due to the 2025 lapse in appropriations” in both CPI and the unemployment rate (our POST on 2026-10-30).
Provider reference (external)Setup references
HTTP request example
Adapted from the attributed source dataset. Review before running; these examples were not executed by Tech in General.
curl -sS -X POST "https://api.bls.gov/publicAPI/v1/timeseries/data/" \
-H "Content-Type: application/json" \
-d '{"seriesid":["LNS14000000","CUUR0000SA0"],"startyear":"2025","endyear":"2026"}'Agent connection example
Adapted from the attributed source dataset. Review before running; these examples were not executed by Tech in General.
// Tool definition for Claude, OpenAI or any function-calling agent
{
"name": "bls_timeseries",
"description": "Fetch published U.S. Bureau of Labor Statistics time series (CPI, unemployment, payrolls, wages) by series ID. No key: 25 queries/day, 25 series and 10 years per query.",
"input_schema": {
"type": "object",
"properties": {
"seriesid": { "type": "array", "items": { "type": "string" }, "maxItems": 25, "description": "e.g. CUUR0000SA0 (CPI-U), LNS14000000 (unemployment rate), CES0000000001 (nonfarm payrolls)" },
"startyear": { "type": "string", "pattern": "^[0-9]{4}$" },
"endyear": { "type": "string", "pattern": "^[0-9]{4}$" }
},
"required": ["seriesid"]
}
}
// Implementation: POST https://api.bls.gov/publicAPI/v1/timeseries/data/
// Content-Type: application/json, body = the input. Values are strings; "-" means unavailable.A tool schema needs an HTTP implementation; it does not by itself install an MCP server. Keep credentials out of browser code.
Other connections to explore
- SEC EDGAR API (external)
- NPPES NPI Registry API (external)
- Open-Meteo API (external)
- TED Search API (external)
Source & reuse
Download the complete licensed source snapshot (JSON), including the original source’s caveats, alternative notes and examples.