API REST / Activité du marché

Activité du marché

Analysez le volume mensuel et la saisonnalité d'un marché immobilier sur une période donnée.

GET/v1/market-activity10 crédits

Retourne le volume de transactions mois par mois avec un indicateur d'activité (high/normal/low) et les patterns de saisonnalité sur la période analysée.

Paramètres

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

Exemple — activité du marché à Nantes sur 2 ans

curl "https://mcp.normi.fr/v1/market-activity?commune=NANTES&months=24" \
  -H "X-API-Key: normi_votre_token"

Réponse

{
  "location": { "commune": "NANTES" },
  "period": {
    "months": 24,
    "date_debut": "2024-03-01",
    "date_fin": "2026-03-01"
  },
  "total_transactions": 4821,
  "monthly_average": 201,
  "monthly_data": [
    {
      "month": "2026-02",
      "count": 148,
      "activity_level": "low",
      "vs_average_pct": -26.4,
      "prix_m2_median": 3920
    },
    {
      "month": "2026-01",
      "count": 212,
      "activity_level": "normal",
      "vs_average_pct": 5.5,
      "prix_m2_median": 3980
    },
    {
      "month": "2025-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"]
  },
  "_credits": { "used": 10, "remaining": 50 },
  "query_time_ms": 312
}

Interpréter activity_level

high : volume supérieur de plus de 30 % à la moyenne mensuelle de la période.
normal : dans la fourchette ±30 %.
low : volume inférieur de plus de 30 % à la moyenne.
Utilisez seasonality pour conseiller sur le meilleur moment pour vendre ou acheter.
Voir aussi get_market_activity pour l'équivalent MCP.

GET /v1/stats/compare

GET /v1/property-history