What it returns
Statistics Finland data from the official StatFin PxWeb API, as labelled rows with ISO periods. - **Presets**: `cpi` (CPI 2025=100: point figure, annual and monthly change), `unemployment` (LFS unemployment rate seasonally adjusted and trend, unemployed, employment rate 20-64), `gdp` (volume change quarter-on-quarter and year-on-year, seasonally adjusted level) - **Any table**: `table` as database/table (e.g. `khi/15b5.px`) with optional `filters` - **Search**: `search` returns matching table paths and titles
| field | meaning |. |---|---|. | `table`, `tableTitle` | StatFin table path and title |. | `indicator`, `contentsCode` | the measure and its code |. | `period`, `periodCode` | ISO period (`2026-09`, `2026Q2`) and the StatFin code |. | `series`, `dimensions`, `codes` | the measure plus variable labels, and the codes to reuse in `filters` |. | `value`, `updated`, `preset`, `source` | the figure, table update time, preset used and table page |.
Request
POST https://api.pushbuild.com/statistics-finland/run with a JSON body. Send your key in the X-API-Key header.
| Field | Type | Description |
|---|---|---|
presets | list of strings | Any of: cpi, unemployment, gdp. Default (when no table is given): all three. |
table | string | Any StatFin table as database/table, e.g. khi/15b5.px, tyti/135z.px, ntp/132h.px. Find them with search. |
filters | string | Variable code -> value codes, e.g. {"coicop_46_20231201": ["01", "04"]}. ["*"] selects all values. Variables left out use the table total where it has one, else their first value; all contents are returned unless contentscode is filtered. |
lastN | integer | How many of the latest periods to return. Default: 12. |
fromPeriod | string | Period code in the table format, e.g. 2020M01, 2020Q1, 2020. Overrides lastN. |
toPeriod | string | ISO form, e.g. 2026-06 or 2026Q2. |
search | string | Words to search StatFin tables. Returns matching tables instead of data. |
maxItems | integer | Maximum items to return (1-500). Default: 100. |
Example
curl -X POST https://api.pushbuild.com/statistics-finland/run \
-H "X-API-Key: YOUR_KEY" \
-H "Content-Type: application/json" \
-d '{"presets": ["cpi", "unemployment"], "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 values. No charge for errors or empty searches.
Related APIs
Australian Bureau of Statistics API: CPI, Jobs, GDP, Any Data API
Australian Bureau of Statistics data from the official ABS Data API: monthly CPI and trimmed mean, unemployment by state, GDP, wage price index and household spending presets, any ABS dataflow by SDMX key, and dataflow search.
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.
Bank of Israel API: BOI Rate, SHIR & Shekel Exchange Rates API
Bank of Israel statistics from its official SDMX API: the BOI interest rate, SHIR overnight rate and standing facility rates, daily representative shekel exchange rates (USD, EUR, GBP, JPY, CHF, CAD, AUD), or any series of any BOI dataflow..
Bank of Japan API: Call Rate, USD/JPY, Money Stock & Tankan API
Bank of Japan statistics from its official Time-Series Data Search API: overnight call rate, basic loan rate, USD/JPY, monetary base, M2, producer prices and Tankan business conditions presets, any series by database and code, and series search..
BIS Statistics API: Global Policy Rates, House Prices & Credit API
Bank for International Settlements data for 40-60 economies: central bank policy rates (daily or monthly), real residential property prices, credit-to-GDP gaps, effective exchange rates, USD exchange rates and CPI inflation, or any BIS dataflow by SDMX key..
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