API Access
Access dataset files directly from scripts, code, or AI agents.
Browse dataset files
API Access
Access dataset files directly from scripts, code, or AI agents.
Dataset Files
Each file has a stable URL (r-link) that you can use directly in scripts, apps, or AI agents. These URLs are permanent and safe to hardcode.
/core/cpi-us/
https://datahub.io/core/cpi-us/_r/-/README.md
https://datahub.io/core/cpi-us/_r/-/UPDATE_SCRIPT_MAINTENANCE_REPORT.md
https://datahub.io/core/cpi-us/_r/-/archive/cpiai_archived.csv
https://datahub.io/core/cpi-us/_r/-/data/cpiai.csv
https://datahub.io/core/cpi-us/_r/-/datapackage.json
Key Files
Start with these files — they give you everything you need to understand and access the dataset.
datapackage.json— metadata & schema
https://datahub.io/core/cpi-us/_r/-/datapackage.json
README.md— documentation
https://datahub.io/core/cpi-us/_r/-/README.md
Typical Usage
- 1. Fetch datapackage.json to inspect schema and resources
- 2. Download data resources listed in datapackage.json
- 3. Read README.md for full context
Data Views
Monthly Consumer Price Inflation
Monthly Consumer Price Index
Data Files
Explore with AIcpiai
| Field | Type | Format | Description |
|---|---|---|---|
| Date | date | default | Date of the observation in YYYY-MM-DD format, always the first day of the month. |
| Index | number | Monthly Consumer Price Index. Values are U.S. city averages for all items and 1982-84=100. | |
| Inflation | number | Monthly Consumer Price Inflation. Values are for U.S. city averages for all items. |
Download
Download CSVAbout
- Monthly CPI-U index values and derived month-on-month inflation rates for the US city average (all items), from January 1913 to the most recent available month. The first row (1913-01-01) has an empty Inflation value because percent-change calculation requires a prior month.
- Last updated
- 19 May 2026
- Total rows
- ...
- Format
- CSV
- File size
- 29.3 kB
- Source
- BLS Public API v2
About this dataset
Update Script Maintenance Report
Date: 2026-03-03
- Executed updater locally:
python scripts/process.py. - Verified script executes and merges latest available CPI rows.
- Added workflow write permission in
.github/workflows/actions.yml(permissions: contents: write) so scheduled updates can push commits reliably.
Note:
- Automated updates depend on
BLS_API_KEYin repository secrets for full historical range requests.