Estimation

7 opérations servies.

/

Estimation affinée par IA

POST/api/v1/estimations/affinees

La même estimation qu'estimer_bien (même moteur, même sortie), affinée par un modèle de langage à partir de l'état, des qualités, de la description, de l'exposition, des annexes, des équipements et de photos lues sur des liens https publics (JPEG, PNG ou WebP). Rend en plus la liste unique des ajustements, chacun avec sa nature, son pourcentage, son motif et sa source (barème ou IA, chaque ligne IA vérifiée par le serveur), l'état de l'affinage et la lecture des photos. Les photos sont lues le temps de l'appel, jamais écrites ni renvoyées. Une panne de l'IA rend l'estimation déterministe, et le dit.

Coût: 30 crédits par appel réussi
Accès: À l'usage ou avec l'abonnement Data
Portée: estimation
Outil MCP: estimer_bien_affine
Bac à sable: Non
Mémoire: Jamais gardée
Délai: 45 s

Essayer en direct

Paramètres

adressetexte
Adresse du bien en toutes lettres, numéro et commune compris.
de 5 à 160 caractères
code_postaltexte
Code postal, pour départager une adresse homonyme.
inseetexte
Code INSEE de la commune, quand l'adresse n'est pas donnée.
typetexteobligatoire
Valeurs : appartement, maison
surfacenombreobligatoire
Surface habitable, en m².
de 9 à 2 000
piecesentier
de 1 à 30
chambresentier
de 0 à 20
etageentier
Appartement : étage, 0 pour le rez-de-chaussée.
de -1 à 40
etages_immeubleentier
de 0 à 60
ascenseurbooléen
terrain_m2nombre
Maison : surface du terrain, en m².
de 0 à 100 000
dpetexte
Valeurs : A, B, C, D, E, F, G
annee_constructionentier
de 1 700 à 2 030
prix_demandeentier
Prix demandé ou affiché, en euros.
de 10 000 à 50 000 000
loyer_pratiquenombre
Loyer mensuel pratiqué, en euros : remplace le loyer estimé dans le rendement.
100 000 au plus ; plus de 0
etattexte
État d'entretien du bien.
Valeurs : a_renover, travaux, correct, renove, neuf
qualitesliste de textes
Qualités ou défauts du bien, une courte phrase chacun.
20 éléments au plus
descriptiontexte
Description libre du bien.
1 200 caractères au plus
expositiontexte
Valeurs : nord, sud, est, ouest, sud_est, sud_ouest, nord_est, nord_ouest, traversant
annexesobjet
Afficher les 5 champsMasquer
- parkingentier
  de 0 à 3
- garagebooléen
- cavebooléen
- balcon_m2nombre
  de 0 à 200
- terrasse_m2nombre
  de 0 à 500
equipementsliste de textes
Équipements, clés du catalogue de la page /estimation ; une clé inconnue est ignorée.
60 éléments au plus
photosliste de textes
Liens https publics vers des photos du bien (JPEG, PNG ou WebP), 12 au plus, de 1.6 Mo chacune au plus. Aucune redirection n'est suivie.
12 éléments au plus

Exemple d'appel

curl -X POST https://pillr.fr/api/v1/estimations/affinees \
  -H "Authorization: Bearer $PILLR_CLE" \
  -H "Content-Type: application/json" \
  -d '{"type":"appartement","surface":9}'

Réponse

bienobjet
Afficher les 7 champsMasquer
- typetexte
  Valeurs : appartement, maison
- surface_m2nombre
- piecesentier ou null
- communetexte
- code_postaltexte ou null
- inseetexte ou null
- originetexte
  adresse : faits situés à l'adresse donnée ; commune : faits décrits dans la commune.
  Valeurs : adresse, commune
valeurobjet
Afficher les 6 champsMasquer
- basnombre
- valeurnombre
- hautnombre
- prix_m2nombre
- demi_largeur_pctnombre
  Demi-largeur de la fourchette, en % de la valeur.
- qualiteobjet
  Ce qui permet de juger la valeur : nombre, provenance, incertitude, drapeaux, date et source.
  Afficher les 7 champsMasquer
  - 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 champsMasquer
    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.
niveauobjet
Afficher les 7 champsMasquer
- naturetexte
  mesure : ventes DVF réelles ; estime : modèle Pillr, faute de ventes locales du type.
  Valeurs : mesure, estime
- socletexte
  Socle retenu par la cascade : ventes comparables, quartier ou commune.
  Valeurs : comparables_dvf, iris, commune
- libelletexte
- ventesentier
- rayon_mnombre ou null
- millesimeentier ou null
- prix_m2_soclenombre
  Prix au m² du socle, avant les ajustements du bien.
fiabilitetexte
Valeurs : elevee, correcte, limitee
comparablesobjet
Afficher les 4 champsMasquer
- nentier
- prix_m2_mediannombre ou null
- millesimesliste d'entiers
- ventesliste d'objets
  Ventes DVF retenues, avec leur adresse DVF quand elle est retrouvée et leurs coordonnées. Vide sans adresse précise ou faute de ventes assez proches.
  Afficher les 12 champsMasquer
  - datetexte
  - typetexte
    Valeurs : appartement, maison
  - surface_m2nombre
  - prixnombre
  - prix_m2nombre
  - distance_mnombre ou null
    Distance au bien, arrondie à 50 m.
  - millesimeentier
  - adressetexte ou null
    Adresse DVF de la vente (numéro et voie), relue au lac par la commune, la date et le prix ; null si la vente est introuvable, ambiguë ou sans numéro.
  - code_postaltexte ou null
  - id_mutationtexte ou null
    Identifiant DVF de la mutation, quand l'adresse a été retrouvée.
  - latnombre ou null
    Latitude DVF de la vente (open data).
  - lonnombre ou null
    Longitude DVF de la vente (open data).
loyerobjet ou null
Afficher les 6 champsMasquer
- mensuelnombre
- basnombre ou null
- hautnombre ou null
- naturetexte
  observe_commune : loyer d'annonce observé dans la commune ; predit_maille : prédit à la maille de la Carte des loyers.
  Valeurs : observe_commune, predit_maille
- charges_comprisesbooléen
  Loyer d'annonce de la Carte des loyers, charges comprises.
- qualiteobjet
  Ce qui permet de juger la valeur : nombre, provenance, incertitude, drapeaux, date et source.
  Afficher les 7 champsMasquer
  - 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 champsMasquer
    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.
rendementobjet ou null
null sans loyer estimé ni loyer pratiqué.
Afficher les 7 champsMasquer
- surtexte
  Prix sur lequel les rendements sont calculés.
  Valeurs : prix_demande, valeur_estimee
- prixnombre
- loyertexte
  Loyer retenu : celui donné par l'appelant, ou le loyer estimé.
  Valeurs : pratique, estime
- loyer_mensuelnombre
- brut_pctnombre
  12 fois le loyer mensuel, divisé par le prix, en %.
- frais_notairenombre
  Frais d'acquisition retenus : 8 % du prix, en euros.
- net_hors_travaux_pctnombre
  85 % de 12 fois le loyer mensuel, divisés par le prix augmenté des frais, en %. Aucun budget de travaux n'est compté : cette opération n'en estime pas.
prix_demandeobjet ou null
Le prix demandé situé face au marché ; null sans prix demandé.
Afficher les 7 champsMasquer
- prixnombre
- prix_m2nombre
- ecart_pctnombre
  Écart du prix demandé à la valeur estimée, en % (positif : plus cher).
- positiontexte
  Valeurs : sous_la_fourchette, dans_la_fourchette, au_dessus_de_la_fourchette
- annonces_en_venteobjet ou null
  Annonces comparables en vente dans la commune (prix affichés) ; null quand elles sont trop peu nombreuses.
  Afficher les 3 champsMasquer
  - nentier
  - prix_m2_mediannombre
  - part_moins_cheres_pctnombre
- baissesobjet ou null
  Annonces comparables du secteur dont le prix a baissé, sans remontée ; null quand elles sont trop peu nombreuses.
  Afficher les 5 champsMasquer
  - biensentier
  - annonces_suiviesentier
  - baisse_mediane_pctnombre
  - prix_m2_median_apres_baissenombre
  - fenetre_joursentier
- retraitsobjet ou null
  Annonces comparables retirées de la vente (vendues, expirées ou retirées, sans distinction possible) ; null quand elles sont trop peu nombreuses.
  Afficher les 3 champsMasquer
  - biensentier
  - dernier_prix_m2_mediannombre
  - fenetre_joursentier
dpeobjet ou null
null sans étiquette DPE donnée.
Afficher les 4 champsMasquer
- classetexte
  Valeurs : A, B, C, D, E, F, G
- interdiction_locationtexte ou null
  Premier jour où la location d'un logement de cette classe est interdite (AAAA-MM-JJ), selon le calendrier de la loi Climat et résilience en métropole (G 2025, F 2028, E 2034). null : classe sans échéance, DPE absent, ou adresse hors de la métropole (le calendrier des outre-mer n'est pas servi).
- mois_restantsentier ou null
  Mois pleins avant l'échéance ; 0 quand l'interdiction est déjà en vigueur ; null sans échéance.
- sortieobjet ou null
  Coût de sortie d'une passoire (classe E, F ou G) vers D, C ou B, mesuré sur les audits énergétiques réglementaires de l'ADEME pour des logements comparables. null hors des classes E à G, pour un type de logement sans comparable, ou hors de la métropole.
  Afficher les 4 champsMasquer
  - classe_departtexte
    Valeurs : E, F, G
  - ciblesliste d'objets
    Afficher les 9 champsMasquer
    verstexte
    Classe visée.
    Valeurs : D, C, B
    n_auditsentier
    Nombre d'audits comparables de la cellule retenue.
    eurosobjet
    Coût des travaux chiffré par les audits comparables, sur leurs propres surfaces, en euros arrondis à la centaine.
    Afficher les 3 champsMasquer
    medianenombre
    p25nombre
    p75nombre
    eur_m2objet ou null
    Le même coût rapporté à la surface habitable, en euros par m² ; null s'il y a trop peu d'audits avec surface.
    Afficher les 3 champsMasquer
    medianenombre
    p25nombre
    p75nombre
    surface_mediane_m2nombre ou null
    Surface habitable médiane des logements audités.
    pour_la_surfaceobjet ou null
    Le coût au m² des audits appliqué à la surface du bien, quand elle est connue : le chiffre à citer.
    Afficher les 4 champsMasquer
    surface_m2nombre
    medianenombre
    p25nombre
    p75nombre
    part_au_delanombre ou null
    Part des audits (0 à 1) dont l'étape chiffrée atteint déjà la classe suivante : le chiffrage dépasse alors la cible.
    perimetretexte
    Les audits comparables, en clair (type de logement, zone climatique, période de construction).
    niveautexte
    Finesse de la cellule retenue, de la plus fine (type, zone climatique et période) à la plus large (type seul, France métropolitaine).
    Valeurs : complet, sans_periode, sans_zone, national
  - lecturetexte
    Ce que mesure le chiffre : une estimation d'auditeur, pas un devis.
  - sourcetexte
erreurtexte
L'erreur de la méthode, telle que le moteur la publie.
limitesliste de textes
mentiontexte
sourcesliste de textes
calcule_letexte
ajustementsliste d'objets
La liste unique des ajustements appliqués, une ligne par nature.
Afficher les 5 champsMasquer
- naturetexte
  Nature de l'ajustement (surface, etage, dpe, etat_general, prestations...).
- libelletexte
- pctnombre
  Points de pourcentage appliqués au prix de référence du secteur.
- motiftexte ou null
- sourcetexte
  bareme : repère calculé sur nos données ; ia : lecture de la description ou des photos, vérifiée par le serveur.
  Valeurs : bareme, ia
affinageobjet
Afficher les 3 champsMasquer
- appliquebooléen
- modeletexte ou null
  Modèle de langage qui a relu le dossier, quand l'affinage a tourné.
- raisontexte
visionobjet ou null
La lecture des photos ; null sans photo.
Afficher les 6 champsMasquer
- disponiblebooléen
- photos_recuesentier
- photos_analyseesentier
- equipementsliste de textes
  Équipements reconnus sur les photos (catalogue de la page /estimation).
- constatsliste de textes
  Constats factuels tirés des photos, sans prix ni pourcentage.
- raison_indisponibletexte 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 champsMasquer
- debitesentier
  0 au moins
- restantsentier ou null

Erreurs possibles

400parametres_invalidesUn paramètre manque ou ne passe pas son contrôle ; le détail est donné champ par champ
415type_contenuLe corps n'est pas envoyé en application/json
400corps_illisibleLe corps n'est pas un JSON lisible
413corps_trop_lourdLe corps dépasse la taille permise
401cle_absenteL'en-tête Authorization manque
401cle_invalideLa clé est inconnue, révoquée ou expirée
403organisation_suspendueL'organisation de la clé n'est pas active
403portee_insuffisanteLa clé ou l'accès de l'organisation n'ouvre pas cette opération
403hors_bac_a_sableUne clé pk_test_ l'appelle : l'opération n'a pas de bac à sable
402credits_insuffisantsLes crédits ne suffisent plus pour cet appel
429plafond_cleLe plafond mensuel de crédits de la clé est atteint
429quota_minuteLe débit par minute de l'organisation est atteint
503charge_globaleL'API est momentanément surchargée, tous clients confondus ; rien n'est débité
504delai_depasseLe calcul dépasse le délai de l'opération ; rien n'est débité
503service_indisponibleL'API est momentanément indisponible
500erreur_interneUne erreur de notre côté ; rien n'est servi ni débité

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

Terrain de référence d'une maison

GET/api/v1/communes/{insee}/terrain-reference

GET/api/v1/departements/{code}/terrain-reference

La surface de terrain médiane d'une maison vendue dans le département, pour le type de commune (groupe déduit du zonage ABC et de la population), telle que le moteur d'estimation la retient : c'est le terrain que le prix du secteur porte déjà. Le niveau dit si la cellule département et groupe est mesurée ou si la médiane nationale du groupe sert de repli. Par commune (code INSEE), ou par département avec le groupe.

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

Essayer en direct

Paramètres de /api/v1/communes/{insee}/terrain-reference

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

Paramètres de /api/v1/departements/{code}/terrain-reference

codetexteobligatoire
Code du département (01 à 95, 2A, 2B, 971 à 976).
groupetexteobligatoire
Groupe de communes, pour une demande par département : tendu (zones A et B1), B2, C_bourg ou C_rural.
Valeurs : tendu, B2, C_bourg, C_rural

Exemple d'appel

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

Réponse

m2nombre
Surface de terrain médiane d'une maison vendue, en m².
groupetexte
Valeurs : tendu, B2, C_bourg, C_rural
libelle_groupetexte
niveautexte
departement : cellule mesurée du département ; national : médiane nationale du groupe, faute de ventes assez nombreuses dans la cellule.
Valeurs : departement, national
departementtexte
communeobjet ou null
La commune demandée et ce qui fixe son groupe ; null pour une demande par département.
Afficher les 4 champsMasquer
- inseetexte
- nomtexte ou null
- zone_abctexte ou null
- populationnombre ou null
mesureobjet
Afficher les 4 champsMasquer
- ventes_totalentier
  Ventes DVF d'une maison seule retenues pour toute la table.
- millesimeentier
- mesure_letexte
- seuil_celluleentier
  Ventes minimales d'une cellule département et groupe.
qualiteobjet
Ce qui permet de juger la valeur : nombre, provenance, incertitude, drapeaux, date et source.
Afficher les 7 champsMasquer
- 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 champsMasquer
  - 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 champsMasquer
- debitesentier
  0 au moins
- restantsentier ou null

Erreurs possibles

400parametres_invalidesUn paramètre manque ou ne passe pas son contrôle ; le détail est donné champ par champ
401cle_absenteL'en-tête Authorization manque
401cle_invalideLa clé est inconnue, révoquée ou expirée
403organisation_suspendueL'organisation de la clé n'est pas active
403portee_insuffisanteLa clé ou l'accès de l'organisation n'ouvre pas cette opération
403hors_bac_a_sableUne clé pk_test_ demande une entrée hors du jeu figé de l'opération
402credits_insuffisantsLes crédits ne suffisent plus pour cet appel
429plafond_cleLe plafond mensuel de crédits de la clé est atteint
429quota_minuteLe débit par minute de l'organisation est atteint
503charge_globaleL'API est momentanément surchargée, tous clients confondus ; rien n'est débité
504delai_depasseLe calcul dépasse le délai de l'opération ; rien n'est débité
503service_indisponibleL'API est momentanément indisponible
500erreur_interneUne erreur de notre côté ; rien n'est servi ni débité

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

Rendement, cash-flow et crédit

POST/api/v1/simulations/rendement

Simulation d'un investissement locatif avec le moteur du simulateur de la fiche annonce de pillr.fr : pour la location nue, la location meublée longue durée et la courte durée, loyer, rendements brut et net, mensualité du crédit, cash-flow mensuel avant et après l'impôt de la première année (régime le moins imposé), décomposé poste par poste, et projection année par année. Recommandation sur le cash-flow avant impôt et sur le TRI après impôt et revente, taux d'effort au sens du HCSF quand les revenus sont donnés. Le loyer est celui donné, sinon le loyer de marché de la commune ; la courte durée suit le profil de marché AirDNA et le statut réglementaire de la commune. Les frais d'acquisition suivent le barème du département. Calcul déterministe, aucun conseil fiscal.

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

Essayer en direct

Paramètres

prixentierobligatoire
Prix d'achat hors frais, en euros.
de 10 000 à 50 000 000
surfacenombreobligatoire
Surface habitable, en m².
1 000 au plus ; plus de 0
inseetexte
Commune du bien : loyer de marché, vacance, courte durée, réglementation et frais d'acquisition du département.
loyernombre
Loyer mensuel en location nue, en euros ; sans lui, le loyer de marché de la commune.
100 000 au plus ; plus de 0
travauxnombre
Budget de travaux, en euros (0 par défaut).
de 0 à 10 000 000
mobiliernombre
Budget mobilier d'une location meublée, en euros.
de 0 à 1 000 000
apportnombre
Apport en euros, rapporté à l'investissement de la location nue.
de 0 à 50 000 000
apport_pctnombre
Apport en % de l'investissement (à la place d'apport).
de 0 à 100
tauxnombre
Taux du crédit, en % par an.
de 0 à 15
dureeentier
Durée du crédit, en années.
de 1 à 30
chargesnombre
Charges non récupérables, en euros par mois.
de 0 à 20 000
taxe_foncierenombre
Taxe foncière, en euros par an.
de 0 à 200 000
tminombre
Tranche marginale d'imposition, en %.
de 0 à 45
revenusnombre
Revenus nets mensuels du foyer, pour le taux d'effort.
10 000 000 au plus ; plus de 0
credits_en_coursnombre
Mensualités des crédits en cours, en euros.
de 0 à 1 000 000
typetexte
Valeurs : appartement, maison
chambresentier
Chambres : capacité d'accueil en courte durée.
de 0 à 20
dpetexte
Étiquette DPE : statut réglementaire de la courte durée.
Valeurs : A, B, C, D, E, F, G
neufbooléen
horizonentier
Années de projection et de TRI.
de 1 à 30
lcd_classebooléen
Courte durée : meublé de tourisme classé (oui par défaut).
lcd_conciergeriebooléen
Courte durée : gestion par une conciergerie (oui par défaut).
lcd_occupation_pctnombre
Courte durée : occupation imposée, en % des nuits ouvertes.
de 0 à 100
lcd_autorisebooléen
Courte durée : autorisation de changement d'usage obtenue.

Exemple d'appel

curl -X POST https://pillr.fr/api/v1/simulations/rendement \
  -H "Authorization: Bearer $PILLR_CLE" \
  -H "Content-Type: application/json" \
  -d '{"prix":10000,"surface":1}'

Réponse

hypothesesobjet
Afficher les 18 champsMasquer
- prixnombre
- surface_m2nombre
- communetexte ou null
- inseetexte ou null
- travauxnombre
- mobiliernombre
- apport_pctnombre
- taux_pctnombre
- duree_ansentier
- charges_mensuellesnombre
- taxe_foncierenombre
- tmi_pctnombre
- frais_acquisitionnombre
- frais_acquisition_sourcetexte
- loyer_mensuel_nunombre
- loyer_sourcetexte
  donne : le loyer de l'appelant ; marche_commune : loyer de marché au m² de la commune multiplié par la surface.
  Valeurs : donne, marche_commune
- vacance_pctnombre
- horizon_ansentier
strategiesliste d'objets
Afficher les 18 champsMasquer
- cletexte
  lld_nue : location nue ; lld_meublee : location meublée longue durée (LMNP) ; lcd : location courte durée (meublé de tourisme).
  Valeurs : lld_nue, lld_meublee, lcd
- libelletexte
- loyer_mensuelnombre
- loyer_annuelnombre
- rendement_brut_pctnombre
  Loyer annuel sur investissement total (prix, frais, travaux, mobilier), en %.
- rendement_net_pctnombre
  Loyer annuel moins charges, vacance et gestion, sur investissement total, en %.
- investissement_totalnombre
- empruntnombre
- mensualitenombre
- charges_annuellesnombre
- vacance_pctnombre
- gestion_pctnombre
- regime_annee1objet
  Afficher les 4 champsMasquer
  - cletexte
  - libelletexte
  - impot_annuelnombre
  - base_imposablenombre
- cashflow_mensuelobjet
  Afficher les 2 champsMasquer
  - avant_impotnombre
  - apres_impotnombre
- decompositionobjet
  Montants mensuels en euros, les coûts en positif : loyer moins mensualité, charges, taxe foncière et vacance et gestion égale le cash-flow avant impôt ; moins l'impôt, le cash-flow après impôt.
  Afficher les 8 champsMasquer
  - loyernombre
  - mensualitenombre
  - chargesnombre
  - taxe_foncierenombre
  - vacance_et_gestionnombre
    Vacance locative, gestion et arrondis du moteur : le reste du cash-flow avant impôt.
  - cashflow_avant_impotnombre
  - impotnombre
    Impôt mensuel du régime de l'année 1 ; négatif : économie d'impôt (déficit foncier).
  - cashflow_apres_impotnombre
- projectionliste d'objets
  Afficher les 4 champsMasquer
  - anneeentier
  - cashflow_annuelnombre
  - cashflow_cumulenombre
  - capital_restant_dunombre
- recommandablebooléen
  Faux pour une courte durée que la réglementation locale ou le DPE ferment.
- courte_dureeobjet ou null
  Afficher les 10 champsMasquer
  - prix_nuitnombre
  - occupation_pctnombre
  - nuits_ouvertesentier
  - nuits_reserveesentier
  - capaciteentier
  - revenu_annee1nombre
    Revenu de la première année (montée en charge).
  - revenu_croisierenombre
    Revenu annuel en régime de croisière.
  - confiancetexte
    Valeurs : mesure, estime, faible
  - sourcetexte
    Provenance du profil de marché : marché AirDNA de la commune, profil départemental ou national, anciennes colonnes, ou repli sur le loyer nu.
  - statut_reglementaireobjet
    Afficher les 4 champsMasquer
    niveautexte
    Valeurs : libre, declaration, autorisation, compensation, dpe
    recommandablebooléen
    titretexte
    textetexte
recommandeeobjet
Afficher les 2 champsMasquer
- avant_impottexte
  Meilleur cashflow mensuel avant impôt, parmi les stratégies recommandables.
  Valeurs : lld_nue, lld_meublee, lcd
- apres_impotobjet ou null
  Meilleur TRI après impôt et revente sur l'horizon, régime le plus favorable de chaque stratégie.
  Afficher les 4 champsMasquer
  - cletexte
    lld_nue : location nue ; lld_meublee : location meublée longue durée (LMNP) ; lcd : location courte durée (meublé de tourisme).
    Valeurs : lld_nue, lld_meublee, lcd
  - horizon_ansentier
  - tri_pctnombre ou null
  - regimetexte
syntheseobjet
Afficher les 5 champsMasquer
- strategietexte
  lld_nue : location nue ; lld_meublee : location meublée longue durée (LMNP) ; lcd : location courte durée (meublé de tourisme).
  Valeurs : lld_nue, lld_meublee, lcd
- rendement_brut_pctnombre
- rendement_net_pctnombre
- mensualitenombre
- cashflow_mensuelobjet
  Afficher les 2 champsMasquer
  - avant_impotnombre
  - apres_impotnombre
hcsfobjet ou null
Taux d'effort au sens du Haut Conseil de stabilité financière ; null sans revenus.
Afficher les 6 champsMasquer
- revenus_mensuelsnombre
- mensualitesnombre
  Mensualité de la stratégie de la synthèse, plus les crédits en cours.
- taux_effort_pctnombre
- seuil_pctnombre
- conformebooléen
- mensualite_maxnombre
avertissementsliste de textes
qualiteobjet
Ce qui permet de juger la valeur : nombre, provenance, incertitude, drapeaux, date et source.
Afficher les 7 champsMasquer
- 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 champsMasquer
  - 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 champsMasquer
- debitesentier
  0 au moins
- restantsentier ou null

Erreurs possibles

400parametres_invalidesUn paramètre manque ou ne passe pas son contrôle ; le détail est donné champ par champ
415type_contenuLe corps n'est pas envoyé en application/json
400corps_illisibleLe corps n'est pas un JSON lisible
413corps_trop_lourdLe corps dépasse la taille permise
401cle_absenteL'en-tête Authorization manque
401cle_invalideLa clé est inconnue, révoquée ou expirée
403organisation_suspendueL'organisation de la clé n'est pas active
403portee_insuffisanteLa clé ou l'accès de l'organisation n'ouvre pas cette opération
403hors_bac_a_sableUne clé pk_test_ demande une entrée hors du jeu figé de l'opération
402credits_insuffisantsLes crédits ne suffisent plus pour cet appel
429plafond_cleLe plafond mensuel de crédits de la clé est atteint
429quota_minuteLe débit par minute de l'organisation est atteint
503charge_globaleL'API est momentanément surchargée, tous clients confondus ; rien n'est débité
504delai_depasseLe calcul dépasse le délai de l'opération ; rien n'est débité
503service_indisponibleL'API est momentanément indisponible
500erreur_interneUne erreur de notre côté ; rien n'est servi ni débité

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

Taux de crédit du moment

GET/api/v1/taux-credit

Taux de crédit immobilier du moment par durée (bon taux, très bon taux, taux excellent), lus dans le tableau du baromètre public de meilleurtaux.com, avec la date de sa simulation. Lecture d'une page tierce sans API ni contrat : si le tableau change de forme ou ne répond pas, l'opération répond « donnée indisponible », jamais un taux de repli. Réponse gardée 6 heures.

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

Essayer en direct

Paramètres

Aucun.

Exemple d'appel

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

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

Réponse du bac à sable

{
  "taux": [
    {
      "duree_ans": 15,
      "bon_pct": 3.77,
      "tres_bon_pct": 3.56,
      "excellent_pct": 3.3
    },
    {
      "duree_ans": 20,
      "bon_pct": 3.85,
      "tres_bon_pct": 3.69,
      "excellent_pct": 3.4
    },
    {
      "duree_ans": 25,
      "bon_pct": 4,
      "tres_bon_pct": 3.8,
      "excellent_pct": 3.5
    }
  ],
  "simulation_du": "2026-10-12",
  "lu_le": "2026-10-18T20:49:34.469Z",
  "source": "Meilleurtaux, baromètre public des taux immobiliers",
  "url": "https://www.meilleurtaux.com/credit-immobilier/barometre-des-taux.html",
  "qualite": {
    "n": null,
    "provenance": "mesure",
    "incertitude": null,
    "drapeaux": [],
    "methode": "tableau du baromètre lu par ses en-têtes ; taux nominaux hors assurance publiés par le courtier",
    "donnees_du": "2026-10-12",
    "source": "Meilleurtaux, baromètre public des taux immobiliers"
  },
  "credits": {
    "debites": 0,
    "restants": null
  }
}

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

Réponse

tauxliste d'objets
Taux nominaux par durée, hors assurance, tels que le baromètre les publie.
Afficher les 4 champsMasquer
- duree_ansentier
- bon_pctnombre ou null
  « Bon taux » du baromètre, en % par an.
- tres_bon_pctnombre ou null
  « Très bon taux » du baromètre, en % par an.
- excellent_pctnombre ou null
  « Taux excellent » du baromètre, en % par an.
simulation_dutexte ou null
Date de la simulation publiée par le baromètre (AAAA-MM-JJ).
lu_letexte
Horodatage de la lecture de la page.
sourcetexte
urltexte
qualiteobjet
Ce qui permet de juger la valeur : nombre, provenance, incertitude, drapeaux, date et source.
Afficher les 7 champsMasquer
- 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 champsMasquer
  - 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 champsMasquer
- debitesentier
  0 au moins
- restantsentier ou null

Erreurs possibles

400parametres_invalidesUn paramètre manque ou ne passe pas son contrôle ; le détail est donné champ par champ
401cle_absenteL'en-tête Authorization manque
401cle_invalideLa clé est inconnue, révoquée ou expirée
403organisation_suspendueL'organisation de la clé n'est pas active
403portee_insuffisanteLa clé ou l'accès de l'organisation n'ouvre pas cette opération
403hors_bac_a_sableUne clé pk_test_ demande une entrée hors du jeu figé de l'opération
402credits_insuffisantsLes crédits ne suffisent plus pour cet appel
429plafond_cleLe plafond mensuel de crédits de la clé est atteint
429quota_minuteLe débit par minute de l'organisation est atteint
503charge_globaleL'API est momentanément surchargée, tous clients confondus ; rien n'est débité
504delai_depasseLe calcul dépasse le délai de l'opération ; rien n'est débité
503service_indisponibleL'API est momentanément indisponible
500erreur_interneUne erreur de notre côté ; rien n'est servi ni débité

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

Simulation fiscale sur l'horizon de détention

POST/api/v1/fiscal/simulations

Simulation fiscale déterministe d'un investissement locatif, décrit ou désigné par une annonce, avec le moteur du simulateur de pillr.fr et de l'agent du Hub : location nue, meublée longue durée et courte durée, chacune évaluée sous chacun de ses régimes (micro-foncier, réel avec déficit, bailleur privé, micro-BIC, micro-BIC classé, réel LMNP, SCI à l'IS). Pour chaque régime : impôt et cash-flow année par année, revente nette et impôt de plus-value, TRI, VAN, enrichissement, et le motif d'un régime inaccessible. Recommandation motivée au meilleur TRI après impôt, prix maximum pour un TRI visé et pour un cash-flow nul, test de résistance, contraintes locales. Règles fiscales codées dans le moteur et citées dans ses avertissements ; aucun conseil fiscal.

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

Essayer en direct

Paramètres

annoncetexte
Annonce du catalogue : prix, surface, type, commune, DPE, chambres, loyer estimé et travaux servent de défaut.
de 3 à 200 caractères
prixentier
Prix d'achat hors frais, en euros.
de 10 000 à 50 000 000
surfacenombre
1 000 au plus ; plus de 0
inseetexte
Commune : loyer de marché, vacance, courte durée, réglementation, frais d'acquisition du département.
loyernombre
Loyer mensuel en location nue, en euros ; sans lui, le loyer estimé de l'annonce ou le loyer de marché.
100 000 au plus ; plus de 0
typetexte
Valeurs : appartement, maison
neufbooléen
dpetexte
Valeurs : A, B, C, D, E, F, G
chambresentier
de 0 à 20
travauxnombre
de 0 à 10 000 000
mobiliernombre
de 0 à 1 000 000
apport_pctnombre
Apport, en % de l'investissement.
de 0 à 100
tauxnombre
Taux du crédit, en % par an.
de 0 à 15
dureeentier
Durée du crédit, en années.
de 1 à 30
tminombre
Tranche marginale d'imposition, en %.
de 0 à 45
chargesnombre
Charges non récupérables, en euros par mois.
de 0 à 20 000
taxe_foncierenombre
Taxe foncière, en euros par an.
de 0 à 200 000
horizonentier
Années de détention avant revente.
de 1 à 35
bailleur_prive_loyertexte
Niveau de loyer du statut du bailleur privé.
Valeurs : intermediaire, social, tres_social
sci_distribuebooléen
SCI à l'IS : résultats distribués (sinon capitalisés).
lcd_classebooléen
lcd_conciergeriebooléen
lcd_occupation_pctnombre
de 0 à 100
lcd_autorisebooléen
valorisation_pctnombre
Valorisation annuelle du bien, en %.
de -10 à 15
hausse_loyer_pctnombre
Hausse annuelle des loyers, en %.
de -10 à 15
tri_vise_pctnombre
TRI visé pour le prix maximum, en %.
de 0 à 30

Exemple d'appel

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

Réponse

annoncetexte ou null
bientexte ou null
hypothesesobjet
Afficher les 19 champsMasquer
- prix_eurnombre
- surface_m2nombre
- type_bientexte
- neufbooléen
- travaux_eurnombre
- mobilier_eurnombre
- apport_pctnombre
- taux_credit_pctnombre
- duree_credit_ansnombre
- tmi_pctnombre
- charges_mensuelles_eurnombre
- taxe_fonciere_eur_annombre
- frais_acquisition_eurnombre ou null
- frais_acquisition_sourcetexte ou null
- horizon_ansentier
- valorisation_pctnombre ou null
  Valorisation annuelle du bien retenue ; null : celle du moteur.
- hausse_loyer_pctnombre ou null
  Hausse annuelle des loyers retenue ; null : celle du moteur.
- source_loyertexte
- source_lcdtexte
strategiesliste d'objets
Afficher les 13 champsMasquer
- strategietexte
- cletexte
  lld_nue : location nue ; lld_meublee : location meublée longue durée (LMNP) ; lcd : location courte durée (meublé de tourisme).
  Valeurs : lld_nue, lld_meublee, lcd
- loyer_mensuel_eurnombre
- rendement_brut_pctnombre
- rendement_net_avant_impot_pctnombre
- cashflow_mensuel_avant_impot_eurnombre
- investissement_total_eurnombre
- apport_eurnombre ou null
- mensualite_credit_eurnombre
- regime_conseilleobjet ou null
  Afficher les 11 champsMasquer
  - regimetexte
  - cletexte
    Régime fiscal : micro-foncier, réel foncier, bailleur privé (Relance logement), micro-BIC, micro-BIC classé, réel LMNP, SCI à l'IS.
    Valeurs : micro_foncier, reel_foncier, bailleur_prive, micro_bic, micro_bic_classe, reel_bic_lmnp, sci_is
  - tri_pctnombre ou null
  - rendement_net_net_annee1_pctnombre ou null
  - cashflow_mensuel_apres_impot_annee1_eurnombre
  - cashflow_cumule_apres_impot_eurnombre
  - impot_total_horizon_eurnombre
  - revente_nette_eurnombre
  - enrichissement_eurnombre
  - annees_sans_impotentier
  - cotisations_sociales_eurnombre ou null
- raisonsliste de textes
- regimesliste d'objets
  Afficher les 18 champsMasquer
  - regimetexte
  - cletexte
    Régime fiscal : micro-foncier, réel foncier, bailleur privé (Relance logement), micro-BIC, micro-BIC classé, réel LMNP, SCI à l'IS.
    Valeurs : micro_foncier, reel_foncier, bailleur_prive, micro_bic, micro_bic_classe, reel_bic_lmnp, sci_is
  - eligiblebooléen
  - inaccessiblebooléen
    Vrai si le régime n'est pas ouvert à ce bien ; raison dit pourquoi.
  - raisontexte
  - impot_annee1_eurnombre
  - base_imposable_annee1_eurnombre
  - cashflow_mensuel_apres_impot_annee1_eurnombre
  - tri_pctnombre ou null
  - van_eurnombre
    Valeur actuelle nette des flux de l'investisseur sur l'horizon.
  - impot_total_horizon_eurnombre
  - cotisations_sociales_eurnombre ou null
    Meublé de tourisme au-delà du seuil de recettes : cotisations sociales, déjà comprises dans l'impôt.
  - cashflow_cumule_apres_impot_eurnombre
  - annees_sans_impotentier
  - reventeobjet
    Afficher les 5 champsMasquer
    prix_eurnombre
    capital_restant_du_eurnombre
    impot_eurnombre
    Impôt sur la plus-value de revente (ou plus-value professionnelle de la SCI).
    amortissements_reintegres_eurnombre
    net_apres_credit_eurnombre
  - enrichissement_eurnombre
  - notesliste de textes
  - anneesliste d'objets
    Afficher les 16 champsMasquer
    anneeentier
    loyer_brutnombre
    loyer_encaissenombre
    chargesnombre
    interetsnombre
    capital_remboursenombre
    base_imposablenombre
    impotnombre
    Impôt de l'année (impôt sur le revenu et prélèvements sociaux, ou IS) ; négatif : économie d'impôt sur le revenu global.
    cashflow_avant_impotnombre
    cashflow_apres_impotnombre
    cumul_apres_impotnombre
    amortissement_deduitnombre
    reportnombre
    Déficits ou amortissements en report à la fin de l'année.
    capital_restant_dunombre
    valeur_biennombre
    enrichissementnombre
- courte_dureeobjet ou null
  Afficher les 16 champsMasquer
  - prix_nuit_eurnombre
  - occupation_pctnombre
  - nuits_reserveesentier
  - nuits_ouvertesentier
  - rotationsentier
  - capaciteentier
  - revenu_annee1_eurnombre
  - revenu_croisiere_eurnombre
  - ratio_vs_loyer_nunombre ou null
  - confiancetexte
  - sourcetexte
  - marcheobjet
    Afficher les 9 champsMasquer
    nomtexte ou null
    annonces_activesnombre ou null
    datetexte ou null
    score_marchenombre ou null
    score_demandenombre ou null
    score_saisonnalitenombre ou null
    score_croissancenombre ou null
    score_reglementationnombre ou null
    variation_annuelle_annonces_pctnombre ou null
  - coutsobjet
    Afficher les 10 champsMasquer
    plateforme_pctnombre
    conciergerie_pctnombre
    renouvellement_pctnombre
    menage_eurnombre
    linge_eurnombre
    energie_eurnombre
    internet_eurnombre
    assurance_eurnombre
    classement_eurnombre
    total_eurnombre
  - reglementationobjet
    Afficher les 4 champsMasquer
    niveautexte
    recommandablebooléen
    titretexte
    textetexte
  - notesliste de textes
  - avertissementsliste de textes
recommandationobjet ou null
La stratégie au meilleur TRI après impôt et revente, parmi les stratégies recommandables, et son régime.
Afficher les 7 champsMasquer
- strategietexte
- cle_strategietexte
  lld_nue : location nue ; lld_meublee : location meublée longue durée (LMNP) ; lcd : location courte durée (meublé de tourisme).
  Valeurs : lld_nue, lld_meublee, lcd
- regimetexte
- cle_regimetexte
  Régime fiscal : micro-foncier, réel foncier, bailleur privé (Relance logement), micro-BIC, micro-BIC classé, réel LMNP, SCI à l'IS.
  Valeurs : micro_foncier, reel_foncier, bailleur_prive, micro_bic, micro_bic_classe, reel_bic_lmnp, sci_is
- tri_pctnombre ou null
- rendement_net_net_pctnombre ou null
- raisonsliste de textes
courbesobjet ou null
Afficher les 3 champsMasquer
- strategietexte
- anneesliste d'entiers
- regimesliste d'objets
  Afficher les 6 champsMasquer
  - regimetexte
  - cletexte
    Régime fiscal : micro-foncier, réel foncier, bailleur privé (Relance logement), micro-BIC, micro-BIC classé, réel LMNP, SCI à l'IS.
    Valeurs : micro_foncier, reel_foncier, bailleur_prive, micro_bic, micro_bic_classe, reel_bic_lmnp, sci_is
  - eligiblebooléen
  - cumul_apres_impotliste de nombres
  - enrichissementliste de nombres
  - impotliste de nombres
prix_maximumobjet ou null
Afficher les 5 champsMasquer
- strategietexte
- regimetexte
- prix_demande_eurnombre
- pour_tri_cibleobjet ou null
  Afficher les 3 champsMasquer
  - tri_cible_pctnombre
  - prix_eurnombre
  - ecart_pctnombre
- pour_cashflow_nulobjet ou null
  Afficher les 2 champsMasquer
  - prix_eurnombre
  - ecart_pctnombre
test_de_resistanceobjet ou null
Afficher les 3 champsMasquer
- strategietexte
- regimetexte
- scenariosliste d'objets
  Afficher les 5 champsMasquer
  - cletexte
  - libelletexte
  - tri_pctnombre ou null
  - cashflow_mensuel_apres_impot_annee1_eurnombre
  - enrichissement_eurnombre
contraintes_localesliste d'objets
Afficher les 3 champsMasquer
- niveautexte
  Valeurs : info, attention
- titretexte
- textetexte
avertissementsliste de textes
qualiteobjet
Ce qui permet de juger la valeur : nombre, provenance, incertitude, drapeaux, date et source.
Afficher les 7 champsMasquer
- 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 champsMasquer
  - 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 champsMasquer
- debitesentier
  0 au moins
- restantsentier ou null

Erreurs possibles

400parametres_invalidesUn paramètre manque ou ne passe pas son contrôle ; le détail est donné champ par champ
415type_contenuLe corps n'est pas envoyé en application/json
400corps_illisibleLe corps n'est pas un JSON lisible
413corps_trop_lourdLe corps dépasse la taille permise
401cle_absenteL'en-tête Authorization manque
401cle_invalideLa clé est inconnue, révoquée ou expirée
403organisation_suspendueL'organisation de la clé n'est pas active
403portee_insuffisanteLa clé ou l'accès de l'organisation n'ouvre pas cette opération
403hors_bac_a_sableUne clé pk_test_ demande une entrée hors du jeu figé de l'opération
402credits_insuffisantsLes crédits ne suffisent plus pour cet appel
429plafond_cleLe plafond mensuel de crédits de la clé est atteint
429quota_minuteLe débit par minute de l'organisation est atteint
503charge_globaleL'API est momentanément surchargée, tous clients confondus ; rien n'est débité
504delai_depasseLe calcul dépasse le délai de l'opération ; rien n'est débité
503service_indisponibleL'API est momentanément indisponible
500erreur_interneUne erreur de notre côté ; rien n'est servi ni débité

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

Plus-value immobilière à la revente

POST/api/v1/fiscal/plus-value

Plus-value immobilière d'un particulier à la revente, avec le moteur fiscal de pillr.fr : durée de détention, prix d'acquisition majoré des frais (réels, ou forfait de 7,5 %) et des travaux (réels, ou forfait de 15 % après 5 ans), amortissements réintégrés en LMNP ou en bailleur privé, abattements pour durée de détention à l'impôt sur le revenu et aux prélèvements sociaux, impôt, prélèvements, surtaxe des plus-values élevées, impôt total et net vendeur. Exonération de la résidence principale. Aucun conseil fiscal.

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

Essayer en direct

Paramètres

prix_achatnombreobligatoire
Prix d'achat, en euros.
de 1 000 à 100 000 000
date_achattexteobligatoire
Date d'achat (AAAA-MM-JJ).
frais_acquisitionnombre
Frais d'acquisition réels, en euros ; sans eux, le forfait de 7,5 % du prix d'achat.
de 0 à 10 000 000
travauxnombre
Travaux réels non déduits des revenus, en euros.
de 0 à 100 000 000
travaux_forfaitbooléen
Forfait travaux de 15 % du prix d'achat, au-delà de 5 ans de détention (à la place des travaux réels).
prix_ventenombreobligatoire
Prix de vente, en euros.
de 1 000 à 100 000 000
date_ventetexteobligatoire
Date de vente (AAAA-MM-JJ).
residence_principalebooléen
Vente de la résidence principale : exonérée.
regimetexte
lmnp ou bailleur_prive : les amortissements déduits sont réintégrés au prix d'acquisition.
Valeurs : particulier, lmnp, bailleur_prive
amortissements_deduitsnombre
Amortissements déduits pendant la détention, en euros.
de 0 à 100 000 000

Exemple d'appel

curl -X POST https://pillr.fr/api/v1/fiscal/plus-value \
  -H "Authorization: Bearer $PILLR_CLE" \
  -H "Content-Type: application/json" \
  -d '{"prix_achat":1000,"date_achat":"<date_achat>","prix_vente":1000,"date_vente":"<date_vente>"}'

Réponse

duree_detention_ansentier
prix_achatnombre
frais_acquisitionnombre
frais_acquisition_modetexte
forfait : 7,5 % du prix d'achat, retenu quand les frais réels ne sont pas donnés.
Valeurs : reels, forfait
travauxnombre
travaux_modetexte
forfait : 15 % du prix d'achat, après plus de 5 ans de détention.
Valeurs : reels, forfait, aucun
amortissements_reintegresnombre
prix_acquisition_majorenombre
Prix d'achat, frais et travaux, diminué des amortissements réintégrés.
prix_ventenombre
plus_value_brutenombre
Prix de vente moins prix d'achat, frais et travaux.
plus_value_imposablenombre
abattement_ir_pctnombre
abattement_ps_pctnombre
base_irnombre
base_psnombre
impot_irnombre
prelevements_sociauxnombre
surtaxenombre
impot_totalnombre
plus_value_nettenombre
Plus-value brute moins l'impôt total.
net_vendeurnombre
Prix de vente moins l'impôt total, avant remboursement d'un éventuel crédit.
exonerationobjet ou null
Afficher les 2 champsMasquer
- motiftexte
- sourcetexte
tauxobjet
Afficher les 2 champsMasquer
- impot_revenu_pctnombre
- prelevements_sociaux_pctnombre
hypothesesliste de textes
sourcesliste de textes
qualiteobjet
Ce qui permet de juger la valeur : nombre, provenance, incertitude, drapeaux, date et source.
Afficher les 7 champsMasquer
- 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 champsMasquer
  - 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 champsMasquer
- debitesentier
  0 au moins
- restantsentier ou null

Erreurs possibles

400parametres_invalidesUn paramètre manque ou ne passe pas son contrôle ; le détail est donné champ par champ
415type_contenuLe corps n'est pas envoyé en application/json
400corps_illisibleLe corps n'est pas un JSON lisible
413corps_trop_lourdLe corps dépasse la taille permise
401cle_absenteL'en-tête Authorization manque
401cle_invalideLa clé est inconnue, révoquée ou expirée
403organisation_suspendueL'organisation de la clé n'est pas active
403portee_insuffisanteLa clé ou l'accès de l'organisation n'ouvre pas cette opération
403hors_bac_a_sableUne clé pk_test_ demande une entrée hors du jeu figé de l'opération
402credits_insuffisantsLes crédits ne suffisent plus pour cet appel
429plafond_cleLe plafond mensuel de crédits de la clé est atteint
429quota_minuteLe débit par minute de l'organisation est atteint
503charge_globaleL'API est momentanément surchargée, tous clients confondus ; rien n'est débité
504delai_depasseLe calcul dépasse le délai de l'opération ; rien n'est débité
503service_indisponibleL'API est momentanément indisponible
500erreur_interneUne erreur de notre côté ; rien n'est servi ni débité

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

Revenu de courte durée d'un logement

POST/api/v1/courte-duree/estimations

Revenu de location courte durée d'un logement décrit par sa commune, sa surface et ses chambres, avec le modèle du simulateur de pillr.fr : capacité d'accueil, prix de nuit et occupation ajustés à la capacité depuis le profil de marché AirDNA de la commune, nuits ouvertes et réservées, montée en charge de la première année ; coûts d'exploitation (plateforme, conciergerie, renouvellement, ménage, linge, énergie, internet, assurance, classement), revenu net, statut réglementaire de la commune et du DPE, hypothèses et avertissements. Sans profil de marché, le revenu est un multiple du loyer nu, et le dit.

Coût: 2 crédits par appel réussi
Accès: À l'usage ou avec l'abonnement Data
Portée: estimation
Outil MCP: estimer_courte_duree
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).
surfacenombreobligatoire
Surface habitable, en m².
1 000 au plus ; plus de 0
chambresentier
Chambres ; sans elles, la capacité est déduite de la surface.
de 0 à 20
nuits_ouvertesentier
Nuits ouvertes à la location dans l'année.
de 1 à 365
occupation_pctnombre
Occupation imposée, en % des nuits ouvertes ; sinon celle du marché, ajustée à la capacité.
de 0 à 100
gestiontexte
Gestion par l'investisseur seul, ou par une conciergerie (par défaut).
Valeurs : seul, conciergerie
classebooléen
Meublé de tourisme classé (oui par défaut).
dpetexte
Étiquette DPE : une nouvelle autorisation l'exige suffisante.
Valeurs : A, B, C, D, E, F, G
loyer_nunombre
Loyer mensuel en location nue, pour le repli et la comparaison ; sinon le loyer de marché de la commune.
100 000 au plus ; plus de 0

Exemple d'appel

curl -X POST https://pillr.fr/api/v1/courte-duree/estimations \
  -H "Authorization: Bearer $PILLR_CLE" \
  -H "Content-Type: application/json" \
  -d '{"insee":"<insee>","surface":1}'

Réponse

inseetexte
communetexte ou null
revenuobjet
Afficher les 14 champsMasquer
- capaciteentier
  Couchages retenus : deux par chambre plus un, ou déduits de la surface.
- prix_nuitnombre
- occupation_pctnombre
- nuits_ouvertesentier
- nuits_reserveesentier
- rotationsentier
- revenu_brutnombre
  Revenu annuel en régime de croisière, en euros.
- revenu_annee1nombre
  Revenu de la première année (montée en charge).
- ratio_loyer_nunombre ou null
  Revenu brut sur loyer nu annuel.
- 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
- sourcetexte
  Valeurs : airdna_market, airdna_departement, airdna_national, legacy_dump, loyer_nu
- notesliste de textes
- avertissementsliste de textes
- qualiteobjet
  Ce qui permet de juger la valeur : nombre, provenance, incertitude, drapeaux, date et source.
  Afficher les 7 champsMasquer
  - 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 champsMasquer
    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.
coutsobjet
Afficher les 13 champsMasquer
- plateforme_pctnombre
- conciergerie_pctnombre
- renouvellement_pctnombre
- plateformenombre
- conciergerienombre
- renouvellementnombre
- menagenombre
- lingenombre
- energienombre
- internetnombre
- assurancenombre
- classementnombre
- totalnombre
  Coûts d'exploitation annuels, en euros, sur le revenu brut.
revenu_netnombre
Revenu brut moins coûts d'exploitation, avant charges de copropriété, taxe foncière, crédit et impôt.
loyer_nu_mensuelnombre ou null
Loyer nu de comparaison : celui donné, ou loyer de marché au m² de la commune multiplié par la surface.
statut_reglementaireobjet
Afficher les 4 champsMasquer
- 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
hypothesesliste 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 champsMasquer
- debitesentier
  0 au moins
- restantsentier ou null

Erreurs possibles

400parametres_invalidesUn paramètre manque ou ne passe pas son contrôle ; le détail est donné champ par champ
415type_contenuLe corps n'est pas envoyé en application/json
400corps_illisibleLe corps n'est pas un JSON lisible
413corps_trop_lourdLe corps dépasse la taille permise
401cle_absenteL'en-tête Authorization manque
401cle_invalideLa clé est inconnue, révoquée ou expirée
403organisation_suspendueL'organisation de la clé n'est pas active
403portee_insuffisanteLa clé ou l'accès de l'organisation n'ouvre pas cette opération
403hors_bac_a_sableUne clé pk_test_ demande une entrée hors du jeu figé de l'opération
402credits_insuffisantsLes crédits ne suffisent plus pour cet appel
429plafond_cleLe plafond mensuel de crédits de la clé est atteint
429quota_minuteLe débit par minute de l'organisation est atteint
503charge_globaleL'API est momentanément surchargée, tous clients confondus ; rien n'est débité
504delai_depasseLe calcul dépasse le délai de l'opération ; rien n'est débité
503service_indisponibleL'API est momentanément indisponible
500erreur_interneUne erreur de notre côté ; rien n'est servi ni débité

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