Une API DVF self-serve qui renvoie le prix DVF déjà joint au DPE et au niveau de vie de la zone en un seul payload JSON, là où les repackagers exposent le brut DGFiP reformaté. Prix médian €/m², quartiles P25–P75, split maison/appartement et tendance 12 mois — à la commune (code INSEE) ou à l'adresse (via la clé adresse-bâtiment ban_id). Donnée d'entrée pour vos modèles, pas une fiche de risque ou de valeur.
Pas un export de mutations à retraiter : des statistiques de prix déjà calculées sur le sous-ensemble résidentiel qualifié de DVF (filtres surface 15–300 m², prix 30 k€–2 M€), pour la commune ou la maille de l'adresse demandée.
Chaque réponse expose un bloc prix homogène, calculé sur 8 152 086 transactions DVF analysées couvrant 33 408 communes. Le corpus brut publié par la DGFiP est plus large (≈ 13,3 M de mutations depuis 2014) : nous n'en restituons que la partie résidentielle qualifiée, là où une statistique de prix au m² a un sens.
| Champ | Description |
|---|---|
prix_med_m2 | Prix médian au m² sur la maille (commune ou IRIS), corrigé des ventes atypiques. |
prix_p25_m2 · prix_p75_m2 | Quartiles P25 et P75 — la fourchette, pas seulement le point central, pour borner la dispersion réelle du marché local. |
prix_med_m2_maison · prix_med_m2_appart | Split maison / appartement : deux marchés distincts qu'une médiane globale écrase. |
tendance_12m_pct | Variation du prix médian sur 12 mois glissants, en pourcentage. |
nb_ventes | Nombre de transactions analysées sur la maille — l'indicateur de fiabilité de la statistique. |
Le nb_ventes est livré sans détour : sur une commune à dix ventes, la médiane est indicative et vous le voyez. C'est la matière première de votre propre modèle d'estimation, pas un verdict de valeur.
Le DVF, le registre DPE et le revenu sont trois jeux publics distincts. Les recoller à la main, c'est du géocodage, des appariements approximatifs et des semaines de pipeline. L'API les renvoie déjà joints.
Le croisement repose sur une clé d'identité adresse-bâtiment, le ban_id, qui relie environ 93 % du parc bâti. Sur une même maille, un appel renvoie en un payload :
Médiane €/m², quartiles et split maison/appartement, calculés sur les transactions analysées de la maille.
Part de passoires F+G observée parmi les 13 304 431 DPE analysés (9,8 % au national, F 6,3 % · G 3,6 %), parmi les diagnostics réalisés — pas une prédiction du DPE de votre logement.
Niveau de vie médian réel de la zone, carroyé Filosofi 200 m (INSEE), disponible sur 34 864 communes — la maille fine, pas une moyenne départementale.
La part de passoires est calculée parmi les DPE analysés, pas sur le parc total. Le registre ADEME brut compte ≈ 14,9 M de diagnostics ; nous en analysons 13 304 431. Le DPE de la zone est une statistique de marché observée — la classe énergétique réelle d'un bien n'apparaît que si un diagnostic existe pour cette adresse. Aucun modèle d'imputation du DPE d'un logement. Contexte réglementaire : la location d'un logement classé G est interdite depuis le 01/01/2025, F le sera en 2028 (loi Climat).
Le croisement DVF + DPE alimente directement les usages rénovation énergétique ; le détail des sources est documenté sur la page DVF et la page API DPE.
Un objet commune (interrogation par code INSEE) et un objet adresse (résolu via ban_id). Champs et ordres de grandeur plausibles — votre clé renvoie les valeurs de la maille demandée.
Interrogation par commune — GET /v1/dvf/commune/33063
{
"code_commune": "33063",
"nom_commune": "Bordeaux",
"prix_med_m2": 4720,
"prix_p25_m2": 3850,
"prix_p75_m2": 5610,
"prix_med_m2_maison": 4980,
"prix_med_m2_appart": 4610,
"tendance_12m_pct": -3.2,
"nb_ventes": 6184,
"dpe_pct_passoire": 11.4,
"niveau_vie_median": 23180,
"source": "DVF DGFiP + DPE ADEME + Filosofi 200m (INSEE)",
"maille": "commune"
}Interrogation par adresse — GET /v1/dvf/adresse?q=12+cours+de+l-Intendance+33000+Bordeaux
{
"ban_id": "33063_2380_00012",
"code_commune": "33063",
"prix_med_m2": 5240,
"prix_p25_m2": 4310,
"prix_p75_m2": 6180,
"nb_ventes": 87,
"dpe_pct_passoire": 9.1,
"niveau_vie_median": 24960,
"maille": "iris",
"appariement_ban": "confirme"
}Au grain adresse, maille indique la finesse réellement servie (IRIS lorsque le volume de ventes le permet, commune sinon) et appariement_ban signale la qualité du rattachement — les croisements faibles sont déclarés, pas imputés silencieusement.
L'API DVF est une vue de la grammaire ouverte « Actif immobilier » v1, servie par l'infrastructure Intent Analytics.
Deux surfaces sont en production :
/tool/{name}, authentification par JWT + scope — la voie applicative pour les intégrations internes.Le scope d'une clé borne les champs et les mailles accessibles ; le métering compte les appels par clé. La donnée est publique et travaillée au grain adresse ou bâtiment, sans donnée nominative, sur la base de l'intérêt légitime documenté (art. 6.1.f du RGPD) — aucun profilage de personne nommée. La grammaire de champs, la provenance et la licence source par champ sont décrites sur la page API & standard ouvert ; l'inventaire des sources publiques sur la page Données.
Cette API renvoie une statistique de marché observée, destinée à nourrir vos propres modèles. Elle ne constitue ni un conseil en investissement, ni une promesse de valorisation, ni une « valeur verte » d'un bien rénové. Pour une estimation produite par notre AVM (erreur médiane 21,4 % en out-of-time, 25,8 % des estimations à ±10 %), voir la page Estimation.
L'API DVF officielle (api.gouv.fr / DataFair) et le portail Étalab exposent les mutations brutes de la DGFiP, gratuitement, sous licence ouverte — c'est la source de référence. Les API qui repackagent le DVF se contentent souvent de reformater ce brut. Notre API renvoie le prix médian €/m² déjà calculé et déjà joint au DPE et au niveau de vie de la zone en un seul payload, via la clé adresse-bâtiment ban_id, là où ces données sont éclatées dans trois jeux distincts. C'est une donnée d'entrée pour vos modèles, pas une fiche de valeur. Comparatif détaillé sur vs DVF Étalab.
Oui. Le DVF est publié par la DGFiP sur data.gouv.fr sous licence ouverte Étalab 2.0, et l'API DVF officielle est gratuite. Notre API est un service météré : elle ne remplace pas la source publique, elle livre le prix déjà agrégé et croisé pour vous éviter de retraiter les fichiers et de joindre vous-même le DPE et le revenu. Les pages communes restent consultables gratuitement sur le site.
Oui. L'API accepte une requête par commune (code INSEE) ou par adresse, résolue via la clé ban_id. Au grain adresse, vous recevez le prix médian €/m² de la maille, le profil DPE local et le niveau de vie médian de la zone (carroyé Filosofi 200 m). Le ban_id relie environ 93 % du parc bâti ; les croisements à faible appariement sont signalés plutôt qu'imputés silencieusement.
Non. Nous ne prédisons ni n'imputons le DPE d'un logement. L'API renvoie la statistique DPE observée sur la maille (part de passoires F+G parmi les diagnostics analysés), issue de 13 304 431 DPE analysés. La part de passoires affichée est calculée parmi les DPE réalisés et ne représente pas la part du parc total. La classe énergétique réelle d'un bien n'est restituée que si un diagnostic existe pour cette adresse dans le registre.
L'API couvre la France entière : 8 152 086 transactions DVF analysées sur 33 408 communes pour les statistiques de prix, le niveau de vie médian réel sur 34 864 communes (Filosofi 200 m, INSEE). Les données sont publiques et travaillées au grain adresse ou bâtiment, sans donnée nominative, sur la base de l'intérêt légitime documenté (art. 6.1.f du RGPD). Aucun profilage de personne nommée.
La grammaire « Actif immobilier », les scopes et le métering par clé sont documentés sur la page API. Le DVF reste la source publique — nous livrons la couche croisée.