API REST/Référence MCP/get_market_activity

get_market_activity

10 crédits

Analyse le volume d'activité du marché mois par mois et identifie les patterns de saisonnalité (périodes actives et creuses) sur une zone donnée.

Paramètres

Au moins un filtre de localisation est requis : code_postal, commune ou code_departement.

Paramètre	Type	Défaut	Description
code_postal	string	—	Code postal (ex. '44000'). Au moins un filtre de localisation est requis.
commune	string	—	Nom de commune en majuscules (ex. 'NANTES').
code_departement	string	—	Code département (ex. '44').
type_local	enum	—	Maison \| Appartement \| Terrain \| Local commercial \| Dépendance \| Local industriel
months	number	24	Nombre de mois d'historique à analyser (min 6, max 60).

Demandez à Claude

Claude déduit automatiquement la durée d'analyse depuis votre formulation :

Analyse l'activité du marché immobilier à Nantes ces 2 dernières années. Y a-t-il des mois plus actifs ?

Exemple de réponse

{
  "location": { "commune": "NANTES" },
  "period": {
    "months": 24,
    "date_debut": "2022-03-01",
    "date_fin": "2024-03-01"
  },
  "total_transactions": 4821,
  "monthly_average": 201,
  "monthly_data": [
    {
      "month": "2024-02",
      "count": 148,
      "activity_level": "low",
      "vs_average_pct": -26.4,
      "prix_m2_median": 3920
    },
    {
      "month": "2024-03",
      "count": 231,
      "activity_level": "normal",
      "vs_average_pct": 14.9,
      "prix_m2_median": 4010
    },
    {
      "month": "2023-05",
      "count": 298,
      "activity_level": "high",
      "vs_average_pct": 48.3,
      "prix_m2_median": 4180
    }
  ],
  "seasonality": {
    "most_active_months": ["mai", "juin", "septembre"],
    "least_active_months": ["janvier", "février", "août"],
    "peak_month_avg_boost_pct": 45.2
  },
  "_credits": { "used": 10, "remaining": 50 },
  "query_time_ms": 312
}

activity_level : high / normal / low

Chaque mois est classé par rapport à la moyenne annuelle de la période analysée. high = volume supérieur de plus de 30 % à la moyenne, low = inférieur de plus de 30 %, normal = dans la fourchette ±30 %. Utilisez ce champ pour conseiller sur le meilleur moment pour vendre ou acheter.

compare_neighborhoods

get_market_heatmap