Aller au contenu

Documentation

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
GET/api/v1/adresses/{cle_ban}/ventes
GET/api/v1/parcelles/{id_parcelle}/ventes

Toutes 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_bantexteobligatoire

    Clé d'interopérabilité de la Base Adresse Nationale, ex. 69383_1234_00012.

  • depuistexte

    Ne garder que les mutations à partir de cette date (AAAA-MM-JJ).

  • jusqu_atexte

    Ne garder que les mutations jusqu'à cette date comprise (AAAA-MM-JJ).

  • inclure_2018_2020valeur

    Ajouter les ventes de 2018 à 2020 rapprochées par position (adresse seulement). Vrai par défaut.

    par défaut true

  • rayon_position_mentier

    Rayon 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_parcelletexteobligatoire

    Identifiant 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 null

    Clé BAN demandée ; null pour une demande par parcelle.

  • id_parcelletexte ou null

    Parcelle demandée ; null pour une demande par adresse.

  • rattachementtexte ou null

    Comment les ventes 2021 et suivantes ont été trouvées : au numéro, sinon aux parcelles de l'adresse ; null si aucune.

    Valeurs : numero, parcelle, position

  • adresseobjet ou null

    L'adresse résolue (Base Adresse Nationale et faits Pillr de l'adresse) ; null pour une demande par parcelle.

    Afficher les 7 champs
    • numerotexte ou null
    • voietexte ou null
    • code_postaltexte ou null
    • inseetexte ou null
    • communetexte ou null
    • latnombre ou null
    • lonnombre ou null
  • parcelles_luesliste de textes

    Parcelles lues pour le rattachement par parcelle.

  • mutationsliste d'objets

    Toutes les mutations, la plus récente d'abord.

    Afficher les 23 champs
    • id_mutationtexte ou null

      Identifiant DVF de la mutation ; null pour une vente de 2018 à 2020 (fichier sans identifiant).

    • datetexte

      Date de la mutation (AAAA-MM-JJ).

    • naturetexte ou null

      Nature de la mutation : Vente, Vente en l'état futur d'achèvement, Adjudication, Échange...

    • valeur_foncierenombre ou null

      Valeur foncière de la mutation entière, en euros.

    • adresseobjet ou null

      Adresse DVF de la mutation (celle de ses logements d'abord) ; null quand DVF n'en donne pas.

      Afficher les 4 champs
      • numerotexte ou null

        Numéro dans la voie, suffixe compris (« 12 bis »), tel que DVF l'écrit.

      • voietexte ou null

        Libellé DVF de la voie, souvent abrégé.

      • code_voietexte ou null

        Code FANTOIR de la voie, le même que dans la clé BAN.

      • cle_bantexte ou null

        Clé 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 null
    • inseetexte ou null

      Code INSEE de la commune DVF (l'arrondissement à Paris, Lyon et Marseille).

    • nb_dispositionsentier

      Dispositions de l'acte (une vente peut en compter plusieurs).

    • locauxliste d'objets

      Locaux de la mutation, lus une fois par parcelle.

      Afficher les 5 champs
      • typetexte

        Type de local DVF : Appartement, Maison, Dépendance, Local industriel. commercial ou assimilé.

      • surface_batinombre ou null

        Surface réelle bâtie du local, en m².

      • piecesentier ou null

        Nombre de pièces principales.

      • id_parcelletexte ou null
      • lotsliste d'objets

        Lots déclarés sur la ligne du local (cinq au plus dans DVF).

        Afficher les 2 champs
        • numerotexte

          Numéro du lot de copropriété.

        • carreznombre ou null

          Surface Carrez du lot, en m² ; null quand elle n'est pas déclarée.

    • nombre_lotsentier ou null

      Lots de copropriété déclarés dans la mutation.

    • terrainsliste d'objets

      Terrains de la mutation, par parcelle et nature de culture.

      Afficher les 4 champs
      • id_parcelletexte ou null
      • nature_culturetexte ou null

        Nature de culture du terrain (sols, jardins, terres...).

      • nature_culture_specialetexte ou null
      • surfacenombre ou null

        Surface du terrain, en m².

    • surface_terrainnombre ou null

      Somme des surfaces de terrain, en m².

    • parcellesliste de textes

      Parcelles cadastrales de la mutation.

    • volumesliste de textes

      Numéros de volume (division en volumes), s'il y en a.

    • latnombre ou null
    • lonnombre ou null
    • surface_logementsnombre ou null

      Surface bâtie des appartements et maisons, en m².

    • prix_m2nombre ou null

      Valeur foncière rapportée à la surface bâtie des logements, en euros par m², arrondie ; null sans logement. Recalculé à la mutation, jamais à la ligne.

    • indicateursobjet
      Afficher les 6 champs
      • logementsentier

        Appartements et maisons de la mutation.

      • vente_en_blocbooléen

        Plus d'un logement : le prix au m² porte sur l'ensemble des logements.

      • avec_dependancebooléen

        La mutation comprend une dépendance (cave, parking, garage).

      • avec_local_probooléen

        La mutation comprend un local industriel, commercial ou assimilé.

      • prix_atypiquebooléen

        Surface ou prix au m² hors des bornes du barème Pillr : à lire avec prudence.

      • motiftexte ou null

        Pourquoi le prix est atypique ; null sinon.

    • qualiteobjet

      Qualité du prix au m² de cette vente : une observation, ses drapeaux et sa méthode.

      Afficher les 7 champs
      • nentier ou null

        Nombre d'observations derrière la valeur ; null si sans objet.

        0 au moins

      • provenancetexte ou null

        mesure : observé sur la donnée ; estime : modèle, barème ou imputation ; null : sans objet.

        Valeurs : mesure, estime

      • incertitudeobjet ou null

        Incertitude de la valeur : fourchette et demi-largeur.

        Afficher les 3 champs
        • demi_largeur_pctnombre ou null

          Demi-largeur de la fourchette, en % de la valeur.

        • basnombre ou null
        • hautnombre ou null
      • drapeauxliste de textes

        Ce 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_ancienne

      • methodetexte ou null

        Méthode de calcul ou de rattachement, en clair.

      • donnees_dutexte ou null

        Date de la donnée (AAAA-MM-JJ ou horodatage ISO 8601).

      • sourcetexte

        Source publique ou moteur Pillr, en clair.

    • millesimetexte ou null

      Millésime du fichier DVF qui porte la mutation.

    • rattachementtexte

      numero : 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, position

    • distance_mentier ou null

      Distance entre la vente et l'adresse demandée, en mètres ; null sans position.

  • resumeobjet
    Afficher les 4 champs
    • nentier

      Mutations servies.

    • n_2021_et_apresentier
    • n_2018_2020entier
    • derniereobjet ou null

      La mutation la plus récente.

      Afficher les 3 champs
      • datetexte
      • prixnombre ou null
      • prix_m2nombre ou null
  • millesimesobjet

    Premier et dernier millésimes DVF des mutations servies.

    Afficher les 2 champs
    • premiertexte ou null
    • derniertexte ou null
  • donnees_dutexte ou null

    Date de chargement des lignes DVF servies (horodatage ISO 8601).

  • limitesliste de textes

    Ce que la réponse ne couvre pas, en clair.

  • creditsobjet

    Cré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 champs
    • debitesentier

      0 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'API

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
GET/api/v1/ventes
GET/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

  • latnombre

    Latitude du point (WGS 84), avec lon.

    de -90 à 90

  • lonnombre

    Longitude du point (WGS 84), avec lat.

    de -180 à 180

  • rayon_mentier

    Rayon autour du point, en mètres (300 par défaut, 2000 au plus).

    de 10 à 2 000

  • inseetexte

    Code INSEE de la commune DVF (l'arrondissement à Paris, Lyon et Marseille).

  • typetexte

    Ne garder que les mutations qui comptent ce type de local.

    Valeurs : appartement, maison, dependance, local

  • naturetexte

    Nature de la mutation : vente, vefa, terrain_a_batir, adjudication, echange, expropriation.

    Valeurs : vente, vefa, terrain_a_batir, adjudication, echange, expropriation

  • depuistexte

    Mutations à partir de cette date (AAAA-MM-JJ).

  • jusqu_atexte

    Mutations jusqu'à cette date comprise (AAAA-MM-JJ).

  • surface_minnombre

    Surface bâtie des logements, minimum, en m².

    0 au moins

  • surface_maxnombre

    Surface bâtie des logements, maximum, en m².

    0 au moins

  • prix_minnombre

    Valeur foncière de la mutation, minimum, en euros.

    0 au moins

  • prix_maxnombre

    Valeur foncière de la mutation, maximum, en euros.

    0 au moins

  • tritexte

    date (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, distance

  • limiteentier

    Nombre d'éléments par page (50 au plus).

    de 1 à 50 ; par défaut 20

  • curseurtexte

    Curseur 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_mutationtexteobligatoire

    Identifiant 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

  • rechercheobjet

    La recherche servie, telle que lue.

    Afficher les 6 champs
    • modetexte

      Valeurs : mutation, point, commune

    • tritexte

      Valeurs : date, distance

    • inseetexte ou null
    • latnombre ou null
    • lonnombre ou null
    • rayon_mentier ou null
  • donneesliste d'objets

    Les mutations de la page, chacune avec toutes ses lignes et son adresse.

    Afficher les 23 champs
    • id_mutationtexte ou null

      Identifiant DVF de la mutation ; null pour une vente de 2018 à 2020 (fichier sans identifiant).

    • datetexte

      Date de la mutation (AAAA-MM-JJ).

    • naturetexte ou null

      Nature de la mutation : Vente, Vente en l'état futur d'achèvement, Adjudication, Échange...

    • valeur_foncierenombre ou null

      Valeur foncière de la mutation entière, en euros.

    • adresseobjet ou null

      Adresse DVF de la mutation (celle de ses logements d'abord) ; null quand DVF n'en donne pas.

      Afficher les 4 champs
      • numerotexte ou null

        Numéro dans la voie, suffixe compris (« 12 bis »), tel que DVF l'écrit.

      • voietexte ou null

        Libellé DVF de la voie, souvent abrégé.

      • code_voietexte ou null

        Code FANTOIR de la voie, le même que dans la clé BAN.

      • cle_bantexte ou null

        Clé 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 null
    • inseetexte ou null

      Code INSEE de la commune DVF (l'arrondissement à Paris, Lyon et Marseille).

    • nb_dispositionsentier

      Dispositions de l'acte (une vente peut en compter plusieurs).

    • locauxliste d'objets

      Locaux de la mutation, lus une fois par parcelle.

      Afficher les 5 champs
      • typetexte

        Type de local DVF : Appartement, Maison, Dépendance, Local industriel. commercial ou assimilé.

      • surface_batinombre ou null

        Surface réelle bâtie du local, en m².

      • piecesentier ou null

        Nombre de pièces principales.

      • id_parcelletexte ou null
      • lotsliste d'objets

        Lots déclarés sur la ligne du local (cinq au plus dans DVF).

        Afficher les 2 champs
        • numerotexte

          Numéro du lot de copropriété.

        • carreznombre ou null

          Surface Carrez du lot, en m² ; null quand elle n'est pas déclarée.

    • nombre_lotsentier ou null

      Lots de copropriété déclarés dans la mutation.

    • terrainsliste d'objets

      Terrains de la mutation, par parcelle et nature de culture.

      Afficher les 4 champs
      • id_parcelletexte ou null
      • nature_culturetexte ou null

        Nature de culture du terrain (sols, jardins, terres...).

      • nature_culture_specialetexte ou null
      • surfacenombre ou null

        Surface du terrain, en m².

    • surface_terrainnombre ou null

      Somme des surfaces de terrain, en m².

    • parcellesliste de textes

      Parcelles cadastrales de la mutation.

    • volumesliste de textes

      Numéros de volume (division en volumes), s'il y en a.

    • latnombre ou null
    • lonnombre ou null
    • surface_logementsnombre ou null

      Surface bâtie des appartements et maisons, en m².

    • prix_m2nombre ou null

      Valeur foncière rapportée à la surface bâtie des logements, en euros par m², arrondie ; null sans logement. Recalculé à la mutation, jamais à la ligne.

    • indicateursobjet
      Afficher les 6 champs
      • logementsentier

        Appartements et maisons de la mutation.

      • vente_en_blocbooléen

        Plus d'un logement : le prix au m² porte sur l'ensemble des logements.

      • avec_dependancebooléen

        La mutation comprend une dépendance (cave, parking, garage).

      • avec_local_probooléen

        La mutation comprend un local industriel, commercial ou assimilé.

      • prix_atypiquebooléen

        Surface ou prix au m² hors des bornes du barème Pillr : à lire avec prudence.

      • motiftexte ou null

        Pourquoi le prix est atypique ; null sinon.

    • qualiteobjet

      Qualité du prix au m² de cette vente : une observation, ses drapeaux et sa méthode.

      Afficher les 7 champs
      • nentier ou null

        Nombre d'observations derrière la valeur ; null si sans objet.

        0 au moins

      • provenancetexte ou null

        mesure : observé sur la donnée ; estime : modèle, barème ou imputation ; null : sans objet.

        Valeurs : mesure, estime

      • incertitudeobjet ou null

        Incertitude de la valeur : fourchette et demi-largeur.

        Afficher les 3 champs
        • demi_largeur_pctnombre ou null

          Demi-largeur de la fourchette, en % de la valeur.

        • basnombre ou null
        • hautnombre ou null
      • drapeauxliste de textes

        Ce 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_ancienne

      • methodetexte ou null

        Méthode de calcul ou de rattachement, en clair.

      • donnees_dutexte ou null

        Date de la donnée (AAAA-MM-JJ ou horodatage ISO 8601).

      • sourcetexte

        Source publique ou moteur Pillr, en clair.

    • millesimetexte ou null

      Millésime du fichier DVF qui porte la mutation.

    • distance_mentier ou null

      Distance au point demandé, en mètres ; null hors d'une recherche autour d'un point.

    • iristexte ou null

      Code IRIS de la vente (ventes de logement rattachées par Pillr) ; null sinon.

  • limitesliste de textes

    Ce que la page ne couvre pas, en clair.

  • curseur_suivanttexte ou null

    Curseur de la page suivante, à repasser dans curseur ; null sur la dernière page.

  • creditsobjet

    Cré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 champs
    • debitesentier

      0 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'API

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
GET/api/v1/ventes/rue

Les 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

  • voietexte

    Nom de la voie, ex. « rue de Genève ».

    de 2 à 160 caractères

  • code_voietexte

    Code FANTOIR de la voie (deuxième segment de la clé BAN), avec insee, au lieu de son nom.

  • inseetexte

    Code INSEE de la commune DVF (l'arrondissement à Paris, Lyon et Marseille).

  • code_postaltexte

    Code postal, à défaut du code INSEE.

  • typetexte

    Ne servir qu'un type de bien.

    Valeurs : appartement, maison

  • depuistexte

    Ne 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

  • cibleobjet
    Afficher les 6 champs
    • perimetretexte

      Valeurs : voie, commune

    • voietexte ou null

      La 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 null
    • communetexte ou null
    • inseetexte
    • code_postaltexte ou null
  • par_typeobjet
    Afficher les 2 champs
    • appartementobjet ou null
      Afficher les 3 champs
      • periodeobjet ou null

        Toutes les années réunies, prix non ramenés à une même date ; null sans vente typique.

        Afficher les 11 champs
        • periodetexte

          Période couverte, ex. « 2021 à 2025 ».

        • nentier

          Ventes typiques qui portent l'agrégat : à lire avant la médiane.

        • mediane_m2nombre

          Prix au m² médian, en euros.

        • q1nombre ou null

          Premier quartile du prix au m², dès 2 ventes.

        • q3nombre ou null

          Troisième quartile du prix au m², dès 2 ventes.

        • minnombre
        • maxnombre
        • surface_medianenombre

          Surface médiane, en m².

        • derniere_vente_letexte
        • n_prix_atypiquesentier

          Ventes au prix atypique du groupe, écartées de l'agrégat (listées à la voie).

        • qualiteobjet

          Ce qui permet de juger la valeur : nombre, provenance, incertitude, drapeaux, date et source.

          Afficher les 7 champs
          • nentier ou null

            Nombre d'observations derrière la valeur ; null si sans objet.

            0 au moins

          • provenancetexte ou null

            mesure : observé sur la donnée ; estime : modèle, barème ou imputation ; null : sans objet.

            Valeurs : mesure, estime

          • incertitudeobjet ou null

            Incertitude de la valeur : fourchette et demi-largeur.

            Afficher les 3 champs
            • demi_largeur_pctnombre ou null

              Demi-largeur de la fourchette, en % de la valeur.

            • basnombre ou null
            • hautnombre ou null
          • drapeauxliste de textes

            Ce 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_ancienne

          • methodetexte ou null

            Méthode de calcul ou de rattachement, en clair.

          • donnees_dutexte ou null

            Date de la donnée (AAAA-MM-JJ ou horodatage ISO 8601).

          • sourcetexte

            Source publique ou moteur Pillr, en clair.

      • par_anneeliste d'objets

        Chaque année qui compte au moins une vente typique, la plus récente d'abord.

        Afficher les 11 champs
        • anneeentier
        • nentier

          Ventes typiques qui portent l'agrégat : à lire avant la médiane.

        • mediane_m2nombre

          Prix au m² médian, en euros.

        • q1nombre ou null

          Premier quartile du prix au m², dès 2 ventes.

        • q3nombre ou null

          Troisième quartile du prix au m², dès 2 ventes.

        • minnombre
        • maxnombre
        • surface_medianenombre

          Surface médiane, en m².

        • derniere_vente_letexte
        • n_prix_atypiquesentier

          Ventes au prix atypique du groupe, écartées de l'agrégat (listées à la voie).

        • qualiteobjet

          Ce qui permet de juger la valeur : nombre, provenance, incertitude, drapeaux, date et source.

          Afficher les 7 champs
          • nentier ou null

            Nombre d'observations derrière la valeur ; null si sans objet.

            0 au moins

          • provenancetexte ou null

            mesure : observé sur la donnée ; estime : modèle, barème ou imputation ; null : sans objet.

            Valeurs : mesure, estime

          • incertitudeobjet ou null

            Incertitude de la valeur : fourchette et demi-largeur.

            Afficher les 3 champs
            • demi_largeur_pctnombre ou null

              Demi-largeur de la fourchette, en % de la valeur.

            • basnombre ou null
            • hautnombre ou null
          • drapeauxliste de textes

            Ce 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_ancienne

          • methodetexte ou null

            Méthode de calcul ou de rattachement, en clair.

          • donnees_dutexte ou null

            Date de la donnée (AAAA-MM-JJ ou horodatage ISO 8601).

          • sourcetexte

            Source publique ou moteur Pillr, en clair.

      • notetexte ou null
    • maisonobjet ou null
      Afficher les 3 champs
      • periodeobjet ou null

        Toutes les années réunies, prix non ramenés à une même date ; null sans vente typique.

        Afficher les 11 champs
        • periodetexte

          Période couverte, ex. « 2021 à 2025 ».

        • nentier

          Ventes typiques qui portent l'agrégat : à lire avant la médiane.

        • mediane_m2nombre

          Prix au m² médian, en euros.

        • q1nombre ou null

          Premier quartile du prix au m², dès 2 ventes.

        • q3nombre ou null

          Troisième quartile du prix au m², dès 2 ventes.

        • minnombre
        • maxnombre
        • surface_medianenombre

          Surface médiane, en m².

        • derniere_vente_letexte
        • n_prix_atypiquesentier

          Ventes au prix atypique du groupe, écartées de l'agrégat (listées à la voie).

        • qualiteobjet

          Ce qui permet de juger la valeur : nombre, provenance, incertitude, drapeaux, date et source.

          Afficher les 7 champs
          • nentier ou null

            Nombre d'observations derrière la valeur ; null si sans objet.

            0 au moins

          • provenancetexte ou null

            mesure : observé sur la donnée ; estime : modèle, barème ou imputation ; null : sans objet.

            Valeurs : mesure, estime

          • incertitudeobjet ou null

            Incertitude de la valeur : fourchette et demi-largeur.

            Afficher les 3 champs
            • demi_largeur_pctnombre ou null

              Demi-largeur de la fourchette, en % de la valeur.

            • basnombre ou null
            • hautnombre ou null
          • drapeauxliste de textes

            Ce 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_ancienne

          • methodetexte ou null

            Méthode de calcul ou de rattachement, en clair.

          • donnees_dutexte ou null

            Date de la donnée (AAAA-MM-JJ ou horodatage ISO 8601).

          • sourcetexte

            Source publique ou moteur Pillr, en clair.

      • par_anneeliste d'objets

        Chaque année qui compte au moins une vente typique, la plus récente d'abord.

        Afficher les 11 champs
        • anneeentier
        • nentier

          Ventes typiques qui portent l'agrégat : à lire avant la médiane.

        • mediane_m2nombre

          Prix au m² médian, en euros.

        • q1nombre ou null

          Premier quartile du prix au m², dès 2 ventes.

        • q3nombre ou null

          Troisième quartile du prix au m², dès 2 ventes.

        • minnombre
        • maxnombre
        • surface_medianenombre

          Surface médiane, en m².

        • derniere_vente_letexte
        • n_prix_atypiquesentier

          Ventes au prix atypique du groupe, écartées de l'agrégat (listées à la voie).

        • qualiteobjet

          Ce qui permet de juger la valeur : nombre, provenance, incertitude, drapeaux, date et source.

          Afficher les 7 champs
          • nentier ou null

            Nombre d'observations derrière la valeur ; null si sans objet.

            0 au moins

          • provenancetexte ou null

            mesure : observé sur la donnée ; estime : modèle, barème ou imputation ; null : sans objet.

            Valeurs : mesure, estime

          • incertitudeobjet ou null

            Incertitude de la valeur : fourchette et demi-largeur.

            Afficher les 3 champs
            • demi_largeur_pctnombre ou null

              Demi-largeur de la fourchette, en % de la valeur.

            • basnombre ou null
            • hautnombre ou null
          • drapeauxliste de textes

            Ce 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_ancienne

          • methodetexte ou null

            Méthode de calcul ou de rattachement, en clair.

          • donnees_dutexte ou null

            Date de la donnée (AAAA-MM-JJ ou horodatage ISO 8601).

          • sourcetexte

            Source 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 champs
    • datetexte
    • numerotexte ou null

      Numéro dans la voie, suffixe compris ; null quand DVF n'en donne pas.

    • adressetexte ou null

      Numéro et voie, tels que DVF les écrit.

    • typetexte

      Valeurs : appartement, maison

    • surfacenombre

      Surface du logement, en m².

    • prixnombre ou null

      Valeur foncière de la mutation, en euros.

    • prix_m2nombre
    • id_mutationtexte ou null
    • qualiteobjet

      Ce qui permet de juger la valeur : nombre, provenance, incertitude, drapeaux, date et source.

      Afficher les 7 champs
      • nentier ou null

        Nombre d'observations derrière la valeur ; null si sans objet.

        0 au moins

      • provenancetexte ou null

        mesure : observé sur la donnée ; estime : modèle, barème ou imputation ; null : sans objet.

        Valeurs : mesure, estime

      • incertitudeobjet ou null

        Incertitude de la valeur : fourchette et demi-largeur.

        Afficher les 3 champs
        • demi_largeur_pctnombre ou null

          Demi-largeur de la fourchette, en % de la valeur.

        • basnombre ou null
        • hautnombre ou null
      • drapeauxliste de textes

        Ce 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_ancienne

      • methodetexte ou null

        Méthode de calcul ou de rattachement, en clair.

      • donnees_dutexte ou null

        Date de la donnée (AAAA-MM-JJ ou horodatage ISO 8601).

      • sourcetexte

        Source publique ou moteur Pillr, en clair.

  • ventes_totalentier ou null

    Ventes de la voie quand la liste est tronquée ; null sinon.

  • prix_reference_communeobjet
    Afficher les 3 champs
    • appartementobjet ou null
      Afficher les 3 champs
      • prix_m2nombre
      • libelletexte

        Comment citer ce prix.

      • qualiteobjet

        Ce qui permet de juger la valeur : nombre, provenance, incertitude, drapeaux, date et source.

        Afficher les 7 champs
        • nentier ou null

          Nombre d'observations derrière la valeur ; null si sans objet.

          0 au moins

        • provenancetexte ou null

          mesure : observé sur la donnée ; estime : modèle, barème ou imputation ; null : sans objet.

          Valeurs : mesure, estime

        • incertitudeobjet ou null

          Incertitude de la valeur : fourchette et demi-largeur.

          Afficher les 3 champs
          • demi_largeur_pctnombre ou null

            Demi-largeur de la fourchette, en % de la valeur.

          • basnombre ou null
          • hautnombre ou null
        • drapeauxliste de textes

          Ce 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_ancienne

        • methodetexte ou null

          Méthode de calcul ou de rattachement, en clair.

        • donnees_dutexte ou null

          Date de la donnée (AAAA-MM-JJ ou horodatage ISO 8601).

        • sourcetexte

          Source publique ou moteur Pillr, en clair.

    • maisonobjet ou null
      Afficher les 3 champs
      • prix_m2nombre
      • libelletexte

        Comment citer ce prix.

      • qualiteobjet

        Ce qui permet de juger la valeur : nombre, provenance, incertitude, drapeaux, date et source.

        Afficher les 7 champs
        • nentier ou null

          Nombre d'observations derrière la valeur ; null si sans objet.

          0 au moins

        • provenancetexte ou null

          mesure : observé sur la donnée ; estime : modèle, barème ou imputation ; null : sans objet.

          Valeurs : mesure, estime

        • incertitudeobjet ou null

          Incertitude de la valeur : fourchette et demi-largeur.

          Afficher les 3 champs
          • demi_largeur_pctnombre ou null

            Demi-largeur de la fourchette, en % de la valeur.

          • basnombre ou null
          • hautnombre ou null
        • drapeauxliste de textes

          Ce 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_ancienne

        • methodetexte ou null

          Méthode de calcul ou de rattachement, en clair.

        • donnees_dutexte ou null

          Date de la donnée (AAAA-MM-JJ ou horodatage ISO 8601).

        • sourcetexte

          Source publique ou moteur Pillr, en clair.

    • sourcetexte
  • millesimestexte ou null
  • notetexte
  • limitesliste de textes
  • creditsobjet

    Cré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 champs
    • debitesentier

      0 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'API

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
GET/api/v1/communes/{insee}/ventes
GET/api/v1/codes-postaux/{code_postal}/ventes

Les 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

  • inseetexteobligatoire

    Code INSEE de la commune ou de l'arrondissement (5 caractères, 2A ou 2B pour la Corse).

  • typetexte

    Ne 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_postaltexteobligatoire

    Code postal.

Exemple d'appel

curl https://pillr.fr/api/v1/communes/76540/ventes \
  -H "Authorization: Bearer $PILLR_CLE"

Réponse

  • communeobjet
    Afficher les 3 champs
    • inseetexte
    • nomtexte ou null
    • code_postaltexte ou null

      Code postal principal de la commune, celui de la vélocité.

  • par_trimestreliste d'objets

    Ventes DVF de la commune par trimestre, le plus ancien d'abord.

    Afficher les 7 champs
    • trimestretexte

      Trimestre, ex. 2025-T4.

    • debuttexte

      Premier jour du trimestre.

    • ventesentier
    • appartementsentier ou null
    • maisonsentier ou null
    • prix_m2_mediannombre ou null

      Médiane du prix au m² des ventes du trimestre, en euros.

    • qualiteobjet

      Ce qui permet de juger la valeur : nombre, provenance, incertitude, drapeaux, date et source.

      Afficher les 7 champs
      • nentier ou null

        Nombre d'observations derrière la valeur ; null si sans objet.

        0 au moins

      • provenancetexte ou null

        mesure : observé sur la donnée ; estime : modèle, barème ou imputation ; null : sans objet.

        Valeurs : mesure, estime

      • incertitudeobjet ou null

        Incertitude de la valeur : fourchette et demi-largeur.

        Afficher les 3 champs
        • demi_largeur_pctnombre ou null

          Demi-largeur de la fourchette, en % de la valeur.

        • basnombre ou null
        • hautnombre ou null
      • drapeauxliste de textes

        Ce 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_ancienne

      • methodetexte ou null

        Méthode de calcul ou de rattachement, en clair.

      • donnees_dutexte ou null

        Date de la donnée (AAAA-MM-JJ ou horodatage ISO 8601).

      • sourcetexte

        Source publique ou moteur Pillr, en clair.

  • par_anneeliste d'objets

    Série annuelle du prix au m² et des transactions de la commune, la plus ancienne d'abord.

    Afficher les 14 champs
    • anneeentier
    • transactions_appartementsentier ou null
    • transactions_maisonsentier ou null
    • transactions_totalentier ou null
    • prix_m2_appartementnombre ou null
    • prix_m2_maisonnombre ou null
    • prix_m2_globalnombre ou null
    • min_appartementnombre ou null
    • max_appartementnombre ou null
    • min_maisonnombre ou null
    • max_maisonnombre ou null
    • basse_confiance_appartementbooléen ou null
    • basse_confiance_maisonbooléen ou null
    • qualiteobjet

      Ce qui permet de juger la valeur : nombre, provenance, incertitude, drapeaux, date et source.

      Afficher les 7 champs
      • nentier ou null

        Nombre d'observations derrière la valeur ; null si sans objet.

        0 au moins

      • provenancetexte ou null

        mesure : observé sur la donnée ; estime : modèle, barème ou imputation ; null : sans objet.

        Valeurs : mesure, estime

      • incertitudeobjet ou null

        Incertitude de la valeur : fourchette et demi-largeur.

        Afficher les 3 champs
        • demi_largeur_pctnombre ou null

          Demi-largeur de la fourchette, en % de la valeur.

        • basnombre ou null
        • hautnombre ou null
      • drapeauxliste de textes

        Ce 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_ancienne

      • methodetexte ou null

        Méthode de calcul ou de rattachement, en clair.

      • donnees_dutexte ou null

        Date de la donnée (AAAA-MM-JJ ou horodatage ISO 8601).

      • sourcetexte

        Source publique ou moteur Pillr, en clair.

  • velociteobjet ou null

    Vélocité au code postal principal ; null sans code postal connu.

    Afficher les 5 champs
    • code_postaltexte
    • par_anneeliste d'objets
      Afficher les 2 champs
      • anneeentier
      • ventesentier
    • evolution_volume_pctnombre ou null

      Évolution du volume de la première année à la dernière année pleine, en %.

    • lecturetexte

      Ce que dit l'évolution du volume sur la liquidité du marché (même lecture que le Hub).

    • qualiteobjet

      Ce qui permet de juger la valeur : nombre, provenance, incertitude, drapeaux, date et source.

      Afficher les 7 champs
      • nentier ou null

        Nombre d'observations derrière la valeur ; null si sans objet.

        0 au moins

      • provenancetexte ou null

        mesure : observé sur la donnée ; estime : modèle, barème ou imputation ; null : sans objet.

        Valeurs : mesure, estime

      • incertitudeobjet ou null

        Incertitude de la valeur : fourchette et demi-largeur.

        Afficher les 3 champs
        • demi_largeur_pctnombre ou null

          Demi-largeur de la fourchette, en % de la valeur.

        • basnombre ou null
        • hautnombre ou null
      • drapeauxliste de textes

        Ce 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_ancienne

      • methodetexte ou null

        Méthode de calcul ou de rattachement, en clair.

      • donnees_dutexte ou null

        Date de la donnée (AAAA-MM-JJ ou horodatage ISO 8601).

      • sourcetexte

        Source publique ou moteur Pillr, en clair.

  • limitesliste de textes
  • creditsobjet

    Cré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 champs
    • debitesentier

      0 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'API

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 : référence de l'API | Pillr Data