Aller au contenu

Documentation

Analyse des photos

3 opérations servies.

Lecture photo par photo et rapport complet

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

Essayer en direct

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/{id}/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

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

Indice Travaux et état du parc en vente

GET/api/v1/travaux/{maille}

Pour un code postal ou une commune, un mois d'entrée au catalogue et un type de bien : biens lus (une fiche par bien), état visuel médian lu sur les photos, part des biens à rénover, coût médian des travaux et au m², avec l'incertitude mesurée du chiffrage. Le coût vient du barème déterministe d'artisans appliqué aux postes vus sur les photos, jamais d'un montant écrit par le modèle ; les annonces aux photos de catalogue sont écartées et comptées. Par défaut le dernier mois calculé et tous les types. Rien n'est masqué : une maille à peu de biens est servie avec le drapeau peu_d_observations. Maille inconnue : 404 ressource_absente, rien n'est débité.

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

Essayer en direct

Paramètres

  • mailletexteobligatoire

    Code postal ou code INSEE de la commune.

  • type_mailletexte

    code_postal ou insee ; sans lui, le code est lu comme un code postal s'il en est un, sinon comme un code INSEE.

    Valeurs : code_postal, insee

  • moistexte

    Mois d'entrée des annonces au catalogue (AAAA-MM) ; par défaut le dernier calculé.

  • typetexte

    appartement ou maison ; par défaut, les deux et leur ensemble.

    Valeurs : appartement, maison

Exemple d'appel

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

Réponse

  • mailleobjet
    Afficher les 2 champs
    • typetexte

      Valeurs : code_postal, insee

    • codetexte
  • moistexte

    Mois d'entrée des annonces au catalogue (AAAA-MM).

  • segmentsliste d'objets
    Afficher les 12 champs
    • type_bientexte

      Valeurs : appartement, maison, tous

    • nentier

      Biens distincts lus (une fiche par bien, empreinte de diffusion).

    • n_annoncesentier

      Annonces analysées avant le dédoublonnage.

    • etat_mediannombre ou null

      État visuel médian lu sur les photos, de 0 (à reprendre) à 100 (neuf).

    • part_a_renover_pctnombre ou null

      Part des biens à rénover d'après leurs photos, en %.

    • cout_mediannombre ou null

      Coût médian des travaux (milieu de la fourchette du barème), en euros.

    • cout_min_mediannombre ou null
    • cout_max_mediannombre ou null
    • cout_median_m2nombre ou null

      Coût médian des travaux rapporté à la surface, en euros par m².

    • incertitude_pctobjet

      Écart médian mesuré entre deux analyses d'un même bien sur le chiffrage, en % : l'incertitude du coût.

      Afficher les 3 champs
      • basnombre
      • hautnombre
      • mesuree_letexte
    • photos_catalogue_excluesentier

      Annonces écartées parce que leurs photos sont des photos de catalogue.

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

  • methodetexte
  • donnees_dutexte ou null

    Date du calcul de l'indice (horodatage ISO 8601).

  • creditsobjet

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

    Afficher les 2 champs
    • debitesentier

      0 au moins

    • restantsentier ou null

Erreurs possibles

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

Indice Travaux et état du parc en vente, en lot

POST/api/v1/travaux/lot

Indice Travaux et état du parc en vente pour 100 éléments au plus en un appel : chaque élément est servi ou refusé seul, avec son code d'erreur, et seuls les éléments servis sont débités. Pour un code postal ou une commune, un mois d'entrée au catalogue et un type de bien : biens lus (une fiche par bien), état visuel médian lu sur les photos, part des biens à rénover, coût médian des travaux et au m², avec l'incertitude mesurée du chiffrage. Le coût vient du barème déterministe d'artisans appliqué aux postes vus sur les photos, jamais d'un montant écrit par le modèle ; les annonces aux photos de catalogue sont écartées et comptées. Par défaut le dernier mois calculé et tous les types. Rien n'est masqué : une maille à peu de biens est servie avec le drapeau peu_d_observations. Maille inconnue : 404 ressource_absente, rien n'est débité.

Coût
2 crédits par élément rendu
Accès
À l'usage ou avec l'abonnement Data
Portée
analyses_photo
Outil MCP
travaux_zone_lot
Bac à sable
Non
Mémoire
Jamais gardée
Délai
75 s

Essayer en direct

Paramètres

  • elementsliste d'objetsobligatoire

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

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

    Afficher les 4 champs
    • mailletexteobligatoire

      Code postal ou code INSEE de la commune.

    • type_mailletexte

      code_postal ou insee ; sans lui, le code est lu comme un code postal s'il en est un, sinon comme un code INSEE.

      Valeurs : code_postal, insee

    • moistexte

      Mois d'entrée des annonces au catalogue (AAAA-MM) ; par défaut le dernier calculé.

    • typetexte

      appartement ou maison ; par défaut, les deux et leur ensemble.

      Valeurs : appartement, maison

Exemple d'appel

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

Réponse

  • resultatsliste de valeurs

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

  • n_okentier

    0 au moins

  • n_erreursentier

    0 au moins

  • creditsobjet

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

    Afficher les 2 champs
    • debitesentier

      0 au moins

    • restantsentier ou null

Erreurs possibles

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

    Analyse des photos : référence de l'API | Pillr Data