API REST CASAFARI : un cas d'usage concret par API, et quand préférer MCP
La plateforme CASAFARI propose sept API REST alimentées par un graphe de biens dédoublonné couvrant 16 pays (États-Unis : lancement en cours, certains États, immobilier commercial uniquement, via Claro AI). Elles permettent d’intégrer l’estimation immobilière, l’analyse de prix, la détection de vendeurs motivés par leurs baisses de prix et la recherche de biens directement dans vos applications ou serveurs. Un compte gratuit offre 1 000 tokens pendant 30 jours, sans carte bancaire, avec des résolutions de lieux gratuites. Choisissez REST pour un serveur en production et MCP pour un agent IA.
Sept API REST, une seule plateforme : de quoi parle-t-on ?
Imaginez deux projets menés en parallèle dans le même réseau de données. À Lyon, l’équipe produit d’un portail immobilier souhaite afficher la courbe historique du prix au m² sur chaque fiche d’annonce. En Île-de-France, un réseau d’agences cherche à alimenter son CRM chaque matin avec les biens dont le prix affiché a été baissé à plusieurs reprises autour de chaque agence. Ces deux cas d’usage reposent sur des produits distincts, mais ils consomment exactement le même compte, le même solde de tokens et le même graphe de biens CASAFARI.
Toutes les API REST de la plateforme partagent un socle unique : un graphe de biens dédoublonné et nettoyé, couvrant le résidentiel et le commercial, à la vente comme à la location. Chaque bien y figure sous la forme d’un enregistrement unique qui consigne l’historique de ses prix et de ses changements de statut. Pour savoir si votre secteur est disponible, vous pouvez consulter les pays couverts par les données CASAFARI. Si vous découvrez l’architecture des flux de données, un rappel préalable sur ce qu’est une API immobilière permet de mieux situer l’ensemble.
L’intégralité des sept API est documentée dans la référence des API REST sur developers.casafari.com (en anglais). Chaque section ci-dessous présente un cas d’usage concret parmi ceux publiés dans les cas d’usage publiés sur developers.casafari.com (en anglais).
Location Lookup : transformer « Lyon 3e » en identifiant de zone
Avant de demander une série temporelle de prix ou une liste de comparables, votre système doit traduire une saisie utilisateur en un identifiant de zone géographique reconnu par le graphe. C’est le rôle exclusif de Location Lookup.
Ce service est conçu pour alimenter un champ d’autocomplétion ou un formulaire de recherche. Lorsqu’un utilisateur tape « Lyon 3e », « Bruxelles » ou un code postal au Luxembourg, l’API renvoie l’identifiant de zone exact à transmettre aux autres API.
Chaque résolution de lieu via Location Lookup coûte 0 token. Vous pouvez donc exécuter cette requête à chaque frappe de clavier dans votre interface sans impacter votre consommation.
Sur le plan technique, Location Lookup renvoie aussi les lieux parents d’une zone, la liste de ses subdivisions et le lieu contenant un point donné, ce qui permet de descendre d’une ville à ses arrondissements.
Area Insights : la tendance du prix au m² d’une commune, prête à afficher
Pour afficher la tendance du marché sur la fiche descriptive d’un bien ou dans l’espace client d’une banque, l’API Area Insights fournit des séries temporelles de prix moyen et de prix au m² agrégées par zone.
En interrogeant la donnée d’Area Insights à partir de l’identifiant de zone obtenu lors de la résolution de lieu, votre serveur reçoit une série temporelle prête à alimenter un graphique interactif. Pour les proptechs spécialisées dans l’investissement, croiser les données de vente et de location permet d’afficher directement la tendance des rendements locatifs. Pour aller plus loin sur cet indicateur, consultez notre guide expliquant comment trouver le rendement locatif d’une zone.
Sur le plan architectural, il est vivement recommandé de mettre en cache les résultats par zone et par mois. La donnée de marché évolue au rythme des mises en ligne d’annonces et n’a pas besoin d’être recalculée à chaque affichage de page.
Pour en savoir plus sur l’interface produit, vous pouvez consulter la page dédiée à Insights de Zone ou lire la documentation d’Area Insights (en anglais).
Property Sourcing : une recherche de biens dans votre propre application
Si vous développez une application mobile pour investisseurs ou un outil de recherche interne, l’API Property Sourcing vous permet d’exécuter des requêtes multicritères sur l’ensemble du marché.
Contrairement aux portails classiques qui affichent des doublons dès qu’un bien est diffusé par plusieurs agences, Property Sourcing s’appuie sur le graphe de biens CASAFARI pour ne renvoyer que des entités uniques. Vous filtrez par zone, typologie, tranche de prix, prix au m², nombre de chambres et de salles de bains, surface et caractéristiques, puis triez les résultats.
Plutôt que de gérer des alertes instantanées complexes, une bonne pratique d’intégration consiste à programmer une requête périodique (polling) côté serveur pour récupérer les nouveaux biens correspondant aux critères enregistrés par vos utilisateurs. Vous pouvez découvrir une illustration concrète dans l’étude de cas d’une expérience immobilière mobile-first bâtie sur l’API, explorer la Recherche de Propriétés CASAFARI ou consulter la documentation de Property Sourcing (en anglais).
Seller Leads : repérer les biens dont le prix baisse à répétition
Pour alimenter quotidiennement le CRM d’un réseau d’agences, l’API Seller Leads (High Potential Seller Leads) renvoie, autour d’un point et dans un rayon de 50 à 300 mètres, les biens dont le prix affiché a été baissé à plusieurs reprises, avec le nombre de baisses, leur pourcentage cumulé et l’historique daté des prix. Elle couvre l’Espagne, la France, l’Italie, l’Allemagne, la Grèce et Andorre.
Un traitement batch nocturne interroge l’API autour de chaque agence du réseau. Le matin, les conseillers retrouvent dans leur outil de travail des opportunités qualifiées d’entrée de mandat.
L’API ne renvoie aucune coordonnée de propriétaire ; en France, la prospection directe de particuliers implique le respect des règles établies par la CNIL et le RGPD. Pour élargir vos sources de mandats, lisez notre article présentant trois façons de trouver les biens vendus par des particuliers et consultez la documentation de Seller Leads (en anglais).
Comparables : une estimation en ligne adossée à de vrais comparables
Lorsqu’un réseau bancaire ou une enseigne immobilière propose un outil d’estimation en ligne, fournir un simple prix moyen au m² ne suffit pas. L’API Comparables permet d’adosser l’estimation d’un bien à un échantillon précis de biens similaires récemment vendus ou actuellement sur le marché.
En envoyant les caractéristiques du bien étudié (typologie, surface, nombre de pièces, localisation issue de Location Lookup), votre application reçoit trois prix estimés (vente rapide, prix de marché, prix hors marché), des statistiques de marché et la liste détaillée des comparables sélectionnés. Pour comprendre les règles d’ajustement appliquées par l’algorithme, référez-vous à l’article expliquant comment la valeur estimée est calculée.
Cette API est idéale pour renforcer le parcours d’octroi de crédit ou pour générer des prospects qualifiés. Découvrez l’offre complète sur la page consacrée aux évaluations immobilières et l’étude de marché CASAFARI ainsi que la documentation de Comparables (en anglais).
Claro : des locaux commerciaux en Espagne et en Allemagne
Pour les enseignes de commerce et les spécialistes de l’immobilier d’entreprise qui développent leur implantation en Europe, l’API Claro offre un accès ciblé au marché commercial.
Le périmètre géographique de Claro couvre exclusivement les locaux commerciaux en Espagne et en Allemagne, ainsi que les terrains commerciaux en Allemagne. Une enseigne française souhaitant ouvrir des points de vente à Madrid ou Munich peut ainsi automatiser sa sélection de locaux directement depuis ses outils internes.
Consultez l’étude de cas sur les données immobilières au service de l’expansion internationale pour voir des applications concrètes, ainsi que la documentation de Claro (en anglais) et les cas d’usage de Claro (en anglais).
Account : suivre vos tokens et votre forfait depuis votre code
L’API Account assure la gestion administrative de votre intégration. Elle permet de suivre par programmation l’état de votre abonnement et le solde de tokens disponibles sur votre compte.
Les appels de données consomment des tokens d’usage, qu’il convient de ne pas confondre avec les tokens d’accès OAuth utilisés pour authentifier vos requêtes HTTP. L’intégration de l’API Account dans vos outils de monitoring internes permet d’alerter vos équipes d’ingénierie avant d’épuiser vos tokens ou d’atteindre une fenêtre d’usage de votre forfait.
REST ou MCP : lequel choisir pour votre projet ?
Le choix entre l’API REST et le protocole MCP (Model Context Protocol) dépend uniquement de la nature de l’appelant, car les deux canaux reposent sur le même graphe de biens, le même compte et le même solde de tokens.
Optez pour l’API REST dès lors que le système appelant est un serveur automatisé : un backend d’application, un batch nocturne, un widget public sur un portail ou une synchronisation CRM. L’authentification s’effectue au moyen de clés d’API sécurisées d’un serveur à un autre.
Choisissez MCP si la donnée doit être interrogée par un agent d’intelligence artificielle ou directement par un utilisateur humain évoluant dans un environnement comme Claude, ChatGPT, Cursor ou VS Code. CASAFARI propose un serveur MCP par produit (locations, area-insights, comparables, agentgraph, claro) accessible via des flux HTTP (Streamable HTTP). La connexion s’établit par OAuth 2.1 directement dans le navigateur, sans aucune clé d’API à manipuler manuellement. Pour explorer ce mode d’accès, visitez la page dédiée à CASAFARI MCP, les données immobilières pour les agents IA, consultez la page de parité entre REST et MCP (en anglais) et suivez le guide de connexion aux serveurs Casafari MCP (en anglais). Le dépôt GitHub casafari-mcp (en anglais) regroupe par ailleurs un plugin Claude Code, une extension Gemini CLI, des exemples de code et les rapports d’exemple rédigés par Claude avec Claro.
Combien coûtent ces appels ?
Les conditions tarifaires s’appliquent de manière identique quel que soit le canal de connexion utilisé (REST ou MCP). La grille officielle d’octobre 2026 s’articule autour de trois niveaux de forfaits :
- Free : 1 000 tokens offerts pendant 30 jours lors de la création du compte, sans carte bancaire.
- Agent : 49 € par mois en facturation annuelle, ou 70 € par mois en facturation mensuelle (tarifs hors TVA).
- Custom : contrat sur mesure adapté aux très grands volumes d’interrogation.
Des crédits prépayés sont rechargeables à tout moment pour couvrir les dépassements ponctuels. Les détails de consommation par opération sont disponibles dans la FAQ des forfaits et des tokens (en anglais).
Par où commencer dès aujourd’hui
Pour démarrer votre intégration, la démarche se déroule en trois étapes simples :
- Activez votre accès en allant créer un compte sur la plateforme CASAFARI, ou rendez-vous sur la page pour se connecter à la plateforme CASAFARI si vous en avez déjà un, afin de bénéficier immédiatement du forfait Free.
- Parcourez la documentation technique et découvrez les cas d’usage publiés sur developers.casafari.com (en anglais).
- Retrouvez l’ensemble des caractéristiques sur la page produit des API de données immobilières CASAFARI.
Que vous construisiez la nouvelle fonction d’analyse d’un portail lyonnais ou le flux de prospection d’un réseau francilien, un seul compte suffit pour orchestrer l’ensemble de vos flux de données immobilières.
Questions fréquentes
Quelle API CASAFARI utiliser pour afficher une estimation immobilière sur mon site ?
Il convient d’utiliser l’API Comparables, en ayant au préalable résolu la localisation avec Location Lookup. En transmettant la typologie, la surface, l’état et le secteur du bien, vous recevez trois prix estimés (vente rapide, prix de marché, prix hors marché) ainsi que la liste des biens comparables qui motivent cette évaluation. Pour une mise en œuvre sans développement, vous pouvez consulter la page dédiée aux évaluations immobilières et études de marché.
Comment obtenir le prix au m² d’une commune ou d’un arrondissement par API ?
L’API Area Insights fournit la série temporelle du prix au m² pour n’importe quel secteur après résolution de son identifiant de zone via Location Lookup. L’appel à Location Lookup coûte 0 token, et les résultats d’Area Insights gagnent à être mis en cache mensuellement côté serveur. Ce service permet également de calculer le rendement locatif brut en combinant les données de vente et de location sur la même zone.
Existe-t-il une API pour repérer les biens dont le prix a baissé plusieurs fois ?
L’API Seller Leads est spécialement conçue pour cet usage. Elle renvoie, dans un rayon de 50 à 300 mètres autour d’un point, les biens dont le prix affiché a été baissé à plusieurs reprises, en Espagne, en France, en Italie, en Allemagne, en Grèce et en Andorre, sans aucune coordonnée de propriétaire. L’intégration s’effectue généralement par des requêtes régulières programmées côté serveur afin de mettre à jour votre CRM, dans le respect de la réglementation CNIL et du RGPD.
REST ou MCP : lequel choisir pour connecter un agent IA aux données immobilières ?
Le choix dépend du client qui effectue la requête : utilisez MCP si l’appel émane d’un agent IA ou d’un utilisateur dans Claude, ChatGPT, Cursor ou VS Code, grâce au mécanisme d’authentification OAuth 2.1 sans clé à copier. Privilégiez l’API REST pour les liaisons de serveur à serveur, comme un widget web, un batch nocturne ou un flux CRM. Dans les deux cas, les appels consomment le même compte et le même solde de tokens.
Combien coûte l’API CASAFARI et peut-on l’essayer gratuitement ?
Un forfait Free donne accès à 1 000 tokens pendant 30 jours sans carte bancaire dès la création de votre compte sur la plateforme. Selon les tarifs applicables en octobre 2026, le forfait Agent est proposé à 49 € par mois en engagement annuel ou 70 € par mois sans engagement (hors TVA), complété par des recharges de crédits prépayés pour les besoins volumétriques supérieurs. Les résolutions de lieux via Location Lookup restent gratuites.