API REST/Référence MCP/get_market_stats

get_market_stats

5 crédits

Statistiques agrégées de marché : prix médian, prix moyen, prix au m², volume de transactions et distribution des surfaces sur une zone et une période données.

Paramètres

Au moins un filtre de localisation est requis : code_postal, commune, code_departement ou coordonnées GPS.

ParamètreTypeDéfautDescription
code_postalstringCode postal (ex. '33000'). Au moins un filtre de localisation est requis.
communestringNom de commune en majuscules (ex. 'BORDEAUX', 'PARIS 01').
code_departementstringCode département (ex. '33').
latitudenumberLatitude WGS84. Nécessite aussi longitude.
longitudenumberLongitude WGS84. Nécessite aussi latitude.
radius_mnumber500Rayon en mètres pour la recherche GPS (max 2000).
type_localenumMaison | Appartement | Terrain | Local commercial | Dépendance | Local industriel
date_debutstringDate de début au format YYYY-MM-DD. Par défaut : 3 ans en arrière.
date_finstringDate de fin au format YYYY-MM-DD. Par défaut : aujourd'hui.
exclude_bulk_salesbooleantrueExclure les ventes en lot.
exclude_outliersbooleantrueExclure les prix aberrants.
include_terrainbooleanfalseInclure les terrains dans le calcul des statistiques.

Demandez à Claude

Connectez Normi à Claude Desktop ou Claude Code, puis posez directement :

Quel est le prix médian au m² pour les maisons à Bordeaux ?

Exemple de réponse

{
  "location": {
    "commune": "BORDEAUX",
    "code_departement": "33"
  },
  "type_local": "Maison",
  "period": {
    "date_debut": "2021-03-01",
    "date_fin": "2024-03-01"
  },
  "stats": {
    "count": 1842,
    "prix_median": 425000,
    "prix_moyen": 468200,
    "prix_m2_median": 3850,
    "prix_m2_moyen": 4120,
    "surface_mediane": 105,
    "prix_min": 95000,
    "prix_max": 2100000
  },
  "_credits": { "used": 5, "remaining": 90 },
  "query_time_ms": 211
}
Fenêtre temporelle par défaut : 3 ans
Si vous n'indiquez pas date_debut, l'outil couvre automatiquement les 3 dernières années. Pour cibler le marché récent (12 derniers mois), passez date_debut explicitement. Un champ notice apparaît dans la réponse quand une limite automatique a été appliquée.