API REST/Référence MCP/get_market_heatmap

get_market_heatmap

15 crédits

Prix agrégés par code postal pour cartographier un département ou une grande ville. Chaque zone inclut des coordonnées centroïde pour la visualisation cartographique.

Paramètres

code_departement ou commune est obligatoire.

Paramètre	Type	Défaut	Description
code_departement	string	—	Code département (ex. '75', '92'). Requis si commune non fourni.
commune	string	—	Nom de commune en majuscules (ex. 'MARSEILLE'). Requis si code_departement non fourni.
type_local	enum	—	Maison \| Appartement \| Terrain \| Local commercial \| Dépendance \| Local industriel
group_by	enum	code_postal	Granularité d'agrégation : code_postal \| commune.
min_transactions	number	10	Nombre minimum de transactions pour inclure une zone. Les zones avec moins de transactions sont exclues pour fiabilité statistique.
date_debut	string	—	Date de début au format YYYY-MM-DD.
date_fin	string	—	Date de fin au format YYYY-MM-DD.

Demandez à Claude

Pour couvrir l'Île-de-France, Claude peut appeler l'outil plusieurs fois (un département à la fois) :

Génère une heatmap des prix de l'Île-de-France (département 75, 92, 93, 94) pour les appartements.

Exemple de réponse

{
  "code_departement": "92",
  "type_local": "Appartement",
  "group_by": "code_postal",
  "zones": [
    {
      "code_postal": "92100",
      "commune": "BOULOGNE-BILLANCOURT",
      "count": 1243,
      "prix_m2_median": 8750,
      "prix_m2_moyen": 9020,
      "prix_median": 472000,
      "centroid_lat": 48.8352,
      "centroid_lon": 2.2400,
      "relative_position": "expensive"
    },
    {
      "code_postal": "92120",
      "commune": "MONTROUGE",
      "count": 876,
      "prix_m2_median": 7980,
      "prix_m2_moyen": 8210,
      "prix_median": 398000,
      "centroid_lat": 48.8182,
      "centroid_lon": 2.3201,
      "relative_position": "average"
    },
    {
      "code_postal": "92270",
      "commune": "BOIS-COLOMBES",
      "count": 542,
      "prix_m2_median": 6850,
      "prix_m2_moyen": 7100,
      "prix_median": 342000,
      "centroid_lat": 48.9196,
      "centroid_lon": 2.2717,
      "relative_position": "affordable"
    }
  ],
  "department_summary": {
    "total_zones": 38,
    "prix_m2_median_dept": 7620,
    "prix_m2_range": { "min": 5200, "max": 11400 }
  },
  "_credits": { "used": 15, "remaining": 35 },
  "query_time_ms": 578
}

relative_position : expensive / average / affordable

Chaque zone est classée par rapport à la médiane du département : expensive = prix/m² supérieur de plus de 20 % à la médiane, affordable = inférieur de plus de 20 %, average = dans la fourchette ±20 %. Les coordonnées centroid_lat et centroid_lon permettent d'afficher directement les données sur une carte (Mapbox, Leaflet, etc.).

get_market_activity

get_property_history