Référence · Marché & DVF
Ventes DVF d’une commune ou autour d’un point
GET/v1/market/salesDroit market:read
Ventes d’un seul logement (maison ou appartement, sans local commercial), les plus récentes d’abord : la même base que les comparables du moteur. out_of_market signale une cession hors marché (€/m² hors 200–50 000), jamais un comparable.
Paramètres
| Paramètre | Type | Description |
|---|---|---|
| communefacultatif | chaîne | Code INSEE de la commune (ou un rayon). |
| latfacultatif | nombre, -90 à 90 | Latitude du centre du rayon. |
| lonfacultatif | nombre, -180 à 180 | Longitude du centre du rayon. |
| radius_mfacultatif | entier, 50 à 5000 | Rayon en mètres, de 50 à 5 000. |
| property_typefacultatif | maison | appartement | Type de bien. |
| sincefacultatif | date (AAAA-MM-JJ) | Ventes à partir de cette date (AAAA-MM-JJ). |
| untilfacultatif | date (AAAA-MM-JJ) | Ventes jusqu’à cette date (AAAA-MM-JJ). |
| min_surfacefacultatif | nombre | Surface minimale, en m². |
| max_surfacefacultatif | nombre | Surface maximale, en m². |
| limitfacultatif | entier, 1 à 200 | Taille de page, de 1 à 200 (100 par défaut). |
| cursorfacultatif | chaîne | next_cursor de la page précédente. |
Réponse 200
| Champ | Type | Description |
|---|---|---|
| data | tableau de objet | Ventes, les plus récentes d’abord. |
| ↳ id_mutation | chaîne | Identifiant de la mutation DVF. |
| ↳ date | date (AAAA-MM-JJ) | Date de la vente. |
| ↳ price | nombre | Prix de vente, en euros. |
| ↳ property_type | maison | appartement | Type de bien vendu. |
| ↳ surface | nombre | Surface habitable, en m². |
| ↳ roomspeut être null | entier | Nombre de pièces. |
| ↳ surface_terrainpeut être null | nombre | Surface du terrain, en m². |
| ↳ price_per_sqm | entier | Prix au m², en euros. |
| ↳ out_of_market | booléen | Cession hors marché (€/m² hors 200–50 000) : jamais un comparable. |
| ↳ code_commune | chaîne | Code INSEE de la commune. |
| ↳ code_irispeut être null | chaîne | Quartier INSEE (IRIS). |
| ↳ lonpeut être null | nombre | Longitude. |
| ↳ latpeut être null | nombre | Latitude. |
| ↳ distance_mfacultatif | nombre | Distance au centre du rayon, en mètres (recherche par rayon). |
| next_cursorpeut être null | chaîne | À renvoyer dans cursor pour la page suivante ; null : dernière page. |
Erreurs
400 · Requête invalide401 · Clé absente ou invalide403 · Droit manquant ou accès coupé429 · Limite atteinte503 · Requête trop longue
Toutes les erreurs ont la forme { "error": { "code", "message", "request_id" } } : voir Erreurs.