
Réponse courte : le cadastre identifie une parcelle (commune, section, numéro) mais n'affiche aucun prix de vente. Le DVF, lui, recense les mutations à titre onéreux enregistrées par la DGFiP. Dans sa version géolocalisée, chaque ligne peut porter un identifiant de parcelle (id_parcelle, 14 caractères) et, souvent, des coordonnées. Pour relier une vente à une parcelle, on lit cet identifiant, on cherche les lignes DVF qui le portent, puis on lit la valeur_fonciere de la mutation (un montant global si plusieurs parcelles partagent le même id_mutation). Une API DVF ne filtre pas sur id_parcelle : on interroge une commune, un code postal ou un voisinage GPS, puis on compare ce champ dans la réponse JSON.
La requête « dvf cadastre » mélange deux fichiers publics qu'il ne faut pas confondre. L'un décrit le sol. L'autre décrit des ventes. Les relier sert aussi bien à vérifier le prix d'un terrain qu'à alimenter un outil d'estimation, un CRM ou un agent. Ce guide 2026 reste sur ce pont technique : comment passer d'une parcelle à une mutation, quelles limites garder en tête, et comment le faire de façon répétable avec une API.
Le lien entre DVF et le cadastre
Le DVF, détaillé dans qu'est-ce que le DVF, liste les mutations à titre onéreux de la direction générale des Finances publiques : date, nature, valeur foncière, type de local, surface et adresse. Le cadastre décrit le sol (communes, sections, parcelles, contours). Consulté seul, sur cadastre.gouv.fr ou cadastre.data.gouv.fr, il ne contient pas le prix de la vente.
Le pont est l'identifiant de parcelle. Dans les DVF géolocalisées publiées à partir des fichiers DGFiP (jeux « geo-dvf » sur data.gouv.fr), chaque ligne est rapprochée du plan cadastral Etalab. Si la jointure aboutit, le fichier ajoute l'identifiant actuel, sur 14 caractères, et le centre de la parcelle en longitude et latitude (WGS 84). Une parcelle renumérotée conserve souvent son ancien identifiant dans ancien_id_parcelle.
Une mutation peut concerner plusieurs parcelles ou plusieurs lots. La même valeur foncière est alors répétée sur chaque ligne qui partage le même id_mutation. Ce montant est celui de la vente entière, pas un prix découpé par parcelle. L'attribuer à une seule parcelle, ou le diviser par la surface d'un seul lot, fausse le diagnostic.
Immo API importe ces CSV géolocalisés. La table conserve id_parcelle et ancien_id_parcelle. GET /api/mutations exécute un SELECT * : la ligne complète, donc l'identifiant de parcelle, revient dans le JSON dès que le fichier source le contient, avec l'adresse, le code commune, le code postal et les coordonnées. GET /api/mutations/nearby fait de même, et ajoute distance_km. L'exemple de la documentation omet parfois id_parcelle pour rester lisible, mais le champ est bien présent dans la réponse. En revanche, aucun paramètre HTTP ne filtre la requête sur cet identifiant.
Le numéro de parcelle cadastrale
L'identifiant du cadastre Etalab, repris par les DVF géolocalisées, tient sur 14 caractères. La fiche du localisant de parcelle sur data.gouv.fr, alignée sur le plan de cadastre.data.gouv.fr, le décrit comme quatre blocs collés, sans séparateur :
- code commune INSEE, 5 caractères ;
- préfixe de section, 3 caractères ;
- section, 2 caractères ;
- numéro de parcelle, 4 caractères.
Le préfixe vaut 000 pour une commune non absorbée, ou pour la commune absorbante d'une fusion. Pour une commune absorbée, ce sont en général les trois derniers chiffres de son ancien code INSEE. Une section d'une seule lettre prend un zéro devant : A devient 0A. Le numéro est complété par des zéros à gauche.
Exemple de format, et non un prix ni une vente réelle : 94068000CQ0110 se lit commune 94068, préfixe 000, section CQ, numéro 0110. Le code postal ne remplace pas ce code commune : une commune peut avoir plusieurs codes postaux, et un code postal peut couvrir plusieurs communes. On retrouve l'identifiant sur cadastre.data.gouv.fr, cadastre.gouv.fr, un avis de taxe foncière ou un acte. Dans l'app DVF Etalab, on descend du département à la commune, puis à la section, avant le clic sur la parcelle.
Deux pièges reviennent souvent. Le premier est de chercher une parcelle avec un code postal à la place du code INSEE. Le second est d'oublier le préfixe après une fusion de communes : l'identifiant visible aujourd'hui n'est pas toujours celui porté par une vente plus ancienne. Dans ce cas, ancien_id_parcelle mérite d'être testé en plus de id_parcelle.
Retrouver le prix de vente d'une parcelle
- Repérer la parcelle par l'adresse, le plan cadastral ou l'acte.
- Lire les 14 caractères : code commune, préfixe, section, numéro.
- Chercher les mutations dans l'app DVF, les fichiers géolocalisés ou l'API.
- Lire la valeur foncière de la mutation. Si plusieurs lignes partagent le même
id_mutation, le prix est global.
Sur app.dvf.etalab.gouv.fr, le clic sur une parcelle bleue affiche la date, la valeur foncière et la nature de la vente. Le parcours visuel (département, commune, section, parcelle) est détaillé dans le mode d'emploi de l'app DVF Etalab. C'est l'outil le plus simple pour vérifier deux ou trois biens à la main. Il ne permet pas d'exporter ni de filtrer une liste de parcelles.
Pour travailler en volume, le jeu « Demandes de valeurs foncières géolocalisées » fournit id_parcelle et valeur_fonciere. Il faut télécharger les CSV, les charger, puis filtrer. La méthode est décrite dans comment obtenir les données de transactions immobilières. Si l'objectif est plutôt de lister toutes les ventes d'une ville, sans viser une parcelle précise, partez de DVF par commune.
| Besoin | Cadastre seul | App DVF Etalab | Fichiers geo-DVF | API DVF |
|---|---|---|---|---|
| Voir le contour d'une parcelle | Oui | Oui (plan) | Non (identifiant) | Non (identifiant et coordonnées si jointure) |
| Lire un prix de vente | Non | Oui, clic par clic | Oui | Oui, après filtre |
| Relier vente et parcelle | Non | Oui à l'écran | id_parcelle | Champ id_parcelle dans le JSON |
| Automatiser le rapprochement | Non | Non | Script local | Requête HTTP, puis filtre côté client |
Limites à connaître avant d'attribuer un prix à une parcelle
Toutes les ventes ne sont pas publiées. Le DVF ne contient que des mutations à titre onéreux connues de la DGFiP. Une donation, une succession ou une vente trop récente peut manquer. Les fichiers sont actualisés deux fois par an, en avril (ventes jusqu'à fin décembre de l'année précédente) et en octobre (ventes jusqu'à fin juin de l'année en cours). Le rythme est récapitulé dans le calendrier des mises à jour DVF.
Une jointure cadastrale ratée, ou une section renommée après une fusion de communes, laisse parfois la vente dans le fichier brut sans l'afficher sur la carte. L'inverse existe aussi : l'identifiant peut être renseigné alors que la latitude et la longitude manquent, si la géométrie est absente, erronée, ou si la parcelle est passée dans le domaine public. Une recherche par voisinage GPS ignore alors cette ligne, alors qu'une recherche par commune la renverra encore.
L'Alsace, la Moselle et Mayotte sont absentes du DVF. Dans le Bas-Rhin, le Haut-Rhin et la Moselle, les mutations relèvent du livre foncier, comme le détaille l'article sur le DVF en Alsace-Moselle. Aucune API bâtie sur les fichiers DGFiP ne peut inventer ces ventes.
Quand une mutation touche plusieurs parcelles, la valeur foncière est globale. L'attribuer à une seule parcelle surévalue cette parcelle. Il faut regrouper les lignes par id_mutation avant de lire le prix, et ne pas calculer un prix au m² sur un seul lot si la vente en compte plusieurs. Le même principe vaut pour un immeuble vendu avec des dépendances : le montant unique ne se découpe pas tout seul.
Interroger DVF avec l'API, puis relier la réponse à une parcelle
On ne filtre pas sur id_parcelle. Les paramètres lus par GET /api/mutations sont commune, code_postal, annee, type_local, prix_min, prix_max, limit et offset. Il n'existe pas de paramètre departement, ni de filtre sur le nom de voie. La stratégie est donc : interroger une zone assez étroite, puis comparer l'identifiant (ou, à défaut, l'adresse) dans la réponse.
L'authentification se fait avec une clé qui commence par dvf_live_, passée dans l'en-tête x-api-key ou dans Authorization: Bearer. Le détail du contrat HTTP est dans la documentation de l'API.
Par code postal ou par commune, GET /api/mutations accepte aussi le type de local, l'année et une fourchette de valeur foncière. limit vaut 100 par défaut, avec un maximum de 1 000. offset sert à paginer. Cette route ne force pas nature_mutation à « Vente » : elle renvoie les lignes qui correspondent aux filtres, triées par date décroissante.
curl "https://immoapi.app/api/mutations?code_postal=75001&type_local=Maison&limit=20" -H "x-api-key: VOTRE_CLE_API"
Par coordonnées, GET /api/mutations/nearby prend une latitude, une longitude et un rayon en kilomètres (radius, défaut 5, plancher 0,1, plafond 50). On peut aussi lui donner un code_postal à la place du couple lat/lng : le centre est alors la moyenne des coordonnées disponibles pour ce code. Cette route ne garde que les lignes dont nature_mutation vaut « Vente », dont valeur_fonciere est supérieure à 0, et dont les coordonnées ne sont pas nulles. Elle ajoute distance_km.
curl "https://immoapi.app/api/mutations/nearby?lat=48.8566&lng=2.3522&radius=1" -H "Authorization: Bearer VOTRE_CLE_API"
Il n'y a pas de paramètre « nom de voie ». La réponse contient adresse_nom_voie, le code postal et le code commune : on filtre la voie ensuite, ou l'on part des coordonnées du centre de parcelle. Pour un prix médian à l'échelle d'une commune ou d'un code postal, GET /api/stats calcule des agrégats (dont prix_median et prix_m2_median) après déduplication par id_mutation. Ces statistiques ne descendent pas à la parcelle. Le serveur MCP (POST /api/mcp) reprend les mêmes recherches pour un agent, et le guide développeur montre comment enchaîner les appels. Un prix au m² par rue se calcule sur des mutations déjà dédupliquées.
Forme de réponse, calquée sur l'exemple de la documentation et complétée du champ de parcelle. Ces valeurs illustrent les champs. Elles ne décrivent pas une vente réelle.
{
"id_mutation": "2024-1292937",
"date_mutation": "2024-03-15",
"nature_mutation": "Vente",
"valeur_fonciere": "485000.00",
"adresse_nom_voie": "RUE DE RIVOLI",
"code_postal": "75001",
"code_commune": "75101",
"id_parcelle": "75101000AB0123",
"ancien_id_parcelle": null,
"longitude": "2.3488",
"latitude": "48.8566"
}
75101000AB0123 se lit ainsi : commune 75101, préfixe 000, section AB, numéro 0123. Côté client, on ne garde que les lignes dont id_parcelle (ou, si besoin, ancien_id_parcelle) correspond à celui du plan, puis on regroupe par id_mutation avant de lire valeur_fonciere.
const cible = "75101000AB0123";
const lignes = body.data.filter(function (row) {
return row.id_parcelle === cible || row.ancien_id_parcelle === cible;
});
const parMutation = {};
lignes.forEach(function (row) {
parMutation[row.id_mutation] = row.valeur_fonciere;
});
Côté offre, relue le 8 novembre 2026 sur la page tarifs : plan Starter à 29 € par mois pour 1 000 requêtes par jour, plan Pro à 49 € par mois en requêtes illimitées, essai de 2 jours sur les plans. Les mises à jour suivent le rythme semestriel des fichiers DVF. L'API s'appuie sur les jeux officiels, avec les mêmes absences territoriales (Alsace, Moselle, Mayotte).
FAQ : DVF et cadastre
Comment relier une vente DVF à une parcelle cadastrale ?
Relevez le numéro à 14 caractères, puis cherchez les mutations qui portent cet id_parcelle (app DVF, fichier géolocalisé ou API). Le prix est la valeur foncière, après regroupement des lignes de même id_mutation. Si la parcelle a été renumérotée, testez aussi ancien_id_parcelle.
Le cadastre indique-t-il le prix de vente ?
Non. Le cadastre identifie la parcelle, sa section et sa commune. Le montant de la vente est dans le DVF, relié par l'identifiant cadastral et, si la jointure a réussi, par des coordonnées.
Comment trouver le numéro de parcelle cadastrale ?
Il assemble le code commune INSEE (5 caractères), le préfixe (3), la section (2) et le numéro (4). On le lit sur cadastre.data.gouv.fr, sur cadastre.gouv.fr, sur un avis de taxe foncière ou un acte, ou dans l'app DVF en ouvrant la section puis la parcelle.
Peut-on filtrer une API DVF directement sur id_parcelle ?
Pas avec les paramètres actuels. GET /api/mutations filtre par commune, code postal, type de local, année et prix. GET /api/mutations/nearby part d'un point GPS ou d'un code postal et d'un rayon en kilomètres. La réponse inclut id_parcelle, que l'on compare ensuite côté client. L'authentification se fait par x-api-key ou par Bearer, avec une clé préfixée dvf_live_.
Les ventes DVF sont-elles toutes géolocalisées ?
Non. Les coordonnées viennent de la jointure entre l'identifiant de parcelle et le cadastre Etalab. Elles manquent si la géométrie est absente ou si la parcelle est sortie du plan diffusé. L'identifiant peut tout de même être renseigné : une recherche par commune le verra, une recherche par rayon GPS non.
App DVF, fichiers ou API : que choisir pour une parcelle ?
L'app DVF Etalab suffit pour vérifier quelques parcelles à la main. Les fichiers géolocalisés conviennent si vous construisez votre propre base. Une API devient utile dès qu'il faut répéter la recherche, la croiser avec d'autres filtres (année, type de local, voisinage) ou l'intégrer dans un logiciel. Dans les trois cas, le raisonnement est le même : identifiant à 14 caractères, puis valeur foncière de la mutation, jamais un prix inventé par le cadastre.
Conclusion
DVF et cadastre se rejoignent par un identifiant de 14 caractères. Le plan donne la parcelle, le DVF donne le prix de la mutation, sans le découper quand plusieurs parcelles partagent la même vente. Pour en faire une requête répétable, interrogez une zone avec l'API, filtrez id_parcelle dans le JSON, puis créez votre compte Immo API afin d'obtenir une clé et tester vos premiers appels.
Articles connexes
API annonces immobilières : SeLoger, Leboncoin, agrégateurs et prix de vente DVF
API annonces immobilières : ce que proposent vraiment SeLoger et Leboncoin, les agrégateurs, les limites légales, et comment comparer une annonce aux ventes DVF en Python.
API Adresse data.gouv + DVF : géocoder une adresse et trouver les ventes autour
API Adresse data.gouv (BAN, nouvelle URL Géoplateforme) : géocoder une adresse gratuitement puis récupérer les ventes DVF autour avec /api/mutations/nearby. Code Python, pièges.
DVF par commune : télécharger ou interroger les ventes d'une ville
DVF par commune : le CSV Etalab par code INSEE, l'application DVF ou l'API Immo API (ventes et prix au m² médian d'une commune). URL, colonnes, pièges.