zapi.
APIsPricingDocsMCP
APIsPricingDocsMCPSign in
zapi.
APIsPricingDocsMCP
APIsPricingDocsMCPSign in
On this page
  • Playground
  • Code examples
  • Full reference
  • Related APIs
Finance/BLS
Logo BLS

BLS

US Bureau of Labor Statistics: CPI, PPI, employment and the published timeseries catalogue.

Endpoints
4
Requests
313
Updated
6 hours ago
For LLMs
llms.txt
Endpoint health3 hours ago
  • latestpassing, 1.3s
  • popular-seriespassing, 0.3s
  • surveyspassing, 0.5s
  • timeseries-datapassing, 0.4s
4/4 passingdaily 01:00 WIB

Playground

4 endpoints
GET/v1/finance:bls/latest6h cache1 paramchecking key…
Parameters
seriesstring

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).

·
Response
EXAMPLE
{
  "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"
  ]
}

Code examples

Latest
zpi-sdkrecommended
// npm i zpi-sdk
import { ZpiClient } from "zpi-sdk";

const client = new ZpiClient({ apiKey: "zpi_xxxxxxxxxxxxxxxxxxxxxxxx" });

const data = await client.run("finance:bls", "latest", {
  "series": "LNS14000000,CUUR0000SA0,CES0000000001"
});
console.log(data);
Full SDK reference →
request.sh
curl -X GET "https://api.zpi.web.id/v1/finance:bls/latest?series=LNS14000000%2CCUUR0000SA0%2CCES0000000001" \
  -H "x-api-key: zpi_xxxxxxxxxxxxxxxxxxxxxxxx"

Full reference

4 endpoints · plain text
GETLatest/v1/finance:bls/latestThe newest published print for a set of BLS series, one row each.

Parameters

seriesstringoptional
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).

Request

curl -X GET "https://api.zpi.web.id/v1/finance:bls/latest?series=LNS14000000%2CCUUR0000SA0%2CCES0000000001" \
  -H "x-api-key: zpi_xxxxxxxxxxxxxxxxxxxxxxxx"

Example response

{
  "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"
  ]
}
GETPopular Series/v1/finance:bls/popular-seriesThe BLS series people ask for most, overall or within one survey.

Parameters

surveystringoptional
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.

Request

curl -X GET "https://api.zpi.web.id/v1/finance:bls/popular-series?survey=CU" \
  -H "x-api-key: zpi_xxxxxxxxxxxxxxxxxxxxxxxx"

Example response

{
  "count": 25,
  "items": [
    {
      "seriesId": "CUUR0000SA0"
    },
    {
      "seriesId": "LNS14000000"
    },
    {
      "seriesId": "CES0000000001"
    },
    {
      "seriesId": "CUUR0000SA0L1E"
    },
    {
      "seriesId": "WPUFD49104"
    },
    {
      "seriesId": "CUSR0000SA0"
    }
  ],
  "survey": null,
  "dataset": "popular-series",
  "provider": "bls"
}
GETSurveys/v1/finance:bls/surveysEvery BLS survey programme and its two-letter code.

Parameters

querystringoptional
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.

Request

curl -X GET "https://api.zpi.web.id/v1/finance:bls/surveys?query=consumer+price" \
  -H "x-api-key: zpi_xxxxxxxxxxxxxxxxxxxxxxxx"

Example response

{
  "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"
}
GETTimeseries Data/v1/finance:bls/timeseries-dataBureau of Labor Statistics observations — CPI, unemployment, payrolls, by series id.

Parameters

seriesstringoptional
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).
fromnumberoptional
First year. Defaults to nine years before to.
tonumberoptional
Last year. Defaults to the current year.
annualAverageenumoptional
Include the annual average row (period M13) alongside the monthly prints. Default false. Values: true, false.
lengthnumberoptional
Observations per series, newest first (default 60, max 500)

Request

curl -X GET "https://api.zpi.web.id/v1/finance:bls/timeseries-data?series=LNS14000000%2CCUUR0000SA0&from=2020&to=2026&annualAverage=true&length=24" \
  -H "x-api-key: zpi_xxxxxxxxxxxxxxxxxxxxxxxx"

Example response

{
  "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
}

Related APIs

More in finance

Pluang

finance/pluang

Data pasar Pluang lintas aset: order book, running trade, tradebook dan ringkasan broker per saham IDX, plus saham Amerika, emas, kripto, sinyal analis dan berita.

23.3K calls·1d cache

Binance Vision

finance/binance-vision

Binance's public bulk archive: klines, 5-minute open-interest and long/short metrics, funding, book depth and liquidations, back to 2017.

4.7K calls·1d cache

TradingView

finance/tradingview

Screener, charts, technical indicators, fundamentals, news and the macro calendar across 16 markets — Indonesian equities, US equities, crypto, forex and futures.

52.7K calls·1d cache

Stockbit

finance/stockbit

Data saham IDX dari Stockbit: harga, chart intraday, profil emiten, diskusi komunitas, dan kamus investasi.

17.5K calls·1d cache

Yahoo Finance

finance/yahoo-finance

Global quotes, fundamentals, statements, options, earnings, ownership and analyst coverage. Jakarta listings via the .JK suffix.

12.7K calls·5m cache

IDX (Bursa Efek Indonesia)

finance/idx

Data Bursa Efek Indonesia: ringkasan saham & indeks, top movers, broker, emiten, laporan keuangan, berita, dan passthrough ke ratusan endpoint /primary/.

75.6K calls·1d cache
Browse APIsPricingDocsMCP serverGet an API key
zapi.One key, one response shape.
TermsPrivacyCookiesAUPRefunds© 2026