What it returns
Any time series published by the US Bureau of Labor Statistics, by series id, from the official BLS Public Data API. Also builds state labor force series from plain state codes. - **seriesIds**: any BLS id, for example `CUSR0000SA0` (CPI-U, seasonally adjusted), `LNS14000000` (unemployment rate), `CES0000000001` (total nonfarm payrolls), `WPSFD4` (PPI final demand), `JTS000000000000000JOL` (job openings) - **states**: `CA`, `TX`, `NY` ... with `stateMeasures`: unemployment rate, unemployed, employed, labor force
| field | meaning |. |---|---|. | `seriesId`, `seriesTitle` | the series (titles come with a registration key; state series are labeled always) |. | `state`, `measure` | for state series |. | `year`, `period`, `periodName`, `date` | M01-M12 monthly, Q01-Q04 quarterly, M13 annual average |. | `value` | the published value |. | `preliminary`, `footnotes` | BLS flags, e.g. preliminary values that will be revised |. | `changeFromPrevious`, `pctChangeFromPrevious` | change vs the previous period |. | `changeFromYearAgo`, `pctChangeFromYearAgo` | change vs the same period a year earlier |.
Request
POST https://api.pushbuild.com/bls-data/run with a JSON body. Send your key in the X-API-Key header.
| Field | Type | Description |
|---|---|---|
seriesIds | list of strings | Any BLS series id, e.g. CUSR0000SA0 (CPI-U), LNS14000000 (unemployment rate), CES0000000001 (nonfarm payrolls), WPSFD4 (PPI final demand), JTS000000000000000JOL (job openings). |
states | list of strings | Two-letter state codes (CA, TX, NY, DC, PR) for state labor force statistics. |
stateMeasures | list of strings | Which state series to return (seasonally adjusted). Default: ["unemploymentRate"]. |
startYear | integer | First year. Defaults to two years before the end year. |
endYear | integer | Last year. Defaults to this year. |
latestOnly | boolean | One row per series: the most recent observation. Default: false. |
annualAverages | boolean | Include annual averages (period M13). Needs a registration key. Default: false. |
registrationKey | string | A free BLS key raises the limits from 25 to 500 queries a day, 25 to 50 series per query and 10 to 20 years, and adds series titles. |
maxItems | integer | Maximum items to return (1-500). Default: 100. |
Example
curl -X POST https://api.pushbuild.com/bls-data/run \
-H "X-API-Key: YOUR_KEY" \
-H "Content-Type: application/json" \
-d '{"seriesIds": ["CUSR0000SA0", "LNS14000000", "CES0000000001"], "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.16 per 1,000 observations. 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.
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.
Company Jobs API (Greenhouse, Lever, Ashby, Workable) API
Every open job straight from company career boards on Greenhouse, Lever, Ashby, Workable, SmartRecruiters and Recruitee: title, location, remote flag, department, employment type, posted date, salary where published, apply link and full description..
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