Loyers et rendement
Loyers de marché, encadrement, zonage, et calculs de rendement et de crédit. 5 opérations servies.
Loyer de marché d'un logement
Essayer en direct/api/v1/communes/{insee}/loyersLoyer d'annonce, charges comprises, d'un logement d'une commune selon sa typologie (T1 à T5, maison) et sa surface, lu dans les quatre segments de la Carte des loyers (ANIL, DHUP) : loyer au m², loyer mensuel, fourchette à 95 %, segment retenu et repli éventuel sur l'ensemble des appartements, rendement brut de marché, et le modèle derrière chaque segment (type de prédiction, annonces observées, R² ajusté). Sans typologie ni surface, rend la synthèse de la commune (une ligne par typologie à surface d'exemple). Mêmes fonctions que les pages loyer de pillr.fr ; Paris, Lyon et Marseille sont agrégés depuis leurs arrondissements.
- Coût
- 1 crédit par appel réussi
- Accès
- À l'usage ou avec l'abonnement Data
- Portée
- territoire
- Outil MCP
- loyer_marche
- Bac à sable
- Oui, sans débit, sur un jeu figé
- Cache serveur
- 6 h
- Délai maximal
- 5 s
Paramètres
inseetexteobligatoireCode INSEE de la commune ou de l'arrondissement (5 caractères, 2A ou 2B pour la Corse).
typologietexteTypologie du logement : T1 à T5 (T5 et plus), ou maison.
Valeurs :
T1,T2,T3,T4,T5,maisonsurfacenombreSurface habitable, en m².
1 000 au plus ; plus de 0
Exemple d'appel
curl https://pillr.fr/api/v1/communes/76540/loyers \
-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": "Rouen",
"millesime": "2025",
"arrondissements_agreges": 0,
"charges_comprises": true,
"loyer_m2_commune": {
"valeur": 13.28,
"qualite": {
"n": 53222,
"provenance": "estime",
"incertitude": {
"demi_largeur_pct": 22.86,
"bas": 10.583019422468,
"haut": 16.6537493626823
},
"drapeaux": [],
"methode": "modèle de la Carte des loyers prédit avec les annonces de la commune",
"donnees_du": "2026-09-12",
"source": "Carte des loyers de l'ANIL et de la DHUP (ministère du Logement), loyers d'annonce"
}
},
"logement": null,
"par_typologie": [
{
"typologie": "T1",
"surface_m2": 25,
"segment": "appartement_t1_t2",
"repli": false,
"loyer_m2": 15.38,
"loyer_mensuel": 385,
"fourchette_mensuelle": {
"min": 309,
"max": 478
},
"qualite": {
"n": 35515,
"provenance": "estime",
"incertitude": {
"demi_largeur_pct": 21.98,
"bas": 12.3674766380461,
"haut": 19.1302157120229
},
"drapeaux": [],
"methode": "modèle de la Carte des loyers prédit avec les annonces de la commune",
"donnees_du": "2026-09-12",
"source": "Carte des loyers de l'ANIL et de la DHUP (ministère du Logement), loyers d'annonce"
}
},
{
"typologie": "T2",
"surface_m2": 45,
"segment": "appartement_t1_t2",
"repli": false,
"loyer_m2": 15.38,
"loyer_mensuel": 692,
"fourchette_mensuelle": {
"min": 557,
"max": 861
},
"qualite": {
"n": 35515,
"provenance": "estime",
"incertitude": {
"demi_largeur_pct": 21.98,
"bas": 12.3674766380461,
"haut": 19.1302157120229
},
"drapeaux": [],
"methode": "modèle de la Carte des loyers prédit avec les annonces de la commune",
"donnees_du": "2026-09-12",
"source": "Carte des loyers de l'ANIL et de la DHUP (ministère du Logement), loyers d'annonce"
}
},
{
"typologie": "T3",
"surface_m2": 65,
"segment": "appartement_t3plus",
"repli": false,
"loyer_m2": 11.68,
"loyer_mensuel": 759,
"fourchette_mensuelle": {
"min": 596,
"max": 967
},
"qualite": {
"n": 17737,
"provenance": "estime",
"incertitude": {
"demi_largeur_pct": 24.4,
"bas": 9.17476099862618,
"haut": 14.8761574615209
},
"drapeaux": [],
"methode": "modèle de la Carte des loyers prédit avec les annonces de la commune",
"donnees_du": "2026-09-12",
"source": "Carte des loyers de l'ANIL et de la DHUP (ministère du Logement), loyers d'annonce"
}
},
{
"typologie": "T4",
"surface_m2": 85,
"segment": "appartement_t3plus",
"repli": false,
"loyer_m2": 11.68,
"loyer_mensuel": 993,
"fourchette_mensuelle": {
"min": 780,
"max": 1264
},
"qualite": {
"n": 17737,
"provenance": "estime",
"incertitude": {
"demi_largeur_pct": 24.4,
"bas": 9.17476099862618,
"haut": 14.8761574615209
},
"drapeaux": [],
"methode": "modèle de la Carte des loyers prédit avec les annonces de la commune",
"donnees_du": "2026-09-12",
"source": "Carte des loyers de l'ANIL et de la DHUP (ministère du Logement), loyers d'annonce"
}
},
{
"typologie": "T5",
"surface_m2": 105,
"segment": "appartement_t3plus",
"repli": false,
"loyer_m2": 11.68,
"loyer_mensuel": 1227,
"fourchette_mensuelle": {
"min": 963,
"max": 1562
},
"qualite": {
"n": 17737,
"provenance": "estime",
"incertitude": {
"demi_largeur_pct": 24.4,
"bas": 9.17476099862618,
"haut": 14.8761574615209
},
"drapeaux": [],
"methode": "modèle de la Carte des loyers prédit avec les annonces de la commune",
"donnees_du": "2026-09-12",
"source": "Carte des loyers de l'ANIL et de la DHUP (ministère du Logement), loyers d'annonce"
}
},
{
"typologie": "maison",
"surface_m2": 100,
"segment": "maison",
"repli": false,
"loyer_m2": 12.33,
"loyer_mensuel": 1233,
"fourchette_mensuelle": {
"min": 945,
"max": 1609
},
"qualite": {
"n": 2100,
"provenance": "estime",
"incertitude": {
"demi_largeur_pct": 26.92,
"bas": 9.45258735143007,
"haut": 16.0924962471202
},
"drapeaux": [],
"methode": "modèle de la Carte des loyers prédit avec les annonces de la commune",
"donnees_du": "2026-09-12",
"source": "Carte des loyers de l'ANIL et de la DHUP (ministère du Logement), loyers d'annonce"
}
}
],
"rendement_brut_marche_pct": {
"appartement": 6,
"maison": 5.5,
"qualite": {
"n": 2205,
"provenance": "estime",
"incertitude": null,
"drapeaux": [],
"methode": "loyer d'annonce annuel au m² sur prix médian au m² de la commune (appartement : valeur publiée par le pipeline, recalculée avec la même borne si elle manque ; maison : segment maison), borne de vraisemblance du pipeline",
"donnees_du": "2026-10-19",
"source": "Carte des loyers de l'ANIL et de la DHUP (ministère du Logement), loyers d'annonce ; DVF (DGFiP), barème des prix Pillr"
}
},
"segments": [
{
"segment": "appartement",
"libelle": "appartements, toutes typologies",
"loyer_m2": 13.28,
"min_95": 10.58,
"max_95": 16.65,
"modele": {
"type_prediction": "commune",
"nb_obs_commune": 53222,
"nb_obs_maille": 53222,
"r2_ajuste": 0.843252707249706,
"surface_reference_m2": 52
},
"qualite": {
"n": 53222,
"provenance": "estime",
"incertitude": {
"demi_largeur_pct": 22.86,
"bas": 10.583019422468,
"haut": 16.6537493626823
},
"drapeaux": [],
"methode": "modèle de la Carte des loyers prédit avec les annonces de la commune",
"donnees_du": "2026-09-12",
"source": "Carte des loyers de l'ANIL et de la DHUP (ministère du Logement), loyers d'annonce"
}
},
{
"segment": "appartement_t1_t2",
"libelle": "appartements T1 et T2",
"loyer_m2": 15.38,
"min_95": 12.37,
"max_95": 19.13,
"modele": {
"type_prediction": "commune",
"nb_obs_commune": 35515,
"nb_obs_maille": 36650,
"r2_ajuste": 0.706756541275443,
"surface_reference_m2": 37
},
"qualite": {
"n": 35515,
"provenance": "estime",
"incertitude": {
"demi_largeur_pct": 21.98,
"bas": 12.3674766380461,
"haut": 19.1302157120229
},
"drapeaux": [],
"methode": "modèle de la Carte des loyers prédit avec les annonces de la commune",
"donnees_du": "2026-09-12",
"source": "Carte des loyers de l'ANIL et de la DHUP (ministère du Logement), loyers d'annonce"
}
},
{
"segment": "appartement_t3plus",
"libelle": "appartements T3 et plus",
"loyer_m2": 11.68,
"min_95": 9.17,
"max_95": 14.88,
"modele": {
"type_prediction": "commune",
"nb_obs_commune": 17737,
"nb_obs_maille": 18177,
"r2_ajuste": 0.66022936289375,
"surface_reference_m2": 72
},
"qualite": {
"n": 17737,
"provenance": "estime",
"incertitude": {
"demi_largeur_pct": 24.4,
"bas": 9.17476099862618,
"haut": 14.8761574615209
},
"drapeaux": [],
"methode": "modèle de la Carte des loyers prédit avec les annonces de la commune",
"donnees_du": "2026-09-12",
"source": "Carte des loyers de l'ANIL et de la DHUP (ministère du Logement), loyers d'annonce"
}
},
{
"segment": "maison",
"libelle": "maisons",
"loyer_m2": 12.33,
"min_95": 9.45,
"max_95": 16.09,
"modele": {
"type_prediction": "commune",
"nb_obs_commune": 2100,
"nb_obs_maille": 2484,
"r2_ajuste": 0.816599984807483,
"surface_reference_m2": null
},
"qualite": {
"n": 2100,
"provenance": "estime",
"incertitude": {
"demi_largeur_pct": 26.92,
"bas": 9.45258735143007,
"haut": 16.0924962471202
},
"drapeaux": [],
"methode": "modèle de la Carte des loyers prédit avec les annonces de la commune",
"donnees_du": "2026-09-12",
"source": "Carte des loyers de l'ANIL et de la DHUP (ministère du Logement), loyers d'annonce"
}
}
],
"limites": [
"Loyer d'annonce modélisé par commune et par segment, pas un loyer constaté sur un bien.",
"La fourchette est l'intervalle de prédiction à 95 % publié avec le modèle ; pour Paris, Lyon et Marseille, c'est la moyenne des bornes des arrondissements, un repère et non un intervalle recalculé.",
"Une maison sans segment maison n'a pas de loyer : le loyer des appartements ne la remplace jamais."
],
"source": "Carte des loyers de l'ANIL et de la DHUP (ministère du Logement), loyers d'annonce",
"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 12/09/2026.
Réponse
inseetextecommunetexte ou nullmillesimetexte ou nullMillésime de la Carte des loyers.
arrondissements_agregesentierParis, Lyon et Marseille : nombre d'arrondissements agrégés, pondérés par leur population ; 0 pour une autre commune.
charges_comprisesbooléenLoyers d'annonce de la Carte des loyers, charges comprises.
loyer_m2_communeobjetLoyer d'annonce au m² de la commune, tous appartements (modèle de la Carte des loyers, repli sur le loyer hérité).
Afficher les 2 champsMasquer
valeurnombre ou nullqualiteobjetCe qui permet de juger la valeur : nombre, provenance, incertitude, drapeaux, date et source.
Afficher les 7 champsMasquer
nentier ou nullNombre d'observations derrière la valeur ; null si sans objet.
0 au moins
provenancetexte ou nullmesure : observé sur la donnée ; estime : modèle, barème ou imputation ; null : sans objet.
Valeurs :
mesure,estimeincertitudeobjet ou nullIncertitude de la valeur : fourchette et demi-largeur.
Afficher les 3 champsMasquer
demi_largeur_pctnombre ou nullDemi-largeur de la fourchette, en % de la valeur.
basnombre ou nullhautnombre ou null
drapeauxliste de textesCe qui doit faire lire la valeur avec prudence ; vide si rien.
Valeurs :
prix_atypique,surface_atypique,vente_en_bloc,doublon_probable,date_estimee,peu_d_observations,valeur_imputee,rattachement_incertain,donnee_anciennemethodetexte ou nullMéthode de calcul ou de rattachement, en clair.
donnees_dutexte ou nullDate de la donnée (AAAA-MM-JJ ou horodatage ISO 8601).
sourcetexteSource publique ou moteur Pillr, en clair.
logementobjet ou nullLe logement décrit par typologie et surface ; null sans typologie ni surface, ou quand aucun segment ne le couvre (une maison sans segment maison n'a pas de loyer).
Afficher les 10 champsMasquer
typologietexteTypologie du logement : T1 à T5 (T5 et plus), ou maison.
Valeurs :
T1,T2,T3,T4,T5,maisonsurface_m2nombresegmenttexteSegment de la Carte des loyers : appartement (appartements, toutes typologies), appartement_t1_t2 (appartements T1 et T2), appartement_t3plus (appartements T3 et plus), maison (maisons).
Valeurs :
appartement,appartement_t1_t2,appartement_t3plus,maisonreplibooléenVrai quand le segment de la typologie manquait et que celui de l'ensemble des appartements l'a remplacé.
loyer_m2nombreLoyer d'annonce au m² par mois, charges comprises.
loyer_mensuelnombreLoyer d'annonce mensuel, charges comprises : loyer au m² multiplié par la surface.
fourchette_mensuelleobjet ou nullBornes de l'intervalle de prédiction à 95 % multipliées par la surface ; null si le segment n'en publie pas.
Afficher les 2 champsMasquer
minnombremaxnombre
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.
rendement_brut_marche_pctnombre ou nullRendement brut de marché du type de bien (appartement ou maison) dans la commune, en % ; null sans prix de vente publié ou au-delà de la borne de vraisemblance.
modeleobjet ou nullAfficher les 5 champsMasquer
type_predictiontexte ou nullcommune : prédit avec les annonces de la commune ; maille ou EPCI : prédit à une maille plus large, faute d'annonces assez nombreuses dans la commune.
nb_obs_communeentier ou nullAnnonces de la commune dans le modèle.
nb_obs_mailleentier ou nullAnnonces de la maille dans le modèle.
r2_ajustenombre ou nullR² ajusté du modèle.
surface_reference_m2nombre ou nullSurface de référence publiée pour le segment ; null pour les maisons.
par_typologieliste d'objetsUne ligne par typologie couverte, à la surface d'exemple publiée par les pages loyer de pillr.fr.
Afficher les 8 champsMasquer
typologietexteTypologie du logement : T1 à T5 (T5 et plus), ou maison.
Valeurs :
T1,T2,T3,T4,T5,maisonsurface_m2nombresegmenttexteSegment de la Carte des loyers : appartement (appartements, toutes typologies), appartement_t1_t2 (appartements T1 et T2), appartement_t3plus (appartements T3 et plus), maison (maisons).
Valeurs :
appartement,appartement_t1_t2,appartement_t3plus,maisonreplibooléenVrai quand le segment de la typologie manquait et que celui de l'ensemble des appartements l'a remplacé.
loyer_m2nombreLoyer d'annonce au m² par mois, charges comprises.
loyer_mensuelnombreLoyer d'annonce mensuel, charges comprises : loyer au m² multiplié par la surface.
fourchette_mensuelleobjet ou nullBornes de l'intervalle de prédiction à 95 % multipliées par la surface ; null si le segment n'en publie pas.
Afficher les 2 champsMasquer
minnombremaxnombre
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.
rendement_brut_marche_pctobjetRendement brut de marché de la commune : loyer annuel au m² sur prix médian au m², en %.
Afficher les 3 champsMasquer
appartementnombre ou nullmaisonnombre ou nullqualiteobjetCe qui permet de juger la valeur : nombre, provenance, incertitude, drapeaux, date et source.
Afficher les 7 champsMasquer
nentier ou nullNombre d'observations derrière la valeur ; null si sans objet.
0 au moins
provenancetexte ou nullmesure : observé sur la donnée ; estime : modèle, barème ou imputation ; null : sans objet.
Valeurs :
mesure,estimeincertitudeobjet ou nullIncertitude de la valeur : fourchette et demi-largeur.
Afficher les 3 champsMasquer
demi_largeur_pctnombre ou nullDemi-largeur de la fourchette, en % de la valeur.
basnombre ou nullhautnombre ou null
drapeauxliste de textesCe qui doit faire lire la valeur avec prudence ; vide si rien.
Valeurs :
prix_atypique,surface_atypique,vente_en_bloc,doublon_probable,date_estimee,peu_d_observations,valeur_imputee,rattachement_incertain,donnee_anciennemethodetexte ou nullMéthode de calcul ou de rattachement, en clair.
donnees_dutexte ou nullDate de la donnée (AAAA-MM-JJ ou horodatage ISO 8601).
sourcetexteSource publique ou moteur Pillr, en clair.
segmentsliste d'objetsAfficher les 7 champsMasquer
segmenttexteSegment de la Carte des loyers : appartement (appartements, toutes typologies), appartement_t1_t2 (appartements T1 et T2), appartement_t3plus (appartements T3 et plus), maison (maisons).
Valeurs :
appartement,appartement_t1_t2,appartement_t3plus,maisonlibelletexteloyer_m2nombremin_95nombre ou nullmax_95nombre ou nullmodeleobjet ou nullnull pour un agrégat d'arrondissements.
Afficher les 5 champsMasquer
type_predictiontexte ou nullcommune : prédit avec les annonces de la commune ; maille ou EPCI : prédit à une maille plus large, faute d'annonces assez nombreuses dans la commune.
nb_obs_communeentier ou nullAnnonces de la commune dans le modèle.
nb_obs_mailleentier ou nullAnnonces de la maille dans le modèle.
r2_ajustenombre ou nullR² ajusté du modèle.
surface_reference_m2nombre ou nullSurface de référence publiée pour le segment ; null pour les maisons.
qualiteobjetCe qui permet de juger la valeur : nombre, provenance, incertitude, drapeaux, date et source.
Afficher les 7 champsMasquer
nentier ou nullNombre d'observations derrière la valeur ; null si sans objet.
0 au moins
provenancetexte ou nullmesure : observé sur la donnée ; estime : modèle, barème ou imputation ; null : sans objet.
Valeurs :
mesure,estimeincertitudeobjet ou nullIncertitude de la valeur : fourchette et demi-largeur.
Afficher les 3 champsMasquer
demi_largeur_pctnombre ou nullDemi-largeur de la fourchette, en % de la valeur.
basnombre ou nullhautnombre ou null
drapeauxliste de textesCe qui doit faire lire la valeur avec prudence ; vide si rien.
Valeurs :
prix_atypique,surface_atypique,vente_en_bloc,doublon_probable,date_estimee,peu_d_observations,valeur_imputee,rattachement_incertain,donnee_anciennemethodetexte ou nullMéthode de calcul ou de rattachement, en clair.
donnees_dutexte ou nullDate de la donnée (AAAA-MM-JJ ou horodatage ISO 8601).
sourcetexteSource publique ou moteur Pillr, en clair.
limitesliste de textessourcetextecreditsobjetCré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
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
Encadrement des loyers
Essayer en direct/api/v1/encadrement-loyersEncadrement des loyers d'un logement à Paris, décrit par son code postal, son nombre de pièces, son époque de construction, la location meublée ou non et sa surface, ou par une annonce du catalogue : loyers de référence, minoré et majoré au m² du barème le plus récent (quartier nommé, ou moyenne des quartiers de l'arrondissement), loyer maximal légal hors complément de loyer, et dépassement d'un loyer envisagé. Hors de Paris, applicable vaut faux et encadrement_en_vigueur dit si la commune figure parmi les communes encadrées ; leur barème n'est pas servi.
- Coût
- 1 crédit par appel réussi
- Accès
- À l'usage ou avec l'abonnement Data
- Portée
- territoire
- Outil MCP
- encadrement_loyers
- Bac à sable
- Oui, sans débit, sur un jeu figé
- Cache serveur
- 24 h
- Délai maximal
- 5 s
Paramètres
annoncetexteIdentifiant d'une annonce : son code postal, sa surface, ses pièces, sa location meublée et son loyer estimé servent de défaut.
de 3 à 200 caractères
code_postaltexteCode postal.
quartiertexteQuartier administratif de Paris (ex. Belleville) ; sans lui, la moyenne des quartiers de l'arrondissement.
de 2 à 80 caractères
piecesentierNombre de pièces principales.
de 1 à 30
epoquetexteSans époque : la moyenne des quatre époques.
Valeurs :
avant_1946,1946_1970,1971_1990,apres_1990meublevaleurLocation meublée (true) ou nue (false, par défaut).
surfacenombreSurface habitable, en m².
1 000 au plus ; plus de 0
loyernombreLoyer mensuel envisagé hors charges, en euros.
100 000 au plus ; plus de 0
Exemple d'appel
curl "https://pillr.fr/api/v1/encadrement-loyers?code_postal=75011&pieces=2&epoque=avant_1946&meuble=true&surface=42" \
-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
{
"applicable": true,
"encadrement_en_vigueur": true,
"commune": "Paris",
"code_postal": "75011",
"insee": "75111",
"arrondissement": 11,
"quartier": "11e arrondissement (moyenne)",
"annee_bareme": 2025,
"criteres": {
"pieces": 2,
"epoque": "avant_1946",
"meuble": true
},
"loyer_reference_eur_m2": 30.45,
"loyer_minore_eur_m2": 21.3,
"loyer_majore_eur_m2": 36.55,
"surface_m2": 42,
"loyer_max_legal_eur_mois": 1535,
"loyer_estime_eur_mois": null,
"depassement_pct": null,
"conforme": null,
"lignes_bareme": [
{
"id_quartier": "41",
"quartier": "Folie-Méricourt",
"epoque": "avant_1946",
"loyer_reference": 30,
"loyer_minore": 21,
"loyer_majore": 36
},
{
"id_quartier": "42",
"quartier": "Saint-Ambroise",
"epoque": "avant_1946",
"loyer_reference": 30.9,
"loyer_minore": 21.6,
"loyer_majore": 37.1
},
{
"id_quartier": "43",
"quartier": "Roquette",
"epoque": "avant_1946",
"loyer_reference": 30,
"loyer_minore": 21,
"loyer_majore": 36
},
{
"id_quartier": "44",
"quartier": "Sainte-Marguerite",
"epoque": "avant_1946",
"loyer_reference": 30.9,
"loyer_minore": 21.6,
"loyer_majore": 37.1
}
],
"hypotheses": [],
"note": "Loyer meublé, 2 pièces, barème 2025. Loyer maximal légal : loyer de référence majoré multiplié par la surface, hors complément de loyer.",
"qualite": {
"n": 4,
"provenance": "estime",
"incertitude": null,
"drapeaux": [
"valeur_imputee"
],
"methode": "moyenne des 4 quartiers de l'arrondissement",
"donnees_du": null,
"source": "Ville de Paris, open data « Logement : encadrement des loyers » (loyers de référence fixés chaque année par arrêté préfectoral)"
},
"source": "Ville de Paris, open data « Logement : encadrement des loyers » (loyers de référence fixés chaque année par arrêté préfectoral)",
"credits": {
"debites": 0,
"restants": null
}
}Réponse réelle de l'API à cette entrée, obtenue avec le moteur du bac à sable.
Réponse
applicablebooléenVrai : le barème d'encadrement de ce lieu est servi (Paris). Faux ailleurs, y compris dans une commune encadrée dont le barème n'est pas chargé.
encadrement_en_vigueurbooléenLa commune applique l'encadrement des loyers (liste des communes encadrées du simulateur de pillr.fr).
communetexte ou nullcode_postaltexte ou nullinseetexte ou nullarrondissemententier ou nullquartiertexte ou nullQuartier retenu, ou l'arrondissement quand la moyenne de ses quartiers est prise.
annee_baremeentier ou nullAnnée du barème lu (la plus récente chargée).
criteresobjetAfficher les 3 champsMasquer
piecesentier ou nullPièces du barème, 1 à 4 (4 : quatre pièces et plus).
epoquetexte ou nullnull : toutes les époques de construction, en moyenne.
Valeurs :
avant_1946,1946_1970,1971_1990,apres_1990meublebooléen
loyer_reference_eur_m2nombre ou nullLoyer de référence, en euros par m² et par mois.
loyer_minore_eur_m2nombre ou nullLoyer de référence minoré, en euros par m² et par mois.
loyer_majore_eur_m2nombre ou nullLoyer de référence majoré, en euros par m² et par mois.
surface_m2nombre ou nullloyer_max_legal_eur_moisnombre ou nullLoyer de référence majoré multiplié par la surface : le loyer hors charges maximal, hors complément de loyer.
loyer_estime_eur_moisnombre ou nullLe loyer comparé : celui donné, ou le loyer estimé de l'annonce (charges comprises, voir hypotheses).
depassement_pctnombre ou nullÉcart du loyer comparé au loyer maximal légal, en % (positif : au-dessus).
conformebooléen ou nullVrai si le loyer comparé ne dépasse pas le loyer maximal légal ; null sans loyer ou sans plafond.
lignes_baremeliste d'objetsLes lignes du barème retenues pour les moyennes.
Afficher les 6 champsMasquer
id_quartiertexte ou nullquartiertexte ou nullepoquetexte ou nullloyer_referencenombre ou nullloyer_minorenombre ou nullloyer_majorenombre ou null
hypothesesliste de textesnotetextequaliteobjetCe 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.
sourcetextecreditsobjetCré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
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
Zonage ABC, plafonds et contraintes locales
Essayer en direct/api/v1/communes/{insee}/zonageZone ABC d'une commune (corrigée des révisions officielles que la base n'intègre pas encore), statut à la date de l'appel des dispositifs d'investissement locatif (Pinel, Relance logement, Denormandie, Loc'Avantages, déficit foncier) avec leur source officielle, plafond de loyer de la location intermédiaire au m² et, pour une surface donnée, au mois avec le coefficient de surface, comparé à un loyer, et contraintes locales à vérifier en mairie : encadrement des loyers, location de courte durée, tension du marché. Mêmes faits sourcés que les pages de pillr.fr ; aucun conseil fiscal.
- Coût
- 1 crédit par appel réussi
- Accès
- À l'usage ou avec l'abonnement Data
- Portée
- territoire
- Outil MCP
- zonage_logement
- Bac à sable
- Oui, sans débit, sur un jeu figé
- Cache serveur
- 24 h
- Délai maximal
- 5 s
Paramètres
inseetexteobligatoireCode INSEE de la commune ou de l'arrondissement (5 caractères, 2A ou 2B pour la Corse).
surfacenombreSurface retenue en m² (habitable, plus la moitié des annexes dans la limite de 8 m²).
1 000 au plus ; plus de 0
loyernombreLoyer mensuel hors charges à comparer au plafond, en euros.
100 000 au plus ; plus de 0
Exemple d'appel
curl https://pillr.fr/api/v1/communes/76540/zonage \
-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": "Rouen",
"zone": "B1",
"zone_servie": "B1",
"correction": null,
"zonage": {
"arrete": "arrêté du 5 septembre 2025",
"importe_le": "2026-05-14",
"constate_le": "2026-09-14",
"phrase": "Zonage utilisé : arrêté du 5 septembre 2025, sans l'arrêté du 23 juin 2026 (Alfortville, passée de la zone A à la zone A bis).",
"source": {
"editeur": "data.gouv.fr",
"libelle": "liste des communes selon le zonage ABC",
"url": "https://www.data.gouv.fr/datasets/liste-des-communes-selon-le-zonage-abc",
"date": "2026-07-03"
}
},
"dispositifs": [
{
"cle": "pinel",
"nom": "Pinel",
"statut": "ferme",
"detail": "Le dispositif Pinel est fermé aux acquisitions depuis le 1er janvier 2025 : la réduction d'impôt ne vise que les logements acquis, ou dont le permis de construire a été demandé, au plus tard le 31 décembre 2024, et les engagements de location en cours vont à leur terme.",
"jusqu_au": "2024-12-31",
"role_de_la_zone": "La zone fixait l'éligibilité et les plafonds ; les baux en cours gardent les plafonds de la location intermédiaire.",
"source": {
"editeur": "Légifrance",
"libelle": "article 199 novovicies du code général des impôts",
"url": "https://www.legifrance.gouv.fr/codes/article_lc/LEGIARTI000049399676",
"date": "2024-04-11"
},
"sources_complementaires": [
{
"editeur": "Service-public.gouv.fr",
"libelle": "investissement locatif loi Pinel/Duflot (réduction d'impôt)",
"url": "https://www.service-public.gouv.fr/particuliers/vosdroits/F31151",
"date": "2026-03-11"
},
{
"editeur": "ANIL",
"libelle": "analyse juridique de la loi de finances pour 2026",
"url": "https://www.anil.org/aj-loi-finances-2026/",
"date": "2026-02-20"
}
],
"verifie_le": "2026-09-14"
},
{
"cle": "relance_logement",
"nom": "Relance logement (statut du bailleur privé)",
"statut": "ouvert",
"detail": "Depuis le 21 février 2026, le dispositif Relance logement (dit statut du bailleur privé) permet de déduire des revenus fonciers un amortissement plafonné à 8 000 € par an et par foyer (10 000 € ou 12 000 € selon la part de location sociale ou très sociale). Il vise un logement neuf, ou ancien avec des travaux d'au moins 30 % du prix d'acquisition et une réhabilitation lourde, situé dans un immeuble collectif, acquis (ou dont le permis de construire a été demandé) au plus tard le 31 décembre 2028, puis loué nu en résidence principale pendant au moins 9 ans, avec un loyer et des ressources du locataire plafonnés. Son éligibilité ne dépend pas de la zone.",
"jusqu_au": "2028-12-31",
"role_de_la_zone": "Aucune condition de zone pour l'éligibilité ; la zone fixe les plafonds de ressources du locataire et, en location intermédiaire, le plafond de loyer.",
"source": {
"editeur": "Légifrance",
"libelle": "article 31 du code général des impôts",
"url": "https://www.legifrance.gouv.fr/codes/article_lc/LEGIARTI000053544761",
"date": "2026-02-21"
},
"sources_complementaires": [
{
"editeur": "Légifrance",
"libelle": "article 47 de la loi n° 2026-103 du 19 février 2026 de finances pour 2026",
"url": "https://www.legifrance.gouv.fr/jorf/article_jo/JORFARTI000053508409",
"date": "2026-02-20"
},
{
"editeur": "Service-public.gouv.fr",
"libelle": "« De nouvelles réductions fiscales pour certains propriétaires bailleurs »",
"url": "https://www.service-public.gouv.fr/particuliers/actualites/A18817",
"date": "2026-02-24"
},
{
"editeur": "ecologie.gouv.fr",
"libelle": "« Relance logement : un nouveau dispositif pour faciliter l'achat et la location de logements »",
"url": "https://www.ecologie.gouv.fr/actualites/relance-logement-nouveau-dispositif-faciliter-lachat-location-logements",
"date": "2026-06-10"
},
{
"editeur": "ANIL",
"libelle": "analyse juridique de la loi de finances pour 2026",
"url": "https://www.anil.org/aj-loi-finances-2026/",
"date": "2026-02-20"
}
],
"verifie_le": "2026-09-14"
},
{
"cle": "denormandie",
"nom": "Denormandie",
"statut": "a_verifier",
"detail": "Réduction d'impôt de l'article 199 novovicies du code général des impôts pour un logement ancien avec travaux, acquis au plus tard le 31 décembre 2027, dans une commune éligible : la liste officielle des communes est à vérifier, Pillr Data ne la porte pas.",
"jusqu_au": "2027-12-31",
"role_de_la_zone": "Éligibilité par commune, pas par zone ; plafonds de loyer de la location intermédiaire.",
"source": {
"editeur": "Légifrance",
"libelle": "article 199 novovicies du code général des impôts",
"url": "https://www.legifrance.gouv.fr/codes/article_lc/LEGIARTI000049399676",
"date": "2024-04-11"
},
"sources_complementaires": [
{
"editeur": "ANIL",
"libelle": "analyse juridique de la loi de finances pour 2026",
"url": "https://www.anil.org/aj-loi-finances-2026/",
"date": "2026-02-20"
}
],
"verifie_le": "2026-09-14"
},
{
"cle": "loc_avantages",
"nom": "Loc'Avantages",
"statut": "a_verifier",
"detail": "Réduction d'impôt de 15 % (intermédiaire), 35 % (social) ou 65 % (très social, avec intermédiation locative) des loyers, portée à 20 % et 40 % avec intermédiation locative, pour un logement conventionné avec l'Anah dont la demande est enregistrée au plus tard le 31 décembre 2027. Non cumulable, pour un même logement, avec Relance logement.",
"jusqu_au": "2027-12-31",
"role_de_la_zone": "Plafonds de loyer fixés par commune, plafonds de ressources du locataire par zone.",
"source": {
"editeur": "Légifrance",
"libelle": "article 199 tricies du code général des impôts",
"url": "https://www.legifrance.gouv.fr/codes/article_lc/LEGIARTI000044797610",
"date": "2025-02-16"
},
"sources_complementaires": [
{
"editeur": "Légifrance",
"libelle": "arrêté du 6 janvier 2026 pris en application de l'article 2 terdecies H de l'annexe III au code général des impôts",
"url": "https://www.legifrance.gouv.fr/jorf/id/JORFTEXT000053423293",
"date": "2026-01-31"
},
{
"editeur": "ANIL",
"libelle": "analyse juridique de la loi de finances pour 2026",
"url": "https://www.anil.org/aj-loi-finances-2026/",
"date": "2026-02-20"
}
],
"verifie_le": "2026-09-14"
},
{
"cle": "deficit_foncier",
"nom": "Déficit foncier",
"statut": "ouvert",
"detail": "Imputation sur le revenu global, par an, du déficit foncier hors intérêts d'emprunt dans la limite de 10 700 €, portée à 21 400 € à hauteur des travaux de rénovation énergétique qui font passer un logement de la classe E, F ou G à la classe A, B, C ou D au plus tard le 31 décembre 2027.",
"jusqu_au": null,
"role_de_la_zone": "Aucun.",
"source": {
"editeur": "Légifrance",
"libelle": "article 156 du code général des impôts",
"url": "https://www.legifrance.gouv.fr/codes/article_lc/LEGIARTI000043662638",
"date": "2026-07-01"
},
"sources_complementaires": [
{
"editeur": "Service-public.gouv.fr",
"libelle": "« De nouvelles réductions fiscales pour certains propriétaires bailleurs »",
"url": "https://www.service-public.gouv.fr/particuliers/actualites/A18817",
"date": "2026-02-24"
},
{
"editeur": "ANIL",
"libelle": "analyse juridique de la loi de finances pour 2026",
"url": "https://www.anil.org/aj-loi-finances-2026/",
"date": "2026-02-20"
}
],
"verifie_le": "2026-09-14"
}
],
"plafond_loyer_intermediaire": {
"annee": 2026,
"eur_m2_mois": 11.8,
"coefficient_surface": null,
"formule_coefficient": "0,7 + 19/S, arrondi à deux décimales et plafonné à 1,2",
"plafond_mensuel": null,
"loyer": null,
"depassement_pct": null,
"conforme": null,
"champ": "Location intermédiaire en métropole (Relance logement, baux Pinel en cours, Denormandie). Ne vise ni l'outre-mer, ni la location sociale et très sociale (barème Loc'Avantages, fixé par commune), ni les réductions décidées par arrêté préfectoral.",
"source": {
"editeur": "BOFiP",
"libelle": "barème BOI-BAREME-000017-20260310",
"url": "https://bofip.impots.gouv.fr/bofip/10130-PGP.html/identifiant=BOI-BAREME-000017-20260310",
"date": "2026-03-10"
},
"qualite": {
"n": null,
"provenance": "mesure",
"incertitude": null,
"drapeaux": [],
"methode": "barème 2026 de la zone, coefficient de surface 0,7 + 19/S, arrondi à deux décimales et plafonné à 1,2 (BOI-IR-RICI-360-20-30-20260310)",
"donnees_du": "2026-03-10",
"source": "BOFiP, barème BOI-BAREME-000017-20260310"
}
},
"contraintes_locales": [
{
"type": "tension",
"niveau": "info",
"titre": "Zonage ABC : zone B1",
"detail": "Marché détendu : vérifier la vacance réelle de la commune, la revente peut être plus lente.",
"a_verifier": true
},
{
"type": "courte_duree",
"niveau": "info",
"titre": "Déclaration en mairie",
"detail": "Déclaration préalable en mairie et numéro d'enregistrement (généralisé en 2026), règlement de copropriété à vérifier. Le plafond de 120 nuits ne vise que la résidence principale.",
"a_verifier": true
}
],
"qualite": {
"n": null,
"provenance": "mesure",
"incertitude": null,
"drapeaux": [],
"methode": "zone de la base, comparée code par code au fichier officiel",
"donnees_du": "2026-05-14",
"source": "data.gouv.fr, liste des communes selon le zonage ABC"
},
"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 14/05/2026.
Réponse
inseetextecommunetexte ou nullzonetexte ou nullLa zone en vigueur ; null pour une commune inconnue du zonage (outre-mer compris).
Valeurs :
A bis,A,B1,B2,Czone_servietexte ou nullLa zone lue en base, avant correction.
correctionobjet ou nullUne révision officielle que la base n'intègre pas encore et qui change la zone de la commune.
Afficher les 4 champsMasquer
arretetexteen_vigueur_letextezone_servietexteZone du zonage ABC : A bis, A, B1, B2 ou C.
Valeurs :
A bis,A,B1,B2,CsourceobjetAfficher les 4 champsMasquer
editeurtextelibelletexteurltextedatetexteDate de la source ou de la version du texte consultée (AAAA-MM-JJ).
zonageobjetAfficher les 5 champsMasquer
arretetexteDernière révision officielle intégrée à la base.
importe_letexteconstate_letextephrasetextesourceobjetAfficher les 4 champsMasquer
editeurtextelibelletexteurltextedatetexteDate de la source ou de la version du texte consultée (AAAA-MM-JJ).
dispositifsliste d'objetsAfficher les 9 champsMasquer
cletexteValeurs :
pinel,relance_logement,denormandie,loc_avantages,deficit_fonciernomtextestatuttexteouvert : ouvert aux nouvelles opérations à la date de l'appel ; ferme : fermé ; a_verifier : ouvert sous une condition que Pillr Data ne vérifie pas (liste de communes, convention).
Valeurs :
ouvert,ferme,a_verifierdetailtextejusqu_autexte ou nullDate limite des acquisitions ou des demandes (AAAA-MM-JJ).
role_de_la_zonetextesourceobjetAfficher les 4 champsMasquer
editeurtextelibelletexteurltextedatetexteDate de la source ou de la version du texte consultée (AAAA-MM-JJ).
sources_complementairesliste d'objetsAfficher les 4 champsMasquer
editeurtextelibelletexteurltextedatetexteDate de la source ou de la version du texte consultée (AAAA-MM-JJ).
verifie_letexte
plafond_loyer_intermediaireobjetPlafond de loyer de la location intermédiaire (Relance logement, baux Pinel en cours, Denormandie).
Afficher les 11 champsMasquer
anneeentiereur_m2_moisnombre ou nullPlafond hors charges par m² de surface retenue, avant coefficient ; null hors métropole ou sans zone.
coefficient_surfacenombre ou nullformule_coefficienttexteplafond_mensuelnombre ou nullPlafond mensuel hors charges pour la surface donnée, coefficient compris.
loyernombre ou nullLe loyer comparé, hors charges.
depassement_pctnombre ou nullconformebooléen ou nullchamptexteCe que ce plafond vise, et ce qu'il ne vise pas.
sourceobjetAfficher les 4 champsMasquer
editeurtextelibelletexteurltextedatetexteDate de la source ou de la version du texte consultée (AAAA-MM-JJ).
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.
contraintes_localesliste d'objetsAfficher les 5 champsMasquer
typetexteValeurs :
encadrement,courte_duree,tensionniveautexteValeurs :
info,attentiontitretextedetailtextea_verifierbooléenPillr signale, la mairie confirme.
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.
creditsobjetCrédits débités par cet appel (réservés, pour une tâche en cours), et crédits encore utilisables ce mois avant la coupure : crédits offerts, crédits inclus du mois et crédits facturables sous le plafond de dépense (null si inconnus ou en bac à sable).
Afficher les 2 champsMasquer
debitesentier0 au moins
restantsentier ou null
Erreurs possibles
- 400parametres_invalidesUn paramètre manque ou ne passe pas son contrôle ; le détail est donné champ par champ
- 403hors_bac_a_sableUne clé pk_test_ demande une entrée hors du jeu figé de l'opération
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
Rendement, cash-flow et crédit
Essayer en direct/api/v1/simulations/rendementSimulation d'un investissement locatif avec le moteur du simulateur de la fiche annonce de pillr.fr : pour la location nue, la location meublée longue durée et la courte durée, loyer, rendements brut et net, mensualité du crédit, cash-flow mensuel avant et après l'impôt de la première année (régime le moins imposé), décomposé poste par poste, et projection année par année. Recommandation sur le cash-flow avant impôt et sur le TRI après impôt et revente, taux d'effort au sens du HCSF quand les revenus sont donnés. Le loyer est celui donné, sinon le loyer de marché de la commune ; la courte durée suit le profil de marché AirDNA et le statut réglementaire de la commune. Les frais d'acquisition suivent le barème du département. Calcul déterministe, aucun conseil fiscal.
- Coût
- 2 crédits par appel réussi
- Accès
- À l'usage ou avec l'abonnement Data
- Portée
- estimation
- Outil MCP
- simuler_rendement
- Bac à sable
- Oui, sans débit, sur un jeu figé
- Cache serveur
- 24 h
- Délai maximal
- 5 s
Paramètres
prixentierobligatoirePrix d'achat hors frais, en euros.
de 10 000 à 50 000 000
surfacenombreobligatoireSurface habitable, en m².
1 000 au plus ; plus de 0
inseetexteCommune du bien : loyer de marché, vacance, courte durée, réglementation et frais d'acquisition du département.
loyernombreLoyer mensuel en location nue, en euros ; sans lui, le loyer de marché de la commune.
100 000 au plus ; plus de 0
travauxnombreBudget de travaux, en euros (0 par défaut).
de 0 à 10 000 000
mobiliernombreBudget mobilier d'une location meublée, en euros.
de 0 à 1 000 000
apportnombreApport en euros, rapporté à l'investissement de la location nue.
de 0 à 50 000 000
apport_pctnombreApport en % de l'investissement (à la place d'apport).
de 0 à 100
tauxnombreTaux du crédit, en % par an.
de 0 à 15
dureeentierDurée du crédit, en années.
de 1 à 30
chargesnombreCharges non récupérables, en euros par mois.
de 0 à 20 000
taxe_foncierenombreTaxe foncière, en euros par an.
de 0 à 200 000
tminombreTranche marginale d'imposition, en %.
de 0 à 45
revenusnombreRevenus nets mensuels du foyer, pour le taux d'effort.
10 000 000 au plus ; plus de 0
credits_en_coursnombreMensualités des crédits en cours, en euros.
de 0 à 1 000 000
typetexteValeurs :
appartement,maisonchambresentierChambres : capacité d'accueil en courte durée.
de 0 à 20
dpetexteÉtiquette DPE : statut réglementaire de la courte durée.
Valeurs :
A,B,C,D,E,F,GneufbooléenhorizonentierAnnées de projection et de TRI.
de 1 à 30
lcd_classebooléenCourte durée : meublé de tourisme classé (oui par défaut).
lcd_conciergeriebooléenCourte durée : gestion par une conciergerie (oui par défaut).
lcd_occupation_pctnombreCourte durée : occupation imposée, en % des nuits ouvertes.
de 0 à 100
lcd_autorisebooléenCourte durée : autorisation de changement d'usage obtenue.
Exemple d'appel
curl -X POST https://pillr.fr/api/v1/simulations/rendement \
-H "Authorization: Bearer $PILLR_CLE" \
-H "Content-Type: application/json" \
-d '{"insee":"76540","prix":150000,"surface":50,"type":"appartement"}'Cette entrée est dans le bac à sable : une clé pk_test_ obtient la réponse, sans débit.
Réponse du bac à sable
{
"hypotheses": {
"prix": 150000,
"surface_m2": 50,
"commune": "Rouen",
"insee": "76540",
"travaux": 0,
"mobilier": 5000,
"apport_pct": 20,
"taux_pct": 3.5,
"duree_ans": 25,
"charges_mensuelles": 150,
"taxe_fonciere": 1200,
"taxe_fonciere_source": "forfait",
"tmi_pct": 30,
"frais_acquisition": 12343,
"frais_acquisition_source": "barème DGFiP du 01/06/2026, dép. 76 (DMTO 6,32 %)",
"loyer_mensuel_nu": 664,
"loyer_source": "marche_commune",
"vacance_pct": 9.7,
"horizon_ans": 10
},
"strategies": [
{
"cle": "lld_nue",
"libelle": "Location nue",
"loyer_mensuel": 664,
"loyer_annuel": 7968,
"rendement_brut_pct": 4.91,
"rendement_net_pct": 2.24,
"investissement_total": 162343,
"emprunt": 129874,
"mensualite": 650,
"charges_annuelles": 4331,
"vacance_pct": 9.7,
"gestion_pct": 7,
"regime_annee1": {
"cle": "sci_is",
"libelle": "SCI à l'IS",
"impot_annuel": 0,
"base_imposable": 0
},
"cashflow_mensuel": {
"avant_impot": -347,
"apres_impot": -347
},
"decomposition": {
"loyer": 664,
"mensualite": 650,
"charges": 150,
"taxe_fonciere": 100,
"vacance_et_gestion": 111,
"cashflow_avant_impot": -347,
"impot": 0,
"cashflow_apres_impot": -347
},
"projection": [
{
"annee": 1,
"cashflow_annuel": -4164,
"cashflow_cumule": -4164,
"capital_restant_du": 126567
},
{
"annee": 2,
"cashflow_annuel": -4226,
"cashflow_cumule": -8390,
"capital_restant_du": 123142
},
{
"annee": 3,
"cashflow_annuel": -4290,
"cashflow_cumule": -12680,
"capital_restant_du": 119596
},
{
"annee": 4,
"cashflow_annuel": -4354,
"cashflow_cumule": -17034,
"capital_restant_du": 115923
},
{
"annee": 5,
"cashflow_annuel": -4420,
"cashflow_cumule": -21454,
"capital_restant_du": 112120
},
{
"annee": 6,
"cashflow_annuel": -4486,
"cashflow_cumule": -25940,
"capital_restant_du": 108181
},
{
"annee": 7,
"cashflow_annuel": -4553,
"cashflow_cumule": -30493,
"capital_restant_du": 104102
},
{
"annee": 8,
"cashflow_annuel": -4621,
"cashflow_cumule": -35114,
"capital_restant_du": 99879
},
{
"annee": 9,
"cashflow_annuel": -4691,
"cashflow_cumule": -39805,
"capital_restant_du": 95505
},
{
"annee": 10,
"cashflow_annuel": -4761,
"cashflow_cumule": -44566,
"capital_restant_du": 90975
}
],
"recommandable": true,
"courte_duree": null
},
{
"cle": "lld_meublee",
"libelle": "Meublée (LMNP)",
"loyer_mensuel": 784,
"loyer_annuel": 9408,
"rendement_brut_pct": 5.62,
"rendement_net_pct": 2.83,
"investissement_total": 167343,
"emprunt": 133874,
"mensualite": 670,
"charges_annuelles": 4665,
"vacance_pct": 9.7,
"gestion_pct": 8,
"regime_annee1": {
"cle": "sci_is",
"libelle": "SCI à l'IS",
"impot_annuel": 0,
"base_imposable": 0
},
"cashflow_mensuel": {
"avant_impot": -275,
"apres_impot": -275
},
"decomposition": {
"loyer": 784,
"mensualite": 670,
"charges": 150,
"taxe_fonciere": 100,
"vacance_et_gestion": 139,
"cashflow_avant_impot": -275,
"impot": 0,
"cashflow_apres_impot": -275
},
"projection": [
{
"annee": 1,
"cashflow_annuel": -3300,
"cashflow_cumule": -3300,
"capital_restant_du": 130465
},
{
"annee": 2,
"cashflow_annuel": -3349,
"cashflow_cumule": -6649,
"capital_restant_du": 126935
},
{
"annee": 3,
"cashflow_annuel": -3400,
"cashflow_cumule": -10049,
"capital_restant_du": 123280
},
{
"annee": 4,
"cashflow_annuel": -3451,
"cashflow_cumule": -13500,
"capital_restant_du": 119494
},
{
"annee": 5,
"cashflow_annuel": -3502,
"cashflow_cumule": -17002,
"capital_restant_du": 115574
},
{
"annee": 6,
"cashflow_annuel": -3555,
"cashflow_cumule": -20557,
"capital_restant_du": 111514
},
{
"annee": 7,
"cashflow_annuel": -3608,
"cashflow_cumule": -24165,
"capital_restant_du": 107310
},
{
"annee": 8,
"cashflow_annuel": -3662,
"cashflow_cumule": -27827,
"capital_restant_du": 102957
},
{
"annee": 9,
"cashflow_annuel": -3717,
"cashflow_cumule": -31544,
"capital_restant_du": 98448
},
{
"annee": 10,
"cashflow_annuel": -3773,
"cashflow_cumule": -35317,
"capital_restant_du": 93780
}
],
"recommandable": true,
"courte_duree": null
},
{
"cle": "lcd",
"libelle": "Courte durée (LCD)",
"loyer_mensuel": 962,
"loyer_annuel": 11549,
"rendement_brut_pct": 6.82,
"rendement_net_pct": -1.53,
"investissement_total": 169343,
"emprunt": 135474,
"mensualite": 678,
"charges_annuelles": 14148,
"vacance_pct": 35.8,
"gestion_pct": 38.5,
"regime_annee1": {
"cle": "sci_is",
"libelle": "SCI à l'IS",
"impot_annuel": 0,
"base_imposable": 0
},
"cashflow_mensuel": {
"avant_impot": -895,
"apres_impot": -895
},
"decomposition": {
"loyer": 962,
"mensualite": 678,
"charges": 150,
"taxe_fonciere": 100,
"vacance_et_gestion": 929,
"cashflow_avant_impot": -895,
"impot": 0,
"cashflow_apres_impot": -895
},
"projection": [
{
"annee": 1,
"cashflow_annuel": -10740,
"cashflow_cumule": -10740,
"capital_restant_du": 132025
},
{
"annee": 2,
"cashflow_annuel": -10901,
"cashflow_cumule": -21641,
"capital_restant_du": 128453
},
{
"annee": 3,
"cashflow_annuel": -11065,
"cashflow_cumule": -32706,
"capital_restant_du": 124753
},
{
"annee": 4,
"cashflow_annuel": -11231,
"cashflow_cumule": -43937,
"capital_restant_du": 120923
},
{
"annee": 5,
"cashflow_annuel": -11399,
"cashflow_cumule": -55336,
"capital_restant_du": 116956
},
{
"annee": 6,
"cashflow_annuel": -11570,
"cashflow_cumule": -66906,
"capital_restant_du": 112848
},
{
"annee": 7,
"cashflow_annuel": -11744,
"cashflow_cumule": -78650,
"capital_restant_du": 108594
},
{
"annee": 8,
"cashflow_annuel": -11920,
"cashflow_cumule": -90570,
"capital_restant_du": 104188
},
{
"annee": 9,
"cashflow_annuel": -12099,
"cashflow_cumule": -102669,
"capital_restant_du": 99626
},
{
"annee": 10,
"cashflow_annuel": -12280,
"cashflow_cumule": -114949,
"capital_restant_du": 94902
}
],
"recommandable": true,
"courte_duree": {
"prix_nuit": 51,
"occupation_pct": 64.2,
"nuits_ouvertes": 350,
"nuits_reservees": 225,
"capacite": 3,
"revenu_annee1": 9817,
"revenu_croisiere": 11549,
"confiance": "mesure",
"source": "airdna_market",
"statut_reglementaire": {
"niveau": "libre",
"recommandable": true,
"titre": "Déclaration en mairie",
"texte": "Déclaration préalable en mairie et numéro d'enregistrement (généralisé en 2026), règlement de copropriété à vérifier. Le plafond de 120 nuits ne vise que la résidence principale."
}
}
}
],
"recommandee": {
"avant_impot": "lld_meublee",
"apres_impot": {
"cle": "lld_meublee",
"horizon_ans": 10,
"tri_pct": 3.62,
"regime": "Réel LMNP"
}
},
"synthese": {
"strategie": "lld_meublee",
"rendement_brut_pct": 5.62,
"rendement_net_pct": 2.83,
"mensualite": 670,
"cashflow_mensuel": {
"avant_impot": -275,
"apres_impot": -275
}
},
"hcsf": null,
"avertissements": [
"Prélèvements sociaux : 17,2 % sur le foncier et les plus-values, 18,6 % sur le meublé (LFSS 2026), à confirmer sur le BOFiP.",
"Frais d'acquisition : barème DGFiP du 01/06/2026, dép. 76 (DMTO 6,32 %).",
"Impôt de la première année, au régime le moins imposé de chaque stratégie, à tranche marginale constante. Ceci n'est pas un conseil fiscal."
],
"qualite": {
"n": null,
"provenance": "estime",
"incertitude": null,
"drapeaux": [
"valeur_imputee"
],
"methode": "moteur du simulateur de la fiche annonce, sur le loyer de marché au m² de la commune multiplié par la surface",
"donnees_du": "2026-10-19",
"source": "Moteur de simulation de pillr.fr (lib/finance/simulate.ts), constantes fiscales 2026 ; loyer de marché, vacance et courte durée de la commune (market_data, profils AirDNA)"
},
"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 19/10/2026.
Réponse
hypothesesobjetAfficher les 19 champsMasquer
prixnombresurface_m2nombrecommunetexte ou nullinseetexte ou nulltravauxnombremobiliernombreapport_pctnombretaux_pctnombreduree_ansentiercharges_mensuellesnombretaxe_foncierenombretaxe_fonciere_sourcetextefournie : la taxe foncière de l'appelant ; estimee : estimation d'après les taux de la commune et la base médiane du département ; forfait : le forfait du simulateur, faute de taux pour la commune.
Valeurs :
fournie,estimee,forfaittmi_pctnombrefrais_acquisitionnombrefrais_acquisition_sourcetexteloyer_mensuel_nunombreloyer_sourcetextedonne : le loyer de l'appelant ; marche_commune : loyer de marché au m² de la commune multiplié par la surface.
Valeurs :
donne,marche_communevacance_pctnombrehorizon_ansentier
strategiesliste d'objetsAfficher les 18 champsMasquer
cletextelld_nue : location nue ; lld_meublee : location meublée longue durée (LMNP) ; lcd : location courte durée (meublé de tourisme).
Valeurs :
lld_nue,lld_meublee,lcdlibelletexteloyer_mensuelnombreloyer_annuelnombrerendement_brut_pctnombreLoyer annuel sur investissement total (prix, frais, travaux, mobilier), en %.
rendement_net_pctnombreLoyer annuel moins charges, vacance et gestion, sur investissement total, en %.
investissement_totalnombreempruntnombremensualitenombrecharges_annuellesnombrevacance_pctnombregestion_pctnombreregime_annee1objetAfficher les 5 champsMasquer
cletextelibelletexteimpot_annuelnombrebase_imposablenombrefrais_regime_annuelsnombreFrais propres au régime de l'année 1, payés en plus de l'impôt : CFE et comptable au réel LMNP, comptable de la SCI à l'IS, 0 pour les autres régimes.
cashflow_mensuelobjetAfficher les 2 champsMasquer
avant_impotnombreapres_impotnombre
decompositionobjetMontants mensuels en euros, les coûts en positif : loyer moins mensualité, charges, taxe foncière et vacance et gestion égale le cash-flow avant impôt ; moins l'impôt et les frais du régime, le cash-flow après impôt.
Afficher les 9 champsMasquer
loyernombremensualitenombrechargesnombretaxe_foncierenombrevacance_et_gestionnombreVacance locative, gestion et arrondis du moteur : le reste du cash-flow avant impôt.
cashflow_avant_impotnombreimpotnombreImpôt mensuel du régime de l'année 1 ; négatif : économie d'impôt (déficit foncier).
frais_regimenombreFrais propres au régime de l'année 1, par mois (regime_annee1.frais_regime_annuels sur douze).
cashflow_apres_impotnombre
projectionliste d'objetsAfficher les 4 champsMasquer
anneeentiercashflow_annuelnombrecashflow_cumulenombrecapital_restant_dunombre
recommandablebooléenFaux pour une courte durée que la réglementation locale ou le DPE ferment.
courte_dureeobjet ou nullAfficher les 10 champsMasquer
prix_nuitnombreoccupation_pctnombrenuits_ouvertesentiernuits_reserveesentiercapaciteentierrevenu_annee1nombreRevenu de la première année (montée en charge).
revenu_croisierenombreRevenu annuel en régime de croisière.
confiancetexteValeurs :
mesure,estime,faiblesourcetexteProvenance du profil de marché : marché AirDNA de la commune, profil départemental ou national, anciennes colonnes, ou repli sur le loyer nu.
statut_reglementaireobjetAfficher les 4 champsMasquer
niveautexteValeurs :
libre,declaration,autorisation,compensation,dperecommandablebooléentitretextetextetexte
recommandeeobjetAfficher les 2 champsMasquer
avant_impottexteMeilleur cashflow mensuel avant impôt, parmi les stratégies recommandables.
Valeurs :
lld_nue,lld_meublee,lcdapres_impotobjet ou nullMeilleur TRI après impôt et revente sur l'horizon, régime le plus favorable de chaque stratégie.
Afficher les 4 champsMasquer
cletextelld_nue : location nue ; lld_meublee : location meublée longue durée (LMNP) ; lcd : location courte durée (meublé de tourisme).
Valeurs :
lld_nue,lld_meublee,lcdhorizon_ansentiertri_pctnombre ou nullregimetexte
syntheseobjetAfficher les 5 champsMasquer
strategietextelld_nue : location nue ; lld_meublee : location meublée longue durée (LMNP) ; lcd : location courte durée (meublé de tourisme).
Valeurs :
lld_nue,lld_meublee,lcdrendement_brut_pctnombrerendement_net_pctnombremensualitenombrecashflow_mensuelobjetAfficher les 2 champsMasquer
avant_impotnombreapres_impotnombre
hcsfobjet ou nullTaux d'effort au sens du Haut Conseil de stabilité financière ; null sans revenus.
Afficher les 6 champsMasquer
revenus_mensuelsnombremensualitesnombreMensualité de la stratégie de la synthèse, plus les crédits en cours.
taux_effort_pctnombreseuil_pctnombreconformebooléenmensualite_maxnombre
avertissementsliste de textesqualiteobjetCe 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.
creditsobjetCrédits débités par cet appel (réservés, pour une tâche en cours), et crédits encore utilisables ce mois avant la coupure : crédits offerts, crédits inclus du mois et crédits facturables sous le plafond de dépense (null si inconnus ou en bac à sable).
Afficher les 2 champsMasquer
debitesentier0 au moins
restantsentier ou null
Erreurs possibles
- 400parametres_invalidesUn paramètre manque ou ne passe pas son contrôle ; le détail est donné champ par champ
- 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_ demande une entrée hors du jeu figé de l'opération
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
Taux de crédit du moment
Essayer en direct/api/v1/taux-creditTaux de crédit immobilier du moment par durée (bon taux, très bon taux, taux excellent), lus dans le tableau du baromètre public de meilleurtaux.com, avec la date de sa simulation. Lecture d'une page tierce sans API ni contrat : si le tableau change de forme ou ne répond pas, l'opération répond « donnée indisponible », jamais un taux de repli. Réponse gardée 6 heures.
- Coût
- 1 crédit par appel réussi
- Accès
- À l'usage ou avec l'abonnement Data
- Portée
- estimation
- Outil MCP
- taux_credit
- Bac à sable
- Oui, sans débit, sur un jeu figé
- Cache serveur
- 6 h
- Délai maximal
- 10 s
Paramètres
Aucun.
Exemple d'appel
curl https://pillr.fr/api/v1/taux-credit \
-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
{
"taux": [
{
"duree_ans": 15,
"bon_pct": 3.81,
"tres_bon_pct": 3.65,
"excellent_pct": 3.4
},
{
"duree_ans": 20,
"bon_pct": 3.9,
"tres_bon_pct": 3.79,
"excellent_pct": 3.45
},
{
"duree_ans": 25,
"bon_pct": 4.05,
"tres_bon_pct": 3.89,
"excellent_pct": 3.55
}
],
"simulation_du": "2026-11-18",
"lu_le": "2026-11-22T14:58:19.280Z",
"source": "Meilleurtaux, baromètre public des taux immobiliers",
"url": "https://www.meilleurtaux.com/credit-immobilier/barometre-des-taux.html",
"qualite": {
"n": null,
"provenance": "mesure",
"incertitude": null,
"drapeaux": [],
"methode": "tableau du baromètre lu par ses en-têtes ; taux nominaux hors assurance publiés par le courtier",
"donnees_du": "2026-11-18",
"source": "Meilleurtaux, baromètre public des taux immobiliers"
},
"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 18/11/2026.
Réponse
tauxliste d'objetsTaux nominaux par durée, hors assurance, tels que le baromètre les publie.
Afficher les 4 champsMasquer
duree_ansentierbon_pctnombre ou null« Bon taux » du baromètre, en % par an.
tres_bon_pctnombre ou null« Très bon taux » du baromètre, en % par an.
excellent_pctnombre ou null« Taux excellent » du baromètre, en % par an.
simulation_dutexte ou nullDate de la simulation publiée par le baromètre (AAAA-MM-JJ).
lu_letexteHorodatage de la lecture de la page.
sourcetexteurltextequaliteobjetCe 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.
creditsobjetCrédits débités par cet appel (réservés, pour une tâche en cours), et crédits encore utilisables ce mois avant la coupure : crédits offerts, crédits inclus du mois et crédits facturables sous le plafond de dépense (null si inconnus ou en bac à sable).
Afficher les 2 champsMasquer
debitesentier0 au moins
restantsentier ou null
Erreurs possibles
- 400parametres_invalidesUn paramètre manque ou ne passe pas son contrôle ; le détail est donné champ par champ
- 403hors_bac_a_sableUne clé pk_test_ demande une entrée hors du jeu figé de l'opération
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