What it returns
The headline US macro numbers, straight from the agencies that publish them: the Bureau of Labor Statistics and the Bureau of Economic Analysis. Each value comes with its change from the prior period, its year-over-year change, and the exact time it was released. Use it to: - pull the latest CPI, payrolls or core PCE print the moment it is out - build inflation and labor dashboards without stitching agency files together - backtest macro surprises against release timestamps
One row per indicator per period:. pctChange / pctChangeYoY**: percent changes for index and dollar series. change**: change from the prior period (thousands of jobs for payrolls, percentage points for rates). changeYoY**: year-over-year change in percentage points for rates. releasedAt**: when the agency published that period (BLS release calendar; BEA file publication time for the latest period). Values are the current published figures, including later revisions. Pair with the US Economic Calendar API for upcoming release dates.
Request
POST https://api.pushbuild.com/us-economic-releases/run with a JSON body. Send your key in the X-API-Key header.
| Field | Type | Description |
|---|---|---|
indicators | list of strings | Which indicators to return. Default: all 28. |
latestOnly | boolean | Return only the most recent period of each indicator. Defaults on unless a start date is given. Default: true. |
periods | integer | With latest only off: how many recent periods to return per indicator. Default 24. Default: 24. |
dateFrom | string | Return periods starting on or after this date (YYYY-MM-DD). Up to about 10 years for BLS monthly series; BEA goes back to 1947. |
maxItems | integer | Maximum items to return (1-500). Default: 100. |
Example
curl -X POST https://api.pushbuild.com/us-economic-releases/run \
-H "X-API-Key: YOUR_KEY" \
-H "Content-Type: application/json" \
-d '{"indicators": ["cpi", "cpi_core", "payrolls", "unemployment_rate", "gdp_growth", "pce_core_price"], "dateFrom": "", "maxItems": 20}'Response
{"count": 20, "truncated": false, "seconds": 1.4, "items": [ { ... } ]}Each call returns up to 500 items. Records that fail validation or are not found are flagged in the items and not charged.
Pricing
Pay only for results returned: $0.40 per 1,000 values. No charge for errors or empty searches.
Related APIs
Bank of England API: Bank Rate, SONIA, Gilts & Mortgages API
Bank of England statistics from its official database: Bank Rate, SONIA, gilt yields, implied inflation, mortgage rates and approvals, M4 money, lending and sterling FX.
BLS Data API: Any Bureau of Labor Statistics Series API
Any US Bureau of Labor Statistics time series by id (CPI, payrolls by industry, unemployment, wages, PPI, JOLTS, import prices) plus state unemployment and labor force from plain state codes, with month-over-month and year-over-year changes..
Cboe Put/Call Ratios & VIX Futures Term Structure API
Daily Cboe options statistics: total, equity, index, SPX and VIX put/call ratios with call and put volume and open interest by product, plus the VIX futures curve with settlements, open interest and contango versus spot VIX..
CFPB Consumer Complaints: Banks, Lenders, Fintech API
Search 18 million+ official CFPB consumer complaints against banks, lenders, card issuers, debt collectors, credit bureaus and fintechs.
CFTC Commitments of Traders (COT) Reports API
Weekly CFTC Commitments of Traders positioning for every futures market: legacy, disaggregated (managed money, producers, swap dealers) and financial (leveraged funds, asset managers).
ClinicalTrials.gov API
Search 500,000+ clinical studies from ClinicalTrials.gov by condition, drug, sponsor, location, phase and status.
Tell us what you need built.
Questions about this API, higher volumes, or a data source you need that we don't cover yet.
hello@pushbuild.com