What it returns

French national statistics from INSEE's official macroeconomic database (BDM), via its SDMX API.

Presets: cpi (CPI base 2025, France, all items: index, monthly and annual change for all households, with imputed rents, and urban blue-collar/employee households), gdp (quarterly growth and level, SA-WDA), unemployment (ILO rate, SA), business-climate (business and employment climate, all sectors), consumer-confidence
Any series: up to hundreds of 9-digit idbanks
Any dataflow: dataflow + SDMX key

field	meaning
`idbank`, `title`	INSEE series id and English title
`frequency`, `period`, `value`	M / T (quarterly) / A, `2026-09` / `2026-Q2`, and the value
`unit`, `unitMultiplier`, `adjustment`	unit, multiplier and seasonal adjustment as published
`status`, `quality`, `lastUpdate`, `stopped`	observation status (A normal, P provisional), quality (DEF final, PROV), last update, whether the series is discontinued
`preset`, `source`	the preset used and the insee.fr series page

Request

POST https://api.pushbuild.com/insee-france-statistics/run with a JSON body. Send your key in the X-API-Key header.

Field	Type	Description
`presets`	list of strings	Any of: cpi, gdp, unemployment, business-climate, consumer-confidence. Default (when no idbanks or dataflow are given): cpi, gdp, unemployment, business-climate.
`idbanks`	list of strings	9-digit INSEE series ids, as shown on insee.fr series pages, e.g. 011814632, 001688527.
`dataflow`	string	Any BDM dataflow, e.g. IPC-2025, CNT-2020-PIB-EQB-RF, CLIMAT-AFFAIRES, IPI-2021, ENQ-CONJ-MENAGES.
`key`	string	Dot-separated dimension codes in the dataflow's order, empty position for all, + for several. Keep it narrow: very broad keys are refused by INSEE.
`lastN`	integer	Latest observations per series, used when no period is given. Default: `12`.
`startPeriod`	string	e.g. 2020-01, 2020-Q1, 2020.
`endPeriod`	string	e.g. 2026-09.
`maxItems`	integer	Maximum items to return (1-500). Default: `100`.

Example

curl -X POST https://api.pushbuild.com/insee-france-statistics/run \
  -H "X-API-Key: YOUR_KEY" \
  -H "Content-Type: application/json" \
  -d '{"presets": ["cpi", "gdp"], "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.

Banco de Portugal API: Portugal Rates, Yields, HICP & GDP API

Banco de Portugal BPstat data from the official API: coincident indicators, HICP, GDP, house prices, confidence, Portuguese government bond yields, money-market, loan and deposit rates, banking ratios, or any BPstat dataset or series id..

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..

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

(617) 299-8887

INSEE France Statistics API: CPI, GDP, Jobs & Any Series