# US Labor Statistics API > Official US economic indicators straight from the US Bureau of Labor Statistics (BLS) public time-series API — no key, read live. The cpi endpoint returns the Consumer Price Index for All Urban Consumers (CPI-U, all items, series CUUR0000SA0) for the latest month with the index level plus the month-on-month and year-on-year inflation rates, computed from the official series. The unemployment endpoint returns the seasonally-adjusted US unemployment rate (series LNS14000000) for the latest month plus the trailing year. The indicators endpoint returns a curated dashboard of headline US figures in one call — CPI, core CPI, the unemployment rate, the producer price index, average hourly earnings and total nonfarm employment — each with its latest value and period. The series endpoint is a thin live gateway to any BLS series by its id, returning the data points and computed changes, opening up the full BLS catalogue (prices, employment, wages, productivity). Annual-average rows are labelled and excluded from period maths. Live data from BLS, heavily cached because the public API is rate-limited. Live. 5 endpoints. This serves US national statistics; for the US dollar exchange rate or Treasury yields use an FX / Treasury API. ## Authentication All requests require your oanor API key in the `x-oanor-key` header. Get one at https://www.oanor.com/developer/keys. ```bash curl -H "x-oanor-key: oanor_live_…" "https://api.oanor.com/bls-api/..." ``` ## Pricing - **Free** (Free) — 310 calls/Mo, 2 req/s - **Basic** ($12/Mo) — 21,000 calls/Mo, 6 req/s - **Pro** ($31/Mo) — 108,000 calls/Mo, 22 req/s - **Mega** ($70/Mo) — 490,000 calls/Mo, 55 req/s ## Endpoints ### Inflation #### `GET /v1/cpi` — US CPI-U (latest month): index, MoM and YoY **Example:** ```bash curl -H "x-oanor-key: $KEY" \ "https://api.oanor.com/bls-api/v1/cpi" ``` **Response:** ```json { "data": { "base": "1982-84 = 100", "index": 335.123, "period": "2026 May", "source": "US Bureau of Labor Statistics (series CUUR0000SA0)", "country": "United States", "indicator": "Consumer Price Index for All Urban Consumers (CPI-U, all items)", "period_iso": "2026-05", "change_mom_pct": 0.63, "change_yoy_pct": 4.25 }, "meta": { "timestamp": "2026-06-15T20:40:38.984Z", "request_id": "e28020c2-664a-415d-854f-96061a1596f5" }, "status": "ok", "message": "US CPI retrieved", "success": true } ``` ### Labor #### `GET /v1/unemployment` — US unemployment rate (latest + trailing year) **Example:** ```bash curl -H "x-oanor-key: $KEY" \ "https://api.oanor.com/bls-api/v1/unemployment" ``` **Response:** ```json { "data": { "period": "2026 May", "recent": [ { "period": "2026 May", "rate_pct": 4.3, "period_iso": "2026-05" }, { "period": "2026 April", "rate_pct": 4.3, "period_iso": "2026-04" }, { "period": "2026 March", "rate_pct": 4.3, "period_iso": "2026-03" }, { "period": "2026 February", "rate_pct": 4.4, "period_iso": "2026-02" }, { "period": "2026 January", "rate_pct": 4.3, "period_iso": "2026-01" }, { "period": "2025 December", "rate_pct": 4.4, "period_iso": "2025-12" }, { "period": "2025 November", "rate_pct": 4.5, "period_iso": "2025-11" }, { "period": "2025 October", "rate_pct": null, "period_iso": "2025-10" }, { "period": "2025 September", "rate_pct": 4.4, "period_iso": "2025-09" }, { "period": "2025 August", "rate_pct": 4.3, "period_iso": "2025-08" …(truncated, see openapi.json for full schema) ``` ### Dashboard #### `GET /v1/indicators` — Dashboard of headline US indicators **Example:** ```bash curl -H "x-oanor-key: $KEY" \ "https://api.oanor.com/bls-api/v1/indicators" ``` **Response:** ```json { "data": { "count": 6, "source": "US Bureau of Labor Statistics", "country": "United States", "indicators": [ { "key": "cpi", "unit": "index", "label": "CPI-U, all items (1982-84=100, NSA)", "value": 335.123, "period": "2026 May", "series_id": "CUUR0000SA0", "period_iso": "2026-05" }, { "key": "core_cpi", "unit": "index", "label": "Core CPI-U (all items less food & energy)", "value": 336.846, "period": "2026 May", "series_id": "CUUR0000SA0L1E", "period_iso": "2026-05" }, { "key": "unemployment_rate", "unit": "percent", "label": "Unemployment rate (16+, seasonally adjusted)", "value": 4.3, "period": "2026 May", "series_id": "LNS14000000", "period_iso": "2026-05" }, { "key": "ppi_final_demand", "unit": "index", "label": "PPI, final demand", "value": 158.012, "period": "2026 May", "series_id": "WPUFD4", "period_iso": "2026-05" }, { "key": "avg_hourly_earnings", "uni …(truncated, see openapi.json for full schema) ``` ### Catalogue #### `GET /v1/series` — Fetch any BLS time series by id **Parameters:** - `id` (query, optional, string) — BLS series id (default CUUR0000SA0 = CPI-U all items) Example: `CUUR0000SA0` **Example:** ```bash curl -H "x-oanor-key: $KEY" \ "https://api.oanor.com/bls-api/v1/series?id=CUUR0000SA0" ``` **Response:** ```json { "data": { "count": 31, "latest": { "value": 335.123, "period": "2026 May", "period_iso": "2026-05" }, "points": [ { "value": 335.123, "period": "2026 May", "period_iso": "2026-05" }, { "value": 333.02, "period": "2026 April", "period_iso": "2026-04" }, { "value": 330.213, "period": "2026 March", "period_iso": "2026-03" }, { "value": 326.785, "period": "2026 February", "period_iso": "2026-02" }, { "value": 325.252, "period": "2026 January", "period_iso": "2026-01" }, { "value": 321.943, "period": "2025 Annual", "period_iso": "2025-annual" }, { "value": 324.054, "period": "2025 December", "period_iso": "2025-12" }, { "value": 324.122, "period": "2025 November", "period_iso": "2025-11" }, { "value": null, "period": "2025 October", "period_iso": "2025-10" }, { …(truncated, see openapi.json for full schema) ``` ### Meta #### `GET /v1/meta` — API metadata **Example:** ```bash curl -H "x-oanor-key: $KEY" \ "https://api.oanor.com/bls-api/v1/meta" ``` **Response:** ```json { "data": { "api": "US Bureau of Labor Statistics (BLS) API", "notes": "Live data from BLS; the BLS public API returns roughly the last three years per series. Heavily cached (6h) because BLS rate-limits unregistered use; month-on-month and year-on-year computed from the series.", "source": "US Bureau of Labor Statistics — public Time Series API v1 (api.bls.gov)", "country": "United States", "endpoints": [ "/v1/cpi", "/v1/unemployment", "/v1/indicators", "/v1/series", "/v1/meta" ], "indicators": [ { "key": "cpi", "label": "CPI-U, all items (1982-84=100, NSA)", "series_id": "CUUR0000SA0" }, { "key": "core_cpi", "label": "Core CPI-U (all items less food & energy)", "series_id": "CUUR0000SA0L1E" }, { "key": "unemployment_rate", "label": "Unemployment rate (16+, seasonally adjusted)", "series_id": "LNS14000000" }, { "key": "ppi_final_demand", "label": "PPI, final demand", "series_id": "WPUFD4" }, { "key": "avg_hourly_earnings", "label": "Average hourly earnings, total private (USD)", "series_id": "CES0500000003" …(truncated, see openapi.json for full schema) ``` --- Marketplace page: https://www.oanor.com/api/bls-api OpenAPI spec: https://www.oanor.com/api/bls-api/openapi.json