API REST/Référence MCP/get_property_history

get_property_history

20 crédits

Retourne l'historique complet de toutes les transactions enregistrées pour une adresse précise ou une parcelle cadastrale, depuis 2014.

Paramètres

Deux modes de recherche sont disponibles — utilisez l'un ou l'autre :

Par adresse : address + code_postal (correspondance floue)
Par parcelle cadastrale : section + no_plan + code_commune (correspondance exacte)

Paramètre	Type	Défaut	Description
address	string	—	Adresse du bien (ex. '15 rue de la Paix'). Utilisez avec code_postal pour la recherche par adresse.
code_postal	string	—	Code postal (ex. '75002'). Requis avec address.
section	string	—	Section cadastrale (ex. 'AB'). Utilisez avec no_plan et code_commune pour la recherche cadastrale.
no_plan	string	—	Numéro de plan cadastral (ex. '0042'). Utilisez avec section et code_commune.
code_commune	string	—	Code INSEE de la commune (5 chiffres, ex. '75102'). Requis pour la recherche cadastrale.

Demandez à Claude

Claude extrait automatiquement l'adresse et le code postal depuis votre question :

Montre-moi l'historique des ventes pour le 15 rue de la Paix, 75002 Paris.

Exemple de réponse

{
  "query": {
    "address": "15 rue de la Paix",
    "code_postal": "75002",
    "match_type": "address_fuzzy"
  },
  "property": {
    "commune": "PARIS 02",
    "code_postal": "75002",
    "section": "AB",
    "no_plan": "0017",
    "type_local": "Appartement",
    "surface_reelle_bati": 95
  },
  "transactions": [
    {
      "id": 1872341,
      "date_mutation": "2023-06-14",
      "valeur_fonciere": 1250000,
      "prix_m2": 13158,
      "surface_reelle_bati": 95,
      "nombre_pieces_principales": 4,
      "type_local": "Appartement"
    },
    {
      "id": 1124890,
      "date_mutation": "2018-03-22",
      "valeur_fonciere": 980000,
      "prix_m2": 10316,
      "surface_reelle_bati": 95,
      "nombre_pieces_principales": 4,
      "type_local": "Appartement"
    },
    {
      "id": 734201,
      "date_mutation": "2012-11-08",
      "valeur_fonciere": 720000,
      "prix_m2": 7579,
      "surface_reelle_bati": 95,
      "nombre_pieces_principales": 4,
      "type_local": "Appartement"
    }
  ],
  "price_evolution": {
    "first_transaction": { "date": "2012-11-08", "prix_m2": 7579 },
    "last_transaction": { "date": "2023-06-14", "prix_m2": 13158 },
    "total_change_pct": 73.6,
    "annualized_change_pct": 5.2
  },
  "_credits": { "used": 20, "remaining": 15, "note": "Crédits bas — rechargez bientôt." },
  "query_time_ms": 89
}

Outil le plus coûteux : 20 crédits

C'est l'outil le plus coûteux du serveur. Préférez la recherche cadastrale (section + no_plan + code_commune) lorsque vous avez accès au numéro de parcelle : elle est plus précise que la correspondance floue par adresse et évite les faux positifs sur les immeubles multi-lots. Le champ note apparaît dans _credits quand votre solde passe sous 20 crédits.

get_market_heatmap

estimate_property