# BLS Economic Indicators — CPI, Jobs, Unemployment (`gochujang/bls-economic-indicators`) Actor

Fetch US economic data from the Bureau of Labor Statistics: CPI, core CPI, PPI, unemployment rate, nonfarm payrolls, hourly earnings, and JOLTS job openings. Year-over-year and month-over-month changes included. No API key required.

- **URL**: https://apify.com/gochujang/bls-economic-indicators.md
- **Developed by:** [Hojun Lee](https://apify.com/gochujang) (community)
- **Categories:** Business
- **Features:** Limited permissions
- **Stats:** 3 total users, 2 monthly users, 100.0% runs succeeded, 0 bookmarks
- **User rating**: No ratings yet

## Pricing

$1.00 / 1,000 bls series fetcheds

This Actor is paid per event. You are not charged for the Apify platform usage, but only a fixed price for specific events.

Learn more: https://docs.apify.com/actors/running/actors-in-store.md#pay-per-event

## What's an Apify Actor?

An Actor is a serverless cloud program that runs on the Apify platform. It has two run modes.
In Batch mode, an Actor accepts a well-defined JSON input, performs an action which can take anything from a few seconds to a few hours,
and optionally produces a well-defined JSON output, datasets with results, or files in key-value store.
In Standby mode, an Actor provides a web server which can be used as a website, API, or an MCP server.

Apify vocabulary and the platform model are defined once, in the agent quickstart at https://apify.com/agents.md.

## How to integrate an Actor?

If asked about integration, you help developers integrate Actors into their projects.
You adapt to their stack and deliver integrations that are safe, well-documented, and production-ready.

Do not guess an integration path. Every one of them is in the agent quickstart at https://apify.com/agents.md: the Apify MCP server, Agent Skills with the Apify CLI, the JavaScript and Python clients, the REST API, and the account-free path for an agent with no human to sign in. It also carries the rule on stating cost before the first paid run.

For examples already wired to this Actor's own input schema, see the [API](#api) section below.

Each client library has reference documentation the quickstart does not restate: [JavaScript/TypeScript](https://docs.apify.com/api/client/js/docs.md) (`npm install apify-client`) and [Python](https://docs.apify.com/api/client/python/docs.md) (`pip install apify-client`).

# README

### BLS Economic Indicators — CPI, Jobs, Unemployment, PPI

Fetch **US Bureau of Labor Statistics** economic data: Consumer Price Index (CPI), core CPI, Producer Price Index (PPI), unemployment rate, nonfarm payrolls, average hourly earnings, JOLTS job openings, and initial unemployment claims — all in a single run. Year-over-year and month-over-month percentage changes are automatically calculated. No API key required.

The BLS publishes the most closely watched economic releases in the world. CPI drives Federal Reserve interest rate decisions. Nonfarm payrolls move equity, bond, and currency markets within seconds of release. These indicators are essential inputs for any macro trading strategy, economic research, or investment analysis workflow.

### Available Series

| Key | Series | Description |
|-----|--------|-------------|
| `cpi` | CUUR0000SA0 | Consumer Price Index — All Urban Consumers |
| `core_cpi` | CUSR0000SA0L1E | Core CPI excluding Food and Energy (SA) |
| `ppi` | WPUFD49104 | Producer Price Index — Final Demand |
| `unemployment` | LNS14000000 | Unemployment Rate, seasonally adjusted |
| `nonfarm_payrolls` | CES0000000001 | Total Nonfarm Payrolls (SA) |
| `avg_hourly_earnings` | CES0500000003 | Average Hourly Earnings — Private Sector |
| `job_openings` | JTS000000000000000JOL | JOLTS Job Openings (SA) |
| `initial_claims` | ICSA | Initial Unemployment Insurance Claims |

### What You Get

Each record represents one data point for one series:

- **series_key** — human-readable key (e.g., `"cpi"`)
- **series_id** — official BLS series ID (e.g., `"CUUR0000SA0"`)
- **series_name** — full series description
- **unit** — measurement unit (percent, index value, thousands of persons, etc.)
- **year** / **period** / **period_name** — time dimension (e.g., `"2025"`, `"M01"`, `"January"`)
- **value** — the actual data point
- **yoy_pct_change** — year-over-year percentage change (automatically calculated)
- **mom_pct_change** — month-over-month percentage change
- **footnotes** — any BLS revision or preliminary data notes

### Input Parameters

| Parameter | Type | Default | Description |
|-----------|------|---------|-------------|
| `series` | array | 6 core series | Series keys to fetch (see table above) |
| `startYear` | integer | `2020` | First year of data |
| `endYear` | integer | `2025` | Last year of data |
| `apiKey` | string | — | Optional BLS registration key (higher rate limits) |

### Sample Output

```json
{
  "series_key": "cpi",
  "series_id": "CUUR0000SA0",
  "series_name": "Consumer Price Index (All Urban, NSA)",
  "unit": "index (1982-84=100)",
  "frequency": "monthly",
  "year": "2025",
  "period": "M01",
  "period_name": "January",
  "value": 319.086,
  "yoy_pct_change": 3.0,
  "mom_pct_change": 0.5,
  "footnotes": []
}
```

```json
{
  "series_key": "nonfarm_payrolls",
  "series_id": "CES0000000001",
  "series_name": "Total Nonfarm Payrolls (SA)",
  "unit": "thousands of persons",
  "frequency": "monthly",
  "year": "2025",
  "period": "M01",
  "period_name": "January",
  "value": 159200.0,
  "yoy_pct_change": 1.2,
  "mom_pct_change": 0.1,
  "footnotes": ["Preliminary"]
}
```

### Why These Indicators Matter

**CPI and Core CPI** are the Fed's primary inflation gauges. When CPI accelerates above the 2% target, the Fed raises rates — tightening financial conditions, pressuring growth stocks, and strengthening the dollar. Crypto assets historically move inversely to real rates expectations.

**Nonfarm Payrolls** is the single most market-moving monthly release. A significant beat pushes yields higher (more hikes expected), while a miss triggers rate-cut expectations and risk-on positioning.

**PPI (Final Demand)** is a leading indicator for CPI — inflation starts at the producer level before reaching consumers. Traders watch the spread between PPI and CPI for margin pressure signals.

**Average Hourly Earnings** reveals wage inflation, which is sticky and closely watched by the Fed as a driver of services inflation.

**JOLTS Job Openings** shows labor market slack — when openings far exceed unemployed workers, wage pressure continues.

### Use Cases

- **Fed watch dashboards** — track real-time inflation and labor market data for rate decision forecasting
- **Algorithmic trading signals** — load BLS data as a systematic macro factor for equity, rates, or crypto strategies
- **Economic research** — build long-run time series for academic or policy analysis
- **Inflation-adjusted metrics** — deflate nominal price series using CPI for real returns analysis
- **Portfolio risk management** — monitor macroeconomic regime shifts signaled by payrolls, CPI, and unemployment trends
- **Business intelligence** — track labor cost trends via hourly earnings for sector analysis

### Data Availability

BLS data is published monthly (weekly for initial claims). Key release dates that move markets:

- **First Friday of each month** — Nonfarm Payrolls (Employment Situation Report)
- **Mid-month** — CPI release (~10-12 days after month end)
- **Third week of month** — PPI release
- **Every Thursday** — Initial Unemployment Claims

### Pricing

Pay-per-event: **$0.001 per series fetched** — default 6 series = $0.006 per run, regardless of how many years of data.

### API Key (Optional)

Without a BLS registration key: 25 daily queries, 10 series per query, 10-year range limit. With a free key: 500 daily queries, 50 series per query, 20-year range. Register at [data.bls.gov/registrationEngine](https://data.bls.gov/registrationEngine/).

### FAQ

**How current is the data?**
The BLS updates the API within hours of each scheduled release. For production use, schedule runs after the official release time (typically 8:30 AM ET).

**Can I fetch data before 2020?**
Yes — set `startYear` to any year from 2000 onward. Without an API key, the range is limited to 10 years. With a key, up to 20 years per request.

**Why is some data marked "Preliminary"?**
The BLS revises recent data points as additional survey responses arrive. Preliminary data appears in the `footnotes` field. Final revisions typically land one to two months after initial release.

**What is the difference between SA and NSA?**
SA (Seasonally Adjusted) removes predictable seasonal patterns — used for trend analysis. NSA (Not Seasonally Adjusted) is the raw figure — used for year-over-year comparisons. CPI is typically quoted NSA; unemployment and payrolls are typically SA.

***

### Related actors

- [FRED Economic Data](https://apify.com/gochujang/fred-economic-data) — 800,000+ time series including BLS data with additional context and vintages
- [Federal Reserve Rate Probability](https://apify.com/gochujang/fed-rate-probability) — SOFR/EFFR expectations that markets reprice immediately after CPI and NFP releases
- [CBOE Volatility Tracker](https://apify.com/gochujang/cboe-volatility-tracker) — VIX spike data that often follows surprise BLS prints

### Feedback

If this actor powers your US macro research, a review helps others find it: [Leave a review on Apify Store](https://apify.com/gochujang/bls-economic-indicators#reviews)

***

**Keywords:** BLS economic data, CPI inflation tracker, US unemployment rate, nonfarm payrolls, PPI producer price, BLS API, core CPI, hourly earnings, JOLTS job openings, US economic indicators, Bureau of Labor Statistics, US macro data, inflation data, labor market tracker, US jobs data

# Actor input Schema

## `series` (type: `array`):

BLS series keys to fetch. Options: 'cpi', 'core_cpi', 'ppi', 'unemployment', 'nonfarm_payrolls', 'avg_hourly_earnings', 'job_openings', 'initial_claims'.

## `startYear` (type: `integer`):

First year of data to retrieve.

## `endYear` (type: `integer`):

Last year of data to retrieve (max 20 year range without API key).

## `apiKey` (type: `string`):

Free BLS registration key for higher limits (500 queries/day vs 25/day). Register at https://data.bls.gov/registrationEngine/.

## Actor input object example

```json
{
  "series": [
    "cpi",
    "core_cpi",
    "ppi",
    "unemployment",
    "nonfarm_payrolls",
    "avg_hourly_earnings"
  ],
  "startYear": 2020,
  "endYear": 2025
}
```

# Actor output Schema

## `results` (type: `string`):

No description

# API

You can run this Actor programmatically using our API. Below are code examples in JavaScript, Python, and CLI, as well as the OpenAPI specification and MCP server setup.

## JavaScript example

```javascript
import { ApifyClient } from 'apify-client';

// Initialize the ApifyClient with your Apify API token
// Replace the '<YOUR_API_TOKEN>' with your token
const client = new ApifyClient({
    token: '<YOUR_API_TOKEN>',
});

// Prepare Actor input
const input = {};

// Run the Actor and wait for it to finish
const run = await client.actor("gochujang/bls-economic-indicators").call(input);

// Fetch and print Actor results from the run's dataset (if any)
console.log('Results from dataset');
console.log(`💾 Check your data here: https://console.apify.com/storage/datasets/${run.defaultDatasetId}`);
const { items } = await client.dataset(run.defaultDatasetId).listItems();
items.forEach((item) => {
    console.dir(item);
});

// 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/js/docs

```

## Python example

```python
from apify_client import ApifyClient

# Initialize the ApifyClient with your Apify API token
# Replace '<YOUR_API_TOKEN>' with your token.
client = ApifyClient("<YOUR_API_TOKEN>")

# Prepare the Actor input
run_input = {}

# Run the Actor and wait for it to finish
run = client.actor("gochujang/bls-economic-indicators").call(run_input=run_input)

# Fetch and print Actor results from the run's dataset (if there are any)
print(f"💾 Check your data here: https://console.apify.com/storage/datasets/{run.default_dataset_id}")
for item in client.dataset(run.default_dataset_id).iterate_items():
    print(item)

# 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/python/docs/quick-start

```

## CLI example

```bash
echo '{}' |
apify call gochujang/bls-economic-indicators --silent --output-dataset

```

## MCP server setup

```json
{
    "mcpServers": {
        "apify": {
            "type": "http",
            "url": "https://mcp.apify.com/?tools=fetch-actor-details,gochujang/bls-economic-indicators"
        }
    }
}
```

The hosted server signs you in with OAuth on first connect, so no API token belongs in this config. Clients without OAuth support can send an `Authorization: Bearer <APIFY_API_TOKEN>` header instead, using a token from API & Integrations in Apify Console (https://console.apify.com/settings/integrations).

## OpenAPI specification

Download the OpenAPI definition: https://api.apify.com/v2/actors/hMXiRzr07pfy6gZ5p/builds/r1vS1iWybYSN227Lf/openapi.json
