API REST/Référence MCP/compare_neighborhoods

compare_neighborhoods

10 crédits

Compare 2 à 5 zones géographiques côte à côte : prix médian, prix au m², volume de transactions et classement relatif.

Paramètres

Le paramètre locations est un tableau JSON de 2 à 5 objets. Chaque objet doit contenir au moins code_postal ou commune.

ParamètreTypeDéfautDescription
locations*arrayTableau de 2 à 5 objets de localisation. Chaque objet contient code_postal ou commune. Exemple : [{"code_postal":"75011"},{"code_postal":"75012"}]
type_localenumAppartementMaison | 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.

Format du tableau locations

Exemple avec codes postaux :

[
  { "code_postal": "75011" },
  { "code_postal": "75012" },
  { "code_postal": "75013" }
]

Exemple avec communes (pour comparer des villes entières) :

[
  { "commune": "BORDEAUX" },
  { "commune": "NANTES" },
  { "commune": "TOULOUSE" }
]

Demandez à Claude

Claude construit automatiquement le tableau de locations depuis votre question en langage naturel :

Compare les prix immobiliers entre le 11e et le 12e arrondissement de Paris.

Exemple de réponse

{
  "type_local": "Appartement",
  "period": {
    "date_debut": "2021-03-01",
    "date_fin": "2024-03-01"
  },
  "comparisons": [
    {
      "location": { "code_postal": "75011", "commune": "PARIS 11" },
      "stats": {
        "count": 2341,
        "prix_m2_median": 9850,
        "prix_m2_moyen": 10120,
        "prix_median": 560000,
        "surface_mediane": 55
      },
      "rank_prix_m2": 1
    },
    {
      "location": { "code_postal": "75012", "commune": "PARIS 12" },
      "stats": {
        "count": 1987,
        "prix_m2_median": 9320,
        "prix_m2_moyen": 9580,
        "prix_median": 510000,
        "surface_mediane": 53
      },
      "rank_prix_m2": 2
    }
  ],
  "winner_prix_m2": { "code_postal": "75012", "label": "Le moins cher" },
  "_credits": { "used": 10, "remaining": 60 },
  "query_time_ms": 387
}
2 zones minimum, 5 maximum
L'outil retourne une erreur si le tableau locations contient moins de 2 ou plus de 5 entrées. Pour Paris, utilisez les codes postaux d'arrondissement (75001 à 75020) plutôt que la commune PARIS seule, qui agrègerait toute la ville.