Analyses d'annonce
Ce que le moteur d'analyse a produit, ou peut produire, sur une annonce ou sur un bien fourni : photos, rapport, écart au marché, négociation, division, analyses à la demande. 4 opérations servies.
Lecture photo par photo et rapport complet
Essayer en direct/api/v1/annonces/{id}/analyse-detailleeCe que le moteur d'analyse de Pillr a produit sur une annonce analysée, en deux volets. Volet photos : chaque photo lue (pièce, état sur 100, défauts, observations, travaux déduits, exploitable ou motif du rejet), travaux groupés par poste et chiffrés par le barème déterministe avec leurs photos sources, postes écartés et leur motif, défauts par gravité, pièces vues et manquantes, plancher énergétique, score de qualité de l'annonce. Volet rapport, celui de la page d'analyse : plan financier avec crédit, notation sur six axes, anomalies du moteur de règles, analyse rédigée (forces, points d'attention, verdict, confiance) et photo du marché communal. Avec des photos de catalogue, l'état visuel n'est pas servi et la lecture le dit. Rien n'est débité si l'annonce est absente ou pas encore analysée.
- Coût
- 5 crédits par appel réussi
- Accès
- À l'usage ou avec l'abonnement Data
- Portée
- analyses_photo
- Outil MCP
- analyse_detaillee
- Bac à sable
- Non
- Cache serveur
- 1 h
- Délai maximal
- 5 s
Paramètres
idtexteobligatoireIdentifiant de l'annonce : lbc:<numéro>, bienici:<identifiant>, seloger:<numéro> ou identifiant Pillr.
de 3 à 200 caractères
voletstexteVolets à servir, séparés par une virgule : photos, rapport ou photos,rapport (défaut : les deux).
Exemple d'appel
curl https://pillr.fr/api/v1/annonces/lbc:2894512345/analyse-detaillee \
-H "Authorization: Bearer $PILLR_CLE"Réponse
idtexteIdentifiant Pillr de l'annonce.
id_portailtexte ou nullIdentifiant chez le portail : lbc:<n>, bienici:<id> ou seloger:<id>.
type_vendeurtexteStatut du vendeur : pro (professionnel nommé), particulier, ou inconnu quand le portail ne le dit pas. Une annonce qui n'est pas celle d'un professionnel perd les téléphones et les emails de ses textes.
Valeurs :
pro,particulier,inconnuvoletsliste de textesLes volets servis.
Valeurs :
photos,rapportmoteurobjetLe moteur d'analyse de Pillr qui a produit ces valeurs.
Afficher les 3 champsMasquer
modeletexte ou nullModèle qui a produit l'analyse, tel que le moteur l'a noté.
versionnombre ou nullVersion du moteur d'analyse.
analyse_letexte ou nullDate de l'analyse (ISO 8601).
photosobjet ou nullVolet photos ; null s'il n'est pas demandé ou si l'annonce n'a pas de lecture des photos.
Afficher les 13 champsMasquer
photos_totalentier0 au moins
photos_exploitablesentier0 au moins
qualite_annoncenombre ou nullPart des photos exploitables, en % : le score de qualité de l'annonce.
etat_moyennombre ou nullÉtat visuel moyen des pièces vues, sur 100 ; null sans photo exploitable.
pieces_vuesliste de textespieces_manquantesliste de textesPièces clés absentes des photos (cuisine, salle de bain, salon, façade).
defautsobjetAfficher les 3 champsMasquer
mineurentiermoyenentiermajeurentier
travaux_groupesliste d'objetsTravaux groupés par poste, chiffrés par le barème déterministe à partir de l'intensité décrite et de la surface.
Afficher les 8 champsMasquer
postetexteintensitetexte ou nulllibelletextecout_minnombrecout_maxnombreprioritetexte ou nulljustificationsliste de textesphotosliste d'entiersRangs des photos qui fondent ce poste.
travaux_ecartesliste d'objetsTravaux proposés par la vision et écartés faute de preuve sur la photo, avec leur motif.
Afficher les 3 champsMasquer
postetextemotiftextephotoentier ou null
travauxobjetTotal des travaux du barème, avant imprévus : plancher énergétique et rénovation complète compris.
Afficher les 3 champsMasquer
minnombre ou nullmaxnombre ou nullqualiteobjetCe qui permet de juger la valeur : nombre, provenance, incertitude, drapeaux, date et source.
Afficher les 7 champsMasquer
nentier ou nullNombre d'observations derrière la valeur ; null si sans objet.
0 au moins
provenancetexte ou nullmesure : observé sur la donnée ; estime : modèle, barème ou imputation ; null : sans objet.
Valeurs :
mesure,estimeincertitudeobjet ou nullIncertitude de la valeur : fourchette et demi-largeur.
Afficher les 3 champsMasquer
demi_largeur_pctnombre ou nullDemi-largeur de la fourchette, en % de la valeur.
basnombre ou nullhautnombre ou null
drapeauxliste de textesCe qui doit faire lire la valeur avec prudence ; vide si rien.
Valeurs :
prix_atypique,surface_atypique,vente_en_bloc,doublon_probable,date_estimee,peu_d_observations,valeur_imputee,rattachement_incertain,donnee_anciennemethodetexte ou nullMéthode de calcul ou de rattachement, en clair.
donnees_dutexte ou nullDate de la donnée (AAAA-MM-JJ ou horodatage ISO 8601).
sourcetexteSource publique ou moteur Pillr, en clair.
plancher_energieobjet ou nullLigne énergie déduite d'un DPE E, F ou G quand elle relève le total ; null sinon.
Afficher les 3 champsMasquer
classetextecout_minnombrecout_maxnombre
par_photoliste d'objetsAfficher les 8 champsMasquer
indexentierRang de la photo dans la liste lue (0 pour la première).
0 au moins
piecetextePièce reconnue (cuisine, salon, salle_de_bain, facade_exterieur, plan_2d, indetermine...).
etatnombre ou nullÉtat visuel de la pièce sur 100 (60 correct, 80 bon, 95 neuf) ; null si la photo est inexploitable.
exploitablebooléenmotiftexte ou nullPourquoi la photo est inexploitable ; null sinon.
observationsliste de textesdefautsliste d'objetsAfficher les 3 champsMasquer
libelletextegravitetexteValeurs :
mineur,moyen,majeurpostetextePoste de travaux auquel le défaut se rattache.
travauxliste d'objetsAfficher les 7 champsMasquer
postetexteintensitetexte ou nullleger, moyen ou lourd : l'intervention décrite, qui pilote le barème.
libelletextejustificationtexte ou nullCe que le modèle de vision voit sur la photo.
prioritetexte ou nullurgent, recommande ou optionnel.
cout_min_indicatifnombre ou nullMontant proposé par le modèle de vision pour cette photo, non retenu : le chiffrage servi est celui des travaux groupés, calculé par le barème.
cout_max_indicatifnombre ou null
qualiteobjetCe qui permet de juger la valeur : nombre, provenance, incertitude, drapeaux, date et source.
Afficher les 7 champsMasquer
nentier ou nullNombre d'observations derrière la valeur ; null si sans objet.
0 au moins
provenancetexte ou nullmesure : observé sur la donnée ; estime : modèle, barème ou imputation ; null : sans objet.
Valeurs :
mesure,estimeincertitudeobjet ou nullIncertitude de la valeur : fourchette et demi-largeur.
Afficher les 3 champsMasquer
demi_largeur_pctnombre ou nullDemi-largeur de la fourchette, en % de la valeur.
basnombre ou nullhautnombre ou null
drapeauxliste de textesCe qui doit faire lire la valeur avec prudence ; vide si rien.
Valeurs :
prix_atypique,surface_atypique,vente_en_bloc,doublon_probable,date_estimee,peu_d_observations,valeur_imputee,rattachement_incertain,donnee_anciennemethodetexte ou nullMéthode de calcul ou de rattachement, en clair.
donnees_dutexte ou nullDate de la donnée (AAAA-MM-JJ ou horodatage ISO 8601).
sourcetexteSource publique ou moteur Pillr, en clair.
rapportobjet ou nullVolet rapport ; null s'il n'est pas demandé ou si aucun rapport n'existe pour le lien de l'annonce.
Afficher les 10 champsMasquer
bienobjetLe bien tel que l'analyse l'a lu.
Afficher les 12 champsMasquer
titretexte ou nulltypetexte ou nullprixnombre ou nullsurfacenombre ou nullpiecesnombre ou nulllocalisationtexte ou nullCommune et code postal, tels que l'analyse les a lus.
dpetexte ou nullannee_constructionnombre ou nullterrain_m2nombre ou nullpremiere_parutiontexte ou nulldescriptiontexte ou nulllientexte ou nullLien d'origine de l'annonce, servi quand la clé porte la portée lien_origine.
financierobjetLe plan financier de la page d'analyse, avec le crédit qu'il suppose.
Afficher les 14 champsMasquer
prix_achatnombre ou nullinvestissement_totalnombre ou nullloyer_mensuelnombre ou nullloyer_annuelnombre ou nullcharges_mensuellesnombre ou nullcharges_annuellesnombre ou nullcash_flow_annuelnombre ou nullcap_rate_pctnombre ou nullLoyer annuel rapporté au prix, en %.
roi_pctnombre ou nullCash-flow annuel rapporté à l'apport, en %.
mensualitenombre ou nullmontant_empruntenombre ou nullduree_anneesnombre ou nulltaux_interet_pctnombre ou nullqualiteobjetCe qui permet de juger la valeur : nombre, provenance, incertitude, drapeaux, date et source.
Afficher les 7 champsMasquer
nentier ou nullNombre d'observations derrière la valeur ; null si sans objet.
0 au moins
provenancetexte ou nullmesure : observé sur la donnée ; estime : modèle, barème ou imputation ; null : sans objet.
Valeurs :
mesure,estimeincertitudeobjet ou nullIncertitude de la valeur : fourchette et demi-largeur.
Afficher les 3 champsMasquer
demi_largeur_pctnombre ou nullDemi-largeur de la fourchette, en % de la valeur.
basnombre ou nullhautnombre ou null
drapeauxliste de textesCe qui doit faire lire la valeur avec prudence ; vide si rien.
Valeurs :
prix_atypique,surface_atypique,vente_en_bloc,doublon_probable,date_estimee,peu_d_observations,valeur_imputee,rattachement_incertain,donnee_anciennemethodetexte ou nullMéthode de calcul ou de rattachement, en clair.
donnees_dutexte ou nullDate de la donnée (AAAA-MM-JJ ou horodatage ISO 8601).
sourcetexteSource publique ou moteur Pillr, en clair.
notationobjetLa notation sur six axes de la page d'analyse, sur 100.
Afficher les 6 champsMasquer
globalenombre ou nullfinancierenombre ou nulllocalisationnombre ou nullbiennombre ou nullmarchenombre ou nullrisquenombre ou null
scores_modeleobjet ou nullLes sous-scores du modèle sur 100 (etat, marche, rentabilite, potentiel, localisation, transport, fiscalite, risques, qualite_annonce) ; null pour un rapport antérieur.
noteobjetAfficher les 2 champsMasquer
lettretexte ou nulllibelletexte ou null
anomaliesliste d'objetsAnomalies relevées par le moteur de règles, annonce contre marché.
Afficher les 3 champsMasquer
typetexteseveritetextemessagetexte
analyseobjetL'analyse rédigée par le modèle, telle que la page d'analyse la montre.
Afficher les 13 champsMasquer
verdicttexte ou nullACHAT_RECOMMANDE, ACHAT_SOUS_CONDITIONS ou ACHAT_DECONSEILLE.
resumetexte ou nullsynthesetexte ou nullforcesliste d'objetsAfficher les 3 champsMasquer
titretextedetailtexte ou nullimpact_eurnombre ou null
faiblessesliste d'objetsTous les points d'attention du modèle.
Afficher les 5 champsMasquer
titretextedetailtexte ou nullgravitetexte ou nullFAIBLE, MOYEN, ELEVE ou CRITIQUE, tel que le modèle l'a noté.
impact_eurnombre ou nullsolutiontexte ou null
risquesliste d'objetsLes points d'attention de gravité ELEVE ou CRITIQUE.
Afficher les 5 champsMasquer
titretextedetailtexte ou nullgravitetexte ou nullFAIBLE, MOYEN, ELEVE ou CRITIQUE, tel que le modèle l'a noté.
impact_eurnombre ou nullsolutiontexte ou null
opportunitesliste d'objetsLes travaux d'amélioration proposés par le modèle, avec leur valorisation.
Afficher les 5 champsMasquer
postetextecout_minnombre ou nullcout_maxnombre ou nullvalorisation_pctnombre ou nulljustificationtexte ou null
conditionsliste de textesplan_actionliste de textesanalyse_phototexte ou nullrecommandationtexte ou nullLa recommandation rédigée de la page d'analyse.
confianceobjetAfficher les 3 champsMasquer
niveautexte ou nullhigh, medium ou low, déclaré par le modèle.
facteursliste de texteslimitesliste de textes
sourcesliste de textesSources que le modèle déclare avoir utilisées.
marcheobjet ou nullLa photo du marché communal utilisée par l'analyse : les indicateurs de la commune au jour de l'analyse.
genere_letexte ou nullqualiteobjetCe qui permet de juger la valeur : nombre, provenance, incertitude, drapeaux, date et source.
Afficher les 7 champsMasquer
nentier ou nullNombre d'observations derrière la valeur ; null si sans objet.
0 au moins
provenancetexte ou nullmesure : observé sur la donnée ; estime : modèle, barème ou imputation ; null : sans objet.
Valeurs :
mesure,estimeincertitudeobjet ou nullIncertitude de la valeur : fourchette et demi-largeur.
Afficher les 3 champsMasquer
demi_largeur_pctnombre ou nullDemi-largeur de la fourchette, en % de la valeur.
basnombre ou nullhautnombre ou null
drapeauxliste de textesCe qui doit faire lire la valeur avec prudence ; vide si rien.
Valeurs :
prix_atypique,surface_atypique,vente_en_bloc,doublon_probable,date_estimee,peu_d_observations,valeur_imputee,rattachement_incertain,donnee_anciennemethodetexte ou nullMéthode de calcul ou de rattachement, en clair.
donnees_dutexte ou nullDate de la donnée (AAAA-MM-JJ ou horodatage ISO 8601).
sourcetexteSource publique ou moteur Pillr, en clair.
creditsobjetCrédits débités par cet appel (réservés, pour une tâche en cours), et crédits encore utilisables ce mois avant la coupure : crédits offerts, crédits inclus du mois et crédits facturables sous le plafond de dépense (null si inconnus ou en bac à sable).
Afficher les 2 champsMasquer
debitesentier0 au moins
restantsentier ou null
Erreurs possibles
- 400parametres_invalidesUn paramètre manque ou ne passe pas son contrôle ; le détail est donné champ par champ
- 403hors_bac_a_sableUne clé pk_test_ l'appelle : l'opération n'a pas de bac à sable
Afficher les 11 erreurs communes à toute l'APIMasquer les erreurs communes
- 401cle_absenteL'en-tête Authorization manque
- 401cle_invalideLa clé est inconnue, révoquée ou expirée
- 403organisation_suspendueL'organisation de la clé n'est pas active
- 403portee_insuffisanteLa clé ou l'accès de l'organisation n'ouvre pas cette opération
- 402credits_insuffisantsLes crédits ne suffisent plus pour cet appel
- 429plafond_cleLe plafond mensuel de crédits de la clé est atteint
- 429quota_minuteLe débit par minute de l'organisation est atteint
- 503charge_globaleL'API est momentanément surchargée, tous clients confondus ; rien n'est débité
- 504delai_depasseLe calcul dépasse le délai de l'opération ; rien n'est débité
- 503service_indisponibleL'API est momentanément indisponible
- 500erreur_interneUne erreur de notre côté ; rien n'est servi ni débité
Une ressource absente répond par un code de la famille des ressources absentes, propre à l'opération, sans débit. Guide des erreurs
Écart au marché, anomalies et ventes du rayon
Essayer en direct/api/v1/annonces/{id}/ecart-marcheÉcart du prix au m² d'une annonce analysée au prix de référence Pillr de sa commune (le chiffre de la fiche, calculé par le même module canonique), avec le signal du modèle prédictif, les anomalies annonce contre marché du moteur de règles, les données de l'analyse (travaux, rendements, loyer, score, profil), les cibles et leviers de négociation, et toutes les ventes DVF du rayon une par une, reconstituées à la mutation entière, avec leurs agrégats par type et par année. Aucun seuil ne masque : chaque agrégat porte son nombre de ventes, chaque vente atypique son drapeau. Rien n'est débité si l'annonce est absente.
- Coût
- 3 crédits par appel réussi
- Accès
- À l'usage ou avec l'abonnement Data
- Portée
- annonces
- Outil MCP
- ecart_marche
- Bac à sable
- Non
- Cache serveur
- 6 h
- Délai maximal
- 8 s
Paramètres
idtexteobligatoireIdentifiant de l'annonce : lbc:<numéro>, bienici:<identifiant>, seloger:<numéro> ou identifiant Pillr.
de 3 à 200 caractères
rayon_mentierRayon des ventes DVF autour de l'annonce, en mètres, de 50 à 1 000 (défaut 300).
de 50 à 1 000
Exemple d'appel
curl https://pillr.fr/api/v1/annonces/lbc:2894512345/ecart-marche \
-H "Authorization: Bearer $PILLR_CLE"Réponse
idtexteid_portailtexte ou nulltype_vendeurtexteStatut du vendeur : pro (professionnel nommé), particulier, ou inconnu quand le portail ne le dit pas. Une annonce qui n'est pas celle d'un professionnel perd les téléphones et les emails de ses textes.
Valeurs :
pro,particulier,inconnuprix_m2_annoncenombre ou nullprix_m2_marchenombre ou nullPrix de référence Pillr de la commune pour ce type de bien : le chiffre de la fiche.
ecart_pctnombre ou nullÉcart du prix au m² de l'annonce au prix de référence, en % (positif : plus cher). null quand la référence n'est pas mesurée sur des ventes.
verdicttexteValeurs :
tres_sous_cote,sous_cote,au_marche,sur_cote,tres_sur_cote,inconnusignal_mltexte ou nullSignal du modèle prédictif départemental (un signal, jamais la valeur du marché).
referenceobjetAfficher les 5 champsMasquer
communetexte ou nullcode_inseetexte ou nullcode_postaltexte ou nullprovenancetexte ou nulldvf : médiane de ventes notariées ; estimation : modèle Pillr, faute de ventes locales du type.
Valeurs :
dvf,estimationqualiteobjetCe qui permet de juger la valeur : nombre, provenance, incertitude, drapeaux, date et source.
Afficher les 7 champsMasquer
nentier ou nullNombre d'observations derrière la valeur ; null si sans objet.
0 au moins
provenancetexte ou nullmesure : observé sur la donnée ; estime : modèle, barème ou imputation ; null : sans objet.
Valeurs :
mesure,estimeincertitudeobjet ou nullIncertitude de la valeur : fourchette et demi-largeur.
Afficher les 3 champsMasquer
demi_largeur_pctnombre ou nullDemi-largeur de la fourchette, en % de la valeur.
basnombre ou nullhautnombre ou null
drapeauxliste de textesCe qui doit faire lire la valeur avec prudence ; vide si rien.
Valeurs :
prix_atypique,surface_atypique,vente_en_bloc,doublon_probable,date_estimee,peu_d_observations,valeur_imputee,rattachement_incertain,donnee_anciennemethodetexte ou nullMéthode de calcul ou de rattachement, en clair.
donnees_dutexte ou nullDate de la donnée (AAAA-MM-JJ ou horodatage ISO 8601).
sourcetexteSource publique ou moteur Pillr, en clair.
anomaliesliste d'objetsAfficher les 3 champsMasquer
typetexteseveritetextemessagetexte
donnees_annonceobjetAfficher les 9 champsMasquer
travaux_statuttexte ou nulltravaux_minnombre ou nulltravaux_maxnombre ou nullrendement_brutnombre ou nullrendement_netnombre ou nullloyernombre ou nullloyer_sourcetexte ou nullscorenombre ou nullprofiltexte ou null
negociationobjetAfficher les 3 champsMasquer
cible_minnombre ou nullcible_maxnombre ou nullleviersliste de textes
ventes_rayonobjetAfficher les 13 champsMasquer
rayon_mentiernentierVentes typiques du type de l'annonce dans le rayon, toutes années.
0 au moins
mediane_m2nombre ou nullq1nombre ou nullq3nombre ou nullminnombre ou nullmaxnombre ou nullmillesimestexte ou nullagregatsliste d'objetsAfficher les 11 champsMasquer
type_bientexteValeurs :
appartement,maisonperiodetextenb_ventesentier0 au moins
prix_m2_mediannombre ou nullprix_m2_q1nombre ou nullprix_m2_q3nombre ou nullprix_m2_minnombre ou nullprix_m2_maxnombre ou nullsurface_mediane_m2nombre ou nullderniere_vente_letexte ou nullnb_prix_atypiquesentierVentes du groupe écartées de l'agrégat pour prix atypique (listées une par une).
0 au moins
par_anneeliste d'objetsAfficher les 11 champsMasquer
type_bientexteValeurs :
appartement,maisonperiodetextenb_ventesentier0 au moins
prix_m2_mediannombre ou nullprix_m2_q1nombre ou nullprix_m2_q3nombre ou nullprix_m2_minnombre ou nullprix_m2_maxnombre ou nullsurface_mediane_m2nombre ou nullderniere_vente_letexte ou nullnb_prix_atypiquesentierVentes du groupe écartées de l'agrégat pour prix atypique (listées une par une).
0 au moins
ventesliste d'objetsToutes les ventes du rayon, une par une, les plus proches d'abord, chacune avec son drapeau prix_atypique.
Afficher les 10 champsMasquer
datetexteadressetexte ou nullNuméro et voie tels que DVF les écrit ; null sans numéro.
type_bientexteValeurs :
appartement,maisonsurface_m2nombreprixnombre ou nullValeur foncière de la mutation entière.
prix_m2nombredistance_mnombre ou nullid_mutationtexte ou nullprix_atypiquebooléenmotif_atypiquetexte ou null
notetexte ou nullqualiteobjetCe qui permet de juger la valeur : nombre, provenance, incertitude, drapeaux, date et source.
Afficher les 7 champsMasquer
nentier ou nullNombre d'observations derrière la valeur ; null si sans objet.
0 au moins
provenancetexte ou nullmesure : observé sur la donnée ; estime : modèle, barème ou imputation ; null : sans objet.
Valeurs :
mesure,estimeincertitudeobjet ou nullIncertitude de la valeur : fourchette et demi-largeur.
Afficher les 3 champsMasquer
demi_largeur_pctnombre ou nullDemi-largeur de la fourchette, en % de la valeur.
basnombre ou nullhautnombre ou null
drapeauxliste de textesCe qui doit faire lire la valeur avec prudence ; vide si rien.
Valeurs :
prix_atypique,surface_atypique,vente_en_bloc,doublon_probable,date_estimee,peu_d_observations,valeur_imputee,rattachement_incertain,donnee_anciennemethodetexte ou nullMéthode de calcul ou de rattachement, en clair.
donnees_dutexte ou nullDate de la donnée (AAAA-MM-JJ ou horodatage ISO 8601).
sourcetexteSource publique ou moteur Pillr, en clair.
calcule_letextecreditsobjetCrédits débités par cet appel (réservés, pour une tâche en cours), et crédits encore utilisables ce mois avant la coupure : crédits offerts, crédits inclus du mois et crédits facturables sous le plafond de dépense (null si inconnus ou en bac à sable).
Afficher les 2 champsMasquer
debitesentier0 au moins
restantsentier ou null
Erreurs possibles
- 400parametres_invalidesUn paramètre manque ou ne passe pas son contrôle ; le détail est donné champ par champ
- 403hors_bac_a_sableUne clé pk_test_ l'appelle : l'opération n'a pas de bac à sable
Afficher les 11 erreurs communes à toute l'APIMasquer les erreurs communes
- 401cle_absenteL'en-tête Authorization manque
- 401cle_invalideLa clé est inconnue, révoquée ou expirée
- 403organisation_suspendueL'organisation de la clé n'est pas active
- 403portee_insuffisanteLa clé ou l'accès de l'organisation n'ouvre pas cette opération
- 402credits_insuffisantsLes crédits ne suffisent plus pour cet appel
- 429plafond_cleLe plafond mensuel de crédits de la clé est atteint
- 429quota_minuteLe débit par minute de l'organisation est atteint
- 503charge_globaleL'API est momentanément surchargée, tous clients confondus ; rien n'est débité
- 504delai_depasseLe calcul dépasse le délai de l'opération ; rien n'est débité
- 503service_indisponibleL'API est momentanément indisponible
- 500erreur_interneUne erreur de notre côté ; rien n'est servi ni débité
Une ressource absente répond par un code de la famille des ressources absentes, propre à l'opération, sans débit. Guide des erreurs
Recommandation de négociation et lettre d'offre
Essayer en direct/api/v1/annonces/{id}/negociationRecommandation de négociation et lettre de proposition d'achat pour une annonce analysée : prix proposé (le vôtre, ou le prix demandé moins les travaux estimés et une marge de négociation, borné, comme sur la fiche), cibles et leviers relevés par l'analyse, vie de l'annonce (jours en ligne, baisses de prix), écart au prix de référence de la commune, puis arguments et lettre rédigés par l'IA à partir de ce seul contexte, au ton et au destinataire choisis. Un appel à un modèle Gemini par appel. Rien n'est débité si l'annonce est absente ou si l'IA ne rend rien d'exploitable.
- Coût
- 20 crédits par appel réussi
- Accès
- À l'usage ou avec l'abonnement Data
- Portée
- annonces
- Outil MCP
- negociation
- Bac à sable
- Non
- Cache serveur
- 24 h
- Délai maximal
- 60 s
Paramètres
idtexteobligatoireIdentifiant de l'annonce : lbc:<numéro>, bienici:<identifiant>, seloger:<numéro> ou identifiant Pillr.
de 3 à 200 caractères
prix_proposeentierVotre prix proposé, en euros ; à défaut, le prix recommandé est calculé.
de 1 000 à 50 000 000
tontexteTon de la lettre (défaut : neutre).
Valeurs :
cordial,neutre,fermedestinatairetexteÀ qui la lettre s'adresse : l'agence ou le vendeur.
Valeurs :
agence,vendeur
Exemple d'appel
curl -X POST https://pillr.fr/api/v1/annonces/lbc%3A2894512345/negociation \
-H "Authorization: Bearer $PILLR_CLE" \
-H "Content-Type: application/json" \
-d '{}'Réponse
idtexteid_portailtexte ou nulltype_vendeurtexteStatut du vendeur : pro (professionnel nommé), particulier, ou inconnu quand le portail ne le dit pas. Une annonce qui n'est pas celle d'un professionnel perd les téléphones et les emails de ses textes.
Valeurs :
pro,particulier,inconnuprix_demandenombrerecommandationobjetAfficher les 5 champsMasquer
prix_proposenombreremisenombreremise_pctnombreoriginetextecalcul : prix demandé moins les travaux et une marge, borné ; client : le prix proposé par l'appelant.
Valeurs :
calcul,clientmethodetexte
cibleobjetAfficher les 3 champsMasquer
minnombre ou nullmaxnombre ou nullqualiteobjetCe qui permet de juger la valeur : nombre, provenance, incertitude, drapeaux, date et source.
Afficher les 7 champsMasquer
nentier ou nullNombre d'observations derrière la valeur ; null si sans objet.
0 au moins
provenancetexte ou nullmesure : observé sur la donnée ; estime : modèle, barème ou imputation ; null : sans objet.
Valeurs :
mesure,estimeincertitudeobjet ou nullIncertitude de la valeur : fourchette et demi-largeur.
Afficher les 3 champsMasquer
demi_largeur_pctnombre ou nullDemi-largeur de la fourchette, en % de la valeur.
basnombre ou nullhautnombre ou null
drapeauxliste de textesCe qui doit faire lire la valeur avec prudence ; vide si rien.
Valeurs :
prix_atypique,surface_atypique,vente_en_bloc,doublon_probable,date_estimee,peu_d_observations,valeur_imputee,rattachement_incertain,donnee_anciennemethodetexte ou nullMéthode de calcul ou de rattachement, en clair.
donnees_dutexte ou nullDate de la donnée (AAAA-MM-JJ ou horodatage ISO 8601).
sourcetexteSource publique ou moteur Pillr, en clair.
leviersliste de textesLeviers de négociation relevés par l'analyse de l'annonce.
argumentsliste de textesArguments rédigés par l'IA, tirés du seul contexte servi.
lettretexteLettre de proposition d'achat, à compléter du nom et de la date.
vieobjetAfficher les 5 champsMasquer
premiere_parutiontexte ou nulljours_en_lignenombre ou nullbaissesentier0 au moins
baisse_cumulee_pctnombre ou nulldernier_changement_letexte ou null
ecart_marcheobjetAfficher les 3 champsMasquer
prix_m2_annoncenombre ou nullprix_m2_marchenombre ou nullecart_pctnombre ou null
sourcesliste de textesmoteurobjetAfficher les 2 champsMasquer
modeletexte ou nullgenere_letexte
creditsobjetCrédits débités par cet appel (réservés, pour une tâche en cours), et crédits encore utilisables ce mois avant la coupure : crédits offerts, crédits inclus du mois et crédits facturables sous le plafond de dépense (null si inconnus ou en bac à sable).
Afficher les 2 champsMasquer
debitesentier0 au moins
restantsentier ou null
Erreurs possibles
- 400parametres_invalidesUn paramètre manque ou ne passe pas son contrôle ; le détail est donné champ par champ
- 415type_contenuLe corps n'est pas envoyé en application/json
- 400corps_illisibleLe corps n'est pas un JSON lisible
- 413corps_trop_lourdLe corps dépasse la taille permise
- 403hors_bac_a_sableUne clé pk_test_ l'appelle : l'opération n'a pas de bac à sable
Afficher les 11 erreurs communes à toute l'APIMasquer les erreurs communes
- 401cle_absenteL'en-tête Authorization manque
- 401cle_invalideLa clé est inconnue, révoquée ou expirée
- 403organisation_suspendueL'organisation de la clé n'est pas active
- 403portee_insuffisanteLa clé ou l'accès de l'organisation n'ouvre pas cette opération
- 402credits_insuffisantsLes crédits ne suffisent plus pour cet appel
- 429plafond_cleLe plafond mensuel de crédits de la clé est atteint
- 429quota_minuteLe débit par minute de l'organisation est atteint
- 503charge_globaleL'API est momentanément surchargée, tous clients confondus ; rien n'est débité
- 504delai_depasseLe calcul dépasse le délai de l'opération ; rien n'est débité
- 503service_indisponibleL'API est momentanément indisponible
- 500erreur_interneUne erreur de notre côté ; rien n'est servi ni débité
Une ressource absente répond par un code de la famille des ressources absentes, propre à l'opération, sans débit. Guide des erreurs
Potentiel de division d'un bien
Essayer en direct/api/v1/annonces/{id}/divisionPotentiel de division d'une annonce analysée, par la règle du Hub : la parcelle cadastrale du point de l'annonce (contenance, section, numéro, lue en direct à l'API Carto de l'IGN) croisée avec la surface habitable, le terrain déclaré, le prix au m² face au prix de référence de la commune et la demande locative. Rend un verdict (faible, modéré ou élevé) et ses signaux. Le point d'une annonce est souvent approché : la parcelle est celle du point servi, avec sa précision. Rien n'est débité si l'annonce est absente.
- Coût
- 3 crédits par appel réussi
- Accès
- À l'usage ou avec l'abonnement Data
- Portée
- annonces
- Outil MCP
- division
- Bac à sable
- Non
- Cache serveur
- 24 h
- Délai maximal
- 12 s
Paramètres
idtexteobligatoireIdentifiant de l'annonce : lbc:<numéro>, bienici:<identifiant>, seloger:<numéro> ou identifiant Pillr.
de 3 à 200 caractères
Exemple d'appel
curl https://pillr.fr/api/v1/annonces/lbc:2894512345/division \
-H "Authorization: Bearer $PILLR_CLE"Réponse
idtexteid_portailtexte ou nulltype_vendeurtexteStatut du vendeur : pro (professionnel nommé), particulier, ou inconnu quand le portail ne le dit pas. Une annonce qui n'est pas celle d'un professionnel perd les téléphones et les emails de ses textes.
Valeurs :
pro,particulier,inconnucommunetexte ou nullsurface_bien_m2nombre ou nullpiecesnombre ou nullterrain_annonce_m2nombre ou nullTerrain déclaré par le portail.
prix_m2_biennombre ou nullprix_m2_marchenombre ou nullecart_prix_m2_pctnombre ou nullscore_demandenombre ou nullScore de demande locative de la commune, sur 100.
pointobjetAfficher les 3 champsMasquer
latnombre ou nulllonnombre ou nullprecisiontexteadresse, approchee, centre de la commune ou inconnue : la précision du point donné par le portail.
parcelleobjet ou nullParcelle cadastrale qui contient le point de l'annonce (API Carto de l'IGN) ; null sans point ou sans réponse.
Afficher les 4 champsMasquer
contenance_m2nombre ou nullsectiontexte ou nullnumerotexte ou nullcommunetexte ou null
potentiel_decoupetexteValeurs :
faible,modere,elevesignauxliste de textesqualiteobjetCe qui permet de juger la valeur : nombre, provenance, incertitude, drapeaux, date et source.
Afficher les 7 champsMasquer
nentier ou nullNombre d'observations derrière la valeur ; null si sans objet.
0 au moins
provenancetexte ou nullmesure : observé sur la donnée ; estime : modèle, barème ou imputation ; null : sans objet.
Valeurs :
mesure,estimeincertitudeobjet ou nullIncertitude de la valeur : fourchette et demi-largeur.
Afficher les 3 champsMasquer
demi_largeur_pctnombre ou nullDemi-largeur de la fourchette, en % de la valeur.
basnombre ou nullhautnombre ou null
drapeauxliste de textesCe qui doit faire lire la valeur avec prudence ; vide si rien.
Valeurs :
prix_atypique,surface_atypique,vente_en_bloc,doublon_probable,date_estimee,peu_d_observations,valeur_imputee,rattachement_incertain,donnee_anciennemethodetexte ou nullMéthode de calcul ou de rattachement, en clair.
donnees_dutexte ou nullDate de la donnée (AAAA-MM-JJ ou horodatage ISO 8601).
sourcetexteSource publique ou moteur Pillr, en clair.
creditsobjetCrédits débités par cet appel (réservés, pour une tâche en cours), et crédits encore utilisables ce mois avant la coupure : crédits offerts, crédits inclus du mois et crédits facturables sous le plafond de dépense (null si inconnus ou en bac à sable).
Afficher les 2 champsMasquer
debitesentier0 au moins
restantsentier ou null
Erreurs possibles
- 400parametres_invalidesUn paramètre manque ou ne passe pas son contrôle ; le détail est donné champ par champ
- 403hors_bac_a_sableUne clé pk_test_ l'appelle : l'opération n'a pas de bac à sable
Afficher les 11 erreurs communes à toute l'APIMasquer les erreurs communes
- 401cle_absenteL'en-tête Authorization manque
- 401cle_invalideLa clé est inconnue, révoquée ou expirée
- 403organisation_suspendueL'organisation de la clé n'est pas active
- 403portee_insuffisanteLa clé ou l'accès de l'organisation n'ouvre pas cette opération
- 402credits_insuffisantsLes crédits ne suffisent plus pour cet appel
- 429plafond_cleLe plafond mensuel de crédits de la clé est atteint
- 429quota_minuteLe débit par minute de l'organisation est atteint
- 503charge_globaleL'API est momentanément surchargée, tous clients confondus ; rien n'est débité
- 504delai_depasseLe calcul dépasse le délai de l'opération ; rien n'est débité
- 503service_indisponibleL'API est momentanément indisponible
- 500erreur_interneUne erreur de notre côté ; rien n'est servi ni débité
Une ressource absente répond par un code de la famille des ressources absentes, propre à l'opération, sans débit. Guide des erreurs