Households – Key indicators (full dataset)Ménages – Principaux indicateurs (dossier complet)
Ménages – Principaux indicateurs (dossier complet)Households – Key indicators (full dataset)
This API from INSEE, the French national statistics institute, provides data on households and their composition, broken down by household type or by the socio-professional category of the reference person. Figures are available at the municipal (commune) and supra-municipal levels, covering all of France except Mayotte. The dataset is part of INSEE's population census outputs and supports demographic and socio-economic analysis of household structures across French territorial units.Caractéristiques des ménages et des personnes qui les composent selon le type de ménages ou selon la catégorie socioprofessionnelle de la personne de référence au niveau communal et supracommunal pour la France hors Mayotte.
Trust score
How is this computed?Weighted across five axes. Tap a ring for what it measures.
Data schema (8 fields)
Click a field to see example values.
| Field | Type | Description |
|---|---|---|
| GEOTerritory | string | Geographic code identifying the territorial unit (commune or supra-communal area).Geographic code identifying the territorial unit (commune or supra-communal area). |
| PCS | string | Code for the socio-professional category of the reference person.Code for the socio-professional category of the reference person. |
| FREQFrequency | string | Frequency of the statistical series, e.g. annual.Frequency of the statistical series, e.g. annual. |
| TIME_PERIODPeriod | string | Reference year of the observation.Reference year of the observation. |
| RP_MEASURERp measure | string | Code indicating the census measure type being reported.Code indicating the census measure type being reported. |
| TPH | string | Code identifying the household type category.Code identifying the household type category. |
| OCS | string | Code indicating the occupancy status of the dwelling.Code indicating the occupancy status of the dwelling. |
| OBS_VALUE_NIVEAUValue | number | Estimated number of households, persons or dwellings for the given category.Estimated number of households, persons or dwellings for the given category. |
Schema captured from melodi 6 hours ago.
Query the data
Pick columns and a sort, then fetch a live preview straight from the source. Choose an API-filterable column (marked ▾) under “Where” to pick from its list of values.
Sample data (5 records)
| GEO | PCS | FREQ | TIME_PERIOD | RP_MEASURE | TPH | OCS | OBS_VALUE_NIVEAU |
|---|---|---|---|---|---|---|---|
| 2026-AAV2020-001 | _T | A | 2012 | DWELLINGS | 11 | DW_MAIN | 1883472.31651 |
| 2026-AAV2020-001 | _T | A | 2012 | DWELLINGS | 110 | DW_MAIN | 799449.50866 |
| 2026-AAV2020-001 | _T | A | 2012 | DWELLINGS | 111 | DW_MAIN | 1084022.80785 |
| 2026-AAV2020-001 | _T | A | 2012 | DWELLINGS | 12 | DW_MAIN | 185650.06108 |
| 2026-AAV2020-001 | _T | A | 2012 | DWELLINGS | 2 | DW_MAIN | 3271825.80963 |
Live sample captured at profiling time — values may have changed upstream.
Verification Status
Using the API
Configuration
- Base URL
- https://api.insee.fr/melodi/data/DS_RP_MENAGES_COMP
Query examples
curl -s 'https://api.insee.fr/melodi/data/DS_RP_MENAGES_COMP?maxResult=20' -H 'Accept: application/json'First 20 observations (dimensions + measures) as JSON.
Machine-readable & source
Embed this badge in a README or wiki — it always shows the latest verification state and quality tier.