omnistate / insee

1.x-dev 2026-11-10 07:12 UTC

Requires

• php: >=8.2
• ext-simplexml: *
• omnisense/contracts: ^1.0@dev
• omnisense/omnistate: ^1.0@dev
• symfony/http-client: ^6.4|^7.0|^8.0

Requires (Dev)

• phpstan/phpstan: ^2.1
• phpunit/phpunit: ^11.0

MIT

• Marco Meyer

• statistics
• ipc
• INSEE
• icc
• sdmx
• bdm
• omnistate
• irl
• indice de reference des loyers
• ilc
• ilat

Published on Packagist.org on 2026-11-10 07:27 UTC

README

French statistics from INSEE's macro-economic database (BDM, "Séries chronologiques"), for omnisense/omnistate: every series of insee.fr's "indices et séries chronologiques" by its idBank, and the indices leases refer to by their name - the IRL (residential rents), the ICC, the ILC and the ILAT (commercial and professional leases), consumer prices. Its SDMX 2.1 API: open, no key, no account.

$insee = new Insee($httpClient);
$irl = $insee->series('IRL', from: TimePeriod::quarter(2025, 1));
$irl->observation('2026-Q2')->value;   // 148.37
$irl->credit;                          // "Insee, BDM, série 001515333, extraction au 10/11/2026"

$omnistate = new Omnistate(statistics: [$insee]);
$omnistate->indexChange('insee:IRL', TimePeriod::quarter(2025, 2), TimePeriod::quarter(2026, 2))->ratio();

No framework needed: the package requires omnisense/omnistate, omnisense/contracts, symfony/http-client and PHP's SimpleXML. $httpClient is the HTTP client to call with.

Usage policy

policy.json, read on 2026-11-10: 30 calls a minute (the API's terms; its portal's keyless plan allows 100), commercial reuse allowed, the source cited as "Insee, BDM/, " - each Series::$credit is that line.

Responsibility

This package is an independent, unofficial client: it is not affiliated with, endorsed by or sponsored by INSEE. It reaches its service on behalf of whoever runs it, and it does not redistribute its data beyond the short excerpts recorded as test fixtures. Its MIT licence covers this package's code only and grants no right to the service or to its data.

Whoever installs and runs this package is responsible for complying with the BDM API's terms (its CGU on INSEE's API portal) and insee.fr's legal notice, for citing the source, and for any use made of what it returns. The authors publish it free of charge, make no commercial use of it, and accept no liability for how it is used (see LICENSE).

Documentation

docs/: the requests, the ids, the mapping, history, errors, verified and not.

License

MIT.