BLS labor & price series API

Fetch a U.S. Bureau of Labor Statistics time series by id (CPI, PPI, employment, JOLTS, etc.) via the official BLS public API.

Price$0.01per request

MethodGET

Route/v1/finance/bls-series

StatusLive

MIME typeapplication/json

Rate limit60/minute

Cache3600s public

financemacroblscpiemployment

API URLhttps://x402.hexl.dev/v1/finance/bls-series

Integration docs

Example request

{
  "series": "CUUR0000SA0",
  "startYear": "2024",
  "endYear": "2024"
}

Example response

{
  "feed": "BLS",
  "series": "CUUR0000SA0",
  "title": "All items in U.S. city average, all urban consumers, not seasonally adjusted",
  "obs": 12,
  "data": [
    {
      "date": "2024-12-01",
      "year": "2024",
      "period": "M12",
      "periodName": "December",
      "value": 315.605
    }
  ],
  "sourceUrl": "https://data.bls.gov/timeseries/CUUR0000SA0"
}

Input schema

{
  "type": "object",
  "required": [
    "series"
  ],
  "properties": {
    "series": {
      "type": "string",
      "minLength": 1,
      "examples": [
        "CUUR0000SA0",
        "LNS14000000"
      ]
    },
    "startYear": {
      "type": "string",
      "examples": [
        "2020"
      ]
    },
    "endYear": {
      "type": "string",
      "examples": [
        "2024"
      ]
    }
  }
}

Output schema

{
  "type": "object",
  "required": [
    "feed",
    "series",
    "data",
    "obs"
  ],
  "properties": {
    "feed": {
      "type": "string"
    },
    "series": {
      "type": "string"
    },
    "title": {
      "type": "string"
    },
    "obs": {
      "type": "number"
    },
    "data": {
      "type": "array",
      "items": {
        "type": "object",
        "additionalProperties": true
      }
    },
    "sourceUrl": {
      "type": "string"
    }
  }
}