L'API DVF pour les transactions immobilières en France

data.gouv.fr publie les fichiers des Demandes de valeurs foncières, produits par la DGFiP. Le site référence aussi la fiche API données foncières, portée par le Cerema avec la Direction générale de l'aménagement, du logement et de la nature (DGALN).

D'après cette fiche, les flux ouverts donnent accès aux transactions issues du DVF et à des indicateurs de territoires (prix de l'immobilier, consommation d'espace). DVF+ (mutations et géomutations pour une commune ou une emprise) et les indicateurs agrégés y sont indiqués en accès libre. Les fichiers fonciers et DV3F y sont indiqués en accès restreint, pour des bénéficiaires publics. La fiche présente cette API comme une version bêta.

Immo API est un service distinct, décrit dans la documentation : endpoints REST et serveur MCP, avec une clé API. Le fichier source est présenté dans qu'est-ce que le DVF. Le parcours carte est décrit dans le mode d'emploi de l'app DVF Etalab, et les alternatives à l'API DVF Etalab sont comparées à part.

GET /api/mutations renvoie un objet JSON avec count, limit, offset et data. Chaque élément documenté de data contient id_mutation, date_mutation, nature_mutation, valeur_fonciere, adresse_nom_voie, code_postal, code_commune, commune, code_departement, type_local, surface_reelle_bati, nombre_pieces_principales, longitude et latitude.

GET /api/mutations/nearby ajoute count, radius_km et center (lat, lng). L'exemple documenté inclut aussi distance_km, avec date_mutation, valeur_fonciere, commune, code_postal, type_local, surface_reelle_bati, longitude et latitude.

GET /api/stats renvoie total_mutations, prix_moyen, prix_median, prix_p25, prix_p75, prix_min, prix_max, prix_m2_median et surface_moyenne. La liste de référence est la documentation.

GET /api/mutations accepte notamment les paramètres documentés commune et code_postal. commune fait une recherche souple sur le nom. code_postal prend une valeur comme 75001. L'exemple ci-dessous est copié de la documentation. Le guide développeur de l'API DVF détaille l'intégration.

curl "https://immoapi.app/api/mutations?commune=Paris&type_local=Appartement&annee=2024&prix_min=200000&prix_max=600000" \
  -H "Authorization: Bearer YOUR_API_KEY"

Pour un code postal, le même endpoint accepte le paramètre code_postal, avec le header Authorization Bearer documenté (le header x-api-key est aussi accepté).

Oui, avec GET /api/mutations/nearby. La documentation décrit une recherche autour d'une latitude et d'une longitude, ou à partir d'un code postal qui sert à calculer un centre. Le paramètre radius est en kilomètres (défaut 5, minimum 0.1, maximum 50). Ce n'est pas une recherche par libellé de voie : il faut des coordonnées ou un code postal. L'exemple ci-dessous est copié de la documentation.

curl "https://immoapi.app/api/mutations/nearby?lat=48.8566&lng=2.3522&radius=1&type_local=Appartement" \
  -H "Authorization: Bearer YOUR_API_KEY"

La réponse documentée inclut radius_km, center et distance_km. Pour relier une parcelle à un prix de vente, voir DVF et cadastre : le prix de vente d'une parcelle.

Les formules affichées sur cette page et sur la page tarifs sont Starter à 29€ par mois (1 000 requêtes par jour, tous les endpoints, données DVF officielles) et Pro à 49€ par mois (requêtes illimitées, tous les endpoints, support prioritaire, webhooks). Chaque formule inclut 2 jours d'essai gratuit, sans engagement. Aucune formule gratuite permanente n'est listée. Le détail est sur la page tarifs.

Le serveur MCP est exposé sur /api/mcp, en HTTP JSON-RPC, avec la même clé que le REST (Authorization Bearer ou header x-api-key). Les outils documentés sont search_mutations, search_nearby_mutations et get_market_stats. La documentation cite Claude Code, Cursor, VS Code et les bridges mcp-remote. Les appels MCP ont un plafond documenté de 60 requêtes par minute et par clé.

Commande d'installation Claude Code, copiée de la documentation :

claude mcp add --transport http immoapi \
  https://immoapi.app/api/mcp \
  --header "Authorization: Bearer YOUR_API_KEY"

Les schémas de paramètres et les exemples JSON-RPC sont dans la documentation MCP.