API REST/Référence MCP/lookup_property_history

lookup_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 (numéro exact, nom de rue approché)
Par parcelle cadastrale : section + no_plan + code_commune (correspondance exacte)

Paramètre	Type	Défaut	Description
address	string	—	Adresse avec numéro (ex. '4 rue de Rivoli', '49 cours Richard Vitton', '12 bis avenue Foch'). Sans numéro, renvoie les ventes de toute la rue. Utilisez avec code_postal.
code_postal	string	—	Code postal (ex. '75004'). 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 4 rue de Rivoli, 75004 Paris.

Exemple de réponse

{
  "scope": "address",
  "address_normalized": "4 RUE DE RIVOLI, 75004 PARIS 04",
  "cadastral": { "section": "AD", "no_plan": "12", "code_commune": "104" },
  "transactions": [
    {
      "id": 17998412,
      "date": "2024-03-12",
      "address": "4 RUE DE RIVOLI",
      "price": 1110000,
      "price_per_m2": 11822,
      "surface": 93.89,
      "type": "Appartement",
      "rooms": 4,
      "buyer_type": "unknown",
      "nature": "Vente"
    },
    {
      "id": 9012377,
      "date": "2015-06-30",
      "address": "4 RUE DE RIVOLI",
      "price": 774000,
      "price_per_m2": 8323,
      "surface": 93,
      "type": "Appartement",
      "rooms": 4,
      "buyer_type": "unknown",
      "nature": "Vente"
    }
  ],
  "price_evolution": {
    "basis": "repeat_sale",
    "description": "Same type (Appartement) and surface within 5% (93 m² → 93.89 m²), treated as the same property",
    "appreciation_pct": 43.4,
    "annualized_return_pct": 4.3,
    "period_years": 8.7,
    "first_sale": { "date": "2015-06-30", "price": 774000, "surface": 93 },
    "last_sale": { "date": "2024-03-12", "price": 1110000, "surface": 93.89 }
  },
  "note": "Found 2 transaction(s) at this address. A building can hold several units: compare surface and type before treating two sales as the same property.",
  "_credits": { "used": 20, "remaining": 40 },
  "query_time_ms": 178
}

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. Si aucune vente n'est trouvée, les 20 crédits sont remboursés et la réponse liste les numéros de la rue qui ont des ventes. Le champ note apparaît dans _credits quand votre solde passe sous 20 crédits.

get_zonal_price_distribution

estimate_property_value