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/api/v1/annonces/{id}/immeubleLe 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
idtexteobligatoireIdentifiant 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
annonceobjetL'annonce de l'immeuble ; le vendeur n'y est jamais nommé.
Afficher les 14 champsMasquer
idtexte ou nullIdentifiant Pillr de l'annonce analysée ; null pour un immeuble du lac pas encore analysé.
sourcetextelientexte ou nullLien d'origine de l'annonce, servi quand la clé porte la portée lien_origine.
titretexte ou nullcommunetexte ou nullcode_postaltexte ou nullinseetexte ou nullprixnombre ou nullsurface_m2nombre ou nullpiecesnombre ou nulldpetexte ou nulllatnombre ou nulllonnombre ou nulltype_vendeurtexteValeurs :
pro,particulier,inconnu
bloc_1_lotsobjetAfficher les 13 champsMasquer
disponiblebooléenconfiancetextemesure : 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,inconnunb_lotsentiernb_lots_annonceentier ou nullNombre de logements que le titre ou la description annonce.
adressetexte ou nullAdresse BAN des DPE retenus.
surface_cumulee_m2nombre ou nullsurface_annoncee_m2nombre ou nullecart_surface_pctnombre ou nulllotsliste d'objetsAfficher les 3 champsMasquer
surface_m2nombre ou nulletiquette_dpetexte ou nulldpe_etabli_letexte ou null
desaccordtexte ou nullautres_candidatsliste d'objetsAfficher les 3 champsMasquer
adressetexte ou nullnb_lotsentiersurface_cumulee_m2nombre ou null
methodetextequaliteobjetCe 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.
bloc_2_etat_locatifobjetAfficher les 9 champsMasquer
loyer_m2_communenombre ou nullloyer_sourcetexte ou nullloyer_mensuel_estimenombre ou nullloyer_annuel_estimenombre ou nullrendement_brut_pctnombre ou nulldetail_lotsliste d'objetsAfficher les 3 champsMasquer
surface_m2nombre ou nulletiquette_dpetexte ou nullloyer_mensuel_eurnombre ou null
methodetextedecoupeobjetAfficher les 7 champsMasquer
disponiblebooléenen_lots_de_40_m2objet ou nullAfficher les 4 champsMasquer
nb_lotsentiersurface_par_lot_m2nombreloyer_mensuelnombre ou nullecart_pctnombre ou nullÉcart au loyer de la configuration actuelle, en %.
en_lots_de_30_m2objet ou nullAfficher les 4 champsMasquer
nb_lotsentiersurface_par_lot_m2nombreloyer_mensuelnombre ou nullecart_pctnombre ou nullÉcart au loyer de la configuration actuelle, en %.
loyer_m2_t1_t2nombre ou nullloyer_m2_t3plusnombre ou nullsourcetexte ou nullavertissementtexte ou null
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.
bloc_3_prixobjetAfficher les 10 champsMasquer
disponiblebooléenmailletexte ou nullValeurs :
commune,departementprix_m2_unitenombre ou nullprix_m2_blocnombre ou nullrapportnombre ou nulln_uniteentiern_blocentierpositiontexte ou nullLe prix au m² de l'annonce situé entre le prix en bloc et le prix à l'unité.
avertissementtextequaliteobjetCe 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.
bloc_4_fiscaliteobjetAfficher les 4 champsMasquer
seuil_micro_bic_par_lot_eurnombreseuil_micro_foncier_eurnombreseuil_cotisations_sociales_lcd_eurnombreparticularitesliste de textes
bloc_5_risquesobjetAfficher les 4 champsMasquer
calendrier_energetiquetexte ou nullconcentrationtextelots_sous_contrainteentier ou nullLots en F ou G parmi les lots établis.
a_verifierliste de textes
ordretextecalcule_letextecreditsobjetCré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
Dossier d'un immeuble pas encore analysé
Essayer en direct/api/v1/immeubles/analysesLe 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_urltexteobligatoireLien 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
annonceobjetL'annonce de l'immeuble ; le vendeur n'y est jamais nommé.
Afficher les 14 champsMasquer
idtexte ou nullIdentifiant Pillr de l'annonce analysée ; null pour un immeuble du lac pas encore analysé.
sourcetextelientexte ou nullLien d'origine de l'annonce, servi quand la clé porte la portée lien_origine.
titretexte ou nullcommunetexte ou nullcode_postaltexte ou nullinseetexte ou nullprixnombre ou nullsurface_m2nombre ou nullpiecesnombre ou nulldpetexte ou nulllatnombre ou nulllonnombre ou nulltype_vendeurtexteValeurs :
pro,particulier,inconnu
bloc_1_lotsobjetAfficher les 13 champsMasquer
disponiblebooléenconfiancetextemesure : 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,inconnunb_lotsentiernb_lots_annonceentier ou nullNombre de logements que le titre ou la description annonce.
adressetexte ou nullAdresse BAN des DPE retenus.
surface_cumulee_m2nombre ou nullsurface_annoncee_m2nombre ou nullecart_surface_pctnombre ou nulllotsliste d'objetsAfficher les 3 champsMasquer
surface_m2nombre ou nulletiquette_dpetexte ou nulldpe_etabli_letexte ou null
desaccordtexte ou nullautres_candidatsliste d'objetsAfficher les 3 champsMasquer
adressetexte ou nullnb_lotsentiersurface_cumulee_m2nombre ou null
methodetextequaliteobjetCe 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.
bloc_2_etat_locatifobjetAfficher les 9 champsMasquer
loyer_m2_communenombre ou nullloyer_sourcetexte ou nullloyer_mensuel_estimenombre ou nullloyer_annuel_estimenombre ou nullrendement_brut_pctnombre ou nulldetail_lotsliste d'objetsAfficher les 3 champsMasquer
surface_m2nombre ou nulletiquette_dpetexte ou nullloyer_mensuel_eurnombre ou null
methodetextedecoupeobjetAfficher les 7 champsMasquer
disponiblebooléenen_lots_de_40_m2objet ou nullAfficher les 4 champsMasquer
nb_lotsentiersurface_par_lot_m2nombreloyer_mensuelnombre ou nullecart_pctnombre ou nullÉcart au loyer de la configuration actuelle, en %.
en_lots_de_30_m2objet ou nullAfficher les 4 champsMasquer
nb_lotsentiersurface_par_lot_m2nombreloyer_mensuelnombre ou nullecart_pctnombre ou nullÉcart au loyer de la configuration actuelle, en %.
loyer_m2_t1_t2nombre ou nullloyer_m2_t3plusnombre ou nullsourcetexte ou nullavertissementtexte ou null
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.
bloc_3_prixobjetAfficher les 10 champsMasquer
disponiblebooléenmailletexte ou nullValeurs :
commune,departementprix_m2_unitenombre ou nullprix_m2_blocnombre ou nullrapportnombre ou nulln_uniteentiern_blocentierpositiontexte ou nullLe prix au m² de l'annonce situé entre le prix en bloc et le prix à l'unité.
avertissementtextequaliteobjetCe 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.
bloc_4_fiscaliteobjetAfficher les 4 champsMasquer
seuil_micro_bic_par_lot_eurnombreseuil_micro_foncier_eurnombreseuil_cotisations_sociales_lcd_eurnombreparticularitesliste de textes
bloc_5_risquesobjetAfficher les 4 champsMasquer
calendrier_energetiquetexte ou nullconcentrationtextelots_sous_contrainteentier ou nullLots en F ou G parmi les lots établis.
a_verifierliste de textes
ordretextecalcule_letextecreditsobjetCré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
- 415type_contenuLe corps n'est pas envoyé en application/json
- 400corps_illisibleLe corps n'est pas un JSON lisible
- 413corps_trop_lourdLe corps dépasse la taille permise
- 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
Lots d'un immeuble établis par ses DPE
Essayer en direct/api/v1/adresses/{cle_ban}/lotsLes 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_bantexteobligatoireClé 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_bantexteadressetexte ou nullinseetextenb_lotsentierlotsliste d'objetsAfficher les 5 champsMasquer
surface_m2nombre ou nulletiquette_dpetexte ou nulletageentier ou nullÉtage porté par le DPE, 0 pour le rez-de-chaussée ; null s'il ne le dit pas.
dpeliste d'objetsLe DPE en vigueur d'abord, puis ceux qu'il remplace.
Afficher les 4 champsMasquer
numero_dpetextedatetexte ou nulletiquette_dpetexte ou nullsurface_m2nombre ou null
confiancetextedoublon_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_ecartesentierDPE de l'adresse non retenus : hors appartement, de plus de 10 ans, trop petits, ou remplacés.
registreobjetCe que disent le registre des copropriétés et le DPE de l'immeuble, pour contrôler le compte des lots.
Afficher les 3 champsMasquer
lots_habitationentier ou nullLots d'habitation déclarés au registre national des copropriétés.
immatriculationtexte ou nulllogements_dpe_immeubleentier ou nullNombre d'appartements que le DPE le plus récent attribue à l'immeuble, quand il en décrit plusieurs.
desaccordsliste de textesmethodetextequaliteobjetCe 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.
calcule_letextecreditsobjetCré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
Prime de division d'une commune
Essayer en direct/api/v1/communes/{insee}/prime-divisionPrime 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
inseetexteobligatoireCode 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
inseetextecommune_nomtexte ou nullcommuneobjetAfficher les 11 champsMasquer
mailletexteValeurs :
commune,departementcodetexteCode INSEE de la commune, ou code du département.
prix_m2_unitenombre ou nullPrix au m² médian des mutations d'un seul logement (un lot revendu à l'unité), en euros.
prix_m2_blocnombre ou nullPrix au m² médian des mutations de 4 logements ou plus (vente en bloc), en euros.
rapportnombre ou nullprix_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_uniteentierMutations d'un seul logement retenues.
n_blocentierMutations de 4 logements ou plus retenues.
periodeobjetPremière et dernière mutation retenues.
Afficher les 2 champsMasquer
dutexte ou nullautexte ou null
millesimesliste d'entiersAnnées couvertes par les mutations retenues.
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.
departementobjet ou nullRepli 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 champsMasquer
mailletexteValeurs :
commune,departementcodetexteCode INSEE de la commune, ou code du département.
prix_m2_unitenombre ou nullPrix au m² médian des mutations d'un seul logement (un lot revendu à l'unité), en euros.
prix_m2_blocnombre ou nullPrix au m² médian des mutations de 4 logements ou plus (vente en bloc), en euros.
rapportnombre ou nullprix_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_uniteentierMutations d'un seul logement retenues.
n_blocentierMutations de 4 logements ou plus retenues.
periodeobjetPremière et dernière mutation retenues.
Afficher les 2 champsMasquer
dutexte ou nullautexte ou null
millesimesliste d'entiersAnnées couvertes par les mutations retenues.
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.
avertissementtextecalcule_letextecreditsobjetCré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_ 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'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