Households by household size – Detailed data (MEN4)Ménages selon la taille du ménage – Données détaillées (MEN4)
Ménages selon la taille du ménage – Données détaillées (MEN4)Households by household size – Detailed data (MEN4)
This API from INSEE, the French national statistics institute, provides detailed census-based data on households and their members, broken down by household size, sex, and five-year age groups of the reference person. Data are available at the municipal (commune) level and for larger administrative aggregations, covering all of France except Mayotte. It supports demographic and socio-economic analysis of household composition across French territories.Caractéristiques des ménages et des personnes qui les composent selon la taille, le sexe et l'âge quinquennal 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 (9 fields)
Click a field to see example values.
| Field | Type | Description |
|---|---|---|
| GEOTerritory | string | Geographic area code for the statistical territory.Geographic area code for the statistical territory. |
| NOC | string | Household size category code.Household size category code. |
| SEX | string | Sex of the reference person of the household.Sex of the reference person of the household. |
| FREQFrequency | string | Frequency of data collection, e.g. annual.Frequency of data collection, e.g. annual. |
| TIME_PERIODPeriod | string | Reference year of the observation.Reference year of the observation. |
| RP_MEASURERp measure | string | Type of measure reported, such as dwellings.Type of measure reported, such as dwellings. |
| OCS | string | Occupancy status or housing category code.Occupancy status or housing category code. |
| AGE | string | Five-year age group of the reference person.Five-year age group of the reference person. |
| OBS_VALUE_NIVEAUValue | number | Estimated number of households or dwellings for this category.Estimated number of households or dwellings for this category. |
Schema captured from melodi 7 days 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)
Record 1AGE: Y20T24 · GEO: 2026-AAV2020-001
{
"AGE": "Y20T24",
"GEO": "2026-AAV2020-001",
"NOC": "P1",
"OCS": "DW_MAIN",
"SEX": "F",
"FREQ": "A",
"RP_MEASURE": "DWELLINGS",
"TIME_PERIOD": "2023",
"OBS_VALUE_NIVEAU": 90693.72313
}Record 2AGE: Y25T29 · GEO: 2026-AAV2020-001
{
"AGE": "Y25T29",
"GEO": "2026-AAV2020-001",
"NOC": "P1",
"OCS": "DW_MAIN",
"SEX": "F",
"FREQ": "A",
"RP_MEASURE": "DWELLINGS",
"TIME_PERIOD": "2023",
"OBS_VALUE_NIVEAU": 117677.37748
}Record 3AGE: Y30T34 · GEO: 2026-AAV2020-001
{
"AGE": "Y30T34",
"GEO": "2026-AAV2020-001",
"NOC": "P1",
"OCS": "DW_MAIN",
"SEX": "F",
"FREQ": "A",
"RP_MEASURE": "DWELLINGS",
"TIME_PERIOD": "2023",
"OBS_VALUE_NIVEAU": 92598.3332
}Record 4AGE: Y35T39 · GEO: 2026-AAV2020-001
{
"AGE": "Y35T39",
"GEO": "2026-AAV2020-001",
"NOC": "P1",
"OCS": "DW_MAIN",
"SEX": "F",
"FREQ": "A",
"RP_MEASURE": "DWELLINGS",
"TIME_PERIOD": "2023",
"OBS_VALUE_NIVEAU": 61944.87858
}Record 5AGE: Y40T44 · GEO: 2026-AAV2020-001
{
"AGE": "Y40T44",
"GEO": "2026-AAV2020-001",
"NOC": "P1",
"OCS": "DW_MAIN",
"SEX": "F",
"FREQ": "A",
"RP_MEASURE": "DWELLINGS",
"TIME_PERIOD": "2023",
"OBS_VALUE_NIVEAU": 51912.11958
}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_TD_MENAGES_NOC_COMP
Query examples
curl -s 'https://api.insee.fr/melodi/data/DS_RP_TD_MENAGES_NOC_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.