# Immo API > API REST pour accéder aux données officielles de transactions immobilières DVF (Demandes de Valeurs Foncières) en France. Immo API est une API commerciale qui structure les données ouvertes DVF publiées par la Direction Générale des Finances Publiques (DGFiP). Elle permet aux développeurs, data scientists et professionnels de l'immobilier d'interroger les transactions immobilières en France via des endpoints REST simples. ## Qu'est-ce que le DVF ? Le DVF (Demandes de Valeurs Foncières) est un jeu de données ouvertes publié par la DGFiP. Il recense l'ensemble des transactions immobilières (ventes de biens) en France métropolitaine et dans les DOM-TOM (hors Alsace-Moselle et Mayotte) depuis 2014. Les données incluent le prix de vente, la localisation, le type de bien, la surface, le nombre de pièces et la date de transaction. Les données sont mises à jour deux fois par an (avril et octobre). ## À qui s'adresse Immo API ? - **Développeurs** : intégrez les données DVF dans vos applications via une API REST standard avec réponses JSON - **Data scientists** : analysez les tendances du marché immobilier français avec des données structurées et des statistiques agrégées - **Professionnels de l'immobilier** : accédez aux prix de vente réels pour estimer la valeur des biens, comparer les quartiers et suivre l'évolution du marché - **Startups proptech** : construisez des outils d'estimation, des comparateurs, des tableaux de bord immobiliers ## Endpoints ### POST /api/mcp Serveur MCP natif pour agents IA, expose via transport HTTP JSON-RPC. Authentification avec la meme cle API que l'API REST : ``` Authorization: Bearer YOUR_API_KEY MCP-Protocol-Version: 2025-11-25 ``` Installation Claude Code : ``` claude mcp add --transport http immoapi https://immoapi.app/api/mcp --header "Authorization: Bearer YOUR_API_KEY" ``` Compatibilite : remote MCP server stateless en Streamable HTTP. Les requetes GET avec `Accept: text/event-stream` retournent 405 car le serveur n'ouvre pas de canal SSE serveur-vers-client. Les appels tools passent par POST JSON-RPC. Tools disponibles : - `search_mutations` : rechercher des transactions DVF par commune, code postal, annee, type de bien et fourchette de prix - `search_nearby_mutations` : trouver des ventes comparables autour de coordonnees GPS ou d'un code postal - `get_market_stats` : calculer les statistiques de marche DVF Rate limit MCP : 60 requetes par minute par cle API. Les headers `X-RateLimit-Remaining` et `X-RateLimit-Reset` indiquent la consommation. ### GET /v1/mutations Rechercher des transactions immobilières (mutations) dans la base DVF. Filtrez par commune (code INSEE), département, type de bien (Appartement, Maison, Local industriel, Dépendance), fourchette de prix, fourchette de surface et période (année). Pagination incluse avec paramètres `page` et `per_page` (max 100 résultats par page). Chaque mutation retournée inclut : identifiant unique, date de mutation, nature (Vente), valeur foncière en euros, adresse complète, code postal, commune, département, type de local, surface réelle bâtie en m², nombre de pièces, surface terrain, prix au m² calculé, coordonnées GPS (longitude, latitude). ### GET /v1/mutations/nearby Rechercher des transactions immobilières à proximité d'un point géographique (latitude/longitude). Idéal pour trouver des comparables dans un quartier. Paramètres requis : `lat` (latitude) et `lng` (longitude). Paramètre optionnel : `radius` (rayon en mètres, défaut 1000, max 5000). Filtrage additionnel par type de bien et année. Chaque résultat inclut un champ `distance_m` indiquant la distance en mètres par rapport au point central. ### GET /v1/stats Obtenir des statistiques agrégées sur les transactions immobilières : prix médian et moyen au m², volume de transactions, évolution annuelle, répartition par nombre de pièces, prix au m² par trimestre. Filtrez par commune (code INSEE), département, région, année et type de bien. ## Authentification Toutes les requêtes doivent inclure un header `Authorization` avec votre clé API au format Bearer token : ``` Authorization: Bearer YOUR_API_KEY ``` ## Limites de requêtes - Plan Starter : 1 000 requêtes par jour - Plan Pro : requêtes illimitées Les headers de réponse incluent `X-RateLimit-Remaining` et `X-RateLimit-Reset` pour suivre votre consommation. En cas de dépassement, l'API retourne un code HTTP 429. ## Tarifs - **Starter** : 29 €/mois — 1 000 requêtes/jour, tous les endpoints, données DVF officielles, mises à jour semestrielles, support par email, 2 jours d'essai gratuit - **Pro** : 49 €/mois — requêtes illimitées, tous les endpoints, données DVF officielles, mises à jour semestrielles, support prioritaire, webhooks, 2 jours d'essai gratuit Les deux plans sont sans engagement. Paiement par carte bancaire (Visa, Mastercard) ou virement SEPA pour les paiements annuels. ## Codes d'erreur - 400 Bad Request : paramètres invalides ou manquants - 401 Unauthorized : clé API manquante ou invalide - 429 Too Many Requests : limite de requêtes atteinte - 500 Internal Server Error : erreur serveur ## Couverture géographique L'API couvre la France métropolitaine et les DOM-TOM, à l'exception de l'Alsace-Moselle (départements 57, 67, 68) et de Mayotte (976) qui ne sont pas inclus dans le fichier DVF en raison de leur régime foncier spécifique (droit local alsacien-mosellan et cadastre non numérisé). ## Données disponibles Les transactions immobilières depuis 2014 sont disponibles. Les types de biens couverts sont : Appartement, Maison, Local industriel et commercial, Dépendance. Pour chaque transaction : date, prix, adresse, surface, nombre de pièces, coordonnées GPS, prix au m² calculé. ## Format des réponses Toutes les réponses sont au format JSON. Les listes de résultats incluent des informations de pagination (`total`, `page`, `per_page`). Les statistiques incluent des agrégats calculés (médiane, moyenne, évolution). ## Liens - Site web : https://immoapi.app - Documentation : https://immoapi.app/documentation - Documentation MCP : https://immoapi.app/documentation/mcp - Tarifs : https://immoapi.app/tarifs - Blog : https://immoapi.app/blog - Guide comparatif API DVF : https://immoapi.app/guide/api-dvf-comparatif - Contact : info@immoapi.app