Aller au contenu

Documentation

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
GET/api/v1/annonces/{id}/analyse-detaillee

Ce 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

  • idtexteobligatoire

    Identifiant de l'annonce : lbc:<numéro>, bienici:<identifiant>, seloger:<numéro> ou identifiant Pillr.

    de 3 à 200 caractères

  • voletstexte

    Volets à 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

  • idtexte

    Identifiant Pillr de l'annonce.

  • id_portailtexte ou null

    Identifiant chez le portail : lbc:<n>, bienici:<id> ou seloger:<id>.

  • type_vendeurtexte

    Statut 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, inconnu

  • voletsliste de textes

    Les volets servis.

    Valeurs : photos, rapport

  • moteurobjet

    Le moteur d'analyse de Pillr qui a produit ces valeurs.

    Afficher les 3 champs
    • modeletexte ou null

      Modèle qui a produit l'analyse, tel que le moteur l'a noté.

    • versionnombre ou null

      Version du moteur d'analyse.

    • analyse_letexte ou null

      Date de l'analyse (ISO 8601).

  • photosobjet ou null

    Volet photos ; null s'il n'est pas demandé ou si l'annonce n'a pas de lecture des photos.

    Afficher les 13 champs
    • photos_totalentier

      0 au moins

    • photos_exploitablesentier

      0 au moins

    • qualite_annoncenombre ou null

      Part 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 textes
    • pieces_manquantesliste de textes

      Pièces clés absentes des photos (cuisine, salle de bain, salon, façade).

    • defautsobjet
      Afficher les 3 champs
      • mineurentier
      • moyenentier
      • majeurentier
    • travaux_groupesliste d'objets

      Travaux 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 champs
      • postetexte
      • intensitetexte ou null
      • libelletexte
      • cout_minnombre
      • cout_maxnombre
      • prioritetexte ou null
      • justificationsliste de textes
      • photosliste d'entiers

        Rangs des photos qui fondent ce poste.

    • travaux_ecartesliste d'objets

      Travaux proposés par la vision et écartés faute de preuve sur la photo, avec leur motif.

      Afficher les 3 champs
      • postetexte
      • motiftexte
      • photoentier ou null
    • travauxobjet

      Total des travaux du barème, avant imprévus : plancher énergétique et rénovation complète compris.

      Afficher les 3 champs
      • minnombre ou null
      • maxnombre 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.

    • plancher_energieobjet ou null

      Ligne énergie déduite d'un DPE E, F ou G quand elle relève le total ; null sinon.

      Afficher les 3 champs
      • classetexte
      • cout_minnombre
      • cout_maxnombre
    • par_photoliste d'objets
      Afficher les 8 champs
      • indexentier

        Rang de la photo dans la liste lue (0 pour la première).

        0 au moins

      • piecetexte

        Piè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éen
      • motiftexte ou null

        Pourquoi la photo est inexploitable ; null sinon.

      • observationsliste de textes
      • defautsliste d'objets
        Afficher les 3 champs
        • libelletexte
        • gravitetexte

          Valeurs : mineur, moyen, majeur

        • postetexte

          Poste de travaux auquel le défaut se rattache.

      • travauxliste d'objets
        Afficher les 7 champs
        • postetexte
        • intensitetexte ou null

          leger, moyen ou lourd : l'intervention décrite, qui pilote le barème.

        • libelletexte
        • justificationtexte ou null

          Ce que le modèle de vision voit sur la photo.

        • prioritetexte ou null

          urgent, recommande ou optionnel.

        • cout_min_indicatifnombre ou null

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

  • rapportobjet ou null

    Volet rapport ; null s'il n'est pas demandé ou si aucun rapport n'existe pour le lien de l'annonce.

    Afficher les 10 champs
    • bienobjet

      Le bien tel que l'analyse l'a lu.

      Afficher les 12 champs
      • titretexte ou null
      • typetexte ou null
      • prixnombre ou null
      • surfacenombre ou null
      • piecesnombre ou null
      • localisationtexte ou null

        Commune et code postal, tels que l'analyse les a lus.

      • dpetexte ou null
      • annee_constructionnombre ou null
      • terrain_m2nombre ou null
      • premiere_parutiontexte ou null
      • descriptiontexte ou null
      • lientexte ou null

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

    • financierobjet

      Le plan financier de la page d'analyse, avec le crédit qu'il suppose.

      Afficher les 14 champs
      • prix_achatnombre ou null
      • investissement_totalnombre ou null
      • loyer_mensuelnombre ou null
      • loyer_annuelnombre ou null
      • charges_mensuellesnombre ou null
      • charges_annuellesnombre ou null
      • cash_flow_annuelnombre ou null
      • cap_rate_pctnombre ou null

        Loyer annuel rapporté au prix, en %.

      • roi_pctnombre ou null

        Cash-flow annuel rapporté à l'apport, en %.

      • mensualitenombre ou null
      • montant_empruntenombre ou null
      • duree_anneesnombre ou null
      • taux_interet_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.

    • notationobjet

      La notation sur six axes de la page d'analyse, sur 100.

      Afficher les 6 champs
      • globalenombre ou null
      • financierenombre ou null
      • localisationnombre ou null
      • biennombre ou null
      • marchenombre ou null
      • risquenombre ou null
    • scores_modeleobjet ou null

      Les sous-scores du modèle sur 100 (etat, marche, rentabilite, potentiel, localisation, transport, fiscalite, risques, qualite_annonce) ; null pour un rapport antérieur.

    • noteobjet
      Afficher les 2 champs
      • lettretexte ou null
      • libelletexte ou null
    • anomaliesliste d'objets

      Anomalies relevées par le moteur de règles, annonce contre marché.

      Afficher les 3 champs
      • typetexte
      • severitetexte
      • messagetexte
    • analyseobjet

      L'analyse rédigée par le modèle, telle que la page d'analyse la montre.

      Afficher les 13 champs
      • verdicttexte ou null

        ACHAT_RECOMMANDE, ACHAT_SOUS_CONDITIONS ou ACHAT_DECONSEILLE.

      • resumetexte ou null
      • synthesetexte ou null
      • forcesliste d'objets
        Afficher les 3 champs
        • titretexte
        • detailtexte ou null
        • impact_eurnombre ou null
      • faiblessesliste d'objets

        Tous les points d'attention du modèle.

        Afficher les 5 champs
        • titretexte
        • detailtexte ou null
        • gravitetexte ou null

          FAIBLE, MOYEN, ELEVE ou CRITIQUE, tel que le modèle l'a noté.

        • impact_eurnombre ou null
        • solutiontexte ou null
      • risquesliste d'objets

        Les points d'attention de gravité ELEVE ou CRITIQUE.

        Afficher les 5 champs
        • titretexte
        • detailtexte ou null
        • gravitetexte ou null

          FAIBLE, MOYEN, ELEVE ou CRITIQUE, tel que le modèle l'a noté.

        • impact_eurnombre ou null
        • solutiontexte ou null
      • opportunitesliste d'objets

        Les travaux d'amélioration proposés par le modèle, avec leur valorisation.

        Afficher les 5 champs
        • postetexte
        • cout_minnombre ou null
        • cout_maxnombre ou null
        • valorisation_pctnombre ou null
        • justificationtexte ou null
      • conditionsliste de textes
      • plan_actionliste de textes
      • analyse_phototexte ou null
      • recommandationtexte ou null

        La recommandation rédigée de la page d'analyse.

      • confianceobjet
        Afficher les 3 champs
        • niveautexte ou null

          high, medium ou low, déclaré par le modèle.

        • facteursliste de textes
        • limitesliste de textes
      • sourcesliste de textes

        Sources que le modèle déclare avoir utilisées.

    • marcheobjet ou null

      La photo du marché communal utilisée par l'analyse : les indicateurs de la commune au jour de l'analyse.

    • 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

  • 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'API

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

Écart au marché, anomalies et ventes du rayon

Essayer en direct
GET/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

  • idtexteobligatoire

    Identifiant de l'annonce : lbc:<numéro>, bienici:<identifiant>, seloger:<numéro> ou identifiant Pillr.

    de 3 à 200 caractères

  • rayon_mentier

    Rayon 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

  • idtexte
  • id_portailtexte ou null
  • type_vendeurtexte

    Statut 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, inconnu

  • prix_m2_annoncenombre ou null
  • prix_m2_marchenombre ou null

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

  • verdicttexte

    Valeurs : tres_sous_cote, sous_cote, au_marche, sur_cote, tres_sur_cote, inconnu

  • signal_mltexte ou null

    Signal du modèle prédictif départemental (un signal, jamais la valeur du marché).

  • referenceobjet
    Afficher les 5 champs
    • communetexte ou null
    • code_inseetexte ou null
    • code_postaltexte ou null
    • provenancetexte ou null

      dvf : médiane de ventes notariées ; estimation : modèle Pillr, faute de ventes locales du type.

      Valeurs : dvf, estimation

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

  • anomaliesliste d'objets
    Afficher les 3 champs
    • typetexte
    • severitetexte
    • messagetexte
  • donnees_annonceobjet
    Afficher les 9 champs
    • travaux_statuttexte ou null
    • travaux_minnombre ou null
    • travaux_maxnombre ou null
    • rendement_brutnombre ou null
    • rendement_netnombre ou null
    • loyernombre ou null
    • loyer_sourcetexte ou null
    • scorenombre ou null
    • profiltexte ou null
  • negociationobjet
    Afficher les 3 champs
    • cible_minnombre ou null
    • cible_maxnombre ou null
    • leviersliste de textes
  • ventes_rayonobjet
    Afficher les 13 champs
    • rayon_mentier
    • nentier

      Ventes typiques du type de l'annonce dans le rayon, toutes années.

      0 au moins

    • mediane_m2nombre ou null
    • q1nombre ou null
    • q3nombre ou null
    • minnombre ou null
    • maxnombre ou null
    • millesimestexte ou null
    • agregatsliste d'objets
      Afficher les 11 champs
      • type_bientexte

        Valeurs : appartement, maison

      • periodetexte
      • nb_ventesentier

        0 au moins

      • prix_m2_mediannombre ou null
      • prix_m2_q1nombre ou null
      • prix_m2_q3nombre ou null
      • prix_m2_minnombre ou null
      • prix_m2_maxnombre ou null
      • surface_mediane_m2nombre ou null
      • derniere_vente_letexte ou null
      • nb_prix_atypiquesentier

        Ventes du groupe écartées de l'agrégat pour prix atypique (listées une par une).

        0 au moins

    • par_anneeliste d'objets
      Afficher les 11 champs
      • type_bientexte

        Valeurs : appartement, maison

      • periodetexte
      • nb_ventesentier

        0 au moins

      • prix_m2_mediannombre ou null
      • prix_m2_q1nombre ou null
      • prix_m2_q3nombre ou null
      • prix_m2_minnombre ou null
      • prix_m2_maxnombre ou null
      • surface_mediane_m2nombre ou null
      • derniere_vente_letexte ou null
      • nb_prix_atypiquesentier

        Ventes du groupe écartées de l'agrégat pour prix atypique (listées une par une).

        0 au moins

    • ventesliste d'objets

      Toutes les ventes du rayon, une par une, les plus proches d'abord, chacune avec son drapeau prix_atypique.

      Afficher les 10 champs
      • datetexte
      • adressetexte ou null

        Numéro et voie tels que DVF les écrit ; null sans numéro.

      • type_bientexte

        Valeurs : appartement, maison

      • surface_m2nombre
      • prixnombre ou null

        Valeur foncière de la mutation entière.

      • prix_m2nombre
      • distance_mnombre ou null
      • id_mutationtexte ou null
      • prix_atypiquebooléen
      • motif_atypiquetexte ou null
    • notetexte 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.

  • 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

  • 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'API

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

Recommandation de négociation et lettre d'offre

Essayer en direct
POST/api/v1/annonces/{id}/negociation

Recommandation 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

  • idtexteobligatoire

    Identifiant de l'annonce : lbc:<numéro>, bienici:<identifiant>, seloger:<numéro> ou identifiant Pillr.

    de 3 à 200 caractères

  • prix_proposeentier

    Votre prix proposé, en euros ; à défaut, le prix recommandé est calculé.

    de 1 000 à 50 000 000

  • tontexte

    Ton de la lettre (défaut : neutre).

    Valeurs : cordial, neutre, ferme

  • destinatairetexte

    À 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

  • idtexte
  • id_portailtexte ou null
  • type_vendeurtexte

    Statut 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, inconnu

  • prix_demandenombre
  • recommandationobjet
    Afficher les 5 champs
    • prix_proposenombre
    • remisenombre
    • remise_pctnombre
    • originetexte

      calcul : prix demandé moins les travaux et une marge, borné ; client : le prix proposé par l'appelant.

      Valeurs : calcul, client

    • methodetexte
  • cibleobjet
    Afficher les 3 champs
    • minnombre ou null
    • maxnombre 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.

  • leviersliste de textes

    Leviers de négociation relevés par l'analyse de l'annonce.

  • argumentsliste de textes

    Arguments rédigés par l'IA, tirés du seul contexte servi.

  • lettretexte

    Lettre de proposition d'achat, à compléter du nom et de la date.

  • vieobjet
    Afficher les 5 champs
    • premiere_parutiontexte ou null
    • jours_en_lignenombre ou null
    • baissesentier

      0 au moins

    • baisse_cumulee_pctnombre ou null
    • dernier_changement_letexte ou null
  • ecart_marcheobjet
    Afficher les 3 champs
    • prix_m2_annoncenombre ou null
    • prix_m2_marchenombre ou null
    • ecart_pctnombre ou null
  • sourcesliste de textes
  • moteurobjet
    Afficher les 2 champs
    • modeletexte ou null
    • genere_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

Afficher les 11 erreurs communes à toute l'API

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

Potentiel de division d'un bien

Essayer en direct
GET/api/v1/annonces/{id}/division

Potentiel 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

  • idtexteobligatoire

    Identifiant 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

  • idtexte
  • id_portailtexte ou null
  • type_vendeurtexte

    Statut 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, inconnu

  • communetexte ou null
  • surface_bien_m2nombre ou null
  • piecesnombre ou null
  • terrain_annonce_m2nombre ou null

    Terrain déclaré par le portail.

  • prix_m2_biennombre ou null
  • prix_m2_marchenombre ou null
  • ecart_prix_m2_pctnombre ou null
  • score_demandenombre ou null

    Score de demande locative de la commune, sur 100.

  • pointobjet
    Afficher les 3 champs
    • latnombre ou null
    • lonnombre ou null
    • precisiontexte

      adresse, approchee, centre de la commune ou inconnue : la précision du point donné par le portail.

  • parcelleobjet ou null

    Parcelle cadastrale qui contient le point de l'annonce (API Carto de l'IGN) ; null sans point ou sans réponse.

    Afficher les 4 champs
    • contenance_m2nombre ou null
    • sectiontexte ou null
    • numerotexte ou null
    • communetexte ou null
  • potentiel_decoupetexte

    Valeurs : faible, modere, eleve

  • signauxliste de textes
  • qualiteobjet

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

    Afficher les 7 champs
    • nentier ou null

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

      0 au moins

    • provenancetexte ou null

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

      Valeurs : mesure, estime

    • incertitudeobjet ou null

      Incertitude de la valeur : fourchette et demi-largeur.

      Afficher les 3 champs
      • demi_largeur_pctnombre ou null

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

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

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

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

    • methodetexte ou null

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

    • donnees_dutexte ou null

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

    • sourcetexte

      Source publique ou moteur Pillr, en clair.

  • creditsobjet

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

    Afficher les 2 champs
    • debitesentier

      0 au moins

    • restantsentier ou null

Erreurs possibles

  • 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'API

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

    Analyses d'annonce : référence de l'API | Pillr Data