BLS CPI MCP — Consumer Price Index by Category avatar

BLS CPI MCP — Consumer Price Index by Category

Pricing

Pay per usage

Go to Apify Store
BLS CPI MCP — Consumer Price Index by Category

BLS CPI MCP — Consumer Price Index by Category

BLS CPI MCP — Consumer Price Index by Category

Pricing

Pay per usage

Rating

0.0

(0)

Developer

Andrew Avina

Andrew Avina

Maintained by Community

Actor stats

0

Bookmarked

1

Total users

0

Monthly active users

3 days ago

Last modified

Share

BLS CPI MCP — Consumer Price Index by Category & Time Period

Overview

The Consumer Price Index (CPI), published by the U.S. Bureau of Labor Statistics (BLS), measures the average change over time in the prices paid by urban consumers for a representative basket of goods and services. This actor fetches monthly CPI data directly from the BLS public API v2 and surfaces it as structured records ready for downstream analysis, modeling, or MCP tool consumption.

Features

  • Category filtering — query one focused category or pull all items together
  • Supported categories: food, energy, shelter, medical, apparel, all
  • Monthly granularity — each record represents one calendar month
  • 2-year default range — sensible out-of-the-box window (2022–2024)
  • Automatic fallback — if the BLS API is unavailable or rate-limited, the actor serves a curated set of realistic 2024 CPI values so downstream consumers never receive an empty dataset

Input

{
"category": "food",
"start_year": 2022,
"end_year": 2024,
"limit": 20
}
FieldTypeDefaultOptions
categorystring"all"food, energy, shelter, apparel, medical, all
start_yearinteger2022Any year supported by BLS API
end_yearinteger2024Must be >= start_year
limitinteger20Max records to push across all series

Output

Each record in the dataset contains exactly 8 fields:

FieldTypeDescription
series_idstringBLS series identifier (e.g. CUUR0000SAF1)
series_namestringHuman-readable series label (e.g. "Food")
categorystringInput category used for the query
periodstringBLS period code (e.g. "M01" for January)
yearintegerCalendar year of the data point
monthintegerCalendar month as an integer (1–12)
valuefloatCPI index value (base period 1982-84=100)
base_periodstringAlways "1982-84=100" — standard BLS CPI base

Use Cases

  • Inflation analysis — track month-over-month and year-over-year price changes across consumer categories
  • Cost modeling — incorporate real CPI trends into financial projections and scenario planning
  • Wage adjustment calculations — compute cost-of-living adjustments (COLA) for compensation reviews
  • Contract indexing — benchmark escalation clauses in long-term service or supply agreements to official government price indices