Ventes DVF
Les ventes notariées, à l'adresse, à la mutation, autour d'un point, à la rue et à la commune, sans seuil : chaque agrégat porte son nombre de ventes et chaque vente atypique son drapeau. 4 opérations servies.
DVF à l'adresse : toutes les mutations
Essayer en direct/api/v1/adresses/{cle_ban}/ventes/api/v1/parcelles/{id_parcelle}/ventesToutes les mutations DVF enregistrées à une adresse de la Base Adresse Nationale (par sa clé), ou à une parcelle cadastrale, regroupées par mutation. Les ventes de 2021 et suivantes sont lues au numéro (code de voie et numéro DVF), sinon aux parcelles de l'adresse ; celles de 2018 à 2020, dont le fichier n'a ni adresse ni parcelle, sont rapprochées par position autour du numéro. Pour chaque mutation : date, nature, valeur foncière, adresse DVF, locaux (type, surface bâtie, pièces, lots et surfaces Carrez), terrains, parcelles, volumes, position. Le prix au m² est recalculé à la mutation sur la surface de ses logements, avec sa qualité : vente en bloc, dépendance, local professionnel, prix atypique et son motif, rattachement incertain. Aucune vente : 404 ressource_absente, rien n'est débité. L'Alsace-Moselle (livre foncier) n'est pas dans DVF.
- Coût
- 0 crédit, gratuit avec une clé (donnée publique brute)
- Accès
- À l'usage ou avec l'abonnement Data
- Portée
- adresse
- Outil MCP
- ventes_adresse
- Bac à sable
- Non
- Cache serveur
- 24 h
- Délai maximal
- 15 s
Paramètres de /api/v1/adresses/{cle_ban}/ventes
cle_bantexteobligatoireClé d'interopérabilité de la Base Adresse Nationale, ex. 69383_1234_00012.
depuistexteNe garder que les mutations à partir de cette date (AAAA-MM-JJ).
jusqu_atexteNe garder que les mutations jusqu'à cette date comprise (AAAA-MM-JJ).
inclure_2018_2020valeurAjouter les ventes de 2018 à 2020 rapprochées par position (adresse seulement). Vrai par défaut.
par défaut true
rayon_position_mentierRayon du rapprochement par position des ventes de 2018 à 2020, en mètres (15 par défaut, 100 au plus).
de 1 à 100 ; par défaut 15
Paramètres de /api/v1/parcelles/{id_parcelle}/ventes
id_parcelletexteobligatoireIdentifiant de parcelle cadastrale à 14 caractères, ex. 35238000AB0123.
Exemple d'appel
curl https://pillr.fr/api/v1/adresses/75108_3559_00055/ventes \
-H "Authorization: Bearer $PILLR_CLE"Réponse
cle_bantexte ou nullClé BAN demandée ; null pour une demande par parcelle.
id_parcelletexte ou nullParcelle demandée ; null pour une demande par adresse.
rattachementtexte ou nullComment les ventes 2021 et suivantes ont été trouvées : au numéro, sinon aux parcelles de l'adresse ; null si aucune.
Valeurs :
numero,parcelle,positionadresseobjet ou nullL'adresse résolue (Base Adresse Nationale et faits Pillr de l'adresse) ; null pour une demande par parcelle.
Afficher les 7 champsMasquer
numerotexte ou nullvoietexte ou nullcode_postaltexte ou nullinseetexte ou nullcommunetexte ou nulllatnombre ou nulllonnombre ou null
parcelles_luesliste de textesParcelles lues pour le rattachement par parcelle.
mutationsliste d'objetsToutes les mutations, la plus récente d'abord.
Afficher les 23 champsMasquer
id_mutationtexte ou nullIdentifiant DVF de la mutation ; null pour une vente de 2018 à 2020 (fichier sans identifiant).
datetexteDate de la mutation (AAAA-MM-JJ).
naturetexte ou nullNature de la mutation : Vente, Vente en l'état futur d'achèvement, Adjudication, Échange...
valeur_foncierenombre ou nullValeur foncière de la mutation entière, en euros.
adresseobjet ou nullAdresse DVF de la mutation (celle de ses logements d'abord) ; null quand DVF n'en donne pas.
Afficher les 4 champsMasquer
numerotexte ou nullNuméro dans la voie, suffixe compris (« 12 bis »), tel que DVF l'écrit.
voietexte ou nullLibellé DVF de la voie, souvent abrégé.
code_voietexte ou nullCode FANTOIR de la voie, le même que dans la clé BAN.
cle_bantexte ou nullClé BAN reconstituée depuis la commune, le code de voie et le numéro DVF : elle peut ne pas exister dans la Base Adresse Nationale.
code_postaltexte ou nullinseetexte ou nullCode INSEE de la commune DVF (l'arrondissement à Paris, Lyon et Marseille).
nb_dispositionsentierDispositions de l'acte (une vente peut en compter plusieurs).
locauxliste d'objetsLocaux de la mutation, lus une fois par parcelle.
Afficher les 5 champsMasquer
typetexteType de local DVF : Appartement, Maison, Dépendance, Local industriel. commercial ou assimilé.
surface_batinombre ou nullSurface réelle bâtie du local, en m².
piecesentier ou nullNombre de pièces principales.
id_parcelletexte ou nulllotsliste d'objetsLots déclarés sur la ligne du local (cinq au plus dans DVF).
Afficher les 2 champsMasquer
numerotexteNuméro du lot de copropriété.
carreznombre ou nullSurface Carrez du lot, en m² ; null quand elle n'est pas déclarée.
nombre_lotsentier ou nullLots de copropriété déclarés dans la mutation.
terrainsliste d'objetsTerrains de la mutation, par parcelle et nature de culture.
Afficher les 4 champsMasquer
id_parcelletexte ou nullnature_culturetexte ou nullNature de culture du terrain (sols, jardins, terres...).
nature_culture_specialetexte ou nullsurfacenombre ou nullSurface du terrain, en m².
surface_terrainnombre ou nullSomme des surfaces de terrain, en m².
parcellesliste de textesParcelles cadastrales de la mutation.
volumesliste de textesNuméros de volume (division en volumes), s'il y en a.
latnombre ou nulllonnombre ou nullsurface_logementsnombre ou nullSurface bâtie des appartements et maisons, en m².
prix_m2nombre ou nullValeur foncière rapportée à la surface bâtie des logements, en euros par m², arrondie ; null sans logement. Recalculé à la mutation, jamais à la ligne.
indicateursobjetAfficher les 6 champsMasquer
logementsentierAppartements et maisons de la mutation.
vente_en_blocbooléenPlus d'un logement : le prix au m² porte sur l'ensemble des logements.
avec_dependancebooléenLa mutation comprend une dépendance (cave, parking, garage).
avec_local_probooléenLa mutation comprend un local industriel, commercial ou assimilé.
prix_atypiquebooléenSurface ou prix au m² hors des bornes du barème Pillr : à lire avec prudence.
motiftexte ou nullPourquoi le prix est atypique ; null sinon.
qualiteobjetQualité du prix au m² de cette vente : une observation, ses drapeaux et sa méthode.
Afficher les 7 champsMasquer
nentier ou nullNombre d'observations derrière la valeur ; null si sans objet.
0 au moins
provenancetexte ou nullmesure : observé sur la donnée ; estime : modèle, barème ou imputation ; null : sans objet.
Valeurs :
mesure,estimeincertitudeobjet ou nullIncertitude de la valeur : fourchette et demi-largeur.
Afficher les 3 champsMasquer
demi_largeur_pctnombre ou nullDemi-largeur de la fourchette, en % de la valeur.
basnombre ou nullhautnombre ou null
drapeauxliste de textesCe qui doit faire lire la valeur avec prudence ; vide si rien.
Valeurs :
prix_atypique,surface_atypique,vente_en_bloc,doublon_probable,date_estimee,peu_d_observations,valeur_imputee,rattachement_incertain,donnee_anciennemethodetexte ou nullMéthode de calcul ou de rattachement, en clair.
donnees_dutexte ou nullDate de la donnée (AAAA-MM-JJ ou horodatage ISO 8601).
sourcetexteSource publique ou moteur Pillr, en clair.
millesimetexte ou nullMillésime du fichier DVF qui porte la mutation.
rattachementtextenumero : la vente porte le code de voie et le numéro de l'adresse ; parcelle : elle porte une parcelle de l'adresse ; position : vente de 2018 à 2020 rapprochée par sa position.
Valeurs :
numero,parcelle,positiondistance_mentier ou nullDistance entre la vente et l'adresse demandée, en mètres ; null sans position.
resumeobjetAfficher les 4 champsMasquer
nentierMutations servies.
n_2021_et_apresentiern_2018_2020entierderniereobjet ou nullLa mutation la plus récente.
Afficher les 3 champsMasquer
datetexteprixnombre ou nullprix_m2nombre ou null
millesimesobjetPremier et dernier millésimes DVF des mutations servies.
Afficher les 2 champsMasquer
premiertexte ou nullderniertexte ou null
donnees_dutexte ou nullDate de chargement des lignes DVF servies (horodatage ISO 8601).
limitesliste de textesCe que la réponse ne couvre pas, en clair.
creditsobjetCrédits débités par cet appel (réservés, pour une tâche en cours), et crédits encore utilisables ce mois avant la coupure : crédits offerts, crédits inclus du mois et crédits facturables sous le plafond de dépense (null si inconnus ou en bac à sable).
Afficher les 2 champsMasquer
debitesentier0 au moins
restantsentier ou null
Erreurs possibles
- 400parametres_invalidesUn paramètre manque ou ne passe pas son contrôle ; le détail est donné champ par champ
- 403hors_bac_a_sableUne clé pk_test_ l'appelle : l'opération n'a pas de bac à sable
- 503creneau_reserveEn cas de maintenance lourde exceptionnelle, si la réponse n'est pas déjà en cache
Afficher les 11 erreurs communes à toute l'APIMasquer les erreurs communes
- 401cle_absenteL'en-tête Authorization manque
- 401cle_invalideLa clé est inconnue, révoquée ou expirée
- 403organisation_suspendueL'organisation de la clé n'est pas active
- 403portee_insuffisanteLa clé ou l'accès de l'organisation n'ouvre pas cette opération
- 402credits_insuffisantsLes crédits ne suffisent plus pour cet appel
- 429plafond_cleLe plafond mensuel de crédits de la clé est atteint
- 429quota_minuteLe débit par minute de l'organisation est atteint
- 503charge_globaleL'API est momentanément surchargée, tous clients confondus ; rien n'est débité
- 504delai_depasseLe calcul dépasse le délai de l'opération ; rien n'est débité
- 503service_indisponibleL'API est momentanément indisponible
- 500erreur_interneUne erreur de notre côté ; rien n'est servi ni débité
Une ressource absente répond par un code de la famille des ressources absentes, propre à l'opération, sans débit. Guide des erreurs
Ventes DVF autour d'un point, dans une commune ou par mutation
Essayer en direct/api/v1/ventes/api/v1/ventes/{id_mutation}Les mutations DVF une par une, avec toutes leurs lignes, leur adresse DVF, leurs lots, leurs parcelles et leur position : autour d'un point (rayon de 2000 m au plus), dans une commune (l'arrondissement à Paris, Lyon et Marseille), ou par identifiant de mutation. Filtres : type de local, nature de la mutation, période, surface des logements, valeur foncière. Tri par date (le plus récent d'abord) ou par distance. Le prix au m² est recalculé à la mutation sur la surface de ses logements, avec sa qualité (vente en bloc, prix atypique et son motif). Les filtres de surface et de valeur s'appliquent après lecture : une page peut compter moins de mutations que la limite, curseur_suivant dit s'il en reste. Ventes de 2021 et suivantes ; les lignes d'une mutation situées dans une autre commune ne sont pas relues.
- Coût
- 0 crédit, gratuit avec une clé (donnée publique brute)
- Accès
- À l'usage ou avec l'abonnement Data
- Portée
- adresse
- Outil MCP
- ventes
- Bac à sable
- Non
- Cache serveur
- 24 h
- Délai maximal
- 15 s
Paramètres de /api/v1/ventes
latnombreLatitude du point (WGS 84), avec lon.
de -90 à 90
lonnombreLongitude du point (WGS 84), avec lat.
de -180 à 180
rayon_mentierRayon autour du point, en mètres (300 par défaut, 2000 au plus).
de 10 à 2 000
inseetexteCode INSEE de la commune DVF (l'arrondissement à Paris, Lyon et Marseille).
typetexteNe garder que les mutations qui comptent ce type de local.
Valeurs :
appartement,maison,dependance,localnaturetexteNature de la mutation : vente, vefa, terrain_a_batir, adjudication, echange, expropriation.
Valeurs :
vente,vefa,terrain_a_batir,adjudication,echange,expropriationdepuistexteMutations à partir de cette date (AAAA-MM-JJ).
jusqu_atexteMutations jusqu'à cette date comprise (AAAA-MM-JJ).
surface_minnombreSurface bâtie des logements, minimum, en m².
0 au moins
surface_maxnombreSurface bâtie des logements, maximum, en m².
0 au moins
prix_minnombreValeur foncière de la mutation, minimum, en euros.
0 au moins
prix_maxnombreValeur foncière de la mutation, maximum, en euros.
0 au moins
tritextedate (le plus récent d'abord) ou distance (autour d'un point seulement). Par défaut : distance autour d'un point, date sinon.
Valeurs :
date,distancelimiteentierNombre d'éléments par page (50 au plus).
de 1 à 50 ; par défaut 20
curseurtexteCurseur opaque rendu par la page précédente (curseur_suivant), à repasser tel quel.
de 1 à 1 024 caractères
Paramètres de /api/v1/ventes/{id_mutation}
id_mutationtexteobligatoireIdentifiant DVF de la mutation, ex. 2024-426100.
Exemple d'appel
curl "https://pillr.fr/api/v1/ventes?insee=76540&type=appartement" \
-H "Authorization: Bearer $PILLR_CLE"Réponse
rechercheobjetLa recherche servie, telle que lue.
Afficher les 6 champsMasquer
modetexteValeurs :
mutation,point,communetritexteValeurs :
date,distanceinseetexte ou nulllatnombre ou nulllonnombre ou nullrayon_mentier ou null
donneesliste d'objetsLes mutations de la page, chacune avec toutes ses lignes et son adresse.
Afficher les 23 champsMasquer
id_mutationtexte ou nullIdentifiant DVF de la mutation ; null pour une vente de 2018 à 2020 (fichier sans identifiant).
datetexteDate de la mutation (AAAA-MM-JJ).
naturetexte ou nullNature de la mutation : Vente, Vente en l'état futur d'achèvement, Adjudication, Échange...
valeur_foncierenombre ou nullValeur foncière de la mutation entière, en euros.
adresseobjet ou nullAdresse DVF de la mutation (celle de ses logements d'abord) ; null quand DVF n'en donne pas.
Afficher les 4 champsMasquer
numerotexte ou nullNuméro dans la voie, suffixe compris (« 12 bis »), tel que DVF l'écrit.
voietexte ou nullLibellé DVF de la voie, souvent abrégé.
code_voietexte ou nullCode FANTOIR de la voie, le même que dans la clé BAN.
cle_bantexte ou nullClé BAN reconstituée depuis la commune, le code de voie et le numéro DVF : elle peut ne pas exister dans la Base Adresse Nationale.
code_postaltexte ou nullinseetexte ou nullCode INSEE de la commune DVF (l'arrondissement à Paris, Lyon et Marseille).
nb_dispositionsentierDispositions de l'acte (une vente peut en compter plusieurs).
locauxliste d'objetsLocaux de la mutation, lus une fois par parcelle.
Afficher les 5 champsMasquer
typetexteType de local DVF : Appartement, Maison, Dépendance, Local industriel. commercial ou assimilé.
surface_batinombre ou nullSurface réelle bâtie du local, en m².
piecesentier ou nullNombre de pièces principales.
id_parcelletexte ou nulllotsliste d'objetsLots déclarés sur la ligne du local (cinq au plus dans DVF).
Afficher les 2 champsMasquer
numerotexteNuméro du lot de copropriété.
carreznombre ou nullSurface Carrez du lot, en m² ; null quand elle n'est pas déclarée.
nombre_lotsentier ou nullLots de copropriété déclarés dans la mutation.
terrainsliste d'objetsTerrains de la mutation, par parcelle et nature de culture.
Afficher les 4 champsMasquer
id_parcelletexte ou nullnature_culturetexte ou nullNature de culture du terrain (sols, jardins, terres...).
nature_culture_specialetexte ou nullsurfacenombre ou nullSurface du terrain, en m².
surface_terrainnombre ou nullSomme des surfaces de terrain, en m².
parcellesliste de textesParcelles cadastrales de la mutation.
volumesliste de textesNuméros de volume (division en volumes), s'il y en a.
latnombre ou nulllonnombre ou nullsurface_logementsnombre ou nullSurface bâtie des appartements et maisons, en m².
prix_m2nombre ou nullValeur foncière rapportée à la surface bâtie des logements, en euros par m², arrondie ; null sans logement. Recalculé à la mutation, jamais à la ligne.
indicateursobjetAfficher les 6 champsMasquer
logementsentierAppartements et maisons de la mutation.
vente_en_blocbooléenPlus d'un logement : le prix au m² porte sur l'ensemble des logements.
avec_dependancebooléenLa mutation comprend une dépendance (cave, parking, garage).
avec_local_probooléenLa mutation comprend un local industriel, commercial ou assimilé.
prix_atypiquebooléenSurface ou prix au m² hors des bornes du barème Pillr : à lire avec prudence.
motiftexte ou nullPourquoi le prix est atypique ; null sinon.
qualiteobjetQualité du prix au m² de cette vente : une observation, ses drapeaux et sa méthode.
Afficher les 7 champsMasquer
nentier ou nullNombre d'observations derrière la valeur ; null si sans objet.
0 au moins
provenancetexte ou nullmesure : observé sur la donnée ; estime : modèle, barème ou imputation ; null : sans objet.
Valeurs :
mesure,estimeincertitudeobjet ou nullIncertitude de la valeur : fourchette et demi-largeur.
Afficher les 3 champsMasquer
demi_largeur_pctnombre ou nullDemi-largeur de la fourchette, en % de la valeur.
basnombre ou nullhautnombre ou null
drapeauxliste de textesCe qui doit faire lire la valeur avec prudence ; vide si rien.
Valeurs :
prix_atypique,surface_atypique,vente_en_bloc,doublon_probable,date_estimee,peu_d_observations,valeur_imputee,rattachement_incertain,donnee_anciennemethodetexte ou nullMéthode de calcul ou de rattachement, en clair.
donnees_dutexte ou nullDate de la donnée (AAAA-MM-JJ ou horodatage ISO 8601).
sourcetexteSource publique ou moteur Pillr, en clair.
millesimetexte ou nullMillésime du fichier DVF qui porte la mutation.
distance_mentier ou nullDistance au point demandé, en mètres ; null hors d'une recherche autour d'un point.
iristexte ou nullCode IRIS de la vente (ventes de logement rattachées par Pillr) ; null sinon.
limitesliste de textesCe que la page ne couvre pas, en clair.
curseur_suivanttexte ou nullCurseur de la page suivante, à repasser dans curseur ; null sur la dernière page.
creditsobjetCrédits débités par cet appel (réservés, pour une tâche en cours), et crédits encore utilisables ce mois avant la coupure : crédits offerts, crédits inclus du mois et crédits facturables sous le plafond de dépense (null si inconnus ou en bac à sable).
Afficher les 2 champsMasquer
debitesentier0 au moins
restantsentier ou null
Erreurs possibles
- 400parametres_invalidesUn paramètre manque ou ne passe pas son contrôle ; le détail est donné champ par champ
- 403hors_bac_a_sableUne clé pk_test_ l'appelle : l'opération n'a pas de bac à sable
- 503creneau_reserveEn cas de maintenance lourde exceptionnelle, si la réponse n'est pas déjà en cache
Afficher les 11 erreurs communes à toute l'APIMasquer les erreurs communes
- 401cle_absenteL'en-tête Authorization manque
- 401cle_invalideLa clé est inconnue, révoquée ou expirée
- 403organisation_suspendueL'organisation de la clé n'est pas active
- 403portee_insuffisanteLa clé ou l'accès de l'organisation n'ouvre pas cette opération
- 402credits_insuffisantsLes crédits ne suffisent plus pour cet appel
- 429plafond_cleLe plafond mensuel de crédits de la clé est atteint
- 429quota_minuteLe débit par minute de l'organisation est atteint
- 503charge_globaleL'API est momentanément surchargée, tous clients confondus ; rien n'est débité
- 504delai_depasseLe calcul dépasse le délai de l'opération ; rien n'est débité
- 503service_indisponibleL'API est momentanément indisponible
- 500erreur_interneUne erreur de notre côté ; rien n'est servi ni débité
Une ressource absente répond par un code de la famille des ressources absentes, propre à l'opération, sans débit. Guide des erreurs
Ventes d'une rue ou d'une commune
Essayer en direct/api/v1/ventes/rueLes ventes DVF d'une rue (par son nom géocodé dans la Base Adresse Nationale, ou par son code de voie) ou d'une commune (l'arrondissement à Paris, Lyon et Marseille), lues à la vente entière : une vente d'un seul logement, hors local professionnel et vente en bloc, comme le barème Pillr. Par type de bien, sur la période entière puis année par année : nombre de ventes, médiane, quartiles dès 2 ventes, minimum, maximum, surface médiane, dernière vente, sans seuil de publication. Les ventes au prix atypique sont écartées des agrégats et comptées. À la voie, chaque vente est listée avec son numéro et sa qualité. Le prix de référence de la commune est le barème Pillr, le même que les pages communes. Mêmes calculs que l'outil ventes_rue du Hub.
- Coût
- 5 crédits par appel réussi
- Accès
- À l'usage ou avec l'abonnement Data
- Portée
- adresse
- Outil MCP
- ventes_rue
- Bac à sable
- Non
- Cache serveur
- 24 h
- Délai maximal
- 15 s
Paramètres
voietexteNom de la voie, ex. « rue de Genève ».
de 2 à 160 caractères
code_voietexteCode FANTOIR de la voie (deuxième segment de la clé BAN), avec insee, au lieu de son nom.
inseetexteCode INSEE de la commune DVF (l'arrondissement à Paris, Lyon et Marseille).
code_postaltexteCode postal, à défaut du code INSEE.
typetexteNe servir qu'un type de bien.
Valeurs :
appartement,maisondepuistexteNe compter que les ventes à partir de cette date (AAAA-MM-JJ).
Exemple d'appel
curl "https://pillr.fr/api/v1/ventes/rue?voie=Rue+Beauvoisine&insee=76540" \
-H "Authorization: Bearer $PILLR_CLE"Réponse
cibleobjetAfficher les 6 champsMasquer
perimetretexteValeurs :
voie,communevoietexte ou nullLa voie retenue (libellé de la Base Adresse Nationale, ou celui que DVF écrit quand la voie est donnée par son code).
code_voietexte ou nullcommunetexte ou nullinseetextecode_postaltexte ou null
par_typeobjetAfficher les 2 champsMasquer
appartementobjet ou nullAfficher les 3 champsMasquer
periodeobjet ou nullToutes les années réunies, prix non ramenés à une même date ; null sans vente typique.
Afficher les 11 champsMasquer
periodetextePériode couverte, ex. « 2021 à 2025 ».
nentierVentes typiques qui portent l'agrégat : à lire avant la médiane.
mediane_m2nombrePrix au m² médian, en euros.
q1nombre ou nullPremier quartile du prix au m², dès 2 ventes.
q3nombre ou nullTroisième quartile du prix au m², dès 2 ventes.
minnombremaxnombresurface_medianenombreSurface médiane, en m².
derniere_vente_letexten_prix_atypiquesentierVentes au prix atypique du groupe, écartées de l'agrégat (listées à la voie).
qualiteobjetCe qui permet de juger la valeur : nombre, provenance, incertitude, drapeaux, date et source.
Afficher les 7 champsMasquer
nentier ou nullNombre d'observations derrière la valeur ; null si sans objet.
0 au moins
provenancetexte ou nullmesure : observé sur la donnée ; estime : modèle, barème ou imputation ; null : sans objet.
Valeurs :
mesure,estimeincertitudeobjet ou nullIncertitude de la valeur : fourchette et demi-largeur.
Afficher les 3 champsMasquer
demi_largeur_pctnombre ou nullDemi-largeur de la fourchette, en % de la valeur.
basnombre ou nullhautnombre ou null
drapeauxliste de textesCe qui doit faire lire la valeur avec prudence ; vide si rien.
Valeurs :
prix_atypique,surface_atypique,vente_en_bloc,doublon_probable,date_estimee,peu_d_observations,valeur_imputee,rattachement_incertain,donnee_anciennemethodetexte ou nullMéthode de calcul ou de rattachement, en clair.
donnees_dutexte ou nullDate de la donnée (AAAA-MM-JJ ou horodatage ISO 8601).
sourcetexteSource publique ou moteur Pillr, en clair.
par_anneeliste d'objetsChaque année qui compte au moins une vente typique, la plus récente d'abord.
Afficher les 11 champsMasquer
anneeentiernentierVentes typiques qui portent l'agrégat : à lire avant la médiane.
mediane_m2nombrePrix au m² médian, en euros.
q1nombre ou nullPremier quartile du prix au m², dès 2 ventes.
q3nombre ou nullTroisième quartile du prix au m², dès 2 ventes.
minnombremaxnombresurface_medianenombreSurface médiane, en m².
derniere_vente_letexten_prix_atypiquesentierVentes au prix atypique du groupe, écartées de l'agrégat (listées à la voie).
qualiteobjetCe qui permet de juger la valeur : nombre, provenance, incertitude, drapeaux, date et source.
Afficher les 7 champsMasquer
nentier ou nullNombre d'observations derrière la valeur ; null si sans objet.
0 au moins
provenancetexte ou nullmesure : observé sur la donnée ; estime : modèle, barème ou imputation ; null : sans objet.
Valeurs :
mesure,estimeincertitudeobjet ou nullIncertitude de la valeur : fourchette et demi-largeur.
Afficher les 3 champsMasquer
demi_largeur_pctnombre ou nullDemi-largeur de la fourchette, en % de la valeur.
basnombre ou nullhautnombre ou null
drapeauxliste de textesCe qui doit faire lire la valeur avec prudence ; vide si rien.
Valeurs :
prix_atypique,surface_atypique,vente_en_bloc,doublon_probable,date_estimee,peu_d_observations,valeur_imputee,rattachement_incertain,donnee_anciennemethodetexte ou nullMéthode de calcul ou de rattachement, en clair.
donnees_dutexte ou nullDate de la donnée (AAAA-MM-JJ ou horodatage ISO 8601).
sourcetexteSource publique ou moteur Pillr, en clair.
notetexte ou null
maisonobjet ou nullAfficher les 3 champsMasquer
periodeobjet ou nullToutes les années réunies, prix non ramenés à une même date ; null sans vente typique.
Afficher les 11 champsMasquer
periodetextePériode couverte, ex. « 2021 à 2025 ».
nentierVentes typiques qui portent l'agrégat : à lire avant la médiane.
mediane_m2nombrePrix au m² médian, en euros.
q1nombre ou nullPremier quartile du prix au m², dès 2 ventes.
q3nombre ou nullTroisième quartile du prix au m², dès 2 ventes.
minnombremaxnombresurface_medianenombreSurface médiane, en m².
derniere_vente_letexten_prix_atypiquesentierVentes au prix atypique du groupe, écartées de l'agrégat (listées à la voie).
qualiteobjetCe qui permet de juger la valeur : nombre, provenance, incertitude, drapeaux, date et source.
Afficher les 7 champsMasquer
nentier ou nullNombre d'observations derrière la valeur ; null si sans objet.
0 au moins
provenancetexte ou nullmesure : observé sur la donnée ; estime : modèle, barème ou imputation ; null : sans objet.
Valeurs :
mesure,estimeincertitudeobjet ou nullIncertitude de la valeur : fourchette et demi-largeur.
Afficher les 3 champsMasquer
demi_largeur_pctnombre ou nullDemi-largeur de la fourchette, en % de la valeur.
basnombre ou nullhautnombre ou null
drapeauxliste de textesCe qui doit faire lire la valeur avec prudence ; vide si rien.
Valeurs :
prix_atypique,surface_atypique,vente_en_bloc,doublon_probable,date_estimee,peu_d_observations,valeur_imputee,rattachement_incertain,donnee_anciennemethodetexte ou nullMéthode de calcul ou de rattachement, en clair.
donnees_dutexte ou nullDate de la donnée (AAAA-MM-JJ ou horodatage ISO 8601).
sourcetexteSource publique ou moteur Pillr, en clair.
par_anneeliste d'objetsChaque année qui compte au moins une vente typique, la plus récente d'abord.
Afficher les 11 champsMasquer
anneeentiernentierVentes typiques qui portent l'agrégat : à lire avant la médiane.
mediane_m2nombrePrix au m² médian, en euros.
q1nombre ou nullPremier quartile du prix au m², dès 2 ventes.
q3nombre ou nullTroisième quartile du prix au m², dès 2 ventes.
minnombremaxnombresurface_medianenombreSurface médiane, en m².
derniere_vente_letexten_prix_atypiquesentierVentes au prix atypique du groupe, écartées de l'agrégat (listées à la voie).
qualiteobjetCe qui permet de juger la valeur : nombre, provenance, incertitude, drapeaux, date et source.
Afficher les 7 champsMasquer
nentier ou nullNombre d'observations derrière la valeur ; null si sans objet.
0 au moins
provenancetexte ou nullmesure : observé sur la donnée ; estime : modèle, barème ou imputation ; null : sans objet.
Valeurs :
mesure,estimeincertitudeobjet ou nullIncertitude de la valeur : fourchette et demi-largeur.
Afficher les 3 champsMasquer
demi_largeur_pctnombre ou nullDemi-largeur de la fourchette, en % de la valeur.
basnombre ou nullhautnombre ou null
drapeauxliste de textesCe qui doit faire lire la valeur avec prudence ; vide si rien.
Valeurs :
prix_atypique,surface_atypique,vente_en_bloc,doublon_probable,date_estimee,peu_d_observations,valeur_imputee,rattachement_incertain,donnee_anciennemethodetexte ou nullMéthode de calcul ou de rattachement, en clair.
donnees_dutexte ou nullDate de la donnée (AAAA-MM-JJ ou horodatage ISO 8601).
sourcetexteSource publique ou moteur Pillr, en clair.
notetexte ou null
ventesliste d'objetsÀ la voie : chaque vente, numéro compris, la plus récente d'abord ; vide pour une commune.
Afficher les 9 champsMasquer
datetextenumerotexte ou nullNuméro dans la voie, suffixe compris ; null quand DVF n'en donne pas.
adressetexte ou nullNuméro et voie, tels que DVF les écrit.
typetexteValeurs :
appartement,maisonsurfacenombreSurface du logement, en m².
prixnombre ou nullValeur foncière de la mutation, en euros.
prix_m2nombreid_mutationtexte ou nullqualiteobjetCe qui permet de juger la valeur : nombre, provenance, incertitude, drapeaux, date et source.
Afficher les 7 champsMasquer
nentier ou nullNombre d'observations derrière la valeur ; null si sans objet.
0 au moins
provenancetexte ou nullmesure : observé sur la donnée ; estime : modèle, barème ou imputation ; null : sans objet.
Valeurs :
mesure,estimeincertitudeobjet ou nullIncertitude de la valeur : fourchette et demi-largeur.
Afficher les 3 champsMasquer
demi_largeur_pctnombre ou nullDemi-largeur de la fourchette, en % de la valeur.
basnombre ou nullhautnombre ou null
drapeauxliste de textesCe qui doit faire lire la valeur avec prudence ; vide si rien.
Valeurs :
prix_atypique,surface_atypique,vente_en_bloc,doublon_probable,date_estimee,peu_d_observations,valeur_imputee,rattachement_incertain,donnee_anciennemethodetexte ou nullMéthode de calcul ou de rattachement, en clair.
donnees_dutexte ou nullDate de la donnée (AAAA-MM-JJ ou horodatage ISO 8601).
sourcetexteSource publique ou moteur Pillr, en clair.
ventes_totalentier ou nullVentes de la voie quand la liste est tronquée ; null sinon.
prix_reference_communeobjetAfficher les 3 champsMasquer
appartementobjet ou nullAfficher les 3 champsMasquer
prix_m2nombrelibelletexteComment citer ce prix.
qualiteobjetCe qui permet de juger la valeur : nombre, provenance, incertitude, drapeaux, date et source.
Afficher les 7 champsMasquer
nentier ou nullNombre d'observations derrière la valeur ; null si sans objet.
0 au moins
provenancetexte ou nullmesure : observé sur la donnée ; estime : modèle, barème ou imputation ; null : sans objet.
Valeurs :
mesure,estimeincertitudeobjet ou nullIncertitude de la valeur : fourchette et demi-largeur.
Afficher les 3 champsMasquer
demi_largeur_pctnombre ou nullDemi-largeur de la fourchette, en % de la valeur.
basnombre ou nullhautnombre ou null
drapeauxliste de textesCe qui doit faire lire la valeur avec prudence ; vide si rien.
Valeurs :
prix_atypique,surface_atypique,vente_en_bloc,doublon_probable,date_estimee,peu_d_observations,valeur_imputee,rattachement_incertain,donnee_anciennemethodetexte ou nullMéthode de calcul ou de rattachement, en clair.
donnees_dutexte ou nullDate de la donnée (AAAA-MM-JJ ou horodatage ISO 8601).
sourcetexteSource publique ou moteur Pillr, en clair.
maisonobjet ou nullAfficher les 3 champsMasquer
prix_m2nombrelibelletexteComment citer ce prix.
qualiteobjetCe qui permet de juger la valeur : nombre, provenance, incertitude, drapeaux, date et source.
Afficher les 7 champsMasquer
nentier ou nullNombre d'observations derrière la valeur ; null si sans objet.
0 au moins
provenancetexte ou nullmesure : observé sur la donnée ; estime : modèle, barème ou imputation ; null : sans objet.
Valeurs :
mesure,estimeincertitudeobjet ou nullIncertitude de la valeur : fourchette et demi-largeur.
Afficher les 3 champsMasquer
demi_largeur_pctnombre ou nullDemi-largeur de la fourchette, en % de la valeur.
basnombre ou nullhautnombre ou null
drapeauxliste de textesCe qui doit faire lire la valeur avec prudence ; vide si rien.
Valeurs :
prix_atypique,surface_atypique,vente_en_bloc,doublon_probable,date_estimee,peu_d_observations,valeur_imputee,rattachement_incertain,donnee_anciennemethodetexte ou nullMéthode de calcul ou de rattachement, en clair.
donnees_dutexte ou nullDate de la donnée (AAAA-MM-JJ ou horodatage ISO 8601).
sourcetexteSource publique ou moteur Pillr, en clair.
sourcetexte
millesimestexte ou nullnotetextelimitesliste de textescreditsobjetCrédits débités par cet appel (réservés, pour une tâche en cours), et crédits encore utilisables ce mois avant la coupure : crédits offerts, crédits inclus du mois et crédits facturables sous le plafond de dépense (null si inconnus ou en bac à sable).
Afficher les 2 champsMasquer
debitesentier0 au moins
restantsentier ou null
Erreurs possibles
- 400parametres_invalidesUn paramètre manque ou ne passe pas son contrôle ; le détail est donné champ par champ
- 403hors_bac_a_sableUne clé pk_test_ l'appelle : l'opération n'a pas de bac à sable
- 503creneau_reserveEn cas de maintenance lourde exceptionnelle, si la réponse n'est pas déjà en cache
Afficher les 11 erreurs communes à toute l'APIMasquer les erreurs communes
- 401cle_absenteL'en-tête Authorization manque
- 401cle_invalideLa clé est inconnue, révoquée ou expirée
- 403organisation_suspendueL'organisation de la clé n'est pas active
- 403portee_insuffisanteLa clé ou l'accès de l'organisation n'ouvre pas cette opération
- 402credits_insuffisantsLes crédits ne suffisent plus pour cet appel
- 429plafond_cleLe plafond mensuel de crédits de la clé est atteint
- 429quota_minuteLe débit par minute de l'organisation est atteint
- 503charge_globaleL'API est momentanément surchargée, tous clients confondus ; rien n'est débité
- 504delai_depasseLe calcul dépasse le délai de l'opération ; rien n'est débité
- 503service_indisponibleL'API est momentanément indisponible
- 500erreur_interneUne erreur de notre côté ; rien n'est servi ni débité
Une ressource absente répond par un code de la famille des ressources absentes, propre à l'opération, sans débit. Guide des erreurs
Volumes et prix des ventes d'une commune
Essayer en direct/api/v1/communes/{insee}/ventes/api/v1/codes-postaux/{code_postal}/ventesLes volumes et les prix des ventes DVF d'une commune, par son code INSEE ou par un code postal (la commune la plus peuplée du code postal) : ventes par trimestre (total, appartements, maisons) et médiane au m² ; série annuelle du prix au m² (appartement, maison, ensemble) avec transactions, minimum, maximum et drapeaux de basse confiance ; vélocité au code postal, année par année, évolution du volume et sa lecture, comme l'outil de vélocité du Hub. La vélocité compte des lignes DVF d'appartements et de maisons (une par lot), pas des mutations. Chaque valeur porte son nombre d'observations. Les prix de cette opération sont des médianes des ventes (trimestrielle par lot, annuelle) : le prix de référence d'une commune est celui de prix_commune (barème).
- Coût
- 2 crédits par appel réussi
- Accès
- À l'usage ou avec l'abonnement Data
- Portée
- territoire
- Outil MCP
- ventes_commune
- Bac à sable
- Non
- Cache serveur
- 24 h
- Délai maximal
- 8 s
Paramètres de /api/v1/communes/{insee}/ventes
inseetexteobligatoireCode INSEE de la commune ou de l'arrondissement (5 caractères, 2A ou 2B pour la Corse).
typetexteNe servir que les chiffres d'un type de bien (les autres valent null).
Valeurs :
appartement,maison
Paramètres de /api/v1/codes-postaux/{code_postal}/ventes
code_postaltexteobligatoireCode postal.
Exemple d'appel
curl https://pillr.fr/api/v1/communes/76540/ventes \
-H "Authorization: Bearer $PILLR_CLE"Réponse
communeobjetAfficher les 3 champsMasquer
inseetextenomtexte ou nullcode_postaltexte ou nullCode postal principal de la commune, celui de la vélocité.
par_trimestreliste d'objetsVentes DVF de la commune par trimestre, le plus ancien d'abord.
Afficher les 7 champsMasquer
trimestretexteTrimestre, ex. 2025-T4.
debuttextePremier jour du trimestre.
ventesentierappartementsentier ou nullmaisonsentier ou nullprix_m2_mediannombre ou nullMédiane du prix au m² des ventes du trimestre, en euros.
qualiteobjetCe qui permet de juger la valeur : nombre, provenance, incertitude, drapeaux, date et source.
Afficher les 7 champsMasquer
nentier ou nullNombre d'observations derrière la valeur ; null si sans objet.
0 au moins
provenancetexte ou nullmesure : observé sur la donnée ; estime : modèle, barème ou imputation ; null : sans objet.
Valeurs :
mesure,estimeincertitudeobjet ou nullIncertitude de la valeur : fourchette et demi-largeur.
Afficher les 3 champsMasquer
demi_largeur_pctnombre ou nullDemi-largeur de la fourchette, en % de la valeur.
basnombre ou nullhautnombre ou null
drapeauxliste de textesCe qui doit faire lire la valeur avec prudence ; vide si rien.
Valeurs :
prix_atypique,surface_atypique,vente_en_bloc,doublon_probable,date_estimee,peu_d_observations,valeur_imputee,rattachement_incertain,donnee_anciennemethodetexte ou nullMéthode de calcul ou de rattachement, en clair.
donnees_dutexte ou nullDate de la donnée (AAAA-MM-JJ ou horodatage ISO 8601).
sourcetexteSource publique ou moteur Pillr, en clair.
par_anneeliste d'objetsSérie annuelle du prix au m² et des transactions de la commune, la plus ancienne d'abord.
Afficher les 14 champsMasquer
anneeentiertransactions_appartementsentier ou nulltransactions_maisonsentier ou nulltransactions_totalentier ou nullprix_m2_appartementnombre ou nullprix_m2_maisonnombre ou nullprix_m2_globalnombre ou nullmin_appartementnombre ou nullmax_appartementnombre ou nullmin_maisonnombre ou nullmax_maisonnombre ou nullbasse_confiance_appartementbooléen ou nullbasse_confiance_maisonbooléen ou nullqualiteobjetCe qui permet de juger la valeur : nombre, provenance, incertitude, drapeaux, date et source.
Afficher les 7 champsMasquer
nentier ou nullNombre d'observations derrière la valeur ; null si sans objet.
0 au moins
provenancetexte ou nullmesure : observé sur la donnée ; estime : modèle, barème ou imputation ; null : sans objet.
Valeurs :
mesure,estimeincertitudeobjet ou nullIncertitude de la valeur : fourchette et demi-largeur.
Afficher les 3 champsMasquer
demi_largeur_pctnombre ou nullDemi-largeur de la fourchette, en % de la valeur.
basnombre ou nullhautnombre ou null
drapeauxliste de textesCe qui doit faire lire la valeur avec prudence ; vide si rien.
Valeurs :
prix_atypique,surface_atypique,vente_en_bloc,doublon_probable,date_estimee,peu_d_observations,valeur_imputee,rattachement_incertain,donnee_anciennemethodetexte ou nullMéthode de calcul ou de rattachement, en clair.
donnees_dutexte ou nullDate de la donnée (AAAA-MM-JJ ou horodatage ISO 8601).
sourcetexteSource publique ou moteur Pillr, en clair.
velociteobjet ou nullVélocité au code postal principal ; null sans code postal connu.
Afficher les 5 champsMasquer
code_postaltextepar_anneeliste d'objetsAfficher les 2 champsMasquer
anneeentierventesentier
evolution_volume_pctnombre ou nullÉvolution du volume de la première année à la dernière année pleine, en %.
lecturetexteCe que dit l'évolution du volume sur la liquidité du marché (même lecture que le Hub).
qualiteobjetCe qui permet de juger la valeur : nombre, provenance, incertitude, drapeaux, date et source.
Afficher les 7 champsMasquer
nentier ou nullNombre d'observations derrière la valeur ; null si sans objet.
0 au moins
provenancetexte ou nullmesure : observé sur la donnée ; estime : modèle, barème ou imputation ; null : sans objet.
Valeurs :
mesure,estimeincertitudeobjet ou nullIncertitude de la valeur : fourchette et demi-largeur.
Afficher les 3 champsMasquer
demi_largeur_pctnombre ou nullDemi-largeur de la fourchette, en % de la valeur.
basnombre ou nullhautnombre ou null
drapeauxliste de textesCe qui doit faire lire la valeur avec prudence ; vide si rien.
Valeurs :
prix_atypique,surface_atypique,vente_en_bloc,doublon_probable,date_estimee,peu_d_observations,valeur_imputee,rattachement_incertain,donnee_anciennemethodetexte ou nullMéthode de calcul ou de rattachement, en clair.
donnees_dutexte ou nullDate de la donnée (AAAA-MM-JJ ou horodatage ISO 8601).
sourcetexteSource publique ou moteur Pillr, en clair.
limitesliste de textescreditsobjetCrédits débités par cet appel (réservés, pour une tâche en cours), et crédits encore utilisables ce mois avant la coupure : crédits offerts, crédits inclus du mois et crédits facturables sous le plafond de dépense (null si inconnus ou en bac à sable).
Afficher les 2 champsMasquer
debitesentier0 au moins
restantsentier ou null
Erreurs possibles
- 400parametres_invalidesUn paramètre manque ou ne passe pas son contrôle ; le détail est donné champ par champ
- 403hors_bac_a_sableUne clé pk_test_ l'appelle : l'opération n'a pas de bac à sable
Afficher les 11 erreurs communes à toute l'APIMasquer les erreurs communes
- 401cle_absenteL'en-tête Authorization manque
- 401cle_invalideLa clé est inconnue, révoquée ou expirée
- 403organisation_suspendueL'organisation de la clé n'est pas active
- 403portee_insuffisanteLa clé ou l'accès de l'organisation n'ouvre pas cette opération
- 402credits_insuffisantsLes crédits ne suffisent plus pour cet appel
- 429plafond_cleLe plafond mensuel de crédits de la clé est atteint
- 429quota_minuteLe débit par minute de l'organisation est atteint
- 503charge_globaleL'API est momentanément surchargée, tous clients confondus ; rien n'est débité
- 504delai_depasseLe calcul dépasse le délai de l'opération ; rien n'est débité
- 503service_indisponibleL'API est momentanément indisponible
- 500erreur_interneUne erreur de notre côté ; rien n'est servi ni débité
Une ressource absente répond par un code de la famille des ressources absentes, propre à l'opération, sans débit. Guide des erreurs