← All agent tools

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.

BLS Public Data API (U.S. labor and price statistics) specifications
CapabilityDetails and source
Statusv1.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 requiredNo 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 tierFree

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 limit25 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 serverNot 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 SDKSample 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 / termsPublic 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 allowedAllowed

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 useAccess-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 / coveragePublished 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

Back to the full directory →

Source & reuse

Download the complete licensed source snapshot (JSON), including the original source’s caveats, alternative notes and examples.