API REST / Market Score

Market Score

Score de santé du marché immobilier (0–100) pour une zone géographique.

GET/v1/market-score10 crédits

Calcule un score composite (0–100) reflétant la dynamique du marché : volume de transactions, tendance des prix, délai de vente et équilibre offre/demande. Utile pour comparer rapidement l'attractivité de différentes zones.

Localisation obligatoire

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

Paramètres

Paramètre	Type	Défaut	Description
code_postal	string	—	Code postal (ex. 75011). Au moins un filtre de localisation requis.
commune	string	—	Commune en majuscules (ex. PARIS 11, LYON, BORDEAUX).
code_departement	string	—	Code département (ex. 75, 69, 13).
type_local	enum	—	Maison \| Appartement \| Terrain \| Local commercial. Sans filtre : tous types.

Exemple — score marché Paris 11

curl "https://mcp.normi.fr/v1/market-score?code_postal=75011" \
  -H "X-API-Key: normi_votre_token"

Réponse

{
  "score": 72,
  "label": "Actif",
  "components": {
    "volume_score": 80,
    "price_trend_score": 65,
    "days_on_market_score": 70,
    "supply_demand_score": 74
  },
  "price_trend_pct": 3.2,
  "median_price_m2": 9850,
  "transaction_count_12m": 847,
  "zone": { "code_postal": "75011", "commune": "PARIS 11" },
  "_credits": { "used": 10, "remaining": 90 },
  "query_time_ms": 445
}

Interpréter le score

0–30 : Marché peu actif — faible volume, prix stagnants ou en baisse.
31–60 : Marché modéré — activité correcte, tendances neutres.
61–80 : Marché actif — bon volume, légère hausse des prix.
81–100 : Marché très dynamique — forte demande, prix en hausse rapide.
components détaille chaque sous-score pour comprendre les moteurs du résultat.
Comparez plusieurs zones avec compare_neighborhoods (outil MCP) pour une analyse côte à côte.

GET /v1/estimate

/v1/portfolio — CRUD