Aller au contenu

Documentation

Marché des communes

35 opérations servies.

Volumes et prix des ventes d'une commune

GET/api/v1/communes/{insee}/ventes
GET/api/v1/codes-postaux/{code_postal}/ventes

Les volumes et les prix des ventes DVF d'une commune, par son code INSEE ou par un code postal (la commune la plus peuplée du code postal) : ventes par trimestre (total, appartements, maisons) et médiane au m² ; série annuelle du prix au m² (appartement, maison, ensemble) avec transactions, minimum, maximum et drapeaux de basse confiance ; vélocité au code postal, année par année, évolution du volume et sa lecture, comme l'outil de vélocité du Hub. La vélocité compte des lignes DVF d'appartements et de maisons (une par lot), pas des mutations. Chaque valeur porte son nombre d'observations.

Coût
2 crédits par appel réussi
Accès
À l'usage ou avec l'abonnement Data
Portée
territoire
Outil MCP
ventes_commune
Bac à sable
Non
Mémoire
24 h
Délai
8 s

Essayer en direct

Paramètres de /api/v1/communes/{insee}/ventes

  • inseetexteobligatoire

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

  • typetexte

    Ne servir que les chiffres d'un type de bien (les autres valent null).

    Valeurs : appartement, maison

Paramètres de /api/v1/codes-postaux/{code_postal}/ventes

  • code_postaltexteobligatoire

    Code postal.

Exemple d'appel

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

Réponse

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

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

  • par_trimestreliste d'objets

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

    Afficher les 7 champs
    • trimestretexte

      Trimestre, ex. 2025-T4.

    • debuttexte

      Premier jour du trimestre.

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

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

    • qualiteobjet

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

      Afficher les 7 champs
      • nentier ou null

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

        0 au moins

      • provenancetexte ou null

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

        Valeurs : mesure, estime

      • incertitudeobjet ou null

        Incertitude de la valeur : fourchette et demi-largeur.

        Afficher les 3 champs
        • demi_largeur_pctnombre ou null

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

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

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

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

      • methodetexte ou null

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

      • donnees_dutexte ou null

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

      • sourcetexte

        Source publique ou moteur Pillr, en clair.

  • par_anneeliste d'objets

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

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

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

      Afficher les 7 champs
      • nentier ou null

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

        0 au moins

      • provenancetexte ou null

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

        Valeurs : mesure, estime

      • incertitudeobjet ou null

        Incertitude de la valeur : fourchette et demi-largeur.

        Afficher les 3 champs
        • demi_largeur_pctnombre ou null

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

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

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

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

      • methodetexte ou null

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

      • donnees_dutexte ou null

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

      • sourcetexte

        Source publique ou moteur Pillr, en clair.

  • velociteobjet ou null

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

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

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

    • lecturetexte

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

    • qualiteobjet

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

      Afficher les 7 champs
      • nentier ou null

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

        0 au moins

      • provenancetexte ou null

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

        Valeurs : mesure, estime

      • incertitudeobjet ou null

        Incertitude de la valeur : fourchette et demi-largeur.

        Afficher les 3 champs
        • demi_largeur_pctnombre ou null

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

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

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

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

      • methodetexte ou null

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

      • donnees_dutexte ou null

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

      • sourcetexte

        Source publique ou moteur Pillr, en clair.

  • limitesliste de textes
  • creditsobjet

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

    Afficher les 2 champs
    • debitesentier

      0 au moins

    • restantsentier ou null

Erreurs possibles

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

Mon secteur en 30 secondes

GET/api/v1/codes-postaux/{cp}/secteur

Pour un code postal, les deux signaux de la page « Mon secteur » de pillr.fr : les adresses en pré-marché pur (DPE individuel de moins de 90 jours, ni en vente ni vendues depuis, dont les passoires F et G), et les particuliers qui vendent seuls depuis plus de 50 jours et sont encore en ligne, dont ceux qui ont baissé leur prix ; avec detail=true, la liste de leurs annonces, sans le nom ni les coordonnées du vendeur. Sans annonce de particulier dans le code postal, le compte passe au département et le dit.

Coût
2 crédits par appel réussi
Accès
À l'usage ou avec l'abonnement Data
Portée
territoire
Outil MCP
secteur
Bac à sable
Non
Mémoire
6 h
Délai
8 s

Essayer en direct

Paramètres

  • cptexteobligatoire

    Code postal.

  • detailtexte

    true : la liste des annonces de particuliers.

    Valeurs : true, false

Exemple d'appel

curl https://pillr.fr/api/v1/codes-postaux/{cp}/secteur \
  -H "Authorization: Bearer $PILLR_CLE"

Réponse

  • cptexte
  • communetexte ou null

    La commune la plus peuplée de ce code postal.

  • departementtexte
  • pre_marche_purobjet
    Afficher les 3 champs
    • nentier

      Adresses à DPE individuel de moins de 90 jours, ni en vente ni vendues depuis.

    • passoiresentier

      Dont étiquette F ou G.

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

  • particuliersobjet
    Afficher les 6 champs
    • echelletexte

      departement quand le code postal n'a aucune annonce de particulier ouverte depuis assez longtemps.

      Valeurs : secteur, departement

    • n_plus_50_joursentier
    • duree_moyenne_joursentier
    • n_avec_baisseentier
    • annoncesliste d'objets ou null

      Les annonces elles-mêmes, avec detail=true ; jamais le nom ni les coordonnées du vendeur.

      Afficher les 9 champs
      • idtexte ou null
      • lientexte ou null

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

      • titretexte ou null
      • prixnombre ou null
      • surfacenombre ou null
      • communetexte ou null
      • parue_depuis_joursentier
      • derniere_baisse_letexte ou null
      • type_vendeurtexte
    • qualiteobjet

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

      Afficher les 7 champs
      • nentier ou null

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

        0 au moins

      • provenancetexte ou null

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

        Valeurs : mesure, estime

      • incertitudeobjet ou null

        Incertitude de la valeur : fourchette et demi-largeur.

        Afficher les 3 champs
        • demi_largeur_pctnombre ou null

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

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

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

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

      • methodetexte ou null

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

      • donnees_dutexte ou null

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

      • sourcetexte

        Source publique ou moteur Pillr, en clair.

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

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

Marché d'une commune

GET/api/v1/communes/{insee}

Marché immobilier d'une commune ou d'un arrondissement, par code INSEE : prix de référence au m² des appartements et des maisons avec leur provenance (mesuré sur les ventes DVF ou estimé) et le nombre de ventes, loyer d'annonce au m² et loyers par type de logement (Carte des loyers), rendement brut théorique, évolution des prix sur 1 et 3 ans, zone ABC, et le marché en vente du dernier mois calculé (annonces en ligne, nouvelles annonces, prix affiché médian, part des baisses, délai médian en ligne). Mêmes chiffres que les pages communes de pillr.fr. Paris, Lyon et Marseille sont servies en agrégat de 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
marche_zone
Bac à sable
Oui, sans débit, sur un jeu figé
Mémoire
6 h
Délai
8 s

Essayer en direct

Paramètres

  • inseetexteobligatoire

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

Exemple d'appel

curl https://pillr.fr/api/v1/communes/76540 \
  -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",
  "code_postal": "76000",
  "departement": "76",
  "region": "Normandie",
  "population": 117662,
  "agrege": false,
  "prix_m2": {
    "appartement": 2677,
    "maison": 2809,
    "provenance_appartement": "mesure",
    "provenance_maison": "mesure",
    "ventes_appartement": 9560,
    "ventes_maison": 1878,
    "millesime": "2025",
    "arrondissements": null
  },
  "loyer_m2": {
    "mensuel": 13.28,
    "min_95": 10.583019422468,
    "max_95": 16.6537493626823,
    "source": "dhup",
    "millesime": 2025
  },
  "loyers_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
      }
    },
    {
      "typologie": "T2",
      "surface_m2": 45,
      "segment": "appartement_t1_t2",
      "repli": false,
      "loyer_m2": 15.38,
      "loyer_mensuel": 692,
      "fourchette_mensuelle": {
        "min": 557,
        "max": 861
      }
    },
    {
      "typologie": "T3",
      "surface_m2": 65,
      "segment": "appartement_t3plus",
      "repli": false,
      "loyer_m2": 11.68,
      "loyer_mensuel": 759,
      "fourchette_mensuelle": {
        "min": 596,
        "max": 967
      }
    },
    {
      "typologie": "T4",
      "surface_m2": 85,
      "segment": "appartement_t3plus",
      "repli": false,
      "loyer_m2": 11.68,
      "loyer_mensuel": 993,
      "fourchette_mensuelle": {
        "min": 780,
        "max": 1264
      }
    },
    {
      "typologie": "T5",
      "surface_m2": 105,
      "segment": "appartement_t3plus",
      "repli": false,
      "loyer_m2": 11.68,
      "loyer_mensuel": 1227,
      "fourchette_mensuelle": {
        "min": 963,
        "max": 1562
      }
    },
    {
      "typologie": "maison",
      "surface_m2": 100,
      "segment": "maison",
      "repli": false,
      "loyer_m2": 12.33,
      "loyer_mensuel": 1233,
      "fourchette_mensuelle": {
        "min": 945,
        "max": 1609
      }
    }
  ],
  "rendement_brut_pct": {
    "appartement": 5.95,
    "maison": 5.27
  },
  "evolution_prix_pct": {
    "un_an": 0.9,
    "trois_ans": -4.2,
    "confiance": "haute"
  },
  "zone_abc": "B1",
  "marche_en_vente": {
    "statut": "ok",
    "mois": "2026-09",
    "calcule_le": "2026-10-19T01:40:32.000Z",
    "annonces_en_ligne": null,
    "nouvelles_annonces": 997,
    "annonces_retirees": null,
    "delai_median_jours": null,
    "part_baissees_pct": null,
    "prix_affiche_m2_median": 2813,
    "variation_annonces_en_ligne_pct": null,
    "variation_nouvelles_annonces_pct": null,
    "variation_prix_affiche_m2_pct": null,
    "volumes_comparables": true,
    "mois_mise_a_jour_collecte": true
  },
  "donnees_du": "2026-09-20T09:16:03.406Z",
  "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 20/09/2026.

Réponse

  • inseetexte
  • communetexte
  • code_postaltexte ou null
  • departementtexte ou null
  • regiontexte ou null
  • populationnombre ou null
  • agregebooléen

    Vrai pour Paris, Lyon et Marseille : agrégat de leurs arrondissements, pondéré par les ventes.

  • prix_m2objet
    Afficher les 8 champs
    • appartementnombre ou null
    • maisonnombre ou null
    • provenance_appartementtexte ou null

      mesure : mesuré sur les ventes DVF de la commune ; estime : estimé par le barème sur trop peu de ventes pour une mesure, à lire avec le nombre de ventes ; null : non étiquetée.

      Valeurs : mesure, estime

    • provenance_maisontexte ou null

      mesure : mesuré sur les ventes DVF de la commune ; estime : estimé par le barème sur trop peu de ventes pour une mesure, à lire avec le nombre de ventes ; null : non étiquetée.

      Valeurs : mesure, estime

    • ventes_appartementnombre ou null
    • ventes_maisonnombre ou null
    • millesimetexte ou null
    • arrondissementsobjet ou null
      Afficher les 2 champs
      • appartementobjet
        Afficher les 5 champs
        • totalentier
        • avec_prixentier
        • mesuresentier
        • estimesentier
        • ventesentier ou null
      • maisonobjet
        Afficher les 5 champs
        • totalentier
        • avec_prixentier
        • mesuresentier
        • estimesentier
        • ventesentier ou null
  • loyer_m2objet
    Afficher les 5 champs
    • mensuelnombre ou null
    • min_95nombre ou null
    • max_95nombre ou null
    • sourcetexte ou null
    • millesimenombre ou null
  • loyers_par_typologieliste d'objets
    Afficher les 7 champs
    • typologietexte

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

    • surface_m2nombre
    • segmenttexte

      Valeurs : appartement, appartement_t1_t2, appartement_t3plus, maison

    • replibooléen
    • loyer_m2nombre
    • loyer_mensuelnombre
    • fourchette_mensuelleobjet ou null
      Afficher les 2 champs
      • minnombre
      • maxnombre
  • rendement_brut_pctobjet
    Afficher les 2 champs
    • appartementnombre ou null
    • maisonnombre ou null
  • evolution_prix_pctobjet
    Afficher les 3 champs
    • un_annombre ou null
    • trois_ansnombre ou null
    • confiancetexte ou null
  • zone_abctexte ou null
  • marche_en_venteobjet
    Afficher les 14 champs
    • statuttexte

      ok : chiffres servis ; perime : calcul trop ancien ; absent : aucune annonce de la commune le dernier mois ; indisponible : source momentanément injoignable.

      Valeurs : ok, perime, absent, indisponible

    • moistexte ou null

      Mois des chiffres, AAAA-MM.

    • calcule_letexte ou null
    • annonces_en_lignenombre ou null
    • nouvelles_annoncesnombre ou null
    • annonces_retireesnombre ou null
    • delai_median_joursnombre ou null
    • part_baissees_pctnombre ou null
    • prix_affiche_m2_mediannombre ou null
    • variation_annonces_en_ligne_pctnombre ou null
    • variation_nouvelles_annonces_pctnombre ou null
    • variation_prix_affiche_m2_pctnombre ou null
    • volumes_comparablesbooléen ou null

      Faux quand l'un des deux mois comparés précède la stabilisation de la collecte : aucune variation de volume n'est alors calculée.

    • mois_mise_a_jour_collectebooléen ou null

      Vrai quand le mois trahit un changement de la collecte plutôt que du marché : seuls les nouvelles annonces et le prix affiché sont servis.

  • donnees_dutexte ou null

    Date de reconstruction des données de la commune.

  • 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

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

Synthèse complète d'une commune

GET/api/v1/communes/{insee}/synthese

Une commune en un appel, avec les chiffres de l'outil de zone du Hub : marché (prix et provenance, rendements, demande, vacance, loyer, évolutions, passoires, transactions), démographie, moyennes des annonces analysées par Pillr dans la commune, score Pillr et ses huit sous-scores, marchabilité et équipements à 500 m, loyer prédit avec son intervalle à 95 %, loyers par typologie et loyer d'un logement donné (typologie, surface), mesures de zone (équipements, gare et aéroport, délinquance, risques), signal de prix, QPV et zone ABC, ratios d'accessibilité, courte durée, points forts et signaux d'alerte de l'analyse rédigée, marché en vente du dernier mois. Paris, Lyon et Marseille se lisent par arrondissement.

Coût
3 crédits par appel réussi
Accès
À l'usage ou avec l'abonnement Data
Portée
territoire
Outil MCP
synthese_zone
Bac à sable
Oui, sans débit, sur un jeu figé
Mémoire
6 h
Délai
8 s

Essayer en direct

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 dont estimer le loyer (T1 à T5 ou maison).

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

  • surface_m2nombre

    Surface du logement dont estimer le loyer, en m².

    1 000 au plus ; plus de 0

Exemple d'appel

curl https://pillr.fr/api/v1/communes/{insee}/synthese \
  -H "Authorization: Bearer $PILLR_CLE"

Réponse

  • inseetexte

    Code INSEE demandé.

  • communetexte ou null

    Nom de la commune ou de l'arrondissement.

  • code_postaltexte ou null
  • departementtexte ou null
  • regiontexte ou null
  • marcheobjet
    Afficher les 18 champs
    • prix_m2_appartementnombre ou null
    • prix_m2_maisonnombre ou null
    • provenance_appartementtexte ou null

      mesure : mesuré sur les ventes DVF de la commune ; estime : estimé par le barème sur trop peu de ventes pour une mesure, à lire avec le nombre de ventes ; null : non étiquetée.

      Valeurs : mesure, estime

    • provenance_maisontexte ou null

      mesure : mesuré sur les ventes DVF de la commune ; estime : estimé par le barème sur trop peu de ventes pour une mesure, à lire avec le nombre de ventes ; null : non étiquetée.

      Valeurs : mesure, estime

    • ventes_appartemententier ou null
    • ventes_maisonentier ou null
    • rendement_brut_appartement_pctnombre ou null
    • rendement_brut_maison_pctnombre ou null
    • score_demandenombre ou null
    • vacance_locative_pctnombre ou null
    • loyer_m2nombre ou null
    • evolution_prix_1_an_pctnombre ou null
    • evolution_prix_3_ans_pctnombre ou null
    • evolution_prix_5_ans_pctnombre ou null
    • confiance_evolutiontexte ou null
    • passoires_dpe_fg_pctnombre ou null
    • transactions_recentesentier 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.

  • demographieobjet
    Afficher les 5 champs
    • populationentier ou null
    • salaire_mediannombre ou null
    • taux_chomage_pctnombre ou null
    • part_hlm_pctnombre ou null
    • profil_sociotexte ou null
  • catalogue_pillrobjet
    Afficher les 4 champs
    • annonces_analyseesentier
    • score_moyennombre ou null
    • rendement_brut_moyen_pctnombre 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.

  • score_pillrnombre ou null
  • scores_detailobjet
    Afficher les 8 champs
    • rentabilitenombre ou null
    • demandenombre ou null
    • liquiditenombre ou null
    • croissancenombre ou null
    • stabilitenombre ou null
    • qualitenombre ou null
    • servicesnombre ou null
    • securitenombre ou null
  • qualite_lieuobjet
    Afficher les 2 champs
    • walkabilitynombre ou null
    • qualite_vienombre ou null
  • poi_500mobjet
    Afficher les 7 champs
    • totalnombre ou null
    • transportsnombre ou null
    • ecolesnombre ou null
    • commercesnombre ou null
    • santenombre ou null
    • loisirsnombre ou null
    • restaurationnombre ou null
  • loyer_preditobjet
    Afficher les 5 champs
    • loyer_m2_mensuelnombre ou null
    • ic95_minnombre ou null
    • ic95_maxnombre ou null
    • sourcetexte 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.

  • loyers_par_typologieliste d'objets
    Afficher les 7 champs
    • typologietexte

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

    • surface_m2nombre
    • segmenttexte

      Valeurs : appartement, appartement_t1_t2, appartement_t3plus, maison

    • replibooléen
    • loyer_m2nombre
    • loyer_mensuelnombre
    • fourchette_mensuelleobjet ou null
      Afficher les 2 champs
      • minnombre
      • maxnombre
  • loyers_millesimetexte ou null
  • loyer_estimeobjet ou null

    Loyer d'un logement donné (typologie, surface) ; null sans l'une ni l'autre.

    Afficher les 4 champs
    • typologietexte

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

    • surface_m2nombre ou null
    • estimationobjet ou null
      Afficher les 7 champs
      • typologietexte

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

      • surface_m2nombre
      • segmenttexte

        Valeurs : appartement, appartement_t1_t2, appartement_t3plus, maison

      • replibooléen
      • loyer_m2nombre
      • loyer_mensuelnombre
      • fourchette_mensuelleobjet ou null
        Afficher les 2 champs
        • minnombre
        • maxnombre
    • indisponibletexte ou null

      Pourquoi aucun loyer n'est estimé (maison sans loyer publié, surface invalide).

  • mesures_zoneobjet
    Afficher les 4 champs
    • equipementsobjet ou null
      Afficher les 3 champs
      • comptesobjet
      • essentiels_absentsliste de textes
      • resumetexte
    • accestexte ou null
    • securitetexte ou null
    • risquestexte
  • signal_prixobjet
    Afficher les 4 champs
    • signal_dealtexte ou null
    • prix_residuel_pctnombre ou null
    • prix_attendu_m2nombre ou null
    • volatilite_prixnombre ou null
  • contraintesobjet
    Afficher les 3 champs
    • est_en_qpvbooléen ou null
    • nb_qpventier ou null
    • zone_abctexte ou null
  • accessibilite_prixobjet
    Afficher les 2 champs
    • ratio_loyer_revenunombre ou null
    • prix_revenu_anneesnombre ou null
  • courte_dureeobjet
    Afficher les 6 champs
    • revenu_lcd_annuel_eurnombre ou null
    • taux_occupation_pctnombre ou null
    • revpar_eurnombre ou null
    • score_lcdnombre ou null
    • score_lldnombre ou null
    • part_residences_secondaires_pctnombre ou null
  • avis_pillrobjet
    Afficher les 2 champs
    • points_fortsliste d'objets
      Afficher les 2 champs
      • titretexte
      • raisontexte ou null
    • signaux_alerteliste d'objets
      Afficher les 3 champs
      • titretexte
      • raisontexte ou null
      • attenuationtexte ou null
  • marche_en_venteobjet
    Afficher les 14 champs
    • statuttexte

      ok : chiffres servis ; perime : calcul trop ancien ; absent : aucune annonce de la commune le dernier mois ; indisponible : source momentanément injoignable.

      Valeurs : ok, perime, absent, indisponible

    • moistexte ou null

      Mois des chiffres, AAAA-MM.

    • calcule_letexte ou null
    • annonces_en_lignenombre ou null
    • nouvelles_annoncesnombre ou null
    • annonces_retireesnombre ou null
    • delai_median_joursnombre ou null
    • part_baissees_pctnombre ou null
    • prix_affiche_m2_mediannombre ou null
    • variation_annonces_en_ligne_pctnombre ou null
    • variation_nouvelles_annonces_pctnombre ou null
    • variation_prix_affiche_m2_pctnombre ou null
    • volumes_comparablesbooléen ou null

      Faux quand l'un des deux mois comparés précède la stabilisation de la collecte : aucune variation de volume n'est alors calculée.

    • mois_mise_a_jour_collectebooléen ou null

      Vrai quand le mois trahit un changement de la collecte plutôt que du marché : seuls les nouvelles annonces et le prix affiché sont servis.

  • donnees_dutexte ou null
  • 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

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

Score Pillr et scores d'une commune

GET/api/v1/communes/{insee}/scores

Scores d'une commune tels que le pipeline de Pillr les publie : score Pillr sur 100 et ses huit sous-scores (rentabilité, demande, liquidité, croissance, stabilité, qualité, services, sécurité), scores d'attractivité, de location longue et courte durée, de tourisme et de démographie, z-scores et percentiles des prix, du rendement et des loyers, volatilité, prix attendu par le modèle départemental et écart au prix observé, ratios d'accessibilité. Un sous-score de rentabilité posé par défaut faute de rendement mesuré est signalé. Paris, Lyon et Marseille se lisent par arrondissement.

Coût
2 crédits par appel réussi
Accès
À l'usage ou avec l'abonnement Data
Portée
territoire
Outil MCP
scores_commune
Bac à sable
Oui, sans débit, sur un jeu figé
Mémoire
6 h
Délai
4 s

Essayer en direct

Paramètres

  • inseetexteobligatoire

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

Exemple d'appel

curl https://pillr.fr/api/v1/communes/{insee}/scores \
  -H "Authorization: Bearer $PILLR_CLE"

Réponse

  • inseetexte

    Code INSEE demandé.

  • communetexte ou null

    Nom de la commune ou de l'arrondissement.

  • score_pillrnombre ou null

    Score Pillr sur 100 : moyenne pondérée des huit sous-scores.

  • sous_scoresobjet
    Afficher les 8 champs
    • rentabilitenombre ou null

      Note sur 100 ; null si non calculée.

    • demandenombre ou null

      Note sur 100 ; null si non calculée.

    • liquiditenombre ou null

      Note sur 100 ; null si non calculée.

    • croissancenombre ou null

      Note sur 100 ; null si non calculée.

    • stabilitenombre ou null

      Note sur 100 ; null si non calculée.

    • qualitenombre ou null

      Note sur 100 ; null si non calculée.

    • servicesnombre ou null

      Note sur 100 ; null si non calculée.

    • securitenombre ou null

      Note sur 100 ; null si non calculée.

  • sous_scores_imputesliste de textes

    Sous-scores posés à leur valeur par défaut faute de donnée (rentabilité sans aucun rendement mesuré).

    Valeurs : rentabilite

  • scoresobjet
    Afficher les 5 champs
    • attractivitenombre ou null

      Note sur 100 ; null si non calculée.

    • location_longue_dureenombre ou null

      Note sur 100 ; null si non calculée.

    • location_courte_dureenombre ou null

      Note sur 100 ; null si non calculée.

    • tourismenombre ou null

      Note sur 100 ; null si non calculée.

    • demographienombre ou null

      Note sur 100 ; null si non calculée.

  • zscoresobjet
    Afficher les 5 champs
    • prix_appartement_nationalnombre ou null
    • prix_appartement_regionalnombre ou null
    • prix_appartement_departementalnombre ou null
    • rendement_nationalnombre ou null
    • loyer_nationalnombre ou null
  • percentilesobjet
    Afficher les 4 champs
    • prix_appartement_nationalnombre ou null
    • prix_appartement_regionalnombre ou null
    • rendement_nationalnombre ou null
    • loyer_nationalnombre ou null
  • volatilite_prixnombre ou null
  • prix_attendu_m2nombre ou null

    Prix au m² attendu par le modèle départemental (revenu, services).

  • prix_residuel_pctnombre ou null

    Écart du prix observé au prix attendu, en % ; négatif : sous le prix attendu.

  • residuel_saturebooléen ou null

    Vrai quand le modèle est hors de son domaine de validité (écart plafonné).

  • signal_dealtexte ou null

    Position face au prix attendu du département (bien_en_dessous_dept à bien_au_dessus_dept).

  • ratio_loyer_revenunombre ou null

    Loyer mensuel de 30 m² rapporté au revenu médian mensuel.

  • prix_revenu_anneesnombre ou null

    Années de revenu médian pour acheter 50 m² d'appartement au prix de la commune.

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

  • donnees_dutexte ou null
  • 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

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

Profil socio-démographique et politique

GET/api/v1/communes/{insee}/profil

Profil d'une commune, chaque bloc lu dans sa source publique et servi avec sa qualité : population et codes postaux (recensement), âge moyen, chômage et part de HLM, revenus par unité de consommation, déciles 1 et 9, pauvreté et indice de Gini (Filosofi), quartiers prioritaires (nombre et codes), indice de position sociale des lycées, premier tour de la présidentielle 2022 (orientation, candidat en tête, parts par bloc, abstention). Un bloc absent de sa source est servi vide, avec n = 0.

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

Essayer en direct

Paramètres

  • inseetexteobligatoire

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

Exemple d'appel

curl https://pillr.fr/api/v1/communes/{insee}/profil \
  -H "Authorization: Bearer $PILLR_CLE"

Réponse

  • inseetexte

    Code INSEE demandé.

  • communetexte ou null

    Nom de la commune ou de l'arrondissement.

  • populationobjet
    Afficher les 4 champs
    • valeurentier ou null
    • millesimetexte ou null
    • codes_postauxliste 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.

  • age_moyennombre ou null
  • taux_chomage_pctnombre ou null
  • part_hlm_pctnombre ou null
  • marche_qualiteobjet

    Qualité des champs âge, chômage et HLM, lus dans la table communale de Pillr.

    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.

  • revenusobjet
    Afficher les 7 champs
    • median_ucnombre ou null

      Revenu disponible médian par unité de consommation, en euros par an.

    • decile_1nombre ou null
    • decile_9nombre ou null
    • taux_pauvrete_pctnombre ou null
    • gininombre ou null
    • millesimetexte 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.

  • qpvobjet
    Afficher les 4 champs
    • en_qpvbooléen ou null
    • nentier ou null
    • codesliste 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.

  • ips_lyceesobjet
    Afficher les 7 champs
    • lyceesentier ou null
    • moyennombre ou null
    • maximumnombre ou null
    • minimumnombre ou null
    • moyenne_departementnombre ou null
    • premiumbooléen ou null
    • qualiteobjet

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

      Afficher les 7 champs
      • nentier ou null

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

        0 au moins

      • provenancetexte ou null

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

        Valeurs : mesure, estime

      • incertitudeobjet ou null

        Incertitude de la valeur : fourchette et demi-largeur.

        Afficher les 3 champs
        • demi_largeur_pctnombre ou null

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

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

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

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

      • methodetexte ou null

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

      • donnees_dutexte ou null

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

      • sourcetexte

        Source publique ou moteur Pillr, en clair.

  • presidentielle_2022objet
    Afficher les 8 champs
    • orientationtexte ou null
    • premiertexte ou null

      Candidat arrivé en tête au premier tour.

    • part_premier_pctnombre ou null
    • blocs_pctobjet
      Afficher les 5 champs
      • gauche_radicalenombre ou null
      • gauchenombre ou null
      • centrenombre ou null
      • droitenombre ou null
      • extreme_droitenombre ou null
    • abstention_pctnombre ou null
    • blancs_nuls_pctnombre ou null
    • inscritsentier 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.

  • donnees_dutexte ou null
  • 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

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

Parc de logements d'une commune

GET/api/v1/communes/{insee}/parc

Parc de logements d'une commune, chaque bloc depuis sa source : résidences principales, secondaires et vacantes, propriétaires et locataires (recensement) ; vacance du parc privé par année, dont plus de deux ans (LOVAC) ; diagnostics de performance énergétique par étiquette, part de passoires et série mensuelle des DPE et des audits (ADEME) ; copropriétés, lots, sans mandat, aidées, en plan de sauvegarde, gérées par un syndic bénévole, en nombre (RNC) ; autorisations et logements créés par mois, permis sur 12 et 24 mois (Sitadel). Les séries partent du mois demandé.

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

Essayer en direct

Paramètres

  • inseetexteobligatoire

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

  • depuistexte

    Premier mois des séries mensuelles, AAAA-MM.

Exemple d'appel

curl https://pillr.fr/api/v1/communes/{insee}/parc \
  -H "Authorization: Bearer $PILLR_CLE"

Réponse

  • inseetexte

    Code INSEE demandé.

  • communetexte ou null

    Nom de la commune ou de l'arrondissement.

  • logementsobjet
    Afficher les 10 champs
    • totalentier ou null
    • residences_principalesentier ou null
    • residences_secondairesentier ou null
    • vacantsentier ou null
    • occupants_proprietairesentier ou null
    • locataires_priveentier ou null
    • locataires_hlmentier ou null
    • parts_pctobjet
      Afficher les 6 champs
      • residences_principalesnombre ou null
      • residences_secondairesnombre ou null
      • vacantsnombre ou null
      • occupants_proprietairesnombre ou null
      • locataires_privenombre ou null
      • locataires_hlmnombre ou null
    • millesimetexte 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.

  • vacanceobjet
    Afficher les 2 champs
    • anneesliste d'objets
      Afficher les 5 champs
      • anneeentier
      • logements_privesentier ou null
      • vacantsentier ou null
      • vacants_plus_2_ansentier ou null
      • taux_pctnombre 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.

  • dpeobjet
    Afficher les 6 champs
    • totalentier ou null
    • repartitionobjet
      Afficher les 8 champs
      • Aentier ou null
      • Bentier ou null
      • Centier ou null
      • Dentier ou null
      • Eentier ou null
      • Fentier ou null
      • Gentier ou null
      • non_renseigneentier ou null
    • part_fg_pctnombre ou null
    • part_passoires_pctnombre ou null
    • serieliste d'objets
      Afficher les 5 champs
      • moistexte
      • dimensiontexte ou null
      • modalitetexte ou null
      • nentier ou null
      • sourcetexte 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.

  • coproprietesobjet ou null
    Afficher les 8 champs
    • coprosentier ou null
    • lots_totalentier ou null
    • lots_habitationentier ou null
    • sans_mandatentier ou null
    • aideesentier ou null
    • plan_sauvegardeentier ou null
    • syndic_benevoleentier ou null

      Nombre de copropriétés gérées par un syndic bénévole : un compte, jamais une identité.

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

  • constructionobjet
    Afficher les 7 champs
    • serieliste d'objets
      Afficher les 6 champs
      • moistexte
      • autorisationsentier ou null
      • logements_creesentier ou null
      • individuelsentier ou null
      • collectifsentier ou null
      • demolisentier ou null
    • permis_12_moisentier ou null
    • permis_24_moisentier ou null
    • permis_commences_12_moisentier ou null
    • surface_autorisee_12_mois_m2nombre ou null
    • intensite_12_moisnombre ou null

      Logements autorisés sur 12 mois pour 1 000 habitants.

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

  • donnees_dutexte ou null
  • 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

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

Prix au m² d'une commune : barème, série, évolutions

GET/api/v1/communes/{insee}/prix

Prix de référence au m² d'une commune par type de bien, avec toute sa qualité : provenance (mesuré ou estimé), ventes et ventes récentes, communes voisines et ventes du bassin, poids local, dominance, demi-bande d'incertitude, prix local brut. Rien n'est masqué : un prix sur peu de ventes est servi avec son nombre et son drapeau. S'y ajoutent la série annuelle (prix, transactions, minimum, maximum, basse confiance), les évolutions sur 1, 3 et 5 ans avec leur confiance et celle du département, l'indice annuel du département et la ligne indexée (barème multiplié par l'indice). Paris, Lyon et Marseille se lisent par arrondissement.

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

Essayer en direct

Paramètres

  • inseetexteobligatoire

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

  • typetexte

    Ne garder qu'un type de bien (appartement ou maison) ; les deux par défaut.

    Valeurs : appartement, maison

Exemple d'appel

curl https://pillr.fr/api/v1/communes/{insee}/prix \
  -H "Authorization: Bearer $PILLR_CLE"

Réponse

  • inseetexte

    Code INSEE demandé.

  • communetexte ou null

    Nom de la commune ou de l'arrondissement.

  • baremeliste d'objets
    Afficher les 13 champs
    • typetexte

      Valeurs : appartement, maison

    • millesimetexte ou null
    • prix_m2nombre ou null
    • labeltexte ou null

      mesure : mesuré sur les ventes DVF de la commune ; estime : estimé par le barème sur trop peu de ventes pour une mesure, à lire avec le nombre de ventes ; null : non étiquetée.

      Valeurs : mesure, estime

    • n_ventesentier ou null
    • n_ventes_recentesentier ou null
    • nb_voisinsentier ou null
    • n_ventes_bassinentier ou null
    • poids_localnombre ou null
    • dominancenombre ou null
    • demi_bande_pctnombre ou null
    • prix_m2_localnombre 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.

  • serieliste d'objets
    Afficher les 13 champs
    • anneeentier
    • prix_m2_appartementnombre ou null
    • prix_m2_maisonnombre ou null
    • prix_m2_globalnombre ou null
    • transactionsentier ou null
    • transactions_appartemententier ou null
    • transactions_maisonentier ou null
    • min_appartementnombre ou null
    • max_appartementnombre ou null
    • min_maisonnombre ou null
    • max_maisonnombre ou null
    • basse_confiance_appartementbooléen ou null
    • basse_confiance_maisonbooléen ou null
  • evolutionobjet ou null
    Afficher les 10 champs
    • appartementobjet
      Afficher les 3 champs
      • un_annombre ou null
      • trois_ansnombre ou null
      • cinq_ansnombre ou null
    • maisonobjet
      Afficher les 3 champs
      • un_annombre ou null
      • trois_ansnombre ou null
      • cinq_ansnombre ou null
    • globalobjet
      Afficher les 3 champs
      • un_annombre ou null
      • trois_ansnombre ou null
      • cinq_ansnombre ou null
    • tendance_5_anstexte ou null
    • confiancetexte ou null
    • derniere_anneeentier ou null
    • transactions_annee_recenteentier ou null
    • transactions_3_ansentier ou null
    • departementobjet
      Afficher les 2 champs
      • un_annombre ou null
      • trois_ansnombre 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.

  • ligne_indexeeliste d'objets

    Trajectoire du prix de référence : barème multiplié par l'indice annuel du département, millésime par millésime.

    Afficher les 3 champs
    • anneeentier
    • prix_m2_appartementnombre ou null
    • prix_m2_maisonnombre ou null
  • indice_departementliste d'objets
    Afficher les 5 champs
    • departementtexte
    • typetexte

      Valeurs : appartement, maison

    • anneeentier
    • coefnombre ou null
    • n_ventesentier ou null
  • donnees_dutexte ou null
  • 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

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

Prix au m² par quartier IRIS

GET/api/v1/iris/{code_iris}
GET/api/v1/communes/{insee}/iris

Prix au m² des appartements et des maisons par quartier IRIS, avec le nombre de ventes, la provenance (mesuré au quartier ou estimé depuis le prix de la commune), le poids local, la demi-bande d'incertitude, le nom du quartier et, sur demande, son contour GeoJSON. Un quartier par son code IRIS, ou tous les quartiers d'une commune. Tous les quartiers sont servis, ceux à peu de ventes avec leur drapeau.

Coût
1 crédit par élément rendu
Accès
À l'usage ou avec l'abonnement Data
Portée
territoire
Outil MCP
prix_iris
Bac à sable
Oui, sans débit, sur un jeu figé
Mémoire
24 h
Délai
5 s

Essayer en direct

Paramètres de /api/v1/iris/{code_iris}

  • code_iristexteobligatoire

    Code IRIS du quartier (9 caractères : code INSEE de la commune puis quatre chiffres).

  • geometrievaleur

    true : ajoute le contour GeoJSON de chaque quartier.

Paramètres de /api/v1/communes/{insee}/iris

  • inseetexteobligatoire

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

Exemple d'appel

curl https://pillr.fr/api/v1/iris/{code_iris} \
  -H "Authorization: Bearer $PILLR_CLE"

Réponse

  • donneesliste d'objets
    Afficher les 6 champs
    • code_iristexte
    • nomtexte ou null
    • inseetexte ou null
    • appartementobjet ou null
      Afficher les 9 champs
      • prix_m2nombre ou null
      • labeltexte ou null

        mesure : mesuré sur les ventes DVF de la commune ; estime : estimé par le barème sur trop peu de ventes pour une mesure, à lire avec le nombre de ventes ; null : non étiquetée.

        Valeurs : mesure, estime

      • n_ventesentier ou null
      • n_ventes_recentesentier ou null
      • poids_localnombre ou null

        Part du prix portée par les ventes du quartier ; le reste vient du prix de la commune.

      • prix_m2_communenombre ou null
      • demi_bande_pctnombre ou null
      • millesimetexte 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.

    • maisonobjet ou null
      Afficher les 9 champs
      • prix_m2nombre ou null
      • labeltexte ou null

        mesure : mesuré sur les ventes DVF de la commune ; estime : estimé par le barème sur trop peu de ventes pour une mesure, à lire avec le nombre de ventes ; null : non étiquetée.

        Valeurs : mesure, estime

      • n_ventesentier ou null
      • n_ventes_recentesentier ou null
      • poids_localnombre ou null

        Part du prix portée par les ventes du quartier ; le reste vient du prix de la commune.

      • prix_m2_communenombre ou null
      • demi_bande_pctnombre ou null
      • millesimetexte 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.

    • geometrieobjet ou null

      Contour GeoJSON du quartier, servi avec geometrie=true.

  • 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

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

Prix d'un département ou d'une région

GET/api/v1/departements/{departement}/prix
GET/api/v1/regions/{region}/prix

Prix médians au m² des appartements et des maisons d'un département ou d'une région, ceux de la carte des prix de Pillr, avec la surface médiane, la population et le nombre de communes, l'emprise, l'indice annuel par type et les coefficients semestriels du barème. Une région se donne par son code INSEE ou son nom court.

Coût
1 crédit par appel réussi
Accès
À l'usage ou avec l'abonnement Data
Portée
territoire
Outil MCP
prix_territoire
Bac à sable
Oui, sans débit, sur un jeu figé
Mémoire
24 h
Délai
5 s

Essayer en direct

Paramètres de /api/v1/departements/{departement}/prix

  • departementtexteobligatoire

    Code du département (01 à 95, 2A, 2B, 971 à 976).

Paramètres de /api/v1/regions/{region}/prix

  • regiontexteobligatoire

    Code INSEE de la région (53) ou son nom court (bretagne).

Exemple d'appel

curl https://pillr.fr/api/v1/departements/{departement}/prix \
  -H "Authorization: Bearer $PILLR_CLE"

Réponse

  • niveautexte

    Valeurs : departement, region

  • codetexte
  • nomtexte ou null
  • regionobjet ou null
    Afficher les 2 champs
    • codetexte ou null
    • nomtexte ou null
  • prix_m2_appartementnombre ou null
  • prix_m2_maisonnombre ou null
  • surface_mediane_m2nombre ou null
  • populationentier ou null

    Population municipale cumulée des communes du territoire (table communale de Pillr).

  • communesentier ou null

    Communes du territoire dans la table communale de Pillr.

  • empriseliste de nombres ou null

    Emprise du territoire : ouest, sud, est, nord, en degrés.

  • indiceliste d'objets
    Afficher les 5 champs
    • departementtexte
    • typetexte

      Valeurs : appartement, maison

    • anneeentier
    • coefnombre ou null
    • n_ventesentier ou null
  • indice_semestrielliste d'objets
    Afficher les 4 champs
    • departementtexte
    • typetexte

      Valeurs : appartement, maison

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

  • 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

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

Vie des annonces d'une zone

GET/api/v1/communes/{insee}/vie-annonces
GET/api/v1/codes-postaux/{cp}/vie-annonces

Vie des annonces d'une commune ou d'un code postal, mois par mois : entrées (particuliers, professionnels, exclusifs, maisons, appartements), part nationale, sorties rapides et longues, stock, durée médiane en ligne, prix affiché médian au m², baisses et baisse moyenne, chaque mois marqué comparable ou non selon la stabilisation de la collecte. Pour une zone de plusieurs communes, les comptes s'additionnent et les médianes restent vides. S'y ajoutent la durée en ligne par code postal et type de bien (médiane et quartiles, avec l'effectif) et, sur demande, les évènements des derniers jours : baisses de prix et annonces diffusées par plusieurs agences, par identifiant d'annonce.

Coût
5 crédits par appel réussi
Accès
À l'usage ou avec l'abonnement Data
Portée
territoire
Outil MCP
vie_annonces_zone
Bac à sable
Oui, sans débit, sur un jeu figé
Mémoire
6 h
Délai
6 s

Essayer en direct

Paramètres de /api/v1/communes/{insee}/vie-annonces

  • inseetexteobligatoire

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

  • depuistexte

    Premier mois, AAAA-MM.

  • jusqu_atexte

    Dernier mois, AAAA-MM.

  • evenementsvaleur

    true : ajoute les évènements des derniers jours.

  • joursnombre

    Fenêtre des évènements, en jours (7 par défaut, 30 au plus).

Paramètres de /api/v1/codes-postaux/{cp}/vie-annonces

  • cptexteobligatoire

Exemple d'appel

curl https://pillr.fr/api/v1/communes/{insee}/vie-annonces \
  -H "Authorization: Bearer $PILLR_CLE"

Réponse

  • zoneobjet
    Afficher les 3 champs
    • niveautexte

      Valeurs : commune, code_postal

    • codetexte
    • communesliste de textes
  • serieliste d'objets
    Afficher les 18 champs
    • moistexte
    • communesentier

      Communes de la zone qui portent ce mois.

    • entreesnombre ou null
    • entrees_particuliernombre ou null
    • entrees_pronombre ou null
    • entrees_exclusifnombre ou null
    • entrees_maisonnombre ou null
    • entrees_appartnombre ou null
    • part_nationalenombre ou null
    • sortiesnombre ou null
    • sorties_rapidesnombre ou null
    • sorties_longuesnombre ou null
    • duree_mediane_jnombre ou null

      Médiane : servie pour une seule commune, vide pour une zone de plusieurs communes (une médiane ne s'additionne pas).

    • prix_m2_mediannombre ou null
    • baissesnombre ou null
    • baisse_moy_pctnombre ou null
    • stock_finnombre ou null
    • volumes_comparablesbooléen
  • duree_en_ligneliste d'objets
    Afficher les 7 champs
    • code_postaltexte
    • typetexte
    • nentier ou null
    • mediane_jnombre ou null
    • p25_jnombre ou null
    • p75_jnombre ou null
    • fenetre_jentier ou null
  • evenementsliste d'objets
    Afficher les 8 champs
    • genretexte

      Valeurs : baisse_prix, multi_agences

    • annonce_idtexte
    • letexte
    • ancien_prixnombre ou null
    • nouveau_prixnombre ou null
    • ecart_pctnombre ou null
    • agencesentier ou null
    • portailsentier 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.

  • donnees_dutexte ou null
  • 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

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

Tableau mensuel des signaux d'une commune

GET/api/v1/communes/{insee}/signaux

Tableau mensuel consolidé d'une commune, tel que le lac de Pillr le calcule : DPE (existants, passoires, maisons, appartements, neufs, tertiaires) et audits, sociétés civiles (créations, modifications, radiations), permis et logements autorisés, flux d'annonces (entrées, sorties, stock, durée, prix affiché, baisses), agences actives, part du leader et concentration, vacance du parc privé, copropriétés, ventes DVF du trimestre. Les avis BODACC des codes postaux de la commune sont comptés par famille. La date de calcul est servie, et un tableau ancien le dit.

Coût
3 crédits par appel réussi
Accès
À l'usage ou avec l'abonnement Data
Portée
territoire
Outil MCP
signaux_commune
Bac à sable
Oui, sans débit, sur un jeu figé
Mémoire
24 h
Délai
5 s

Essayer en direct

Paramètres

  • inseetexteobligatoire

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

  • depuistexte

    Premier mois, AAAA-MM.

  • jusqu_atexte

    Dernier mois, AAAA-MM.

Exemple d'appel

curl https://pillr.fr/api/v1/communes/{insee}/signaux \
  -H "Authorization: Bearer $PILLR_CLE"

Réponse

  • inseetexte

    Code INSEE demandé.

  • communetexte ou null

    Nom de la commune ou de l'arrondissement.

  • moisliste d'objets
    Afficher les 44 champs
    • moistexte
    • dpe_existantnombre ou null
    • dpe_passoiresnombre ou null
    • dpe_maisonnombre ou null
    • dpe_appartnombre ou null
    • dpe_neufnombre ou null
    • dpe_tertiairenombre ou null
    • auditsnombre ou null
    • sci_creationsnombre ou null
    • sci_modificationsnombre ou null
    • sci_radiationsnombre ou null
    • permisnombre ou null
    • permis_logementsnombre ou null
    • entreesnombre ou null
    • entrees_particuliernombre ou null
    • entrees_pronombre ou null
    • entrees_exclusifnombre ou null
    • entrees_maisonnombre ou null
    • entrees_appartnombre ou null
    • sortiesnombre ou null
    • sorties_rapidesnombre ou null
    • sorties_longuesnombre ou null
    • duree_mediane_jnombre ou null
    • stock_finnombre ou null
    • prix_m2_mediannombre ou null
    • baissesnombre ou null
    • baisse_moy_pctnombre ou null
    • agencesnombre ou null
    • mandats_prisnombre ou null
    • part_leadernombre ou null
    • hhinombre ou null
    • logements_privesnombre ou null
    • vacantsnombre ou null
    • vacants_2ansnombre ou null
    • taux_vacancenombre ou null
    • coprosnombre ou null
    • lots_habitationnombre ou null
    • copros_sans_mandatnombre ou null
    • copros_aideesnombre ou null
    • copros_plan_sauvegardenombre ou null
    • ventes_trimestrenombre ou null
    • ventes_trimestre_refnombre ou null
    • dvf_prix_m2_mediannombre ou null
    • volumes_comparablesbooléen
  • bodacc_cpliste d'objets
    Afficher les 5 champs
    • code_postaltexte
    • moistexte
    • familletexte
    • nentier ou null
    • n_forme_scientier 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.

  • donnees_dutexte ou null
  • 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

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

Classement de communes (screener)

GET/api/v1/communes/classement

Communes classées par rendement brut théorique (loyer multiplié par douze, divisé par le prix au m², pour les appartements ou les maisons), par score Pillr ou par distance, avec la logique de l'outil de screening du Hub. Filtres : budget et surface type, prix au m² maximal, rendement minimal, population, sécurité, vacance, évolution à 3 ans, exclusion des QPV, type de bien, distance réelle autour d'une commune (entre centres habités), et les stratégies cashflow, patrimonial, pinel et deal de la page des opportunités. Chaque commune porte la provenance et le nombre de ventes de son prix. Liste paginée.

Coût
1 crédit par élément rendu
Accès
À l'usage ou avec l'abonnement Data
Portée
territoire
Outil MCP
classement_communes
Bac à sable
Oui, sans débit, sur un jeu figé
Mémoire
6 h
Délai
8 s

Essayer en direct

Paramètres

  • autour_detexte

    Code INSEE de la commune de départ du rayon.

  • rayon_kmnombre

    Rayon autour de la commune de départ, en km (50 par défaut, 150 au plus).

  • budget_eurnombre

    Budget d'achat, en euros : fixe le prix au m² maximal avec la surface type.

  • surface_type_m2nombre

    Surface type pour le budget, en m² (50 par défaut).

  • rendement_brut_min_pctnombre
  • prix_m2_maxnombre
  • population_minnombre

    Population minimale (2 000 par défaut).

  • securite_minnombre

    Sous-score de sécurité minimal, sur 100.

  • vacance_max_pctnombre
  • evol_3y_min_pctnombre
  • exclure_qpvvaleur

    true : écarte les communes qui comptent un quartier prioritaire.

  • typetexte

    Type de bien : appartement (par défaut) ou maison.

    Valeurs : appartement, maison

    par défaut "appartement"

  • strategietexte

    rendement (par défaut, aucun filtre de plus), cashflow, patrimonial, pinel ou deal : les seuils de la page des opportunités.

    Valeurs : rendement, cashflow, patrimonial, pinel, deal

    par défaut "rendement"

  • tritexte

    Tri : rendement (par défaut), score_pillr ou distance (avec autour_de).

    Valeurs : rendement, score_pillr, distance

  • limiteentier

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

    de 1 à 50 ; par défaut 20

  • curseurtexte

    Curseur opaque rendu par la page précédente (curseur_suivant), à repasser tel quel.

    de 1 à 1 024 caractères

Exemple d'appel

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

Réponse

  • criteresobjet
    Afficher les 13 champs
    • typetexte

      Valeurs : appartement, maison

    • strategietexte

      Valeurs : rendement, cashflow, patrimonial, pinel, deal

    • tritexte

      Valeurs : rendement, score_pillr, distance

    • population_minnombre
    • prix_m2_maxnombre ou null
    • rendement_brut_min_pctnombre ou null
    • securite_minnombre ou null
    • vacance_max_pctnombre ou null
    • evol_3y_min_pctnombre ou null
    • exclure_qpvbooléen
    • autour_detexte ou null
    • rayon_kmnombre ou null
    • perimetretexte ou null

      Le périmètre appliqué, en clair.

  • candidatesentier

    Communes qui passent les critères, toutes pages confondues.

  • donneesliste d'objets
    Afficher les 19 champs
    • inseetexte
    • communetexte ou null
    • code_postaltexte ou null
    • departementtexte ou null
    • prix_m2nombre
    • provenance_prixtexte ou null

      mesure : mesuré sur les ventes DVF de la commune ; estime : estimé par le barème sur trop peu de ventes pour une mesure, à lire avec le nombre de ventes ; null : non étiquetée.

      Valeurs : mesure, estime

    • ventesentier ou null
    • loyer_m2nombre
    • rendement_brut_pctnombre
    • evolution_3_ans_pctnombre ou null
    • score_securitenombre ou null
    • score_pillrnombre ou null
    • vacance_pctnombre ou null
    • populationentier ou null
    • signal_dealtexte ou null
    • est_en_qpvbooléen ou null
    • zone_abctexte ou null
    • distance_kmnombre ou null

      À vol d'oiseau entre centres habités ; null sans commune de départ.

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

  • donnees_dutexte ou null
  • curseur_suivanttexte ou null

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

  • creditsobjet

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

    Afficher les 2 champs
    • debitesentier

      0 au moins

    • restantsentier ou null

Erreurs possibles

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

Analyse rédigée d'une commune

GET/api/v1/communes/{insee}/analyse-ia

Analyse rédigée de la commune, déjà générée et stockée par Pillr : note de synthèse sur 100 et sous-notes, points forts, signaux d'alerte avec leur atténuation, recommandations. Servie comme sur les pages communes : les affirmations que le modèle ne pouvait pas sourcer (transport, délinquance, risques, équipements) sont remplacées par les mesures du jour, rendues à côté, et les textes sont réécrits pour la lecture. Aucun modèle n'est appelé. Paris, Lyon et Marseille se lisent par arrondissement.

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

Essayer en direct

Paramètres

  • inseetexteobligatoire

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

Exemple d'appel

curl https://pillr.fr/api/v1/communes/{insee}/analyse-ia \
  -H "Authorization: Bearer $PILLR_CLE"

Réponse

  • inseetexte

    Code INSEE demandé.

  • communetexte ou null

    Nom de la commune ou de l'arrondissement.

  • note_synthesenombre ou null

    Note de synthèse sur 100, rédigée par le modèle à partir des données mesurées.

  • lecture_notetexte ou null

    Comment lire la note.

  • sous_notesobjet
    Afficher les 5 champs
    • liquiditenombre ou null
    • demande_locativenombre ou null
    • croissancenombre ou null
    • tourismenombre ou null
    • risquenombre ou null
  • points_fortsliste d'objets
    Afficher les 2 champs
    • titretexte
    • raisontexte ou null
  • signaux_alerteliste d'objets
    Afficher les 3 champs
    • titretexte
    • raisontexte ou null
    • attenuationtexte ou null
  • recommandationsliste d'objets
    Afficher les 2 champs
    • titretexte
    • actiontexte ou null
  • mesuresobjet

    Ce que les données mesurées disent de la commune, substitué aux affirmations que le modèle ne pouvait pas sourcer.

    Afficher les 4 champs
    • equipementstexte ou null
    • accestexte ou null
    • securitetexte ou null
    • risquestexte
  • versiontexte ou null
  • modeletexte ou null
  • genere_letexte 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.

  • 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

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

Signaux de valorisation d'une commune

GET/api/v1/communes/{insee}/gentrification

Signaux de valorisation d'une commune, comme l'outil du Hub : évolutions des prix sur 1, 3 et 5 ans, salaire médian, demande, commerces signaux (coworking, bien-être, bio, créatif) comptés en direct dans la base Sirene et rapportés à 100 000 habitants, et un verdict par une règle dont les seuils sont rendus. Signal indicatif à la maille de la commune. Si l'API publique ne répond pas, rien n'est servi ni débité. Paris, Lyon et Marseille se lisent par arrondissement.

Coût
3 crédits par appel réussi
Accès
À l'usage ou avec l'abonnement Data
Portée
territoire
Outil MCP
gentrification
Bac à sable
Oui, sans débit, sur un jeu figé
Mémoire
24 h
Délai
12 s

Essayer en direct

Paramètres

  • inseetexteobligatoire

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

Exemple d'appel

curl https://pillr.fr/api/v1/communes/{insee}/gentrification \
  -H "Authorization: Bearer $PILLR_CLE"

Réponse

  • inseetexte

    Code INSEE demandé.

  • communetexte ou null

    Nom de la commune ou de l'arrondissement.

  • code_postaltexte ou null
  • populationentier ou null
  • evolution_prix_1_an_pctnombre ou null
  • evolution_prix_3_ans_pctnombre ou null
  • evolution_prix_5_ans_pctnombre ou null
  • salaire_mediannombre ou null
  • score_demandenombre ou null
  • commerces_signauxobjet
    Afficher les 5 champs
    • coworkingentier
    • bien_etreentier
    • bioentier
    • creatifentier
    • totalentier
  • signaux_pour_100k_habnombre ou null
  • verdictobjet
    Afficher les 2 champs
    • codetexte

      Valeurs : en_cours, emergente, hausse_sans_signaux, aucun_signal

    • libelletexte
  • seuilsobjet
    Afficher les 5 champs
    • evolution_3_ans_pctnombre
    • evolution_1_an_pctnombre
    • signaux_pour_100k_minnombre
    • signaux_min_avec_populationnombre
    • signaux_min_sans_populationnombre
  • granularitetexte
  • 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.

  • donnees_dutexte ou null
  • 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

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

Contours, centre et voisins d'un territoire

GET/api/v1/communes/{insee}/geographie
GET/api/v1/iris/{code_iris}/geographie
GET/api/v1/departements/{departement}/geographie
GET/api/v1/regions/{region}/geographie

Contour GeoJSON d'une commune, d'un arrondissement, d'un quartier IRIS, d'un département ou d'une région, simplifiable à une tolérance en mètres, avec son emprise. Pour une commune : son centre habité (celui des distances du Hub), ses communes voisines et son intercommunalité. Pour un quartier IRIS : sa commune et son intercommunalité.

Coût
1 crédit par appel réussi
Accès
À l'usage ou avec l'abonnement Data
Portée
territoire
Outil MCP
geographie
Bac à sable
Oui, sans débit, sur un jeu figé
Mémoire
168 h
Délai
5 s

Essayer en direct

Paramètres de /api/v1/communes/{insee}/geographie

  • inseetexteobligatoire

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

  • simplification_mnombre

    Tolérance de simplification du contour, en mètres (1 à 5 000) ; absent : contour complet.

    de 1 à 5 000

Paramètres de /api/v1/iris/{code_iris}/geographie

  • code_iristexteobligatoire

    Code IRIS du quartier (9 caractères : code INSEE de la commune puis quatre chiffres).

Paramètres de /api/v1/departements/{departement}/geographie

  • departementtexteobligatoire

    Code du département (01 à 95, 2A, 2B, 971 à 976).

Paramètres de /api/v1/regions/{region}/geographie

  • regiontexteobligatoire

    Code INSEE de la région (53) ou son nom court (bretagne).

Exemple d'appel

curl https://pillr.fr/api/v1/communes/{insee}/geographie \
  -H "Authorization: Bearer $PILLR_CLE"

Réponse

  • niveautexte

    Valeurs : commune, arrondissement, iris, departement, region

  • codetexte
  • nomtexte ou null
  • geometrieobjet ou null

    Contour GeoJSON (coordonnées WGS 84, six décimales).

  • sommetsentier

    Nombre de sommets du contour servi.

  • simplification_mnombre ou null

    Tolérance de simplification appliquée, en mètres ; null : contour complet.

  • centreobjet ou null
    Afficher les 3 champs
    • latnombre
    • lonnombre
    • sourcetexte ou null
  • empriseliste de nombres ou null

    Emprise : ouest, sud, est, nord, en degrés.

  • communeobjet ou null

    Pour un quartier IRIS ou un arrondissement : sa commune.

    Afficher les 2 champs
    • inseetexte
    • nomtexte ou null
  • voisinesliste d'objets
    Afficher les 2 champs
    • inseetexte
    • nomtexte ou null
  • epciobjet ou null
    Afficher les 2 champs
    • sirentexte
    • nomtexte
  • 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

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

Tuiles vectorielles de la carte des prix

GET/api/v1/tuiles/prix/{z}/{x}/{y}

Une tuile vectorielle (Mapbox Vector Tile) de la carte des prix de Pillr, prête à poser dans MapLibre : régions jusqu'au zoom 6, départements jusqu'au 8, communes ensuite, avec les prix au m² des appartements et des maisons. En REST, la tuile part en octets ; en MCP, ses métadonnées et la tuile en ressource. Une tuile hors de la pyramide générée est refusée sans débit.

Coût
1 crédit par appel réussi
Accès
À l'usage ou avec l'abonnement Data
Portée
territoire
Outil MCP
tuiles_prix
Bac à sable
Oui, sans débit, sur un jeu figé
Mémoire
168 h
Délai
3 s

Essayer en direct

Paramètres

  • zentierobligatoire

    Niveau de zoom, de 5 à 11.

    de 5 à 11

  • xentierobligatoire

    0 au moins

  • yvaleurobligatoire

    Numéro de ligne de la tuile, avec ou sans l'extension .pbf ou .mvt.

Exemple d'appel

curl https://pillr.fr/api/v1/tuiles/prix/{z}/{x}/{y} \
  -H "Authorization: Bearer $PILLR_CLE"

Réponse

  • zentier
  • xentier
  • yentier
  • typetexte
  • octetsentier
  • 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

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

Référentiels de communes et de codes postaux

GET/api/v1/referentiels/communes
GET/api/v1/referentiels/codes-postaux/{cp}
GET/api/v1/intercommunalites/{siren}

Correspondances entre nom de commune, code INSEE, code postal, libellé d'acheminement et intercommunalité, lues dans le Code officiel géographique, la base officielle des codes postaux et le référentiel des intercommunalités : recherche d'une commune par son nom (q), communes d'un code postal (cp) ou d'une intercommunalité (siren). Chaque commune porte ses codes postaux, son intercommunalité, ses communes déléguées ou associées et ses mouvements au COG.

Coût
0 crédit par appel réussi
Accès
À l'usage ou avec l'abonnement Data
Portée
territoire
Outil MCP
referentiels
Bac à sable
Oui, sans débit, sur un jeu figé
Mémoire
24 h
Délai
4 s

Essayer en direct

Paramètres de /api/v1/referentiels/communes

  • qtexte

    Nom de commune cherché, accents et tirets libres.

    de 2 à 80 caractères

Paramètres de /api/v1/referentiels/codes-postaux/{cp}

  • cptexteobligatoire

Paramètres de /api/v1/intercommunalites/{siren}

  • sirentexteobligatoire

Exemple d'appel

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

Réponse

  • communesliste d'objets
    Afficher les 9 champs
    • inseetexte
    • nomtexte ou null
    • typetexte ou null

      Type au Code officiel géographique : COM (commune), ARM (arrondissement municipal).

    • departementtexte ou null
    • codes_postauxliste de textes
    • libelles_acheminementliste de textes
    • epciobjet ou null
      Afficher les 2 champs
      • sirentexte
      • nomtexte
    • delegueesliste d'objets
      Afficher les 3 champs
      • inseetexte
      • nomtexte ou null
      • typetexte ou null
    • mouvementsliste d'objets
      Afficher les 4 champs
      • datetexte ou null
      • naturetexte ou null

        Code de la modification au COG (fusion, changement de nom, rétablissement...).

      • avantobjet
        Afficher les 2 champs
        • inseetexte
        • nomtexte ou null
      • apresobjet
        Afficher les 2 champs
        • inseetexte
        • nomtexte ou null
  • confiancetexte

    Comment les communes ont été trouvées.

    Valeurs : exacte, prefixe, code_postal, intercommunalite

  • intercommunaliteobjet ou null
    Afficher les 2 champs
    • sirentexte
    • nomtexte
  • millesimesobjet
    Afficher les 3 champs
    • cogtexte ou null
    • codes_postauxtexte ou null
    • intercommunalitestexte ou null
  • 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

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

Verdict d'investissement d'une commune

GET/api/v1/communes/{insee}/verdict

Verdict factuel sur une commune, calculé sans IA par la règle des pages communes : niveau (acheter, surveiller ou cher), libellé, ton et raisons chiffrées, à partir de l'écart au prix attendu du département, du rendement brut et de la tendance des prix, pondérés selon l'optique (achat ou rendement). Les entrées utilisées sont rendues. Quand les données manquent, le verdict le dit. Paris, Lyon et Marseille sont jugées sur l'agrégat de 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
verdict_commune
Bac à sable
Oui, sans débit, sur un jeu figé
Mémoire
6 h
Délai
4 s

Essayer en direct

Paramètres

  • inseetexteobligatoire

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

  • optiquetexte

    achat (par défaut) ou rendement : oriente la pondération et le libellé.

    Valeurs : achat, rendement

    par défaut "achat"

Exemple d'appel

curl https://pillr.fr/api/v1/communes/{insee}/verdict \
  -H "Authorization: Bearer $PILLR_CLE"

Réponse

  • inseetexte

    Code INSEE demandé.

  • communetexte ou null

    Nom de la commune ou de l'arrondissement.

  • optiquetexte

    Valeurs : achat, rendement

  • niveautexte

    Valeurs : acheter, surveiller, cher

  • labeltexte
  • tontexte

    Valeurs : positif, neutre, prudent

  • raisonsliste de textes
  • entrees_utiliseesobjet
    Afficher les 7 champs
    • signal_dealtexte ou null
    • prix_residuel_pctnombre ou null
    • residuel_saturebooléen ou null
    • rendement_brut_appartement_pctnombre ou null
    • evolution_prix_3_ans_pctnombre ou null
    • evolution_prix_1_an_pctnombre ou null
    • horizon_tendancetexte ou null

      Valeurs : 3 ans, 1 an

  • agregebooléen

    Vrai pour Paris, Lyon et Marseille : agrégat de leurs arrondissements.

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

  • donnees_dutexte ou null
  • 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

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

Comparaison de communes

GET/api/v1/communes/comparaison

De deux à quatre communes côte à côte, avec les chiffres des pages communes : prix au m² des appartements et des maisons avec leur provenance et leur nombre de ventes, loyer, rendements, évolutions sur 1 et 3 ans, zone ABC, population, score Pillr, part de passoires et verdict d'investissement sans IA. Pour chaque indicateur, la commune la mieux placée est désignée. Paris, Lyon et Marseille sont comparées sur l'agrégat de leurs arrondissements.

Coût
1 crédit par élément rendu
Accès
À l'usage ou avec l'abonnement Data
Portée
territoire
Outil MCP
comparer_communes
Bac à sable
Oui, sans débit, sur un jeu figé
Mémoire
6 h
Délai
8 s

Essayer en direct

Paramètres

  • inseevaleurobligatoire

    Deux à quatre codes INSEE, séparés par des virgules (35238,44109) ou en liste.

  • optiquetexte

    achat (par défaut) ou rendement : oriente le verdict.

    Valeurs : achat, rendement

    par défaut "achat"

Exemple d'appel

curl "https://pillr.fr/api/v1/communes/comparaison?insee=%3Cinsee%3E" \
  -H "Authorization: Bearer $PILLR_CLE"

Réponse

  • optiquetexte

    Valeurs : achat, rendement

  • communesliste d'objets
    Afficher les 14 champs
    • inseetexte
    • communetexte ou null
    • agregebooléen
    • prix_m2objet
      Afficher les 6 champs
      • appartementnombre ou null
      • maisonnombre ou null
      • provenance_appartementtexte ou null

        mesure : mesuré sur les ventes DVF de la commune ; estime : estimé par le barème sur trop peu de ventes pour une mesure, à lire avec le nombre de ventes ; null : non étiquetée.

        Valeurs : mesure, estime

      • provenance_maisontexte ou null

        mesure : mesuré sur les ventes DVF de la commune ; estime : estimé par le barème sur trop peu de ventes pour une mesure, à lire avec le nombre de ventes ; null : non étiquetée.

        Valeurs : mesure, estime

      • ventes_appartemententier ou null
      • ventes_maisonentier ou null
    • loyer_m2nombre ou null
    • rendement_brut_pctobjet
      Afficher les 2 champs
      • appartementnombre ou null
      • maisonnombre ou null
    • evolution_pctobjet
      Afficher les 3 champs
      • un_annombre ou null
      • trois_ansnombre ou null
      • confiancetexte ou null
    • zone_abctexte ou null
    • populationentier ou null
    • score_pillrnombre ou null
    • passoires_dpe_fg_pctnombre ou null
    • verdictobjet
      Afficher les 3 champs
      • niveautexte

        Valeurs : acheter, surveiller, cher

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

    • donnees_dutexte ou null
  • meilleure_par_indicateurobjet

    Code INSEE de la commune la mieux placée sur chaque indicateur ; null quand aucune commune ne le porte.

    Afficher les 7 champs
    • prix_appartement_le_plus_bastexte ou null
    • prix_maison_le_plus_bastexte ou null
    • rendement_appartement_le_plus_hauttexte ou null
    • rendement_maison_le_plus_hauttexte ou null
    • evolution_3_ans_la_plus_hautetexte ou null
    • score_pillr_le_plus_hauttexte ou null
    • passoires_les_moins_nombreusestexte ou null
  • introuvablesliste de textes
  • creditsobjet

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

    Afficher les 2 champs
    • debitesentier

      0 au moins

    • restantsentier ou null

Erreurs possibles

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

Palmarès de communes par indicateur

GET/api/v1/communes/palmares

Communes classées sur un indicateur publié par Pillr, avec les filtres et les tris des pages de classement du site : rendement locatif, cashflow positif, zones A et A bis, prix bas, prix élevés, peu de passoires, score Pillr, communes sous le prix attendu de leur département, meilleur rendement, ou les deux à la fois. En France, dans un département ou dans une région. Chaque ligne porte son rang, sa valeur, sa population et ses ventes ; les seuils de fiabilité appliqués sont rendus en clair. Liste paginée.

Coût
1 crédit par élément rendu
Accès
À l'usage ou avec l'abonnement Data
Portée
territoire
Outil MCP
palmares_communes
Bac à sable
Oui, sans débit, sur un jeu figé
Mémoire
6 h
Délai
6 s

Essayer en direct

Paramètres

  • indicateurtexteobligatoire

    L'indicateur du classement.

    Valeurs : rendement-locatif, cashflow-positif, pinel-a, prix-bas, prix-eleve, peu-de-passoires, score-pillr, sous-evaluees, meilleur-rendement, sous-evaluees-et-rendement

  • departementtexte

    Code du département (01 à 95, 2A, 2B, 971 à 976).

  • regiontexte

    Région : code INSEE, nom court ou nom.

    de 2 à 60 caractères

  • population_minnombre

    Population minimale ; par défaut celle des pages de classement du site, plus basse en maille géographique et pour les classements d'étude. Le seuil appliqué est rendu dans filtres_appliques.

  • transactions_minnombre

    Ventes minimales.

  • limiteentier

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

    de 1 à 50 ; par défaut 20

  • curseurtexte

    Curseur opaque rendu par la page précédente (curseur_suivant), à repasser tel quel.

    de 1 à 1 024 caractères

Exemple d'appel

curl "https://pillr.fr/api/v1/communes/palmares?indicateur=rendement-locatif" \
  -H "Authorization: Bearer $PILLR_CLE"

Réponse

  • indicateurtexte

    Valeurs : rendement-locatif, cashflow-positif, pinel-a, prix-bas, prix-eleve, peu-de-passoires, score-pillr, sous-evaluees, meilleur-rendement, sous-evaluees-et-rendement

  • libelletexte
  • methodetexte
  • mailleobjet
    Afficher les 3 champs
    • niveautexte

      Valeurs : france, departement, region

    • codetexte ou null
    • nomtexte ou null
  • filtres_appliquesliste de textes

    Les seuils de fiabilité appliqués, en clair.

  • donneesliste d'objets
    Afficher les 19 champs
    • rangentier
    • inseetexte
    • communetexte ou null
    • code_postaltexte ou null
    • departementtexte ou null
    • regiontexte ou null
    • populationentier ou null
    • transactionsentier ou null
    • prix_m2_appartementnombre ou null
    • prix_m2_maisonnombre ou null
    • loyer_m2_preditnombre ou null
    • rendement_brut_appartement_pctnombre ou null
    • rendement_brut_maison_pctnombre ou null
    • prix_residuel_pctnombre ou null
    • evolution_3_ans_pctnombre ou null
    • passoires_dpe_fg_pctnombre ou null
    • zone_abctexte ou null
    • score_attractivitenombre ou null
    • valeur_indicateurnombre 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.

  • donnees_dutexte ou null
  • curseur_suivanttexte ou null

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

  • creditsobjet

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

    Afficher les 2 champs
    • debitesentier

      0 au moins

    • restantsentier ou null

Erreurs possibles

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

Avis des investisseurs sur une commune

GET/api/v1/communes/{insee}/avis

Avis déposés par les utilisateurs de Pillr sur une commune, triés par utilité puis par date (ou par date) : note globale et quatre notes (rentabilité, qualité de vie, demande locative, valorisation), titre, texte, profil déclaré de l'auteur et mention de vérification, avec les moyennes de la commune. L'identité de l'auteur n'est jamais servie, ni les coordonnées citées dans un texte. Liste paginée.

Coût
1 crédit par appel réussi
Accès
À l'usage ou avec l'abonnement Data
Portée
territoire
Outil MCP
avis_zone
Bac à sable
Oui, sans débit, sur un jeu figé
Mémoire
10 min
Délai
3 s

Essayer en direct

Paramètres

  • inseetexteobligatoire

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

  • tritexte

    utiles (par défaut) : utilité puis date ; recents : date.

    Valeurs : utiles, recents

    par défaut "utiles"

  • limiteentier

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

    de 1 à 50 ; par défaut 20

  • curseurtexte

    Curseur opaque rendu par la page précédente (curseur_suivant), à repasser tel quel.

    de 1 à 1 024 caractères

Exemple d'appel

curl https://pillr.fr/api/v1/communes/{insee}/avis \
  -H "Authorization: Bearer $PILLR_CLE"

Réponse

  • inseetexte

    Code INSEE demandé.

  • communetexte ou null

    Nom de la commune ou de l'arrondissement.

  • moyennesobjet
    Afficher les 6 champs
    • globalenombre ou null
    • rentabilitenombre ou null
    • qualite_de_vienombre ou null
    • demande_locativenombre ou null
    • valorisationnombre ou null
    • nentier
  • avisliste d'objets
    Afficher les 8 champs
    • idtexte
    • notesobjet
      Afficher les 5 champs
      • globaleentier ou null

        de 1 à 5

      • rentabiliteentier ou null

        de 1 à 5

      • qualite_de_vieentier ou null

        de 1 à 5

      • demande_locativeentier ou null

        de 1 à 5

      • valorisationentier ou null

        de 1 à 5

    • titretexte ou null
    • contenutexte ou null
    • profil_auteurtexte ou null

      Profil déclaré de l'auteur (propriétaire, locataire, investisseur, professionnel) ; jamais son identité.

    • verifiebooléen ou null
    • votes_utilesentier ou null
    • cree_letexte 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.

  • curseur_suivanttexte ou null

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

  • creditsobjet

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

    Afficher les 2 champs
    • debitesentier

      0 au moins

    • restantsentier ou null

Erreurs possibles

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

Publier un avis sur une commune

POST/api/v1/communes/{insee}/avis

Publie l'avis de l'utilisateur de la clé sur une commune, avec les règles du site : note globale de 1 à 5, quatre notes facultatives, titre, texte et profil. Un seul avis par compte et par commune ; un second est refusé. L'avis est servi ensuite sans l'identité de son auteur.

Coût
0 crédit par appel réussi
Accès
À l'usage ou avec l'abonnement Data
Portée
territoire
Outil MCP
avis_zone_publier
Bac à sable
Non
Mémoire
Jamais gardée
Délai
5 s

Essayer en direct

Paramètres

  • inseetexteobligatoire

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

  • noteentierobligatoire

    Note globale, de 1 à 5.

    de 1 à 5

  • note_rentabiliteentier

    de 1 à 5

  • note_qualite_vieentier

    de 1 à 5

  • note_demande_locativeentier

    de 1 à 5

  • note_valorisationentier

    de 1 à 5

  • titretexteobligatoire

    de 3 à 200 caractères

  • contenutexteobligatoire

    de 10 à 5 000 caractères

  • profiltexte

    Votre profil : proprietaire, locataire, investisseur ou professionnel.

    Valeurs : proprietaire, locataire, investisseur, professionnel

Exemple d'appel

curl -X POST https://pillr.fr/api/v1/communes/{insee}/avis \
  -H "Authorization: Bearer $PILLR_CLE" \
  -H "Content-Type: application/json" \
  -d '{"note":1,"titre":"<titre>","contenu":"<contenu>"}'

Réponse

  • idtexte
  • inseetexte
  • communetexte ou null
  • cree_letexte ou null
  • 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

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

Voter pour l'utilité d'un avis

POST/api/v1/avis/{id}/vote

Pose le vote d'utilité de l'utilisateur de la clé sur un avis : utile (par défaut) ou non. Le même appel deux fois laisse le même état ; le compteur d'utilité est recalculé depuis les votes.

Coût
0 crédit par appel réussi
Accès
À l'usage ou avec l'abonnement Data
Portée
territoire
Outil MCP
avis_zone_voter
Bac à sable
Non
Mémoire
Jamais gardée
Délai
5 s

Essayer en direct

Paramètres

  • idtexteobligatoire

    Identifiant de l'avis.

    format uuid

  • utilebooléen

    true (par défaut) : l'avis vous a été utile ; false : retire votre vote.

    par défaut true

Exemple d'appel

curl -X POST https://pillr.fr/api/v1/avis/{id}/vote \
  -H "Authorization: Bearer $PILLR_CLE" \
  -H "Content-Type: application/json" \
  -d '{}'

Réponse

  • idtexte
  • utilebooléen
  • votes_utilesentier
  • 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

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

Loyer de marché d'un logement

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é
Mémoire
6 h
Délai
5 s

Essayer en direct

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/{insee}/loyers \
  -H "Authorization: Bearer $PILLR_CLE"

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

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

Encadrement des loyers

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é
Mémoire
24 h
Délai
5 s

Essayer en direct

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 \
  -H "Authorization: Bearer $PILLR_CLE"

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

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

Zonage ABC, plafonds et contraintes locales

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é
Mémoire
24 h
Délai
5 s

Essayer en direct

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/{insee}/zonage \
  -H "Authorization: Bearer $PILLR_CLE"

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

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

Marché de la courte durée d'une commune

GET/api/v1/communes/{insee}/courte-duree

Marché de la location courte durée d'une commune : profil AirDNA (annonces actives, revenu, occupation, prix de nuit, revenu par nuit disponible, évolutions sur un an, score de marché et sous-scores), à la maille de la commune, de la ville pour un arrondissement, du département ajusté à la part de résidences secondaires ou de la France, avec sa confiance ; rentabilité de la courte durée, scores Pillr de courte durée, de longue durée et de tourisme, part de résidences secondaires, et statut réglementaire de la courte durée. Mêmes profils que le simulateur de pillr.fr. Données aspirées des pages publiques d'AirDNA.

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

Essayer en direct

Paramètres

  • inseetexteobligatoire

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

Exemple d'appel

curl https://pillr.fr/api/v1/communes/{insee}/courte-duree \
  -H "Authorization: Bearer $PILLR_CLE"

Réponse

  • inseetexte
  • communetexte ou null
  • profilobjet ou null

    null : aucun profil, même départemental ou national.

    Afficher les 14 champs
    • mailletexte

      commune : marché AirDNA de la commune ; ville : marché de la ville d'un arrondissement ; departement : profil du département ajusté à la part de résidences secondaires ; france : profil national ; anciennes_donnees : colonnes du jeu de 2025.

      Valeurs : commune, ville, departement, france, anciennes_donnees

    • marchetexte ou null

      Nom du marché ou du profil source.

    • annonces_activesnombre ou null

      Annonces actives sur le marché, douze derniers mois.

    • revenu_annuelnombre ou null

      Revenu annuel de l'annonce type du marché, en euros, avant charges.

    • occupation_pctnombre

      Part des nuits ouvertes réservées, en %.

    • prix_nuitnombre

      Prix de nuit moyen payé, en euros.

    • revparnombre

      Revenu par nuit disponible : prix de nuit multiplié par l'occupation, en euros.

    • evolution_annonces_1an_pctnombre ou null
    • evolution_revenu_1an_pctnombre ou null
    • score_marchenombre ou null

      Score de marché AirDNA, 40 à 100.

    • scores_airdnaobjet
      Afficher les 4 champs
      • demandenombre ou null
      • saisonnalitenombre ou null
      • croissancenombre ou null
      • reglementationnombre ou null
    • confiancetexte

      mesure : marché AirDNA d'au moins 20 annonces ; estime : petit marché lissé avec son département, ou profil départemental ; faible : profil national ou anciennes données.

      Valeurs : mesure, estime, faible

    • millesimetexte ou null

      Millésime de l'aspiration des pages marché AirDNA.

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

  • rentabilite_lcd_pctobjet

    Rentabilité brute de la courte durée publiée par market_data (colonne héritée du jeu de 2025).

    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.

  • scoresobjet

    Scores Pillr de la commune sur 100 : courte durée, longue durée, tourisme.

    Afficher les 4 champs
    • lcdnombre ou null
    • lldnombre ou null
    • tourismenombre 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.

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

  • reglementationobjet

    Statut de la courte durée pour un investisseur (hors résidence principale) dans la commune, sans DPE donné.

    Afficher les 4 champs
    • niveautexte

      libre : déclaration en mairie ; declaration : zone tendue, déclaration et numéro d'enregistrement ; autorisation : changement d'usage à obtenir ; compensation : changement d'usage avec compensation ; dpe : DPE qui ferme le meublé de tourisme.

      Valeurs : libre, declaration, autorisation, compensation, dpe

    • recommandablebooléen

      Faux quand la courte durée ne peut pas être conseillée en l'état (compensation, DPE).

    • titretexte
    • textetexte
  • 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

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

Risques naturels et technologiques

GET/api/v1/communes/{insee}/risques

Risques d'une commune : inondation, remontée de nappe, séisme, mouvement de terrain, argiles, radon, feu de forêt, site industriel, nucléaire, pollution des sols, rupture de barrage et risque minier, avec leur niveau et un score composite là où Géorisques est relevé en base, et les risques recensés par l'API publique Géorisques en direct ailleurs ; potentiel radon de l'IRSN pour toutes les communes ; arrêtés de catastrophe naturelle depuis 1982. Chaque bloc dit sa source. Ne remplace pas l'état des risques d'une adresse, obligatoire avant un achat.

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

Essayer en direct

Paramètres

  • inseetexteobligatoire

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

Exemple d'appel

curl https://pillr.fr/api/v1/communes/{insee}/risques \
  -H "Authorization: Bearer $PILLR_CLE"

Réponse

  • inseetexte
  • communetexte ou null
  • risquesobjet
    Afficher les 5 champs
    • sourcetexte

      base : relevé Géorisques en base ; georisques : risques recensés par l'API publique Géorisques, en direct ; indisponible : l'API n'a pas répondu.

      Valeurs : base, georisques, indisponible

    • par_risqueobjet
      Afficher les 12 champs
      • inondationobjet
        Afficher les 2 champs
        • presentbooléen ou null

          Vrai : risque relevé ou recensé ; faux : ni relevé ni recensé ; null : inconnu (source indisponible).

        • niveauentier ou null

          Niveau relevé en base (0 absent, 1 faible, 2 moyen, 3 fort ; sismicité 1 à 5), ou zone de sismicité recensée ; null sans niveau.

      • remontee_nappeobjet
        Afficher les 2 champs
        • presentbooléen ou null

          Vrai : risque relevé ou recensé ; faux : ni relevé ni recensé ; null : inconnu (source indisponible).

        • niveauentier ou null

          Niveau relevé en base (0 absent, 1 faible, 2 moyen, 3 fort ; sismicité 1 à 5), ou zone de sismicité recensée ; null sans niveau.

      • seismeobjet
        Afficher les 2 champs
        • presentbooléen ou null

          Vrai : risque relevé ou recensé ; faux : ni relevé ni recensé ; null : inconnu (source indisponible).

        • niveauentier ou null

          Niveau relevé en base (0 absent, 1 faible, 2 moyen, 3 fort ; sismicité 1 à 5), ou zone de sismicité recensée ; null sans niveau.

      • mouvement_terrainobjet
        Afficher les 2 champs
        • presentbooléen ou null

          Vrai : risque relevé ou recensé ; faux : ni relevé ni recensé ; null : inconnu (source indisponible).

        • niveauentier ou null

          Niveau relevé en base (0 absent, 1 faible, 2 moyen, 3 fort ; sismicité 1 à 5), ou zone de sismicité recensée ; null sans niveau.

      • argilesobjet
        Afficher les 2 champs
        • presentbooléen ou null

          Vrai : risque relevé ou recensé ; faux : ni relevé ni recensé ; null : inconnu (source indisponible).

        • niveauentier ou null

          Niveau relevé en base (0 absent, 1 faible, 2 moyen, 3 fort ; sismicité 1 à 5), ou zone de sismicité recensée ; null sans niveau.

      • radonobjet
        Afficher les 2 champs
        • presentbooléen ou null

          Vrai : risque relevé ou recensé ; faux : ni relevé ni recensé ; null : inconnu (source indisponible).

        • niveauentier ou null

          Niveau relevé en base (0 absent, 1 faible, 2 moyen, 3 fort ; sismicité 1 à 5), ou zone de sismicité recensée ; null sans niveau.

      • feu_foretobjet
        Afficher les 2 champs
        • presentbooléen ou null

          Vrai : risque relevé ou recensé ; faux : ni relevé ni recensé ; null : inconnu (source indisponible).

        • niveauentier ou null

          Niveau relevé en base (0 absent, 1 faible, 2 moyen, 3 fort ; sismicité 1 à 5), ou zone de sismicité recensée ; null sans niveau.

      • icpeobjet
        Afficher les 2 champs
        • presentbooléen ou null

          Vrai : risque relevé ou recensé ; faux : ni relevé ni recensé ; null : inconnu (source indisponible).

        • niveauentier ou null

          Niveau relevé en base (0 absent, 1 faible, 2 moyen, 3 fort ; sismicité 1 à 5), ou zone de sismicité recensée ; null sans niveau.

      • nucleaireobjet
        Afficher les 2 champs
        • presentbooléen ou null

          Vrai : risque relevé ou recensé ; faux : ni relevé ni recensé ; null : inconnu (source indisponible).

        • niveauentier ou null

          Niveau relevé en base (0 absent, 1 faible, 2 moyen, 3 fort ; sismicité 1 à 5), ou zone de sismicité recensée ; null sans niveau.

      • pollution_solsobjet
        Afficher les 2 champs
        • presentbooléen ou null

          Vrai : risque relevé ou recensé ; faux : ni relevé ni recensé ; null : inconnu (source indisponible).

        • niveauentier ou null

          Niveau relevé en base (0 absent, 1 faible, 2 moyen, 3 fort ; sismicité 1 à 5), ou zone de sismicité recensée ; null sans niveau.

      • rupture_barrageobjet
        Afficher les 2 champs
        • presentbooléen ou null

          Vrai : risque relevé ou recensé ; faux : ni relevé ni recensé ; null : inconnu (source indisponible).

        • niveauentier ou null

          Niveau relevé en base (0 absent, 1 faible, 2 moyen, 3 fort ; sismicité 1 à 5), ou zone de sismicité recensée ; null sans niveau.

      • minierobjet
        Afficher les 2 champs
        • presentbooléen ou null

          Vrai : risque relevé ou recensé ; faux : ni relevé ni recensé ; null : inconnu (source indisponible).

        • niveauentier ou null

          Niveau relevé en base (0 absent, 1 faible, 2 moyen, 3 fort ; sismicité 1 à 5), ou zone de sismicité recensée ; null sans niveau.

    • libellesliste de textes

      Les risques en clair, tels que la source les nomme.

    • score_risque_compositenombre ou null

      Score composite de la base, sur 100 ; null hors des communes relevées.

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

  • radonobjet
    Afficher les 2 champs
    • classeentier ou null

      Potentiel radon de l'IRSN, 1 à 3 (3 : significatif).

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

  • catnatobjet
    Afficher les 2 champs
    • arretesliste d'objets ou null

      Arrêtés de catastrophe naturelle de la commune depuis 1982, du plus récent au plus ancien ; null si l'API n'a pas répondu.

      Afficher les 5 champs
      • codetexte
      • naturetexte
      • debuttexte

        Début de l'évènement (AAAA-MM-JJ).

      • fintexte ou null
      • arrete_publie_letexte ou null

        Publication de l'arrêté au Journal officiel (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.

  • phrasetexte
  • limitesliste de textes
  • sourcesliste de textes
  • creditsobjet

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

    Afficher les 2 champs
    • debitesentier

      0 au moins

    • restantsentier ou null

Erreurs possibles

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

Équipements, accès, délinquance et cadre de vie

GET/api/v1/communes/{insee}/mesures

Mesures d'une commune, chacune avec sa phrase et sa source, celles de l'analyse de zone de pillr.fr : équipements de la Base permanente des équipements (quinze comptes sur la commune entière et les essentiels absents), gare de voyageurs et aéroport les plus proches avec la distance, délinquance enregistrée par catégorie (faits et taux pour 1 000 habitants, comparés à la moyenne des communes publiées), potentiel radon et risques relevés, points d'intérêt à 500 m et score de marche à pied là où ils sont calculés.

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

Essayer en direct

Paramètres

  • inseetexteobligatoire

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

Exemple d'appel

curl https://pillr.fr/api/v1/communes/{insee}/mesures \
  -H "Authorization: Bearer $PILLR_CLE"

Réponse

  • inseetexte
  • communetexte ou null
  • equipementsobjet ou null
    Afficher les 5 champs
    • perimetretexte
    • comptesobjet
      Afficher les 15 champs
      • totalentier
      • services_particuliersentier
      • commercesentier
      • commerces_alimentairesentier
      • enseignemententier
      • ecolesentier
      • collegesentier
      • lyceesentier
      • sante_socialentier
      • medecins_generalistesentier
      • pharmaciesentier
      • transportsentier
      • garesentier
      • sports_loisirsentier
      • tourismeentier
    • essentiels_absentsliste de textes
    • phrasetexte
    • 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.

  • accesobjet ou null

    Gare de voyageurs et aéroport à vols réguliers les plus proches, à vol d'oiseau depuis le centre habité.

    Afficher les 4 champs
    • gareobjet ou null
      Afficher les 3 champs
      • nomtexte
      • categorietexte ou null

        Valeurs : nationale, régionale, locale

      • kmnombre
    • aeroportobjet ou null
      Afficher les 3 champs
      • nomtexte
      • iatatexte ou null
      • kmnombre
    • phrasetexte
    • 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.

  • delinquanceobjet ou null
    Afficher les 5 champs
    • anneeentier ou null
    • populationnombre ou null
    • categoriesliste d'objets
      Afficher les 5 champs
      • cletexte
      • nomtexte
      • nbnombre ou null

        Faits enregistrés ; null quand le ministère ne publie pas (petits effectifs).

      • taux_pour_1000nombre ou null
      • moyenne_pour_1000nombre ou null

        Moyenne des communes dont les chiffres sont publiés, la même année ; null sans moyenne calculée.

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

  • risquesobjet
    Afficher les 4 champs
    • radon_classeentier ou null
    • releveobjet ou null
      Afficher les 3 champs
      • inondationtexte

        Valeurs : faible, moyen, fort, inconnu

      • argilestexte

        Valeurs : faible, moyen, fort, inconnu

      • mouvement_terraintexte

        Valeurs : faible, moyen, fort, inconnu

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

  • poi_500mobjet ou null

    Points d'intérêt OpenStreetMap à 500 m du centre ; calculés pour quelques centaines de communes seulement.

    Afficher les 10 champs
    • transportsnombre ou null
    • ecolesnombre ou null
    • commercesnombre ou null
    • santenombre ou null
    • loisirsnombre ou null
    • restaurationnombre ou null
    • totalnombre ou null
    • score_marche_a_piednombre ou null

      Score de marche à pied, sur 100.

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

  • phrasesliste de textes
  • sourcesliste de textes
  • creditsobjet

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

    Afficher les 2 champs
    • debitesentier

      0 au moins

    • restantsentier ou null

Erreurs possibles

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

Prime de division d'une commune

GET/api/v1/communes/{insee}/prime-division

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

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

Essayer en direct

Paramètres

  • inseetexteobligatoire

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

Exemple d'appel

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

Réponse

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

      Valeurs : commune, departement

    • codetexte

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

    • prix_m2_unitenombre ou null

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

    • prix_m2_blocnombre ou null

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

    • rapportnombre ou null

      prix_m2_unite divisé par prix_m2_bloc.

    • prime_pctnombre ou null

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

    • n_uniteentier

      Mutations d'un seul logement retenues.

    • n_blocentier

      Mutations de 4 logements ou plus retenues.

    • periodeobjet

      Première et dernière mutation retenues.

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

      Années couvertes par les mutations retenues.

    • qualiteobjet

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

      Afficher les 7 champs
      • nentier ou null

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

        0 au moins

      • provenancetexte ou null

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

        Valeurs : mesure, estime

      • incertitudeobjet ou null

        Incertitude de la valeur : fourchette et demi-largeur.

        Afficher les 3 champs
        • demi_largeur_pctnombre ou null

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

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

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

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

      • methodetexte ou null

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

      • donnees_dutexte ou null

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

      • sourcetexte

        Source publique ou moteur Pillr, en clair.

  • departementobjet ou null

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

    Afficher les 11 champs
    • mailletexte

      Valeurs : commune, departement

    • codetexte

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

    • prix_m2_unitenombre ou null

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

    • prix_m2_blocnombre ou null

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

    • rapportnombre ou null

      prix_m2_unite divisé par prix_m2_bloc.

    • prime_pctnombre ou null

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

    • n_uniteentier

      Mutations d'un seul logement retenues.

    • n_blocentier

      Mutations de 4 logements ou plus retenues.

    • periodeobjet

      Première et dernière mutation retenues.

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

      Années couvertes par les mutations retenues.

    • qualiteobjet

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

      Afficher les 7 champs
      • nentier ou null

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

        0 au moins

      • provenancetexte ou null

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

        Valeurs : mesure, estime

      • incertitudeobjet ou null

        Incertitude de la valeur : fourchette et demi-largeur.

        Afficher les 3 champs
        • demi_largeur_pctnombre ou null

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

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

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

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

      • methodetexte ou null

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

      • donnees_dutexte ou null

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

      • sourcetexte

        Source publique ou moteur Pillr, en clair.

  • avertissementtexte
  • calcule_letexte
  • creditsobjet

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

    Afficher les 2 champs
    • debitesentier

      0 au moins

    • restantsentier ou null

Erreurs possibles

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

Baromètre

GET/api/v1/barometre/{edition}

L'édition figée du baromètre de Pillr pour la France, un département ou une commune : chaque mesure du registre (prix de référence, ventes, loyer, rendement, annonces, baisses de prix, biens à rénover, budget travaux, écart au prix de référence, part des DPE F et G, résidences secondaires, vacance, revenu), avec son effectif, son intervalle quand il existe, et son seuil de publication. Rien n'est masqué : une valeur sous le seuil de publication du site est servie avec publiee = faux et son motif. edition vaut AAAA-MM ou courante. Édition ou territoire inconnus : 404, rien n'est débité.

Coût
1 crédit par appel réussi
Accès
À l'usage ou avec l'abonnement Data
Portée
territoire
Outil MCP
barometre
Bac à sable
Oui, sans débit, sur un jeu figé
Mémoire
24 h
Délai
2 s

Essayer en direct

Paramètres

  • editiontexteobligatoire

    Édition (AAAA-MM), ou courante.

  • echelletexte

    france (défaut), departement ou commune.

    Valeurs : france, departement, commune

    par défaut "france"

  • cletexte

    Code du département (echelle departement) ou code INSEE (echelle commune).

Exemple d'appel

curl https://pillr.fr/api/v1/barometre/{edition} \
  -H "Authorization: Bearer $PILLR_CLE"

Réponse

  • editiontexte
  • donnees_autexte

    Date d'arrêt des données de l'édition (AAAA-MM-JJ).

  • methodetexte

    Version de la méthode.

  • revisiontexte
  • echelletexte

    Valeurs : france, departement, commune

  • cletexte

    FR, code du département ou code INSEE.

  • nomtexte
  • mesuresliste d'objets
    Afficher les 13 champs
    • cletexte

      Identifiant de la mesure dans le registre (fg, baisse, prixA...).

    • libelletexte
    • naturetexte

      annonce, vente, diag, recens ou loyer.

    • unitetexte
    • valeurnombre ou null

      La valeur de l'édition, servie même sous le seuil de publication du site ; null si elle n'existe pas à cette échelle.

    • nentier ou null

      Effectif derrière la valeur, quand la mesure en a un.

    • seuil_publicationentier ou null

      Effectif minimal pour que le site publie la valeur.

    • seuil_classemententier ou null
    • publieebooléen

      Vrai si le site publie la valeur (effectif suffisant, prix de référence assez précis).

    • motiftexte ou null

      Pourquoi le site ne publie pas la valeur ; null si elle est publiée.

      Valeurs : non_disponible, sous_seuil

    • intervalleobjet ou null

      Intervalle de confiance à 95 %, quand la mesure en a un.

      Afficher les 2 champs
      • basnombre
      • hautnombre
    • datetexte

      Date de la mesure dans cette édition.

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

  • registreliste d'objets

    Le registre des mesures du baromètre, seuils de publication compris.

    Afficher les 11 champs
    • cletexte
    • libelletexte
    • naturetexte
    • unitetexte
    • echellesliste de textes

      Valeurs : commune, departement

    • sourcetexte
    • calcultexte
    • seuiltexte
    • limitetexte
    • seuil_publicationentier ou null
    • seuil_classemententier ou null
  • calcule_letexte
  • creditsobjet

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

    Afficher les 2 champs
    • debitesentier

      0 au moins

    • restantsentier ou null

Erreurs possibles

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

Baromètre, en lot

POST/api/v1/barometre/lot

Baromètre pour 100 éléments au plus en un appel : chaque élément est servi ou refusé seul, avec son code d'erreur, et seuls les éléments servis sont débités. L'édition figée du baromètre de Pillr pour la France, un département ou une commune : chaque mesure du registre (prix de référence, ventes, loyer, rendement, annonces, baisses de prix, biens à rénover, budget travaux, écart au prix de référence, part des DPE F et G, résidences secondaires, vacance, revenu), avec son effectif, son intervalle quand il existe, et son seuil de publication. Rien n'est masqué : une valeur sous le seuil de publication du site est servie avec publiee = faux et son motif. edition vaut AAAA-MM ou courante. Édition ou territoire inconnus : 404, rien n'est débité.

Coût
1 crédit par élément rendu
Accès
À l'usage ou avec l'abonnement Data
Portée
territoire
Outil MCP
barometre_lot
Bac à sable
Non
Mémoire
Jamais gardée
Délai
50 s

Essayer en direct

Paramètres

  • elementsliste d'objetsobligatoire

    Les entrées de l'opération unitaire, 100 au plus.

    1 éléments au moins ; 100 éléments au plus

    Afficher les 3 champs
    • editiontexteobligatoire

      Édition (AAAA-MM), ou courante.

    • echelletexte

      france (défaut), departement ou commune.

      Valeurs : france, departement, commune

      par défaut "france"

    • cletexte

      Code du département (echelle departement) ou code INSEE (echelle commune).

Exemple d'appel

curl -X POST https://pillr.fr/api/v1/barometre/lot \
  -H "Authorization: Bearer $PILLR_CLE" \
  -H "Content-Type: application/json" \
  -d '{"elements":[{}]}'

Réponse

  • resultatsliste de valeurs

    Un résultat par élément, dans l'ordre de l'entrée : la sortie de l'opération, ou l'erreur de cet élément.

  • n_okentier

    0 au moins

  • n_erreursentier

    0 au moins

  • 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

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

Dossier du baromètre sur demande

POST/api/v1/barometre/dossiers

Un dossier du baromètre composé à partir d'une demande libre : le modèle propose un plan (classements, comparaisons, croisements, répartitions) sur le registre des mesures, sans voir aucun chiffre ; les sections sont calculées de façon déterministe sur l'édition ; la lecture rédigée par le modèle passe par un vérificateur qui retire toute phrase dont un chiffre n'est pas dans les faits calculés. Rend le plan, chaque section (faits, lecture vérifiée, lecture déterministe, graphique, tableau) et un lien signé vers le dossier sur pillr.fr. Les classements suivent les seuils de classement de l'édition. Demande hors du périmètre du baromètre : 400 parametres_invalides, rien n'est débité ; modèle indisponible : 503, crédits rendus.

Coût
20 crédits par appel réussi
Accès
À l'usage ou avec l'abonnement Data
Portée
territoire
Outil MCP
dossier_barometre
Bac à sable
Non
Mémoire
Jamais gardée
Délai
60 s

Essayer en direct

Paramètres

  • questiontexteobligatoire

    La demande, en langage libre (ex. les passoires énergétiques en Bretagne).

    de 3 à 600 caractères

Exemple d'appel

curl -X POST https://pillr.fr/api/v1/barometre/dossiers \
  -H "Authorization: Bearer $PILLR_CLE" \
  -H "Content-Type: application/json" \
  -d '{"question":"<question>"}'

Réponse

  • editiontexte
  • titretexte
  • chapotexte
  • sectionsliste d'objets
    Afficher les 12 champs
    • typetexte

      classement, comparaison, croisement, repartition, agregat ou chiffre_cle.

    • titretexte
    • echelletexte

      Valeurs : commune, departement

    • selectiontexte

      La sélection, en clair.

    • mesuresliste de textes
    • faitsliste de textes

      Les faits calculés sur l'édition, seule matière de la lecture.

    • lectureliste de textes

      Les phrases de la lecture rédigée par le modèle que le vérificateur a gardées.

    • phrases_retireesentier

      Phrases de la lecture retirées par le vérificateur : un chiffre absent des faits.

    • phrasesliste de textes

      La lecture déterministe, calculée sans modèle.

    • graphiquevaleur

      Les points du graphique de la section (barres, nuage, histogramme ou chiffre).

    • tableauvaleur

      Les lignes du tableau de la section.

    • videbooléen
  • lien_signetexte ou null

    Lien signé du dossier sur pillr.fr ; null si la signature n'a pas pu être faite.

  • 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

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

Constantes réglementaires et fiscales de référence

GET/api/v1/referentiels/constantes

Les seuils et taux que les moteurs de Pillr appliquent, par thème : urbanisme (seuils de la déclaration préalable, architecte, piscines), fiscalité (TVA des travaux, Malraux, Pinel, déficit et micro-foncier, régimes micro, prélèvements sociaux, impôt sur les sociétés, amortissement du bailleur privé), pré-marché (fenêtre de mandat, pack de pré-vente) et location (calendrier d'interdiction de louer les passoires énergétiques). Chacune porte sa valeur, son unité, son objet, sa source officielle ou sa mesure, et la date de la version lue. Le registre dit qu'un seuil est le bon seuil, pas qu'il s'applique à un cas donné.

Coût
0 crédit par appel réussi
Accès
À l'usage ou avec l'abonnement Data
Portée
territoire
Outil MCP
constantes_reference
Bac à sable
Oui, sans débit, sur un jeu figé
Mémoire
24 h
Délai
1 s

Essayer en direct

Paramètres

  • contextetexte

    urbanisme, fiscalite, pre_marche ou location ; sans lui, toutes.

    Valeurs : urbanisme, fiscalite, pre_marche, location

  • cletexte

    Une seule constante, par sa clé.

    de 3 à 80 caractères

Exemple d'appel

curl https://pillr.fr/api/v1/referentiels/constantes \
  -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

{
  "relu_le": "2026-09-28",
  "contexte": null,
  "constantes": [
    {
      "cle": "urbanisme.m2.5",
      "valeur": 5,
      "unite": "m2",
      "objet": "Au plus 5 m² d'emprise au sol et de surface de plancher : aucune formalité ; au-delà, déclaration préalable.",
      "contexte": "urbanisme",
      "groupe": "urbanisme",
      "nature": "reglementaire",
      "source": {
        "texte": "Code de l'urbanisme, art. R421-2 a, R421-9 a, R421-13 et R421-17 f et g (base de règles lib/urbanisme/demarches.ts)",
        "lien": null
      },
      "version_le": "2026-09-17"
    },
    {
      "cle": "urbanisme.m2.20",
      "valeur": 20,
      "unite": "m2",
      "objet": "Plafond de la déclaration préalable (construction nouvelle, ou travaux hors zone urbaine d'un PLU).",
      "contexte": "urbanisme",
      "groupe": "urbanisme",
      "nature": "reglementaire",
      "source": {
        "texte": "Code de l'urbanisme, art. R421-9 a, R421-14 a et R421-17 f (base de règles lib/urbanisme/demarches.ts)",
        "lien": null
      },
      "version_le": "2026-09-17"
    },
    {
      "cle": "urbanisme.m2.40",
      "valeur": 40,
      "unite": "m2",
      "objet": "Plafond de la déclaration préalable pour des travaux sur l'existant en zone urbaine d'un PLU.",
      "contexte": "urbanisme",
      "groupe": "urbanisme",
      "nature": "reglementaire",
      "source": {
        "texte": "Code de l'urbanisme, art. R421-14 b et R421-17 f (base de règles lib/urbanisme/demarches.ts)",
        "lien": null
      },
      "version_le": "2026-09-17"
    },
    {
      "cle": "urbanisme.m2.150",
      "valeur": 150,
      "unite": "m2",
      "objet": "Surface de plancher au-delà de laquelle l'architecte est obligatoire pour une personne physique.",
      "contexte": "urbanisme",
      "groupe": "urbanisme",
      "nature": "reglementaire",
      "source": {
        "texte": "Code de l'urbanisme, art. R431-2 (base de règles lib/urbanisme/demarches.ts) ; loi n° 77-2 du 3 janvier 1977, art. 3",
        "lien": null
      },
      "version_le": "2026-09-17"
    },
    {
      "cle": "urbanisme.m.12",
      "valeur": 12,
      "unite": "m",
      "objet": "Hauteur maximale d'une construction nouvelle dispensée de formalité ou soumise à déclaration préalable.",
      "contexte": "urbanisme",
      "groupe": "urbanisme",
      "nature": "reglementaire",
      "source": {
        "texte": "Code de l'urbanisme, art. R421-2 a et R421-9 a (base de règles lib/urbanisme/demarches.ts)",
        "lien": null
      },
      "version_le": "2026-09-17"
    },
    {
      "cle": "piscine.m2.10",
      "valeur": 10,
      "unite": "m2",
      "objet": "Bassin de piscine d'au plus 10 m² : dispensé de formalité hors espace protégé.",
      "contexte": "urbanisme",
      "groupe": "piscine",
      "nature": "reglementaire",
      "source": {
        "texte": "Code de l'urbanisme, art. R421-2 d (base de règles lib/urbanisme/demarches.ts)",
        "lien": null
      },
      "version_le": "2026-09-17"
    },
    {
      "cle": "piscine.m2.100",
      "valeur": 100,
      "unite": "m2",
      "objet": "Bassin de piscine de plus de 10 m² et d'au plus 100 m², non couvert ou couvert à moins de 1,80 m : déclaration préalable.",
      "contexte": "urbanisme",
      "groupe": "piscine",
      "nature": "reglementaire",
      "source": {
        "texte": "Code de l'urbanisme, art. R421-9 (base de règles lib/urbanisme/demarches.ts) ; service-public.gouv.fr, fiche F31404",
        "lien": null
      },
      "version_le": "2026-09-17"
    },
    {
      "cle": "piscine.m.1_8",
      "valeur": 1.8,
      "unite": "m",
      "objet": "Hauteur de couverture de piscine à partir de laquelle un permis de construire est exigé.",
      "contexte": "urbanisme",
      "groupe": "piscine",
      "nature": "reglementaire",
      "source": {
        "texte": "Code de l'urbanisme, art. R421-9 (base de règles lib/urbanisme/demarches.ts) ; service-public.gouv.fr, fiche F31404",
        "lien": null
      },
      "version_le": "2026-09-17"
    },
    {
      "cle": "tva_travaux.pct.20",
      "valeur": 20,
      "unite": "pct",
      "objet": "Taux normal de TVA.",
      "contexte": "fiscalite",
      "groupe": "tva_travaux",
      "nature": "reglementaire",
      "source": {
        "texte": "Code général des impôts, art. 278 (20 %), 279-0 bis (10 %) et 278-0 bis A (5,5 %) ; service-public.gouv.fr (Entreprendre), fiche F23568, vérifiée le 21/02/2026",
        "lien": null
      },
      "version_le": "2026-02-21"
    },
    {
      "cle": "tva_travaux.pct.10",
      "valeur": 10,
      "unite": "pct",
      "objet": "Taux intermédiaire de TVA des travaux d'amélioration, de transformation, d'aménagement et d'entretien d'un logement.",
      "contexte": "fiscalite",
      "groupe": "tva_travaux",
      "nature": "reglementaire",
      "source": {
        "texte": "Code général des impôts, art. 278 (20 %), 279-0 bis (10 %) et 278-0 bis A (5,5 %) ; service-public.gouv.fr (Entreprendre), fiche F23568, vérifiée le 21/02/2026",
        "lien": null
      },
      "version_le": "2026-02-21"
    },
    {
      "cle": "tva_travaux.pct.5_5",
      "valeur": 5.5,
      "unite": "pct",
      "objet": "Taux réduit de TVA des travaux de rénovation énergétique d'un logement.",
      "contexte": "fiscalite",
      "groupe": "tva_travaux",
      "nature": "reglementaire",
      "source": {
        "texte": "Code général des impôts, art. 278 (20 %), 279-0 bis (10 %) et 278-0 bis A (5,5 %) ; service-public.gouv.fr (Entreprendre), fiche F23568, vérifiée le 21/02/2026",
        "lien": null
      },
      "version_le": "2026-02-21"
    },
    {
      "cle": "tva_travaux.an.2",
      "valeur": 2,
      "unite": "an",
      "objet": "Ancienneté minimale du logement pour les taux réduits de TVA des travaux.",
      "contexte": "fiscalite",
      "groupe": "tva_travaux",
      "nature": "reglementaire",
      "source": {
        "texte": "Code général des impôts, art. 278 (20 %), 279-0 bis (10 %) et 278-0 bis A (5,5 %) ; service-public.gouv.fr (Entreprendre), fiche F23568, vérifiée le 21/02/2026",
        "lien": null
      },
      "version_le": "2026-02-21"
    },
    {
      "cle": "malraux.an.9",
      "valeur": 9,
      "unite": "an",
      "objet": "Engagement de location nue à usage de résidence principale.",
      "contexte": "fiscalite",
      "groupe": "malraux",
      "nature": "reglementaire",
      "source": {
        "texte": "Code général des impôts, art. 199 tervicies ; BOFiP BOI-IR-RICI-200 (version du 09/04/2026)",
        "lien": null
      },
      "version_le": "2026-04-09"
    },
    {
      "cle": "malraux.pct.22",
      "valeur": 22,
      "unite": "pct",
      "objet": "Taux de la réduction d'impôt.",
      "contexte": "fiscalite",
      "groupe": "malraux",
      "nature": "reglementaire",
      "source": {
        "texte": "Code général des impôts, art. 199 tervicies ; BOFiP BOI-IR-RICI-200 (version du 09/04/2026)",
        "lien": null
      },
      "version_le": "2026-04-09"
    },
    {
      "cle": "malraux.pct.30",
      "valeur": 30,
      "unite": "pct",
      "objet": "Taux de la réduction d'impôt dans un site patrimonial remarquable couvert par un plan de sauvegarde et de mise en valeur.",
      "contexte": "fiscalite",
      "groupe": "malraux",
      "nature": "reglementaire",
      "source": {
        "texte": "Code général des impôts, art. 199 tervicies ; BOFiP BOI-IR-RICI-200 (version du 09/04/2026)",
        "lien": null
      },
      "version_le": "2026-04-09"
    },
    {
      "cle": "malraux.eur.400000",
      "valeur": 400000,
      "unite": "eur",
      "objet": "Plafond des dépenses retenues sur quatre années consécutives.",
      "contexte": "fiscalite",
      "groupe": "malraux",
      "nature": "reglementaire",
      "source": {
        "texte": "Code général des impôts, art. 199 tervicies ; BOFiP BOI-IR-RICI-200 (version du 09/04/2026)",
        "lien": null
      },
      "version_le": "2026-04-09"
    },
    {
      "cle": "malraux.an.4",
      "valeur": 4,
      "unite": "an",
      "objet": "Période du plafond de dépenses.",
      "contexte": "fiscalite",
      "groupe": "malraux",
      "nature": "reglementaire",
      "source": {
        "texte": "Code général des impôts, art. 199 tervicies ; BOFiP BOI-IR-RICI-200 (version du 09/04/2026)",
        "lien": null
      },
      "version_le": "2026-04-09"
    },
    {
      "cle": "pinel.an.6",
      "valeur": 6,
      "unite": "an",
      "objet": "Durée d'engagement de location d'un investissement Pinel (initiale ou maximale).",
      "contexte": "fiscalite",
      "groupe": "pinel",
      "nature": "reglementaire",
      "source": {
        "texte": "Légifrance, article 199 novovicies du code général des impôts",
        "lien": "https://www.legifrance.gouv.fr/codes/article_lc/LEGIARTI000049399676"
      },
      "version_le": "2026-09-14"
    },
    {
      "cle": "pinel.an.9",
      "valeur": 9,
      "unite": "an",
      "objet": "Durée d'engagement de location d'un investissement Pinel (initiale ou maximale).",
      "contexte": "fiscalite",
      "groupe": "pinel",
      "nature": "reglementaire",
      "source": {
        "texte": "Légifrance, article 199 novovicies du code général des impôts",
        "lien": "https://www.legifrance.gouv.fr/codes/article_lc/LEGIARTI000049399676"
      },
      "version_le": "2026-09-14"
    },
    {
      "cle": "pinel.an.12",
      "valeur": 12,
      "unite": "an",
      "objet": "Durée d'engagement de location d'un investissement Pinel (initiale ou maximale).",
      "contexte": "fiscalite",
      "groupe": "pinel",
      "nature": "reglementaire",
      "source": {
        "texte": "Légifrance, article 199 novovicies du code général des impôts",
        "lien": "https://www.legifrance.gouv.fr/codes/article_lc/LEGIARTI000049399676"
      },
      "version_le": "2026-09-14"
    },
    {
      "cle": "deficit_foncier.eur.10700",
      "valeur": 10700,
      "unite": "eur",
      "objet": "Déficit foncier hors intérêts d'emprunt imputable sur le revenu global, par an.",
      "contexte": "fiscalite",
      "groupe": "deficit_foncier",
      "nature": "reglementaire",
      "source": {
        "texte": "Légifrance, article 156 du code général des impôts",
        "lien": "https://www.legifrance.gouv.fr/codes/article_lc/LEGIARTI000043662638"
      },
      "version_le": "2026-09-14"
    },
    {
      "cle": "deficit_foncier.eur.21400",
      "valeur": 21400,
      "unite": "eur",
      "objet": "Plafond rehaussé pour des travaux de rénovation énergétique qui sortent un logement des classes E, F ou G.",
      "contexte": "fiscalite",
      "groupe": "deficit_foncier",
      "nature": "reglementaire",
      "source": {
        "texte": "Légifrance, article 156 du code général des impôts",
        "lien": "https://www.legifrance.gouv.fr/codes/article_lc/LEGIARTI000043662638"
      },
      "version_le": "2026-09-14"
    },
    {
      "cle": "deficit_foncier.an.10",
      "valeur": 10,
      "unite": "an",
      "objet": "Report du déficit foncier sur les revenus fonciers des années suivantes.",
      "contexte": "fiscalite",
      "groupe": "deficit_foncier",
      "nature": "reglementaire",
      "source": {
        "texte": "Légifrance, article 156 du code général des impôts",
        "lien": "https://www.legifrance.gouv.fr/codes/article_lc/LEGIARTI000043662638"
      },
      "version_le": "2026-09-14"
    },
    {
      "cle": "micro_foncier.pct.30",
      "valeur": 30,
      "unite": "pct",
      "objet": "Abattement forfaitaire du micro-foncier.",
      "contexte": "fiscalite",
      "groupe": "micro_foncier",
      "nature": "reglementaire",
      "source": {
        "texte": "Code général des impôts, art. 32 ; BOFiP BOI-RFPI-DECLA-10",
        "lien": null
      },
      "version_le": "2026-09-28"
    },
    {
      "cle": "micro_foncier.eur.15000",
      "valeur": 15000,
      "unite": "eur",
      "objet": "Plafond de revenus fonciers bruts annuels du micro-foncier.",
      "contexte": "fiscalite",
      "groupe": "micro_foncier",
      "nature": "reglementaire",
      "source": {
        "texte": "Code général des impôts, art. 32 ; BOFiP BOI-RFPI-DECLA-10",
        "lien": null
      },
      "version_le": "2026-09-28"
    },
    {
      "cle": "fenetre_mandat.jour.14",
      "valeur": 14,
      "unite": "jour",
      "objet": "Délai après le DPE auquel est mesurée la part des vendeurs qui ont déjà publié (fenêtre de mandat).",
      "contexte": "pre_marche",
      "groupe": "fenetre_mandat",
      "nature": "mesure_pillr",
      "source": {
        "texte": "Mesure Pillr du 13/09/2026 : délai entre le DPE et la première annonce, énoncée dans la règle PRÉ-MARCHÉ du prompt du Hub (lib/hub/agent.ts)",
        "lien": null
      },
      "version_le": "2026-09-13"
    },
    {
      "cle": "fenetre_mandat.jour.30",
      "valeur": 30,
      "unite": "jour",
      "objet": "Délai après le DPE auquel est mesurée la part des vendeurs qui ont déjà publié (fenêtre de mandat).",
      "contexte": "pre_marche",
      "groupe": "fenetre_mandat",
      "nature": "mesure_pillr",
      "source": {
        "texte": "Mesure Pillr du 13/09/2026 : délai entre le DPE et la première annonce, énoncée dans la règle PRÉ-MARCHÉ du prompt du Hub (lib/hub/agent.ts)",
        "lien": null
      },
      "version_le": "2026-09-13"
    },
    {
      "cle": "fenetre_mandat.jour.45",
      "valeur": 45,
      "unite": "jour",
      "objet": "Délai après le DPE auquel est mesurée la part des vendeurs qui ont déjà publié (fenêtre de mandat).",
      "contexte": "pre_marche",
      "groupe": "fenetre_mandat",
      "nature": "mesure_pillr",
      "source": {
        "texte": "Mesure Pillr du 13/09/2026 : délai entre le DPE et la première annonce, énoncée dans la règle PRÉ-MARCHÉ du prompt du Hub (lib/hub/agent.ts)",
        "lien": null
      },
      "version_le": "2026-09-13"
    },
    {
      "cle": "fenetre_mandat.jour.60",
      "valeur": 60,
      "unite": "jour",
      "objet": "Délai après le DPE auquel est mesurée la part des vendeurs qui ont déjà publié (fenêtre de mandat).",
      "contexte": "pre_marche",
      "groupe": "fenetre_mandat",
      "nature": "mesure_pillr",
      "source": {
        "texte": "Mesure Pillr du 13/09/2026 : délai entre le DPE et la première annonce, énoncée dans la règle PRÉ-MARCHÉ du prompt du Hub (lib/hub/agent.ts)",
        "lien": null
      },
      "version_le": "2026-09-13"
    },
    {
      "cle": "fenetre_mandat.jour.90",
      "valeur": 90,
      "unite": "jour",
      "objet": "Délai après le DPE auquel est mesurée la part des vendeurs qui ont déjà publié (fenêtre de mandat).",
      "contexte": "pre_marche",
      "groupe": "fenetre_mandat",
      "nature": "mesure_pillr",
      "source": {
        "texte": "Mesure Pillr du 13/09/2026 : délai entre le DPE et la première annonce, énoncée dans la règle PRÉ-MARCHÉ du prompt du Hub (lib/hub/agent.ts)",
        "lien": null
      },
      "version_le": "2026-09-13"
    },
    {
      "cle": "fenetre_mandat.pct.2",
      "valeur": 2,
      "unite": "pct",
      "objet": "Part des vendeurs qui publient ayant déjà publié à un délai donné après le DPE (fenêtre de mandat).",
      "contexte": "pre_marche",
      "groupe": "fenetre_mandat",
      "nature": "mesure_pillr",
      "source": {
        "texte": "Mesure Pillr du 13/09/2026 : délai entre le DPE et la première annonce, énoncée dans la règle PRÉ-MARCHÉ du prompt du Hub (lib/hub/agent.ts)",
        "lien": null
      },
      "version_le": "2026-09-13"
    },
    {
      "cle": "fenetre_mandat.pct.6",
      "valeur": 6,
      "unite": "pct",
      "objet": "Part des vendeurs qui publient ayant déjà publié à un délai donné après le DPE (fenêtre de mandat).",
      "contexte": "pre_marche",
      "groupe": "fenetre_mandat",
      "nature": "mesure_pillr",
      "source": {
        "texte": "Mesure Pillr du 13/09/2026 : délai entre le DPE et la première annonce, énoncée dans la règle PRÉ-MARCHÉ du prompt du Hub (lib/hub/agent.ts)",
        "lien": null
      },
      "version_le": "2026-09-13"
    },
    {
      "cle": "fenetre_mandat.pct.9",
      "valeur": 9,
      "unite": "pct",
      "objet": "Part des vendeurs qui publient ayant déjà publié à un délai donné après le DPE (fenêtre de mandat).",
      "contexte": "pre_marche",
      "groupe": "fenetre_mandat",
      "nature": "mesure_pillr",
      "source": {
        "texte": "Mesure Pillr du 13/09/2026 : délai entre le DPE et la première annonce, énoncée dans la règle PRÉ-MARCHÉ du prompt du Hub (lib/hub/agent.ts)",
        "lien": null
      },
      "version_le": "2026-09-13"
    },
    {
      "cle": "fenetre_mandat.pct.16",
      "valeur": 16,
      "unite": "pct",
      "objet": "Part des vendeurs qui publient ayant déjà publié à un délai donné après le DPE (fenêtre de mandat).",
      "contexte": "pre_marche",
      "groupe": "fenetre_mandat",
      "nature": "mesure_pillr",
      "source": {
        "texte": "Mesure Pillr du 13/09/2026 : délai entre le DPE et la première annonce, énoncée dans la règle PRÉ-MARCHÉ du prompt du Hub (lib/hub/agent.ts)",
        "lien": null
      },
      "version_le": "2026-09-13"
    },
    {
      "cle": "fenetre_mandat.pct.20",
      "valeur": 20,
      "unite": "pct",
      "objet": "Part des vendeurs qui publient ayant déjà publié à un délai donné après le DPE (fenêtre de mandat).",
      "contexte": "pre_marche",
      "groupe": "fenetre_mandat",
      "nature": "mesure_pillr",
      "source": {
        "texte": "Mesure Pillr du 13/09/2026 : délai entre le DPE et la première annonce, énoncée dans la règle PRÉ-MARCHÉ du prompt du Hub (lib/hub/agent.ts)",
        "lien": null
      },
      "version_le": "2026-09-13"
    },
    {
      "cle": "fenetre_mandat.pct.35",
      "valeur": 35,
      "unite": "pct",
      "objet": "Part des vendeurs qui publient ayant déjà publié à un délai donné après le DPE (fenêtre de mandat).",
      "contexte": "pre_marche",
      "groupe": "fenetre_mandat",
      "nature": "mesure_pillr",
      "source": {
        "texte": "Mesure Pillr du 13/09/2026 : délai entre le DPE et la première annonce, énoncée dans la règle PRÉ-MARCHÉ du prompt du Hub (lib/hub/agent.ts)",
        "lien": null
      },
      "version_le": "2026-09-13"
    },
    {
      "cle": "fenetre_mandat.pct.41",
      "valeur": 41,
      "unite": "pct",
      "objet": "Part des vendeurs qui publient ayant déjà publié à un délai donné après le DPE (fenêtre de mandat).",
      "contexte": "pre_marche",
      "groupe": "fenetre_mandat",
      "nature": "mesure_pillr",
      "source": {
        "texte": "Mesure Pillr du 13/09/2026 : délai entre le DPE et la première annonce, énoncée dans la règle PRÉ-MARCHÉ du prompt du Hub (lib/hub/agent.ts)",
        "lien": null
      },
      "version_le": "2026-09-13"
    },
    {
      "cle": "pack_pre_vente.jour.60",
      "valeur": 60,
      "unite": "jour",
      "objet": "Écart maximal entre le DPE et l'audit énergétique d'un pack de pré-vente.",
      "contexte": "pre_marche",
      "groupe": "pack_pre_vente",
      "nature": "mesure_pillr",
      "source": {
        "texte": "Mesure Pillr du 13/09/2026 (recalibration du pré-marché), énoncée dans la règle PRÉ-MARCHÉ du prompt du Hub (lib/hub/agent.ts)",
        "lien": null
      },
      "version_le": "2026-09-13"
    },
    {
      "cle": "prelevements_sociaux_foncier.pct.17_2",
      "valeur": 17.2,
      "unite": "pct",
      "objet": "Prélèvements sociaux sur les revenus fonciers (location nue).",
      "contexte": "fiscalite",
      "groupe": "prelevements_sociaux_foncier",
      "nature": "parametre_moteur",
      "source": {
        "texte": "Loi de financement de la sécurité sociale pour 2026, art. L136-8 du code de la sécurité sociale",
        "lien": null
      },
      "version_le": null
    },
    {
      "cle": "prelevements_sociaux_meuble.pct.18_6",
      "valeur": 18.6,
      "unite": "pct",
      "objet": "Prélèvements sociaux appliqués par le simulateur aux revenus de location meublée non professionnelle (lecture de la loi de 2026 à confirmer sur le BOFiP).",
      "contexte": "fiscalite",
      "groupe": "prelevements_sociaux_meuble",
      "nature": "parametre_moteur",
      "source": {
        "texte": "Loi de financement de la sécurité sociale pour 2026, art. L136-8 du code de la sécurité sociale",
        "lien": null
      },
      "version_le": null
    },
    {
      "cle": "prelevements_sociaux_plus_value.pct.17_2",
      "valeur": 17.2,
      "unite": "pct",
      "objet": "Prélèvements sociaux sur les plus-values immobilières des particuliers.",
      "contexte": "fiscalite",
      "groupe": "prelevements_sociaux_plus_value",
      "nature": "parametre_moteur",
      "source": {
        "texte": "Loi de financement de la sécurité sociale pour 2026, art. L136-8 du code de la sécurité sociale",
        "lien": null
      },
      "version_le": null
    },
    {
      "cle": "plus_value_impot.pct.19",
      "valeur": 19,
      "unite": "pct",
      "objet": "Impôt sur le revenu des plus-values immobilières des particuliers.",
      "contexte": "fiscalite",
      "groupe": "plus_value_impot",
      "nature": "parametre_moteur",
      "source": {
        "texte": "BOFiP, BOI-RFPI-PVI-20-20",
        "lien": null
      },
      "version_le": null
    },
    {
      "cle": "micro_bic.eur.77700",
      "valeur": 77700,
      "unite": "eur",
      "objet": "Plafond de recettes annuelles du micro-BIC de la location meublée.",
      "contexte": "fiscalite",
      "groupe": "micro_bic",
      "nature": "parametre_moteur",
      "source": {
        "texte": "Loi n° 2024-1039 (dite loi Le Meur), revenus 2025 et suivants",
        "lien": null
      },
      "version_le": null
    },
    {
      "cle": "micro_bic.pct.50",
      "valeur": 50,
      "unite": "pct",
      "objet": "Abattement forfaitaire du micro-BIC de la location meublée.",
      "contexte": "fiscalite",
      "groupe": "micro_bic",
      "nature": "parametre_moteur",
      "source": {
        "texte": "Loi n° 2024-1039 (dite loi Le Meur), revenus 2025 et suivants",
        "lien": null
      },
      "version_le": null
    },
    {
      "cle": "micro_bic_tourisme_non_classe.eur.15000",
      "valeur": 15000,
      "unite": "eur",
      "objet": "Plafond de recettes du micro-BIC d'un meublé de tourisme non classé.",
      "contexte": "fiscalite",
      "groupe": "micro_bic_tourisme_non_classe",
      "nature": "parametre_moteur",
      "source": {
        "texte": "Loi n° 2024-1039 (dite loi Le Meur), revenus 2025 et suivants",
        "lien": null
      },
      "version_le": null
    },
    {
      "cle": "micro_bic_tourisme_non_classe.pct.30",
      "valeur": 30,
      "unite": "pct",
      "objet": "Abattement du micro-BIC d'un meublé de tourisme non classé.",
      "contexte": "fiscalite",
      "groupe": "micro_bic_tourisme_non_classe",
      "nature": "parametre_moteur",
      "source": {
        "texte": "Loi n° 2024-1039 (dite loi Le Meur), revenus 2025 et suivants",
        "lien": null
      },
      "version_le": null
    },
    {
      "cle": "micro_bic_tourisme_classe.eur.77700",
      "valeur": 77700,
      "unite": "eur",
      "objet": "Plafond de recettes du micro-BIC d'un meublé de tourisme classé.",
      "contexte": "fiscalite",
      "groupe": "micro_bic_tourisme_classe",
      "nature": "parametre_moteur",
      "source": {
        "texte": "Loi n° 2024-1039 (dite loi Le Meur), revenus 2025 et suivants",
        "lien": null
      },
      "version_le": null
    },
    {
      "cle": "micro_bic_tourisme_classe.pct.50",
      "valeur": 50,
      "unite": "pct",
      "objet": "Abattement du micro-BIC d'un meublé de tourisme classé.",
      "contexte": "fiscalite",
      "groupe": "micro_bic_tourisme_classe",
      "nature": "parametre_moteur",
      "source": {
        "texte": "Loi n° 2024-1039 (dite loi Le Meur), revenus 2025 et suivants",
        "lien": null
      },
      "version_le": null
    },
    {
      "cle": "impot_societes.pct.15",
      "valeur": 15,
      "unite": "pct",
      "objet": "Taux réduit de l'impôt sur les sociétés.",
      "contexte": "fiscalite",
      "groupe": "impot_societes",
      "nature": "parametre_moteur",
      "source": {
        "texte": "Code général des impôts, art. 219 I",
        "lien": null
      },
      "version_le": null
    },
    {
      "cle": "impot_societes.eur.42500",
      "valeur": 42500,
      "unite": "eur",
      "objet": "Bénéfice imposé au taux réduit de l'impôt sur les sociétés, au plus.",
      "contexte": "fiscalite",
      "groupe": "impot_societes",
      "nature": "parametre_moteur",
      "source": {
        "texte": "Code général des impôts, art. 219 I",
        "lien": null
      },
      "version_le": null
    },
    {
      "cle": "impot_societes.pct.25",
      "valeur": 25,
      "unite": "pct",
      "objet": "Taux normal de l'impôt sur les sociétés.",
      "contexte": "fiscalite",
      "groupe": "impot_societes",
      "nature": "parametre_moteur",
      "source": {
        "texte": "Code général des impôts, art. 219 I",
        "lien": null
      },
      "version_le": null
    },
    {
      "cle": "bailleur_prive_neuf.pct.3_5",
      "valeur": 3.5,
      "unite": "pct",
      "objet": "Taux d'amortissement d'un logement neuf en location intermédiaire (statut du bailleur privé).",
      "contexte": "fiscalite",
      "groupe": "bailleur_prive_neuf",
      "nature": "parametre_moteur",
      "source": {
        "texte": "Légifrance, article 31 du code général des impôts (i et j du 1° du I), rétabli par l'article 47 de la loi n° 2026-103 du 19 février 2026 de finances pour 2026",
        "lien": "https://www.legifrance.gouv.fr/codes/article_lc/LEGIARTI000053544761"
      },
      "version_le": "2026-09-14"
    },
    {
      "cle": "bailleur_prive_neuf.pct.4_5",
      "valeur": 4.5,
      "unite": "pct",
      "objet": "Taux d'amortissement d'un logement neuf en location sociale.",
      "contexte": "fiscalite",
      "groupe": "bailleur_prive_neuf",
      "nature": "parametre_moteur",
      "source": {
        "texte": "Légifrance, article 31 du code général des impôts (i et j du 1° du I), rétabli par l'article 47 de la loi n° 2026-103 du 19 février 2026 de finances pour 2026",
        "lien": "https://www.legifrance.gouv.fr/codes/article_lc/LEGIARTI000053544761"
      },
      "version_le": "2026-09-14"
    },
    {
      "cle": "bailleur_prive_neuf.pct.5_5",
      "valeur": 5.5,
      "unite": "pct",
      "objet": "Taux d'amortissement d'un logement neuf en location très sociale.",
      "contexte": "fiscalite",
      "groupe": "bailleur_prive_neuf",
      "nature": "parametre_moteur",
      "source": {
        "texte": "Légifrance, article 31 du code général des impôts (i et j du 1° du I), rétabli par l'article 47 de la loi n° 2026-103 du 19 février 2026 de finances pour 2026",
        "lien": "https://www.legifrance.gouv.fr/codes/article_lc/LEGIARTI000053544761"
      },
      "version_le": "2026-09-14"
    },
    {
      "cle": "bailleur_prive_ancien.pct.3",
      "valeur": 3,
      "unite": "pct",
      "objet": "Taux d'amortissement d'un logement ancien rénové en location intermédiaire.",
      "contexte": "fiscalite",
      "groupe": "bailleur_prive_ancien",
      "nature": "parametre_moteur",
      "source": {
        "texte": "Légifrance, article 31 du code général des impôts (i et j du 1° du I), rétabli par l'article 47 de la loi n° 2026-103 du 19 février 2026 de finances pour 2026",
        "lien": "https://www.legifrance.gouv.fr/codes/article_lc/LEGIARTI000053544761"
      },
      "version_le": "2026-09-14"
    },
    {
      "cle": "bailleur_prive_ancien.pct.3_5",
      "valeur": 3.5,
      "unite": "pct",
      "objet": "Taux d'amortissement d'un logement ancien rénové en location sociale.",
      "contexte": "fiscalite",
      "groupe": "bailleur_prive_ancien",
      "nature": "parametre_moteur",
      "source": {
        "texte": "Légifrance, article 31 du code général des impôts (i et j du 1° du I), rétabli par l'article 47 de la loi n° 2026-103 du 19 février 2026 de finances pour 2026",
        "lien": "https://www.legifrance.gouv.fr/codes/article_lc/LEGIARTI000053544761"
      },
      "version_le": "2026-09-14"
    },
    {
      "cle": "bailleur_prive_ancien.pct.4",
      "valeur": 4,
      "unite": "pct",
      "objet": "Taux d'amortissement d'un logement ancien rénové en location très sociale.",
      "contexte": "fiscalite",
      "groupe": "bailleur_prive_ancien",
      "nature": "parametre_moteur",
      "source": {
        "texte": "Légifrance, article 31 du code général des impôts (i et j du 1° du I), rétabli par l'article 47 de la loi n° 2026-103 du 19 février 2026 de finances pour 2026",
        "lien": "https://www.legifrance.gouv.fr/codes/article_lc/LEGIARTI000053544761"
      },
      "version_le": "2026-09-14"
    },
    {
      "cle": "bailleur_prive.eur.8000",
      "valeur": 8000,
      "unite": "eur",
      "objet": "Plafond annuel des amortissements déduits par foyer.",
      "contexte": "fiscalite",
      "groupe": "bailleur_prive",
      "nature": "parametre_moteur",
      "source": {
        "texte": "Légifrance, article 31 du code général des impôts (i et j du 1° du I), rétabli par l'article 47 de la loi n° 2026-103 du 19 février 2026 de finances pour 2026",
        "lien": "https://www.legifrance.gouv.fr/codes/article_lc/LEGIARTI000053544761"
      },
      "version_le": "2026-09-14"
    },
    {
      "cle": "bailleur_prive.eur.10000",
      "valeur": 10000,
      "unite": "eur",
      "objet": "Plafond annuel majoré quand la moitié au moins des loyers vient de la location sociale.",
      "contexte": "fiscalite",
      "groupe": "bailleur_prive",
      "nature": "parametre_moteur",
      "source": {
        "texte": "Légifrance, article 31 du code général des impôts (i et j du 1° du I), rétabli par l'article 47 de la loi n° 2026-103 du 19 février 2026 de finances pour 2026",
        "lien": "https://www.legifrance.gouv.fr/codes/article_lc/LEGIARTI000053544761"
      },
      "version_le": "2026-09-14"
    },
    {
      "cle": "bailleur_prive.eur.12000",
      "valeur": 12000,
      "unite": "eur",
      "objet": "Plafond annuel majoré quand la moitié au moins des loyers vient de la location très sociale.",
      "contexte": "fiscalite",
      "groupe": "bailleur_prive",
      "nature": "parametre_moteur",
      "source": {
        "texte": "Légifrance, article 31 du code général des impôts (i et j du 1° du I), rétabli par l'article 47 de la loi n° 2026-103 du 19 février 2026 de finances pour 2026",
        "lien": "https://www.legifrance.gouv.fr/codes/article_lc/LEGIARTI000053544761"
      },
      "version_le": "2026-09-14"
    },
    {
      "cle": "bailleur_prive.pct.30",
      "valeur": 30,
      "unite": "pct",
      "objet": "Part minimale des travaux dans le prix d'acquisition d'un logement ancien.",
      "contexte": "fiscalite",
      "groupe": "bailleur_prive",
      "nature": "parametre_moteur",
      "source": {
        "texte": "Légifrance, article 31 du code général des impôts (i et j du 1° du I), rétabli par l'article 47 de la loi n° 2026-103 du 19 février 2026 de finances pour 2026",
        "lien": "https://www.legifrance.gouv.fr/codes/article_lc/LEGIARTI000053544761"
      },
      "version_le": "2026-09-14"
    },
    {
      "cle": "bailleur_prive.an.9",
      "valeur": 9,
      "unite": "an",
      "objet": "Durée minimale de l'engagement de location nue en résidence principale.",
      "contexte": "fiscalite",
      "groupe": "bailleur_prive",
      "nature": "parametre_moteur",
      "source": {
        "texte": "Légifrance, article 31 du code général des impôts (i et j du 1° du I), rétabli par l'article 47 de la loi n° 2026-103 du 19 février 2026 de finances pour 2026",
        "lien": "https://www.legifrance.gouv.fr/codes/article_lc/LEGIARTI000053544761"
      },
      "version_le": "2026-09-14"
    },
    {
      "cle": "interdiction_location_g.date.2025-01-01",
      "valeur": "2025-01-01",
      "unite": "date",
      "objet": "Premier jour où la location d'un logement classé G au DPE est interdite en métropole (logement non décent).",
      "contexte": "location",
      "groupe": "interdiction_location_g",
      "nature": "reglementaire",
      "source": {
        "texte": "Loi n° 89-462 du 6 juillet 1989, article 6 (niveau de performance d'un logement décent), calendrier de la loi Climat et résilience, en métropole",
        "lien": null
      },
      "version_le": null
    },
    {
      "cle": "interdiction_location_f.date.2028-01-01",
      "valeur": "2028-01-01",
      "unite": "date",
      "objet": "Premier jour où la location d'un logement classé F au DPE est interdite en métropole (logement non décent).",
      "contexte": "location",
      "groupe": "interdiction_location_f",
      "nature": "reglementaire",
      "source": {
        "texte": "Loi n° 89-462 du 6 juillet 1989, article 6 (niveau de performance d'un logement décent), calendrier de la loi Climat et résilience, en métropole",
        "lien": null
      },
      "version_le": null
    },
    {
      "cle": "interdiction_location_e.date.2034-01-01",
      "valeur": "2034-01-01",
      "unite": "date",
      "objet": "Premier jour où la location d'un logement classé E au DPE est interdite en métropole (logement non décent).",
      "contexte": "location",
      "groupe": "interdiction_location_e",
      "nature": "reglementaire",
      "source": {
        "texte": "Loi n° 89-462 du 6 juillet 1989, article 6 (niveau de performance d'un logement décent), calendrier de la loi Climat et résilience, en métropole",
        "lien": null
      },
      "version_le": null
    }
  ],
  "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 28/09/2026.

Réponse

  • relu_letexte

    Date de la dernière relecture du registre des constantes citées par le Hub.

  • contextetexte ou null

    Valeurs : urbanisme, fiscalite, pre_marche, location

  • constantesliste d'objets
    Afficher les 9 champs
    • cletexte

      Identifiant stable : <groupe>.<unité>.<valeur>.

    • valeurvaleur

      Valeur telle que les moteurs l'appliquent (5,5 pour 5,5 %), ou date AAAA-MM-JJ pour une échéance.

    • unitetexte

      pct, m2, m, an, jour, eur ou date.

    • objettexte
    • contextetexte

      Valeurs : urbanisme, fiscalite, pre_marche, location

    • groupetexte

      Le dispositif ou la règle (urbanisme, piscine, tva, malraux, pinel, deficit_foncier, micro_foncier...).

    • naturetexte

      Valeurs : reglementaire, mesure_pillr, parametre_moteur

    • sourceobjet
      Afficher les 2 champs
      • textetexte
      • lientexte ou null
    • version_letexte ou null

      Date de la version lue du texte, ou de la mesure (AAAA-MM-JJ) ; null si le code ne la date pas.

  • 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

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