API REST/Référence MCP/find_comparables

find_comparables

10 crédits

Trouve des biens similaires vendus récemment autour d'un point GPS pour estimer la valeur de marché d'un appartement ou d'une maison.

Paramètres

Les paramètres marqués * sont obligatoires. Fournissez les coordonnées GPS du bien à estimer (géocodez l'adresse si nécessaire).

ParamètreTypeDéfautDescription
latitude*numberLatitude WGS84 du bien à estimer.
longitude*numberLongitude WGS84 du bien à estimer.
type_local*enumMaison | Appartement (seuls ces deux types sont supportés pour la recherche de comparables).
surface_min*numberSurface minimum en m². Recommandé : surface cible − 20 %.
surface_max*numberSurface maximum en m². Recommandé : surface cible + 20 %.
piecesnumberNombre de pièces principales. Optionnel, affine la recherche.
radius_mnumber500Rayon de recherche en mètres (max 2000). Au-delà de 1000 m, la période est auto-limitée aux 12 derniers mois.
max_age_monthsnumber12Ancienneté maximale des transactions en mois (max 36).
limitnumber10Nombre de comparables à retourner (max 20).
exclude_bulk_salesbooleantrueExclure les ventes en lot.

Demandez à Claude

Claude géocode automatiquement l'adresse et appelle l'outil avec les coordonnées :

Estime la valeur d'un appartement de 70m² au 5 rue de Rivoli Paris 75001 (lat: 48.8604, lon: 2.3483)

Exemple de réponse

{
  "target": {
    "latitude": 48.8604,
    "longitude": 2.3483,
    "type_local": "Appartement",
    "surface_min": 56,
    "surface_max": 84
  },
  "comparables": [
    {
      "id": 3012847,
      "date_mutation": "2024-07-10",
      "commune": "PARIS 01",
      "code_postal": "75001",
      "valeur_fonciere": 672000,
      "surface_reelle_bati": 71,
      "prix_m2": 9465,
      "nombre_pieces_principales": 3,
      "distance_m": 187,
      "latitude": 48.8612,
      "longitude": 2.3471
    },
    {
      "id": 2998341,
      "date_mutation": "2024-05-22",
      "commune": "PARIS 01",
      "code_postal": "75001",
      "valeur_fonciere": 590000,
      "surface_reelle_bati": 65,
      "prix_m2": 9077,
      "nombre_pieces_principales": 2,
      "distance_m": 312,
      "latitude": 48.8599,
      "longitude": 2.3501
    }
  ],
  "summary": {
    "count": 8,
    "prix_m2_median": 9280,
    "prix_m2_moyen": 9341,
    "prix_m2_min": 8500,
    "prix_m2_max": 10200,
    "estimation_70m2_median": 649600,
    "estimation_70m2_fourchette": "595000 – 714000"
  },
  "_credits": { "used": 10, "remaining": 80 },
  "query_time_ms": 298
}
Fourchette de surface ±20 %
Pour des résultats pertinents, définissez surface_min et surface_max comme la surface cible ± 20 %. Par exemple, pour un appartement de 70 m² : surface_min=56, surface_max=84. Un rayon trop grand (> 1 000 m) restreint automatiquement les résultats aux 12 derniers mois.