What it returns
Economic indicators for OECD member countries, partner economies and aggregates (G7, G20, OECD, euro area) from the OECD's official Data Explorer SDMX API, one row per country, series and period, with the change from the previous period.
| field | meaning |. |---|---|. | `preset`, `dataflow`, `country`, `countryName` | what was asked for and the reference area |. | `measure`, `unit`, `adjustment`, `transformation` | the OECD's labels for the series |. | `period`, `value`, `change` | observation and change from the previous period |. | `status`, `source` | OECD observation status and the API query |.
Request
POST https://api.pushbuild.com/oecd-economic-indicators/run with a JSON body. Send your key in the X-API-Key header.
| Field | Type | Description |
|---|---|---|
presets | list of strings | Headline indicators. Default when nothing is chosen: composite leading indicator, CPI inflation and unemployment rate. |
countries | list of strings | ISO 3-letter country codes or OECD aggregates such as G7, G20, OECD or EA20. Use ALL for every area the indicator covers. Default: the G7 countries. |
lastN | integer | Most recent observations per country and series. Ignored when startPeriod is set. Default: 12. |
startPeriod | string | First period to include, for example 2020, 2020-01 or 2020-Q1. Optional. |
endPeriod | string | Last period to include. Optional. |
dataflow | string | Advanced: any OECD Data Explorer dataflow id, for example OECD.SDD.STES,DSD_STES@DF_CLI, (agency,id,version). Used with key. |
key | string | Advanced: the SDMX key for the custom dataflow, for example USA.M.LI...AA...H. Write {countries} where the country codes go. |
changes | boolean | Add the change from the previous period in the same series. Default: true. |
maxItems | integer | Maximum items to return (1-500). Default: 100. |
Example
curl -X POST https://api.pushbuild.com/oecd-economic-indicators/run \
-H "X-API-Key: YOUR_KEY" \
-H "Content-Type: application/json" \
-d '{"presets": ["leading-indicator", "cpi-inflation", "unemployment-rate"], "countries": ["USA", "JPN", "DEU", "GBR", "FRA", "ITA", "CAN"], "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 Canada API: Policy Rate, CORRA, Bonds, CPI & CAD FX API
Bank of Canada statistics from its official Valet API: policy rate, CORRA, prime, T-bills, benchmark bond yields, mortgage and GIC rates, CPI and core CPI, commodity prices and daily CAD exchange rates.
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).
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