API Comparables : des biens comparables et un prix estimé, par REST ou dans votre assistant IA

L'API Comparables de CASAFARI et son serveur MCP fournissent les biens comparables et une valeur estimée pour un logement identifié par un point, une adresse ou une référence cadastrale (Espagne). Conçue pour les experts, les banques, les proptechs et les agents équipés d'un assistant IA, la solution rassemble trois sources : annonces du marché, ventes et locations passées et registres officiels. Elle propose 4 opérations REST et 1 outil MCP pour 25 tokens par appel, la résolution d'adresse via Location Lookup étant gratuite.

Que renvoie Comparables pour un bien donné ?

À Lyon, une experte en évaluation immobilière reçoit la demande d'une banque pour un avis de valeur sur un T3 fictif de 68 m² situé à Villeurbanne. Sur son écran, trois fenêtres se juxtaposent : les annonces actives affichées sur les portails, l'historique des ventes notariales du secteur et ses propres archives d'agences. Chaque source indique une réalité différente. La question fondamentale qui se pose à tout professionnel de l'évaluation est toujours la même : à quel prix se fier ?

L'API Comparables simplifie cette recherche en acceptant trois types d'entrées : un point géographique (latitude et longitude), une adresse postale complète ou une référence cadastrale (cette dernière possibilité étant réservée à l'Espagne). En France et en Belgique, l'adresse est préalablement convertie en identifiant de localisation sans aucun coût via le service gratuit Location Lookup.

En retour, l'API fournit une analyse structurée autour du bien évalué : un rayon de biens comparables qualifiés avec leur distance, leur surface, leur prix au mètre carré et la date exacte de chaque transaction ou publication, accompagnés d'une fourchette d'estimation de valeur vénale ou locative.

Les données restituées reposent sur trois piliers d'informations distincts :

• Les annonces actuellement en cours de commercialisation sur le marché.
• Les ventes et les locations passées identifiées par CASAFARI.
• Les prix enregistrés issus des registres officiels.

D'où viennent les comparables : annonces, ventes passées, locations et prix enregistrés

Une seule source d'information ne suffit jamais pour établir une valeur vénale rigoureuse. En France, un prix affiché sur un portail reflète une attente du vendeur, tandis qu'un prix constaté à l'acte authentique chez le notaire représente un engagement financier réel. Le marché locatif obéit quant à lui à ses propres dynamiques de rendement.

Pour la France, le fichier open data des Demandes de valeurs foncières (DVF), produit par la DGFiP en application du décret n° 2018-1350 du 28 décembre 2018, enregistre les prix de vente réels, les dates de mutation, la nature des biens et leurs surfaces. Mis à jour deux fois par an (en avril et en octobre), ce jeu de données couvre l'ensemble du territoire à l'exception du Bas-Rhin, du Haut-Rhin, de la Moselle et de Mayotte. Les professionnels peuvent consulter le fichier Demandes de valeurs foncières de la DGFiP pour analyser l'historique officiel des transactions.

En Belgique, l'office national de statistique Statbel établit ses statistiques immobilières à partir des actes de vente enregistrés par le SPF Finances. Au premier semestre 2026, Statbel indique un prix médian de 285 000 € pour une maison 2 ou 3 façades (+1,8 % sur un an), 402 400 € pour une maison 4 façades (+4,5 %) et 257 000 € pour un appartement (+3,2 %), comme le détaillent les prix de l'immobilier du premier semestre 2026 publiés par Statbel.

En croisant les offres actives et les transactions enregistrées, la plateforme permet de contextualiser chaque chiffre. Pour en savoir plus sur l'intégration des prix de vente réels dans vos analyses, vous pouvez consulter le guide expliquant où trouver les comparables avec les prix de vente réels.

Comment un expert, une banque ou un réseau appelle Comparables en REST

L'intégration de l'API s'effectue selon un enchaînement simple en trois étapes : l'application résout l'adresse à l'aide de Location Lookup (opération gratuite), exécute l'appel à Comparables (25 tokens), puis exploite les données obtenues pour générer l'estimation et le rapport d'analyse.

L'API propose 4 opérations REST distinctes, décrites en détail dans la documentation de Comparables & Valuation (en anglais). Pour une vue d'ensemble des points d'accès disponibles sur la plateforme, reportez-vous aux API de données immobilières CASAFARI.

Ces services couvrent cinq cas d'usage principaux pour les équipes techniques et métier :

• Estimer la valeur vénale d'un bien résidentiel à partir de comparables qualifiés.
• Estimer la valeur locative et le loyer de marché d'un logement.
• Identifier des comparables à partir d'une référence cadastrale (fonctionnalité disponible en Espagne uniquement).
• Rechercher des biens comparables pour les locaux commerciaux et professionnels.
• Générer un rapport d'analyse comparative de marché (CMA) prêt à être remis au client, dont les spécifications d'intégration sont expliquées dans le guide montrant comment transformer des comparables en rapport CMA prêt pour le client (en anglais).

Pour les établissements bancaires et les analystes risques, cette méthode garantit l'application d'un processus d'évaluation homogène et traçable pour chaque dossier de prêt. L'expert conserve son libre arbitre professionnel, tandis que l'API apporte les justificatifs de marché datés.

Les clés d'accès et le suivi de consommation s'effectuent depuis la console CASAFARI pour obtenir une clé et suivre vos tokens.

Poser la question dans Claude ou un autre assistant : le serveur MCP Comparables

Le serveur MCP (Model Context Protocol) met à disposition 1 outil accessible directement à l'adresse https://platform.casafari.com/mcp/comparables. Ce protocole permet d'interroger la base de données de CASAFARI en langage naturel depuis un assistant IA.

Un agent immobilier ou un expert peut formuler sa requête directement dans son interface de travail : « Quels sont les comparables vendus autour du 12 rue X à Villeurbanne depuis douze mois ? ». L'assistant interroge l'outil MCP et restitue les données de marché avec le même niveau de précision qu'un appel REST direct.

Pour ajouter le serveur dans Claude Code, il suffit d'exécuter la commande suivante dans votre terminal :

claude mcp add --transport http casafari-comparables https://platform.casafari.com/mcp/comparables

Le serveur MCP s'interface avec tout assistant compatible avec le standard MCP sur le protocole HTTP. Pour découvrir comment déployer ces outils dans vos flux de travail automatisés, consultez la page CASAFARI MCP, les données immobilières pour les agents IA.

Combien coûte un appel : les tokens

Chaque requête adressée à l'API Comparables consomme exactement 25 tokens, que l'appel soit effectué via l'infrastructure REST ou par l'intermédiaire du serveur MCP. La résolution d'adresse préalable réalisée avec Location Lookup est entièrement gratuite et ne décompte aucun token.

Il convient de distinguer ces tokens de consommation – utilisés pour mesurer l'utilisation des services de données – des access tokens OAuth employés pour l'authentification sécurisée des requêtes API.

Le solde disponible et le détail de la consommation s'affichent en temps réel sur la console CASAFARI pour obtenir une clé et suivre vos tokens.

Pourquoi les prix enregistrés changent l'avis de valeur en France et en Belgique

En France, les données provisoires de l'Insee et des Notaires de France indiquent une hausse des prix des logements anciens de +1,1 % sur un an au quatrième trimestre 2025 (+1,5 % pour les appartements, +0,8 % pour les maisons), comme le mentionnent les indices Notaires-Insee du quatrième trimestre 2025 publiés en février 2026. L'activité s'établit à 921 000 transactions cumulées sur douze mois à fin septembre 2025 (+11 % sur un an), selon le bilan immobilier 2025 des Notaires de France.

Dans un marché caractérisé par des variations annuelles contenues, l'écart observé entre le prix affiché initialement dans une annonce et le prix réel constaté lors de la signature de l'acte authentique est souvent supérieur à la variation annuelle moyenne du secteur. Sélectionner des références appuyées sur des ventes enregistrées est donc déterminant pour fixer une valeur vénale juste.

En Belgique, le marché affiche une dynamique mesurée : au premier semestre 2026, la Région wallonne enregistre un prix médian de 195 000 € pour les maisons 2 ou 3 façades, marquant une stabilité par rapport à l'année précédente.

Pour les professionnels, la clarté du vocabulaire est essentielle : l'agent immobilier réalise un avis de valeur, tandis que l'expert indépendant rédige un rapport d'expertise immobilière. Pour approfondir la structure de ces documents, vous pouvez lire l'article sur les données de transactions dans le rapport d'estimation ainsi que le guide expliquant comment évaluer un bien immobilier avec CASAFARI.

Pour qui : experts, banques, proptechs, réseaux d'agences

Experts en évaluation immobilière : L'API fournit les preuves de marché nécessaires à la rédaction de rapports d'expertise conformes à la Charte de l'expertise en évaluation immobilière. La traçabilité de chaque référence renforce la sécurité juridique des conclusions.

Équipes crédit et risques des banques : Le service permet d'automatiser le contrôle des garanties hypothécaires. Chaque dossier fait l'objet d'une analyse basée sur des comparables datés, réduisant le risque d'surévaluation des actifs en portefeuille.

Proptechs et services en ligne : Les équipes de développement intègrent la logique d'évaluation directement dans leurs applications Web ou mobiles. L'enchaînement automatisé entre Location Lookup et Comparables permet de délivrer des estimations instantanées à leurs utilisateurs.

Agents et réseaux immobiliers : Grâce au serveur MCP, les conseillers interrogent la base de données CASAFARI depuis leur assistant conversationnel pour préparer leurs avis de valeur en quelques secondes avant leurs rendez-vous vendeurs.

Pour éditer des dossiers complets d'analyse de marché sans développement informatique, découvrez l'outil Évaluations & Étude de Marché de CASAFARI ou testez directement l'estimation immobilière en ligne de CASAFARI.