Aller au contenu

Documentation

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
GET/api/v1/communes/{insee}/loyers

Loyer 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

  • inseetexteobligatoire

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

  • typologietexte

    Typologie du logement : T1 à T5 (T5 et plus), ou maison.

    Valeurs : T1, T2, T3, T4, T5, maison

  • surfacenombre

    Surface 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

  • inseetexte
  • communetexte ou null
  • millesimetexte ou null

    Millésime de la Carte des loyers.

  • arrondissements_agregesentier

    Paris, Lyon et Marseille : nombre d'arrondissements agrégés, pondérés par leur population ; 0 pour une autre commune.

  • charges_comprisesbooléen

    Loyers d'annonce de la Carte des loyers, charges comprises.

  • loyer_m2_communeobjet

    Loyer 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 champs
    • valeurnombre ou null
    • qualiteobjet

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

      Afficher les 7 champs
      • nentier ou null

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

        0 au moins

      • provenancetexte ou null

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

        Valeurs : mesure, estime

      • incertitudeobjet ou null

        Incertitude de la valeur : fourchette et demi-largeur.

        Afficher les 3 champs
        • demi_largeur_pctnombre ou null

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

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

        Ce qui doit faire lire la valeur avec prudence ; vide si rien.

        Valeurs : prix_atypique, surface_atypique, vente_en_bloc, doublon_probable, date_estimee, peu_d_observations, valeur_imputee, rattachement_incertain, donnee_ancienne

      • methodetexte ou null

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

      • donnees_dutexte ou null

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

      • sourcetexte

        Source publique ou moteur Pillr, en clair.

  • logementobjet ou null

    Le 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 champs
    • typologietexte

      Typologie du logement : T1 à T5 (T5 et plus), ou maison.

      Valeurs : T1, T2, T3, T4, T5, maison

    • surface_m2nombre
    • segmenttexte

      Segment 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, maison

    • replibooléen

      Vrai quand le segment de la typologie manquait et que celui de l'ensemble des appartements l'a remplacé.

    • loyer_m2nombre

      Loyer d'annonce au m² par mois, charges comprises.

    • loyer_mensuelnombre

      Loyer d'annonce mensuel, charges comprises : loyer au m² multiplié par la surface.

    • fourchette_mensuelleobjet ou null

      Bornes de l'intervalle de prédiction à 95 % multipliées par la surface ; null si le segment n'en publie pas.

      Afficher les 2 champs
      • minnombre
      • maxnombre
    • qualiteobjet

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

      Afficher les 7 champs
      • nentier ou null

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

        0 au moins

      • provenancetexte ou null

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

        Valeurs : mesure, estime

      • incertitudeobjet ou null

        Incertitude de la valeur : fourchette et demi-largeur.

        Afficher les 3 champs
        • demi_largeur_pctnombre ou null

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

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

        Ce qui doit faire lire la valeur avec prudence ; vide si rien.

        Valeurs : prix_atypique, surface_atypique, vente_en_bloc, doublon_probable, date_estimee, peu_d_observations, valeur_imputee, rattachement_incertain, donnee_ancienne

      • methodetexte ou null

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

      • donnees_dutexte ou null

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

      • sourcetexte

        Source publique ou moteur Pillr, en clair.

    • rendement_brut_marche_pctnombre ou null

      Rendement 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 null
      Afficher les 5 champs
      • type_predictiontexte ou null

        commune : 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 null

        Annonces de la commune dans le modèle.

      • nb_obs_mailleentier ou null

        Annonces de la maille dans le modèle.

      • r2_ajustenombre ou null

        R² ajusté du modèle.

      • surface_reference_m2nombre ou null

        Surface de référence publiée pour le segment ; null pour les maisons.

  • par_typologieliste d'objets

    Une ligne par typologie couverte, à la surface d'exemple publiée par les pages loyer de pillr.fr.

    Afficher les 8 champs
    • typologietexte

      Typologie du logement : T1 à T5 (T5 et plus), ou maison.

      Valeurs : T1, T2, T3, T4, T5, maison

    • surface_m2nombre
    • segmenttexte

      Segment 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, maison

    • replibooléen

      Vrai quand le segment de la typologie manquait et que celui de l'ensemble des appartements l'a remplacé.

    • loyer_m2nombre

      Loyer d'annonce au m² par mois, charges comprises.

    • loyer_mensuelnombre

      Loyer d'annonce mensuel, charges comprises : loyer au m² multiplié par la surface.

    • fourchette_mensuelleobjet ou null

      Bornes de l'intervalle de prédiction à 95 % multipliées par la surface ; null si le segment n'en publie pas.

      Afficher les 2 champs
      • minnombre
      • maxnombre
    • qualiteobjet

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

      Afficher les 7 champs
      • nentier ou null

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

        0 au moins

      • provenancetexte ou null

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

        Valeurs : mesure, estime

      • incertitudeobjet ou null

        Incertitude de la valeur : fourchette et demi-largeur.

        Afficher les 3 champs
        • demi_largeur_pctnombre ou null

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

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

        Ce qui doit faire lire la valeur avec prudence ; vide si rien.

        Valeurs : prix_atypique, surface_atypique, vente_en_bloc, doublon_probable, date_estimee, peu_d_observations, valeur_imputee, rattachement_incertain, donnee_ancienne

      • methodetexte ou null

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

      • donnees_dutexte ou null

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

      • sourcetexte

        Source publique ou moteur Pillr, en clair.

  • rendement_brut_marche_pctobjet

    Rendement brut de marché de la commune : loyer annuel au m² sur prix médian au m², en %.

    Afficher les 3 champs
    • appartementnombre ou null
    • maisonnombre ou null
    • qualiteobjet

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

      Afficher les 7 champs
      • nentier ou null

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

        0 au moins

      • provenancetexte ou null

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

        Valeurs : mesure, estime

      • incertitudeobjet ou null

        Incertitude de la valeur : fourchette et demi-largeur.

        Afficher les 3 champs
        • demi_largeur_pctnombre ou null

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

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

        Ce qui doit faire lire la valeur avec prudence ; vide si rien.

        Valeurs : prix_atypique, surface_atypique, vente_en_bloc, doublon_probable, date_estimee, peu_d_observations, valeur_imputee, rattachement_incertain, donnee_ancienne

      • methodetexte ou null

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

      • donnees_dutexte ou null

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

      • sourcetexte

        Source publique ou moteur Pillr, en clair.

  • segmentsliste d'objets
    Afficher les 7 champs
    • segmenttexte

      Segment 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, maison

    • libelletexte
    • loyer_m2nombre
    • min_95nombre ou null
    • max_95nombre ou null
    • modeleobjet ou null

      null pour un agrégat d'arrondissements.

      Afficher les 5 champs
      • type_predictiontexte ou null

        commune : 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 null

        Annonces de la commune dans le modèle.

      • nb_obs_mailleentier ou null

        Annonces de la maille dans le modèle.

      • r2_ajustenombre ou null

        R² ajusté du modèle.

      • surface_reference_m2nombre ou null

        Surface de référence publiée pour le segment ; null pour les maisons.

    • qualiteobjet

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

      Afficher les 7 champs
      • nentier ou null

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

        0 au moins

      • provenancetexte ou null

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

        Valeurs : mesure, estime

      • incertitudeobjet ou null

        Incertitude de la valeur : fourchette et demi-largeur.

        Afficher les 3 champs
        • demi_largeur_pctnombre ou null

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

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

        Ce qui doit faire lire la valeur avec prudence ; vide si rien.

        Valeurs : prix_atypique, surface_atypique, vente_en_bloc, doublon_probable, date_estimee, peu_d_observations, valeur_imputee, rattachement_incertain, donnee_ancienne

      • methodetexte ou null

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

      • donnees_dutexte ou null

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

      • sourcetexte

        Source publique ou moteur Pillr, en clair.

  • limitesliste de textes
  • sourcetexte
  • creditsobjet

    Crédits débités par cet appel (réservés, pour une tâche en cours), et crédits encore utilisables ce mois avant la coupure : crédits offerts, crédits inclus du mois et crédits facturables sous le plafond de dépense (null si inconnus ou en bac à sable).

    Afficher les 2 champs
    • debitesentier

      0 au moins

    • restantsentier ou null

Erreurs possibles

  • 400parametres_invalidesUn paramètre manque ou ne passe pas son contrôle ; le détail est donné champ par champ
  • 403hors_bac_a_sableUne clé pk_test_ demande une entrée hors du jeu figé de l'opération
Afficher les 11 erreurs communes à toute l'API

Une ressource absente répond par un code de la famille des ressources absentes, propre à l'opération, sans débit. Guide des erreurs

Encadrement des loyers

Essayer en direct
GET/api/v1/encadrement-loyers

Encadrement 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

  • annoncetexte

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

    Code postal.

  • quartiertexte

    Quartier administratif de Paris (ex. Belleville) ; sans lui, la moyenne des quartiers de l'arrondissement.

    de 2 à 80 caractères

  • piecesentier

    Nombre de pièces principales.

    de 1 à 30

  • epoquetexte

    Sans époque : la moyenne des quatre époques.

    Valeurs : avant_1946, 1946_1970, 1971_1990, apres_1990

  • meublevaleur

    Location meublée (true) ou nue (false, par défaut).

  • surfacenombre

    Surface habitable, en m².

    1 000 au plus ; plus de 0

  • loyernombre

    Loyer 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éen

    Vrai : 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éen

    La commune applique l'encadrement des loyers (liste des communes encadrées du simulateur de pillr.fr).

  • communetexte ou null
  • code_postaltexte ou null
  • inseetexte ou null
  • arrondissemententier ou null
  • quartiertexte ou null

    Quartier retenu, ou l'arrondissement quand la moyenne de ses quartiers est prise.

  • annee_baremeentier ou null

    Année du barème lu (la plus récente chargée).

  • criteresobjet
    Afficher les 3 champs
    • piecesentier ou null

      Pièces du barème, 1 à 4 (4 : quatre pièces et plus).

    • epoquetexte ou null

      null : toutes les époques de construction, en moyenne.

      Valeurs : avant_1946, 1946_1970, 1971_1990, apres_1990

    • meublebooléen
  • loyer_reference_eur_m2nombre ou null

    Loyer de référence, en euros par m² et par mois.

  • loyer_minore_eur_m2nombre ou null

    Loyer de référence minoré, en euros par m² et par mois.

  • loyer_majore_eur_m2nombre ou null

    Loyer de référence majoré, en euros par m² et par mois.

  • surface_m2nombre ou null
  • loyer_max_legal_eur_moisnombre ou null

    Loyer de référence majoré multiplié par la surface : le loyer hors charges maximal, hors complément de loyer.

  • loyer_estime_eur_moisnombre ou null

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

    Vrai si le loyer comparé ne dépasse pas le loyer maximal légal ; null sans loyer ou sans plafond.

  • lignes_baremeliste d'objets

    Les lignes du barème retenues pour les moyennes.

    Afficher les 6 champs
    • id_quartiertexte ou null
    • quartiertexte ou null
    • epoquetexte ou null
    • loyer_referencenombre ou null
    • loyer_minorenombre ou null
    • loyer_majorenombre ou null
  • hypothesesliste de textes
  • notetexte
  • qualiteobjet

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

    Afficher les 7 champs
    • nentier ou null

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

      0 au moins

    • provenancetexte ou null

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

      Valeurs : mesure, estime

    • incertitudeobjet ou null

      Incertitude de la valeur : fourchette et demi-largeur.

      Afficher les 3 champs
      • demi_largeur_pctnombre ou null

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

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

      Ce qui doit faire lire la valeur avec prudence ; vide si rien.

      Valeurs : prix_atypique, surface_atypique, vente_en_bloc, doublon_probable, date_estimee, peu_d_observations, valeur_imputee, rattachement_incertain, donnee_ancienne

    • methodetexte ou null

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

    • donnees_dutexte ou null

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

    • sourcetexte

      Source publique ou moteur Pillr, en clair.

  • sourcetexte
  • creditsobjet

    Crédits débités par cet appel (réservés, pour une tâche en cours), et crédits encore utilisables ce mois avant la coupure : crédits offerts, crédits inclus du mois et crédits facturables sous le plafond de dépense (null si inconnus ou en bac à sable).

    Afficher les 2 champs
    • debitesentier

      0 au moins

    • restantsentier ou null

Erreurs possibles

  • 400parametres_invalidesUn paramètre manque ou ne passe pas son contrôle ; le détail est donné champ par champ
  • 403hors_bac_a_sableUne clé pk_test_ demande une entrée hors du jeu figé de l'opération
Afficher les 11 erreurs communes à toute l'API

Une ressource absente répond par un code de la famille des ressources absentes, propre à l'opération, sans débit. Guide des erreurs

Zonage ABC, plafonds et contraintes locales

Essayer en direct
GET/api/v1/communes/{insee}/zonage

Zone 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

  • inseetexteobligatoire

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

  • surfacenombre

    Surface retenue en m² (habitable, plus la moitié des annexes dans la limite de 8 m²).

    1 000 au plus ; plus de 0

  • loyernombre

    Loyer 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

  • inseetexte
  • communetexte ou null
  • zonetexte ou null

    La zone en vigueur ; null pour une commune inconnue du zonage (outre-mer compris).

    Valeurs : A bis, A, B1, B2, C

  • zone_servietexte ou null

    La zone lue en base, avant correction.

  • correctionobjet ou null

    Une révision officielle que la base n'intègre pas encore et qui change la zone de la commune.

    Afficher les 4 champs
    • arretetexte
    • en_vigueur_letexte
    • zone_servietexte

      Zone du zonage ABC : A bis, A, B1, B2 ou C.

      Valeurs : A bis, A, B1, B2, C

    • sourceobjet
      Afficher les 4 champs
      • editeurtexte
      • libelletexte
      • urltexte
      • datetexte

        Date de la source ou de la version du texte consultée (AAAA-MM-JJ).

  • zonageobjet
    Afficher les 5 champs
    • arretetexte

      Dernière révision officielle intégrée à la base.

    • importe_letexte
    • constate_letexte
    • phrasetexte
    • sourceobjet
      Afficher les 4 champs
      • editeurtexte
      • libelletexte
      • urltexte
      • datetexte

        Date de la source ou de la version du texte consultée (AAAA-MM-JJ).

  • dispositifsliste d'objets
    Afficher les 9 champs
    • cletexte

      Valeurs : pinel, relance_logement, denormandie, loc_avantages, deficit_foncier

    • nomtexte
    • statuttexte

      ouvert : 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_verifier

    • detailtexte
    • jusqu_autexte ou null

      Date limite des acquisitions ou des demandes (AAAA-MM-JJ).

    • role_de_la_zonetexte
    • sourceobjet
      Afficher les 4 champs
      • editeurtexte
      • libelletexte
      • urltexte
      • datetexte

        Date de la source ou de la version du texte consultée (AAAA-MM-JJ).

    • sources_complementairesliste d'objets
      Afficher les 4 champs
      • editeurtexte
      • libelletexte
      • urltexte
      • datetexte

        Date de la source ou de la version du texte consultée (AAAA-MM-JJ).

    • verifie_letexte
  • plafond_loyer_intermediaireobjet

    Plafond de loyer de la location intermédiaire (Relance logement, baux Pinel en cours, Denormandie).

    Afficher les 11 champs
    • anneeentier
    • eur_m2_moisnombre ou null

      Plafond hors charges par m² de surface retenue, avant coefficient ; null hors métropole ou sans zone.

    • coefficient_surfacenombre ou null
    • formule_coefficienttexte
    • plafond_mensuelnombre ou null

      Plafond mensuel hors charges pour la surface donnée, coefficient compris.

    • loyernombre ou null

      Le loyer comparé, hors charges.

    • depassement_pctnombre ou null
    • conformebooléen ou null
    • champtexte

      Ce que ce plafond vise, et ce qu'il ne vise pas.

    • sourceobjet
      Afficher les 4 champs
      • editeurtexte
      • libelletexte
      • urltexte
      • datetexte

        Date de la source ou de la version du texte consultée (AAAA-MM-JJ).

    • qualiteobjet

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

      Afficher les 7 champs
      • nentier ou null

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

        0 au moins

      • provenancetexte ou null

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

        Valeurs : mesure, estime

      • incertitudeobjet ou null

        Incertitude de la valeur : fourchette et demi-largeur.

        Afficher les 3 champs
        • demi_largeur_pctnombre ou null

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

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

        Ce qui doit faire lire la valeur avec prudence ; vide si rien.

        Valeurs : prix_atypique, surface_atypique, vente_en_bloc, doublon_probable, date_estimee, peu_d_observations, valeur_imputee, rattachement_incertain, donnee_ancienne

      • methodetexte ou null

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

      • donnees_dutexte ou null

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

      • sourcetexte

        Source publique ou moteur Pillr, en clair.

  • contraintes_localesliste d'objets
    Afficher les 5 champs
    • typetexte

      Valeurs : encadrement, courte_duree, tension

    • niveautexte

      Valeurs : info, attention

    • titretexte
    • detailtexte
    • a_verifierbooléen

      Pillr signale, la mairie confirme.

  • qualiteobjet

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

    Afficher les 7 champs
    • nentier ou null

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

      0 au moins

    • provenancetexte ou null

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

      Valeurs : mesure, estime

    • incertitudeobjet ou null

      Incertitude de la valeur : fourchette et demi-largeur.

      Afficher les 3 champs
      • demi_largeur_pctnombre ou null

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

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

      Ce qui doit faire lire la valeur avec prudence ; vide si rien.

      Valeurs : prix_atypique, surface_atypique, vente_en_bloc, doublon_probable, date_estimee, peu_d_observations, valeur_imputee, rattachement_incertain, donnee_ancienne

    • methodetexte ou null

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

    • donnees_dutexte ou null

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

    • sourcetexte

      Source publique ou moteur Pillr, en clair.

  • creditsobjet

    Crédits débités par cet appel (réservés, pour une tâche en cours), et crédits encore utilisables ce mois avant la coupure : crédits offerts, crédits inclus du mois et crédits facturables sous le plafond de dépense (null si inconnus ou en bac à sable).

    Afficher les 2 champs
    • debitesentier

      0 au moins

    • restantsentier ou null

Erreurs possibles

  • 400parametres_invalidesUn paramètre manque ou ne passe pas son contrôle ; le détail est donné champ par champ
  • 403hors_bac_a_sableUne clé pk_test_ demande une entrée hors du jeu figé de l'opération
Afficher les 11 erreurs communes à toute l'API

Une ressource absente répond par un code de la famille des ressources absentes, propre à l'opération, sans débit. Guide des erreurs

Rendement, cash-flow et crédit

Essayer en direct
POST/api/v1/simulations/rendement

Simulation 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

  • prixentierobligatoire

    Prix d'achat hors frais, en euros.

    de 10 000 à 50 000 000

  • surfacenombreobligatoire

    Surface habitable, en m².

    1 000 au plus ; plus de 0

  • inseetexte

    Commune du bien : loyer de marché, vacance, courte durée, réglementation et frais d'acquisition du département.

  • loyernombre

    Loyer mensuel en location nue, en euros ; sans lui, le loyer de marché de la commune.

    100 000 au plus ; plus de 0

  • travauxnombre

    Budget de travaux, en euros (0 par défaut).

    de 0 à 10 000 000

  • mobiliernombre

    Budget mobilier d'une location meublée, en euros.

    de 0 à 1 000 000

  • apportnombre

    Apport en euros, rapporté à l'investissement de la location nue.

    de 0 à 50 000 000

  • apport_pctnombre

    Apport en % de l'investissement (à la place d'apport).

    de 0 à 100

  • tauxnombre

    Taux du crédit, en % par an.

    de 0 à 15

  • dureeentier

    Durée du crédit, en années.

    de 1 à 30

  • chargesnombre

    Charges non récupérables, en euros par mois.

    de 0 à 20 000

  • taxe_foncierenombre

    Taxe foncière, en euros par an.

    de 0 à 200 000

  • tminombre

    Tranche marginale d'imposition, en %.

    de 0 à 45

  • revenusnombre

    Revenus nets mensuels du foyer, pour le taux d'effort.

    10 000 000 au plus ; plus de 0

  • credits_en_coursnombre

    Mensualités des crédits en cours, en euros.

    de 0 à 1 000 000

  • typetexte

    Valeurs : appartement, maison

  • chambresentier

    Chambres : 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, G

  • neufbooléen
  • horizonentier

    Années de projection et de TRI.

    de 1 à 30

  • lcd_classebooléen

    Courte durée : meublé de tourisme classé (oui par défaut).

  • lcd_conciergeriebooléen

    Courte durée : gestion par une conciergerie (oui par défaut).

  • lcd_occupation_pctnombre

    Courte durée : occupation imposée, en % des nuits ouvertes.

    de 0 à 100

  • lcd_autorisebooléen

    Courte 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

  • hypothesesobjet
    Afficher les 19 champs
    • prixnombre
    • surface_m2nombre
    • communetexte ou null
    • inseetexte ou null
    • travauxnombre
    • mobiliernombre
    • apport_pctnombre
    • taux_pctnombre
    • duree_ansentier
    • charges_mensuellesnombre
    • taxe_foncierenombre
    • taxe_fonciere_sourcetexte

      fournie : 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, forfait

    • tmi_pctnombre
    • frais_acquisitionnombre
    • frais_acquisition_sourcetexte
    • loyer_mensuel_nunombre
    • loyer_sourcetexte

      donne : le loyer de l'appelant ; marche_commune : loyer de marché au m² de la commune multiplié par la surface.

      Valeurs : donne, marche_commune

    • vacance_pctnombre
    • horizon_ansentier
  • strategiesliste d'objets
    Afficher les 18 champs
    • cletexte

      lld_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, lcd

    • libelletexte
    • loyer_mensuelnombre
    • loyer_annuelnombre
    • rendement_brut_pctnombre

      Loyer annuel sur investissement total (prix, frais, travaux, mobilier), en %.

    • rendement_net_pctnombre

      Loyer annuel moins charges, vacance et gestion, sur investissement total, en %.

    • investissement_totalnombre
    • empruntnombre
    • mensualitenombre
    • charges_annuellesnombre
    • vacance_pctnombre
    • gestion_pctnombre
    • regime_annee1objet
      Afficher les 5 champs
      • cletexte
      • libelletexte
      • impot_annuelnombre
      • base_imposablenombre
      • frais_regime_annuelsnombre

        Frais 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_mensuelobjet
      Afficher les 2 champs
      • avant_impotnombre
      • apres_impotnombre
    • decompositionobjet

      Montants 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 champs
      • loyernombre
      • mensualitenombre
      • chargesnombre
      • taxe_foncierenombre
      • vacance_et_gestionnombre

        Vacance locative, gestion et arrondis du moteur : le reste du cash-flow avant impôt.

      • cashflow_avant_impotnombre
      • impotnombre

        Impôt mensuel du régime de l'année 1 ; négatif : économie d'impôt (déficit foncier).

      • frais_regimenombre

        Frais propres au régime de l'année 1, par mois (regime_annee1.frais_regime_annuels sur douze).

      • cashflow_apres_impotnombre
    • projectionliste d'objets
      Afficher les 4 champs
      • anneeentier
      • cashflow_annuelnombre
      • cashflow_cumulenombre
      • capital_restant_dunombre
    • recommandablebooléen

      Faux pour une courte durée que la réglementation locale ou le DPE ferment.

    • courte_dureeobjet ou null
      Afficher les 10 champs
      • prix_nuitnombre
      • occupation_pctnombre
      • nuits_ouvertesentier
      • nuits_reserveesentier
      • capaciteentier
      • revenu_annee1nombre

        Revenu de la première année (montée en charge).

      • revenu_croisierenombre

        Revenu annuel en régime de croisière.

      • confiancetexte

        Valeurs : mesure, estime, faible

      • sourcetexte

        Provenance du profil de marché : marché AirDNA de la commune, profil départemental ou national, anciennes colonnes, ou repli sur le loyer nu.

      • statut_reglementaireobjet
        Afficher les 4 champs
        • niveautexte

          Valeurs : libre, declaration, autorisation, compensation, dpe

        • recommandablebooléen
        • titretexte
        • textetexte
  • recommandeeobjet
    Afficher les 2 champs
    • avant_impottexte

      Meilleur cashflow mensuel avant impôt, parmi les stratégies recommandables.

      Valeurs : lld_nue, lld_meublee, lcd

    • apres_impotobjet ou null

      Meilleur TRI après impôt et revente sur l'horizon, régime le plus favorable de chaque stratégie.

      Afficher les 4 champs
      • cletexte

        lld_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, lcd

      • horizon_ansentier
      • tri_pctnombre ou null
      • regimetexte
  • syntheseobjet
    Afficher les 5 champs
    • strategietexte

      lld_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, lcd

    • rendement_brut_pctnombre
    • rendement_net_pctnombre
    • mensualitenombre
    • cashflow_mensuelobjet
      Afficher les 2 champs
      • avant_impotnombre
      • apres_impotnombre
  • hcsfobjet ou null

    Taux d'effort au sens du Haut Conseil de stabilité financière ; null sans revenus.

    Afficher les 6 champs
    • revenus_mensuelsnombre
    • mensualitesnombre

      Mensualité de la stratégie de la synthèse, plus les crédits en cours.

    • taux_effort_pctnombre
    • seuil_pctnombre
    • conformebooléen
    • mensualite_maxnombre
  • avertissementsliste de textes
  • qualiteobjet

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

    Afficher les 7 champs
    • nentier ou null

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

      0 au moins

    • provenancetexte ou null

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

      Valeurs : mesure, estime

    • incertitudeobjet ou null

      Incertitude de la valeur : fourchette et demi-largeur.

      Afficher les 3 champs
      • demi_largeur_pctnombre ou null

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

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

      Ce qui doit faire lire la valeur avec prudence ; vide si rien.

      Valeurs : prix_atypique, surface_atypique, vente_en_bloc, doublon_probable, date_estimee, peu_d_observations, valeur_imputee, rattachement_incertain, donnee_ancienne

    • methodetexte ou null

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

    • donnees_dutexte ou null

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

    • sourcetexte

      Source publique ou moteur Pillr, en clair.

  • creditsobjet

    Crédits débités par cet appel (réservés, pour une tâche en cours), et crédits encore utilisables ce mois avant la coupure : crédits offerts, crédits inclus du mois et crédits facturables sous le plafond de dépense (null si inconnus ou en bac à sable).

    Afficher les 2 champs
    • debitesentier

      0 au moins

    • restantsentier ou null

Erreurs possibles

Afficher les 11 erreurs communes à toute l'API

Une ressource absente répond par un code de la famille des ressources absentes, propre à l'opération, sans débit. Guide des erreurs

Taux de crédit du moment

Essayer en direct
GET/api/v1/taux-credit

Taux 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'objets

    Taux nominaux par durée, hors assurance, tels que le baromètre les publie.

    Afficher les 4 champs
    • duree_ansentier
    • bon_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 null

    Date de la simulation publiée par le baromètre (AAAA-MM-JJ).

  • lu_letexte

    Horodatage de la lecture de la page.

  • sourcetexte
  • urltexte
  • qualiteobjet

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

    Afficher les 7 champs
    • nentier ou null

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

      0 au moins

    • provenancetexte ou null

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

      Valeurs : mesure, estime

    • incertitudeobjet ou null

      Incertitude de la valeur : fourchette et demi-largeur.

      Afficher les 3 champs
      • demi_largeur_pctnombre ou null

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

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

      Ce qui doit faire lire la valeur avec prudence ; vide si rien.

      Valeurs : prix_atypique, surface_atypique, vente_en_bloc, doublon_probable, date_estimee, peu_d_observations, valeur_imputee, rattachement_incertain, donnee_ancienne

    • methodetexte ou null

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

    • donnees_dutexte ou null

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

    • sourcetexte

      Source publique ou moteur Pillr, en clair.

  • creditsobjet

    Crédits débités par cet appel (réservés, pour une tâche en cours), et crédits encore utilisables ce mois avant la coupure : crédits offerts, crédits inclus du mois et crédits facturables sous le plafond de dépense (null si inconnus ou en bac à sable).

    Afficher les 2 champs
    • debitesentier

      0 au moins

    • restantsentier ou null

Erreurs possibles

  • 400parametres_invalidesUn paramètre manque ou ne passe pas son contrôle ; le détail est donné champ par champ
  • 403hors_bac_a_sableUne clé pk_test_ demande une entrée hors du jeu figé de l'opération
Afficher les 11 erreurs communes à toute l'API

Une ressource absente répond par un code de la famille des ressources absentes, propre à l'opération, sans débit. Guide des erreurs