Guides

Marché et ventes DVF

Deux points d’entrée donnent le marché à partir des ventes DVF : la synthèse d’une commune, et les ventes une à une. Tous deux exigent le droit market:read.

Le marché d’une commune

GET /v1/market/communes/{code}, avec le code INSEE de la commune :

Champ	Contenu
`dvf`	Couverture : `covered` (faux en Alsace-Moselle et à Mayotte, que DVF ne couvre pas), nombre de ventes d’un logement connues, dates de la plus ancienne et de la plus récente.
`sold_price_per_sqm`	Par type (`appartement`, `maison`) : prix médian au m² des ventes sur 36 mois, ventes hors marché écartées, avec leur nombre et la fenêtre (`from`, `to`). `null` sous 10 ventes.
`price_index`	Par type : indice de prix mensuel. `value` vaut 1 au mois de référence (0,9 : des prix 10 % plus bas que ce mois-là), avec la médiane glissante au m² et le nombre de ventes de la fenêtre. L’audit se sert d’un tel indice pour ramener les ventes passées à aujourd’hui.
`calibration`	Par type : rapport prix actés / prix affichés appliqué par le moteur, le nombre de ventes rapprochées de leur annonce qui le fondent, et `is_default` s’il s’agit de la valeur par défaut. `null` si la commune n’en a pas.
`listings`	Biens en vente aujourd’hui (`active`, tous types confondus) et, par type, leur nombre et leur prix affiché médian au m². Le délai de diffusion de votre plan s’applique.

La fenêtre de 36 mois s’arrête à la vente la plus récente du type (to), pas à aujourd’hui : les ventes DVF sont publiées avec plusieurs mois de retard.

Paris (75056), Lyon (69123) et Marseille (13055) : le code de la ville réunit les ventes et les annonces de tous ses arrondissements. L’indice et la calibration étant tenus par arrondissement, ils ne sont alors pas donnés (listes vides, null) : demandez un arrondissement par son code (13208) pour les obtenir.

Un code bien formé mais inconnu ne lève pas d’erreur : la réponse est vide (aucune vente, aucune annonce). Une même synthèse est resservie pendant 10 minutes au plus avant d’être recalculée.

Comparer sold_price_per_sqm au prix affiché médian de listings donne une idée de l’écart entre prix affichés et prix actés, mais les deux populations diffèrent (biens vendus sur 36 mois, biens en vente aujourd’hui). La calibration, elle, rapproche chaque vente de sa propre annonce.

Les ventes DVF

GET /v1/market/sales liste les ventes d’un seul logement (une maison ou un appartement, sans local commercial), les plus récentes d’abord : la même base que les ventes comparables de l’audit.

Zone : une commune (code INSEE ; Paris, Lyon et Marseille réunissent leurs arrondissements), ou un cercle lat + lon + radius_m de 50 à 5 000 mètres. L’un ou l’autre, jamais les deux (400 validation_error). Dans un cercle, chaque vente donne sa distance au centre (distance_m).
Filtres : property_type, since et until (dates AAAA-MM-JJ, bornes incluses), min_surface et max_surface (surface habitable, m²).
Pages : limit de 1 à 200 (100 par défaut), suite par next_cursor, sans total. Voir Pagination.

price_per_sqm est le prix de vente divisé par la surface habitable, arrondi à l’euro. out_of_market: true signale une cession hors marché, à moins de 200 € ou plus de 50 000 € du m² (prix symbolique, erreur de saisie…) : elle est listée, mais n’entre jamais dans les médianes ni dans les comparables de l’audit.

Les ventes ne dépendent pas de votre plan : le délai de diffusion ne s’applique qu’aux annonces. Pour l’usage de ces ventes dans l’estimation d’un bien, voir Lire l’audit de prix.