République
Française
Documentation Datafoncier
Toutes les ressources sur les données foncières
République
Française
Documentation Datafoncier
Toutes les ressources sur les données foncières
Formats de données proposés
Depuis 2025, la base DV3F est proposée, sous une forme allégée, au format CSV.
⚠️ Ce format ne restitue que la table des mutations (1 ligne = 1 transaction) avec les informations principales issues de cette table.
Ce format est particulièrement adapté à des usages simples ou exploratoires :
- 🧭 Nouveau sur le portail ? Suivez le parcours guidé pour créer un compte "bénéficiaire"
- 👤 Déjà inscrit ? Connectez-vous à votre espace
- Cliquez sur le bouton "Télécharger une donnée"
- Indiquez la donnée souhaitée (DV3F simplifiée)
- Précisez le format CSV et le périmètre géographique
- Une invitation Box.com vous parviendra sous 24 à 48h
- Connectez-vous à l’espace sécurisé pour récupérer le fichier compressé (.zip ou .7z)
Selon le volume de données demandé, vous recevrez :
MUTATION_AAAA_V_CSV_NNNN_EDAA1.zip
(pour des jeux de données de taille modérée)MUTATION_AAAA_V_CSV_NNNN_EDAA1_part.7z.001, .002, etc.Une fois l’archive décompressée (voir Etape 1 ci-après), vous obtenez trois dossiers :
🔹 1_DONNEES_LIVRAISON → contient le ou les fichiers de données mutation.csv
🔹 4_METADONNEES_LIVRAISON → contient le fichier de métadonnées et les documents juridiques (acte d'engagement, CGU)
🔹 5_SUPPLEMENTS_LIVRAISON → généralement vide (réservé à des compléments éventuels)
Utilisez un outil de décompression adapté :
.zip : extraire les données à partir d'un outil natif (Windows, macOS, Linux).7z : extraire les données à partir d'outils libres comme 7-Zip ou PeaZip → voir tutoriel 7-zip⚠️ Pour les fichiers découpés (.7z.001), commencez toujours la décompression à partir du fichier numéro 1 en s'assurant que tous les fichiers numérotées sont présents dans le même dossier.
mutation.csv dans LibreOffice Calc, Excel ou un éditeur de texte type Notepad++| (touche AltGr + 6 du clavier)
Un tutoriel pour ouvrir les fichiers csv est disponible sur guides.data.gouv.fr
pandas.read_csv() (Python) ou readr::read_csv2() (R) avec :
- l'encodage
UTF-8- le séparateur
|- une lecture prudente des types de colonnes (
dtypeen Python)
Le fichier csv correspond aux données de la table mutation de DV3F, qui permet de faire une large partie des analyses sur les marchés fonciers ou immobiliers.
Dans ce fichier, chaque ligne correspond aux informations liées à une transaction. Les colonnes proposées sont une sélection des principales variables de cette table dont les descriptions détaillées sont accessibles à partir du dictionnaire de la table
Pour plus de détails sur l'utilisation de la table mutation, n'hésitez pas à consulter le guide DV3F.
| Nom | Description |
|---|---|
| idmutation | identifiant de clef primaire de la table mutation |
| idmutinvar | identifiant invariant de la mutation |
| datemut | date de signature du document (acte de vente) |
| anneemut | annee de signature du document |
| libnatmut | libellé de la nature de mutation |
| vefa | vrai si la mutation est une Vente en l'état futur d'achèvement (VEFA) |
| valeurfonc | prix ou évaluation déclarée dans le cadre d'une mutation onéreuse |
| nbcomm | nombre de communes concernées par la mutation |
| l_codinsee | liste des codes INSEE des communes concernées par la mutation |
| nbpar | nombre de parcelles concernées par la mutation |
| l_idpar | liste des identifiants de parcelles concernées par la mutation (idpar) |
| nbparmut | nombre de parcelles ayant muté |
| l_idparmut | liste des identifiants de parcelles ayant muté (idpar) |
| sterr | surface de terrain ayant muté |
| nbvolmut | nombre de volumes ayant muté |
| nblocmut | nombre de locaux ayant muté |
| nblocmai | nombre de maisons ayant muté |
| nblocapt | nombre d'appartements ayant muté |
| nblocact | nombre de locaux d'activité ayant muté |
| nblocdep | nombre de dépendances ayant muté |
| l_idlocmut | liste des identifiants de locaux ayant muté (idloc) |
| sbati | surface de l'ensemble du bâti ayant muté |
| sbatmai | surface de l'ensemble des maisons ayant muté |
| sbatapt | surface de l'ensemble des appartements ayant muté |
| l_nomv | noms des vendeurs (anonymisés pour les personnes physiques) |
| codtypprov | code de typologie de propriétaire pour les vendeurs (typologie Cerema) |
| l_noma | noms des acheteurs (anonymisés pour les personnes physiques) |
| codtypproa | code de typologie de propriétaire pour les acheteurs (typologie Cerema) |
| fftypact | catégorie d'activité dominante des locaux professionnels |
| ffnbloch | nombre de locaux habitées |
| ffnblogsoc | nombre de logements sociaux (repérés par exonération) |
| nblocanc | nombre de locaux anciens (année construction >= 5 ans) |
| nblocrecen | nombre de locaux récents (1< année construction < 5 ans) |
| nblocneuf | nombre de locaux neufs (<= 1 an) |
| periodecst | période de construction dominante des locaux ayant muté |
| codtypbien | code de la typologie des biens du GnDVF |
| libtypbien | libellé de la typologie des biens du GnDVF |
| filtre | code alphanumerique permettant d'exclure des mutations particulières pour l'analyse |
| devenir | indicateur de changement de typologie ou d'usage des biens vendus après la vente |
| segmtab | indicateur du segment des terrains à bâtir |
| geompar_x | coordonnée X d'un centroide des parcelles concernées par la mutation |
| geompar_y | coordonnée Y d'un centroide des parcelles concernées par la mutation |
Pour toute difficulté, vous pouvez contacter l’équipe Datafoncier
