Aller au contenu

Documentation

Immeubles

Immeubles de rapport : dossier complet, lots d'une adresse, prime de division d'une commune. 4 opérations servies.

Dossier d'un immeuble de rapport

Essayer en direct
GET/api/v1/annonces/{id}/immeuble

Le dossier d'un immeuble de rapport, en cinq blocs, celui de l'outil analyse_immeuble du Hub : 1. les lots établis par les DPE de l'adresse (candidats dans un rayon de 250 m, confiance par concordance de surface et nombre de logements annoncé, désaccord) ; 2. l'état locatif lot par lot au loyer de la Carte des loyers selon la taille de chaque lot, et une découpe en lots de 40 ou 30 m² ; 3. le prix face à la prime de division DVF de la commune (repli départemental), servie quel que soit le nombre de ventes ; 4. les seuils fiscaux propres à l'immeuble ; 5. les risques datés, dont le calendrier énergétique par étiquette. Le vendeur n'est jamais nommé. Pour une annonce d'immeuble du catalogue Pillr, par son identifiant.

Coût
10 crédits par appel réussi
Accès
À l'usage ou avec l'abonnement Data
Portée
annonces
Outil MCP
analyse_immeuble
Bac à sable
Non
Cache serveur
6 h
Délai maximal
20 s

Paramètres

  • idtexteobligatoire

    Identifiant de l'annonce : lbc:<numéro>, bienici:<identifiant>, seloger:<numéro> ou identifiant Pillr.

    de 3 à 200 caractères

Exemple d'appel

curl https://pillr.fr/api/v1/annonces/lbc:2894512345/immeuble \
  -H "Authorization: Bearer $PILLR_CLE"

Réponse

  • annonceobjet

    L'annonce de l'immeuble ; le vendeur n'y est jamais nommé.

    Afficher les 14 champs
    • idtexte ou null

      Identifiant Pillr de l'annonce analysée ; null pour un immeuble du lac pas encore analysé.

    • sourcetexte
    • lientexte ou null

      Lien d'origine de l'annonce, servi quand la clé porte la portée lien_origine.

    • titretexte ou null
    • communetexte ou null
    • code_postaltexte ou null
    • inseetexte ou null
    • prixnombre ou null
    • surface_m2nombre ou null
    • piecesnombre ou null
    • dpetexte ou null
    • latnombre ou null
    • lonnombre ou null
    • type_vendeurtexte

      Valeurs : pro, particulier, inconnu

  • bloc_1_lotsobjet
    Afficher les 13 champs
    • disponiblebooléen
    • confiancetexte

      mesure : lots énumérés dont la surface cumulée concorde à 20 % près avec la surface annoncée ; indice : lots énumérés sans concordance ; inconnu : aucun DPE exploitable.

      Valeurs : mesure, indice, inconnu

    • nb_lotsentier
    • nb_lots_annonceentier ou null

      Nombre de logements que le titre ou la description annonce.

    • adressetexte ou null

      Adresse BAN des DPE retenus.

    • surface_cumulee_m2nombre ou null
    • surface_annoncee_m2nombre ou null
    • ecart_surface_pctnombre ou null
    • lotsliste d'objets
      Afficher les 3 champs
      • surface_m2nombre ou null
      • etiquette_dpetexte ou null
      • dpe_etabli_letexte ou null
    • desaccordtexte ou null
    • autres_candidatsliste d'objets
      Afficher les 3 champs
      • adressetexte ou null
      • nb_lotsentier
      • surface_cumulee_m2nombre ou null
    • methodetexte
    • 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.

  • bloc_2_etat_locatifobjet
    Afficher les 9 champs
    • loyer_m2_communenombre ou null
    • loyer_sourcetexte ou null
    • loyer_mensuel_estimenombre ou null
    • loyer_annuel_estimenombre ou null
    • rendement_brut_pctnombre ou null
    • detail_lotsliste d'objets
      Afficher les 3 champs
      • surface_m2nombre ou null
      • etiquette_dpetexte ou null
      • loyer_mensuel_eurnombre ou null
    • methodetexte
    • decoupeobjet
      Afficher les 7 champs
      • disponiblebooléen
      • en_lots_de_40_m2objet ou null
        Afficher les 4 champs
        • nb_lotsentier
        • surface_par_lot_m2nombre
        • loyer_mensuelnombre ou null
        • ecart_pctnombre ou null

          Écart au loyer de la configuration actuelle, en %.

      • en_lots_de_30_m2objet ou null
        Afficher les 4 champs
        • nb_lotsentier
        • surface_par_lot_m2nombre
        • loyer_mensuelnombre ou null
        • ecart_pctnombre ou null

          Écart au loyer de la configuration actuelle, en %.

      • loyer_m2_t1_t2nombre ou null
      • loyer_m2_t3plusnombre ou null
      • sourcetexte ou null
      • avertissementtexte 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.

  • bloc_3_prixobjet
    Afficher les 10 champs
    • disponiblebooléen
    • mailletexte ou null

      Valeurs : commune, departement

    • prix_m2_unitenombre ou null
    • prix_m2_blocnombre ou null
    • rapportnombre ou null
    • n_uniteentier
    • n_blocentier
    • positiontexte ou null

      Le prix au m² de l'annonce situé entre le prix en bloc et le prix à l'unité.

    • avertissementtexte
    • 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.

  • bloc_4_fiscaliteobjet
    Afficher les 4 champs
    • seuil_micro_bic_par_lot_eurnombre
    • seuil_micro_foncier_eurnombre
    • seuil_cotisations_sociales_lcd_eurnombre
    • particularitesliste de textes
  • bloc_5_risquesobjet
    Afficher les 4 champs
    • calendrier_energetiquetexte ou null
    • concentrationtexte
    • lots_sous_contrainteentier ou null

      Lots en F ou G parmi les lots établis.

    • a_verifierliste de textes
  • ordretexte
  • calcule_letexte
  • 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

Dossier d'un immeuble pas encore analysé

Essayer en direct
POST/api/v1/immeubles/analyses

Le dossier d'un immeuble de rapport, en cinq blocs, celui de l'outil analyse_immeuble du Hub : 1. les lots établis par les DPE de l'adresse (candidats dans un rayon de 250 m, confiance par concordance de surface et nombre de logements annoncé, désaccord) ; 2. l'état locatif lot par lot au loyer de la Carte des loyers selon la taille de chaque lot, et une découpe en lots de 40 ou 30 m² ; 3. le prix face à la prime de division DVF de la commune (repli départemental), servie quel que soit le nombre de ventes ; 4. les seuils fiscaux propres à l'immeuble ; 5. les risques datés, dont le calendrier énergétique par étiquette. Le vendeur n'est jamais nommé. Pour un immeuble collecté par Pillr que la file d'analyse n'a pas encore atteint, par le lien de son annonce (source_url).

Coût
10 crédits par appel réussi
Accès
À l'usage ou avec l'abonnement Data
Portée
annonces
Outil MCP
analyse_immeuble_calculer
Bac à sable
Non
Cache serveur
6 h
Délai maximal
20 s

Paramètres

  • source_urltexteobligatoire

    Lien de l'annonce de l'immeuble sur son portail d'origine.

    500 caractères au plus ; adresse web

Exemple d'appel

curl -X POST https://pillr.fr/api/v1/immeubles/analyses \
  -H "Authorization: Bearer $PILLR_CLE" \
  -H "Content-Type: application/json" \
  -d '{"source_url":"https://www.leboncoin.fr/ad/ventes_immobilieres/2894512345"}'

Réponse

  • annonceobjet

    L'annonce de l'immeuble ; le vendeur n'y est jamais nommé.

    Afficher les 14 champs
    • idtexte ou null

      Identifiant Pillr de l'annonce analysée ; null pour un immeuble du lac pas encore analysé.

    • sourcetexte
    • lientexte ou null

      Lien d'origine de l'annonce, servi quand la clé porte la portée lien_origine.

    • titretexte ou null
    • communetexte ou null
    • code_postaltexte ou null
    • inseetexte ou null
    • prixnombre ou null
    • surface_m2nombre ou null
    • piecesnombre ou null
    • dpetexte ou null
    • latnombre ou null
    • lonnombre ou null
    • type_vendeurtexte

      Valeurs : pro, particulier, inconnu

  • bloc_1_lotsobjet
    Afficher les 13 champs
    • disponiblebooléen
    • confiancetexte

      mesure : lots énumérés dont la surface cumulée concorde à 20 % près avec la surface annoncée ; indice : lots énumérés sans concordance ; inconnu : aucun DPE exploitable.

      Valeurs : mesure, indice, inconnu

    • nb_lotsentier
    • nb_lots_annonceentier ou null

      Nombre de logements que le titre ou la description annonce.

    • adressetexte ou null

      Adresse BAN des DPE retenus.

    • surface_cumulee_m2nombre ou null
    • surface_annoncee_m2nombre ou null
    • ecart_surface_pctnombre ou null
    • lotsliste d'objets
      Afficher les 3 champs
      • surface_m2nombre ou null
      • etiquette_dpetexte ou null
      • dpe_etabli_letexte ou null
    • desaccordtexte ou null
    • autres_candidatsliste d'objets
      Afficher les 3 champs
      • adressetexte ou null
      • nb_lotsentier
      • surface_cumulee_m2nombre ou null
    • methodetexte
    • 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.

  • bloc_2_etat_locatifobjet
    Afficher les 9 champs
    • loyer_m2_communenombre ou null
    • loyer_sourcetexte ou null
    • loyer_mensuel_estimenombre ou null
    • loyer_annuel_estimenombre ou null
    • rendement_brut_pctnombre ou null
    • detail_lotsliste d'objets
      Afficher les 3 champs
      • surface_m2nombre ou null
      • etiquette_dpetexte ou null
      • loyer_mensuel_eurnombre ou null
    • methodetexte
    • decoupeobjet
      Afficher les 7 champs
      • disponiblebooléen
      • en_lots_de_40_m2objet ou null
        Afficher les 4 champs
        • nb_lotsentier
        • surface_par_lot_m2nombre
        • loyer_mensuelnombre ou null
        • ecart_pctnombre ou null

          Écart au loyer de la configuration actuelle, en %.

      • en_lots_de_30_m2objet ou null
        Afficher les 4 champs
        • nb_lotsentier
        • surface_par_lot_m2nombre
        • loyer_mensuelnombre ou null
        • ecart_pctnombre ou null

          Écart au loyer de la configuration actuelle, en %.

      • loyer_m2_t1_t2nombre ou null
      • loyer_m2_t3plusnombre ou null
      • sourcetexte ou null
      • avertissementtexte 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.

  • bloc_3_prixobjet
    Afficher les 10 champs
    • disponiblebooléen
    • mailletexte ou null

      Valeurs : commune, departement

    • prix_m2_unitenombre ou null
    • prix_m2_blocnombre ou null
    • rapportnombre ou null
    • n_uniteentier
    • n_blocentier
    • positiontexte ou null

      Le prix au m² de l'annonce situé entre le prix en bloc et le prix à l'unité.

    • avertissementtexte
    • 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.

  • bloc_4_fiscaliteobjet
    Afficher les 4 champs
    • seuil_micro_bic_par_lot_eurnombre
    • seuil_micro_foncier_eurnombre
    • seuil_cotisations_sociales_lcd_eurnombre
    • particularitesliste de textes
  • bloc_5_risquesobjet
    Afficher les 4 champs
    • calendrier_energetiquetexte ou null
    • concentrationtexte
    • lots_sous_contrainteentier ou null

      Lots en F ou G parmi les lots établis.

    • a_verifierliste de textes
  • ordretexte
  • calcule_letexte
  • 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

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

Lots d'un immeuble établis par ses DPE

Essayer en direct
GET/api/v1/adresses/{cle_ban}/lots

Les lots d'un immeuble à une adresse (clé BAN), établis par les DPE de ses logements (ADEME) : un lot par DPE d'appartement de moins de 10 ans, surface, étiquette, étage, numéros de DPE ; un DPE remplacé rejoint le lot de son remplaçant. Deux DPE du même étage à la même surface sans lien de remplacement sont signalés comme doublon possible, jamais fusionnés. Le compte est confronté au registre des copropriétés et au DPE de l'immeuble ; chaque écart est dit dans desaccords.

Coût
3 crédits par appel réussi
Accès
À l'usage ou avec l'abonnement Data
Portée
adresse
Outil MCP
lots_adresse
Bac à sable
Non
Cache serveur
24 h
Délai maximal
5 s

Paramètres

  • cle_bantexteobligatoire

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

Exemple d'appel

curl https://pillr.fr/api/v1/adresses/75108_3559_00055/lots \
  -H "Authorization: Bearer $PILLR_CLE"

Réponse

  • cle_bantexte
  • adressetexte ou null
  • inseetexte
  • nb_lotsentier
  • lotsliste d'objets
    Afficher les 5 champs
    • surface_m2nombre ou null
    • etiquette_dpetexte ou null
    • etageentier ou null

      Étage porté par le DPE, 0 pour le rez-de-chaussée ; null s'il ne le dit pas.

    • dpeliste d'objets

      Le DPE en vigueur d'abord, puis ceux qu'il remplace.

      Afficher les 4 champs
      • numero_dpetexte
      • datetexte ou null
      • etiquette_dpetexte ou null
      • surface_m2nombre ou null
    • confiancetexte

      doublon_possible : un autre lot du même étage, à la même surface à 1 m² près, porte un DPE d'une autre date sans dire qu'il le remplace.

      Valeurs : distinct, doublon_possible

  • nb_dpe_ecartesentier

    DPE de l'adresse non retenus : hors appartement, de plus de 10 ans, trop petits, ou remplacés.

  • registreobjet

    Ce que disent le registre des copropriétés et le DPE de l'immeuble, pour contrôler le compte des lots.

    Afficher les 3 champs
    • lots_habitationentier ou null

      Lots d'habitation déclarés au registre national des copropriétés.

    • immatriculationtexte ou null
    • logements_dpe_immeubleentier ou null

      Nombre d'appartements que le DPE le plus récent attribue à l'immeuble, quand il en décrit plusieurs.

  • desaccordsliste de textes
  • methodetexte
  • 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.

  • calcule_letexte
  • 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

Prime de division d'une commune

Essayer en direct
GET/api/v1/communes/{insee}/prime-division

Prime de division mesurée sur DVF dans une commune : prix au m² médian des mutations d'un seul logement face aux mutations de 4 logements ou plus (ventes en bloc), sur les 3 dernières années, avec le nombre de mutations de chaque côté, la période couverte et la qualité de la mesure. Les médianes sont servies quel que soit le nombre de ventes, avec le drapeau peu_d_observations sous les seuils du dossier immeuble ; sous ces seuils, la mesure du département est servie à côté. Paris, Lyon et Marseille se mesurent sur leurs arrondissements. Le rapport est un plafond, pas un profit.

Coût
2 crédits par appel réussi
Accès
À l'usage ou avec l'abonnement Data
Portée
territoire
Outil MCP
prime_division
Bac à sable
Oui, sans débit, sur un jeu figé
Cache serveur
24 h
Délai maximal
16 s

Paramètres

  • inseetexteobligatoire

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

Exemple d'appel

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

Cette entrée est dans le bac à sable : une clé pk_test_ obtient la réponse, sans débit.

Réponse du bac à sable

{
  "insee": "76540",
  "commune_nom": "Rouen",
  "commune": {
    "maille": "commune",
    "code": "76540",
    "prix_m2_unite": 2628,
    "prix_m2_bloc": 2250,
    "rapport": 1.17,
    "prime_pct": 16.8,
    "n_unite": 5052,
    "n_bloc": 180,
    "periode": {
      "du": "2023-11-22",
      "au": "2026-06-30"
    },
    "millesimes": [
      2023,
      2024,
      2025,
      2026
    ],
    "qualite": {
      "n": 5232,
      "provenance": "mesure",
      "incertitude": null,
      "drapeaux": [],
      "methode": "Médianes du prix au m² des mutations DVF de vente des 3 dernières années, prix et surfaces aberrants écartés : une mutation d'un seul logement contre une mutation de 4 logements ou plus. Seuils du dossier immeuble : 20 ventes à l'unité et 5 en bloc.",
      "donnees_du": "2026-06-30",
      "source": "DVF (DGFiP), mutations à titre onéreux"
    }
  },
  "departement": null,
  "avertissement": "Ce rapport est un PLAFOND, pas un profit : une vente en bloc embarque des surfaces qui ne sont pas des lots vendables (caves, local commercial, dépendances), et la division coûte géomètre, règlement de copropriété, diagnostics, parfois une autorisation de division, puis des années pour écouler les lots.",
  "calcule_le": "2026-11-22T14:58:21.309Z",
  "credits": {
    "debites": 0,
    "restants": null
  }
}

Réponse réelle de l'API à cette entrée, obtenue avec le moteur du bac à sable, donnée du 30/06/2026.

Réponse

  • inseetexte
  • commune_nomtexte ou null
  • communeobjet
    Afficher les 11 champs
    • mailletexte

      Valeurs : commune, departement

    • codetexte

      Code INSEE de la commune, ou code du département.

    • prix_m2_unitenombre ou null

      Prix au m² médian des mutations d'un seul logement (un lot revendu à l'unité), en euros.

    • prix_m2_blocnombre ou null

      Prix au m² médian des mutations de 4 logements ou plus (vente en bloc), en euros.

    • rapportnombre ou null

      prix_m2_unite divisé par prix_m2_bloc.

    • prime_pctnombre ou null

      Écart du prix à l'unité au prix en bloc, en % du prix en bloc.

    • n_uniteentier

      Mutations d'un seul logement retenues.

    • n_blocentier

      Mutations de 4 logements ou plus retenues.

    • periodeobjet

      Première et dernière mutation retenues.

      Afficher les 2 champs
      • dutexte ou null
      • autexte ou null
    • millesimesliste d'entiers

      Années couvertes par les mutations retenues.

    • 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.

  • departementobjet ou null

    Repli départemental, mesuré seulement quand la commune n'atteint pas les seuils du dossier immeuble (ventes à l'unité ou en bloc) ; null sinon.

    Afficher les 11 champs
    • mailletexte

      Valeurs : commune, departement

    • codetexte

      Code INSEE de la commune, ou code du département.

    • prix_m2_unitenombre ou null

      Prix au m² médian des mutations d'un seul logement (un lot revendu à l'unité), en euros.

    • prix_m2_blocnombre ou null

      Prix au m² médian des mutations de 4 logements ou plus (vente en bloc), en euros.

    • rapportnombre ou null

      prix_m2_unite divisé par prix_m2_bloc.

    • prime_pctnombre ou null

      Écart du prix à l'unité au prix en bloc, en % du prix en bloc.

    • n_uniteentier

      Mutations d'un seul logement retenues.

    • n_blocentier

      Mutations de 4 logements ou plus retenues.

    • periodeobjet

      Première et dernière mutation retenues.

      Afficher les 2 champs
      • dutexte ou null
      • autexte ou null
    • millesimesliste d'entiers

      Années couvertes par les mutations retenues.

    • 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.

  • avertissementtexte
  • calcule_letexte
  • 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_ demande une entrée hors du jeu figé de l'opération
  • 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