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 de prix demandés : les biens sur le marché, les biens retirés après vente et les biens retirés après location. Le service comprend 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 prix affichés dans le 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 permet 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 publication ou retrait du marché, accompagnés d'une fourchette d'estimation de valeur vénale ou locative (prix de vente rapide, prix de marché et prix hors marché).

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

• Les biens actuellement en cours de commercialisation sur le marché.
• Les biens retirés du marché après vente (avec leur dernier prix affiché).
• Les biens retirés du marché après location (avec leur dernier prix affiché).

D'où viennent les comparables : biens sur le marché et biens retirés du marché

Une seule source d'information ne suffit jamais pour établir une valeur vénale rigoureuse. L'API Comparables se concentre sur les biens immobiliers et leurs prix demandés : les biens sur le marché et l'historique des biens retirés après vente ou location (restitués avec leur dernier prix affiché).

Pour analyser le marché, les prix affichés permettent de mesurer l'offre disponible et la dynamique des prix demandés par les vendeurs. Lorsque vous avez également besoin d'intégrer les prix de vente enregistrés dans les registres officiels (DVF en France, actes notariés en Espagne, ventes enregistrées en Italie de l'Agenzia delle Entrate, registre RCN en Pologne), ceux-ci sont disponibles via le service Comparables avec Transactions.

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 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 en savoir plus sur le déploiement de 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.

Structure des coûts par appel :

• Comparables : 25 tokens par requête
• Comparables avec Transactions : 65 tokens par requête

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.

Lorsque vous avez également besoin des prix de vente enregistrés, utilisez Comparables avec Transactions à 65 tokens par appel (serveur MCP https://platform.casafari.com/mcp/comparables-transactions). Ce service ajoute les prix de vente enregistrés de quatre pays : l'Espagne (actes notariés, Notariado), la France (DVF, le registre public des mutations), l'Italie (ventes enregistrées de l'Agenzia delle Entrate) et la Pologne (RCN, le registre officiel des prix immobiliers polonais). Chaque prix est clairement identifié par sa nature (prix demandé ou prix de vente enregistré) et sa source.

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.

Comprendre les évolutions du marché 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, analyser l'historique complet des prix demandés et des retraits du marché est essentiel 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 de 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 directes à 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 avant leurs rendez-vous vendeurs.

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