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)

APIExecutable4/7Query nowOpen workbench Subscribe🇫🇷France

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.

Filter by dimension Run verified request Read the docs

Data schema (9 fields)

Click a field to see example values.

Field	Type	Description
GEOTerritory	string	—
NOC	string	—
SEX	string	—
FREQFrequency	string	—
TIME_PERIODPeriod	string	—
RP_MEASURERp measure	string	—
OCS	string	—
AGE	string	—
OBS_VALUE_NIVEAUValue	number	—

Schema captured from melodi 4 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.

Where=

Sort by

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.

Full API documentation ↗

Machine-readable & source

JSON

Embed this badge in a README or wiki — it always shows the latest verification state and quality tier.