Aller au contenu

Documentation

Localisation des annonces

Retrouver l'adresse d'une annonce floutée : le résultat déjà calculé, puis chaque étape du Hub, déterministe, appuyée sur la vision ou sur Google. 6 opérations servies.

Adresse retrouvée d'une annonce

Essayer en direct
GET/api/v1/annonces/{id}/adresse
GET/api/v1/annonces/par-url/adresse

Adresse retrouvée d'une annonce floutée, par son lien Leboncoin, BienIci ou SeLoger ou par son identifiant, de quatre façons, chacune avec sa qualité : l'adresse retrouvée par le résolveur de Pillr, qui rapproche l'annonce des DPE de l'ADEME et de la Base Adresse Nationale, au meilleur niveau disponible (N1 adresse et bien sûrs, N2 adresse sûre, N3 adresse probable, E estimation qui peut désigner une autre adresse), avec son libellé, sa clé BAN, sa position et sa confiance ; les adresses que désigne l'empreinte du DPE affiché (numéro de DPE, clé BAN, écart de surface), ambiguë quand elle en désigne plusieurs ; l'adresse validée par un utilisateur de Pillr ; et, quand aucune adresse sûre, probable ou validée n'existe, les logements candidats calculés à l'appel dans le disque de flou par le DPE (même étiquette, surface à 3 m² près, même type). La résolution n'est pas relancée à l'appel : elle date du dernier passage du résolveur (resolue_le). Rien n'est débité si aucune de ces quatre réponses n'existe.

Coût
5 crédits par appel réussi
Accès
À l'usage ou avec l'abonnement Data
Portée
annonces
Outil MCP
adresse_annonce
Bac à sable
Non
Cache serveur
1 h
Délai maximal
12 s

Paramètres de /api/v1/annonces/{id}/adresse

  • idtexteobligatoire

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

    de 3 à 200 caractères

Paramètres de /api/v1/annonces/par-url/adresse

  • urltexteobligatoire

    Lien de l'annonce sur le portail d'origine (Leboncoin, BienIci, SeLoger).

    500 caractères au plus ; adresse web

Exemple d'appel

curl "https://pillr.fr/api/v1/annonces/par-url/adresse?url=https:%2F%2Fwww.leboncoin.fr%2Fad%2Fventes_immobilieres%2F2894512345" \
  -H "Authorization: Bearer $PILLR_CLE"

Réponse

  • idtexte ou null

    Identifiant Pillr de l'annonce dans la base servie ; null quand l'annonce n'est connue que des archives du lac.

  • id_portailtexte ou null

    Identifiant de l'annonce chez son portail : lbc:<n>, bienici:<id> ou seloger:<id>.

  • resolueobjet ou null

    Adresse retrouvée de l'annonce, au meilleur niveau disponible : sûre (N1, N2), sinon probable (N3), sinon estimée (E), avec son libellé et sa clé BAN (depuis le 08/11/2026) ; null si le résolveur n'a pas retrouvé d'adresse.

    Afficher les 13 champs
    • adressetexte ou null

      Libellé de l'adresse retrouvée (« 8 Rue Exemple 35000 Rennes ») ; null si la base des adresses de Pillr ne le porte pas.

    • cle_bantexte ou null

      Clé BAN de l'adresse retrouvée, celle des opérations /adresses/{cle_ban} ; null si la résolution n'en donne pas.

    • niveautexte

      Ce que vaut l'adresse : N1, adresse et bien sûrs ; N2, adresse sûre ; N3, adresse probable, à confirmer sur place ; E, estimation (l'annonce comparée aux DPE de la commune sans correspondance sûre), qui peut désigner une autre adresse, le plus souvent dans une autre rue.

      Valeurs : N1, N2, N3, E

    • latnombre
    • lonnombre
    • confiancenombre ou null

      Confiance du rattachement, de 0 à 1 : la probabilité du score du résolveur quand il en donne une (de 0,5 à 0,9 en N2 et N3, de 0,2 à 0,5 en E), sinon 0,95 en N1 et 0,85 en N2 ; null en N3 quand la règle n'en donne pas.

      de 0 à 1

    • methodetexte

      Méthode du rattachement : v3:<niveau>:<règle> (v3:N2:empreinte, v3:E:score...) pour la résolution v3, en service depuis le 26/10/2026.

    • sourcesliste de textes

      Toujours vide depuis la résolution v3 : la règle est dans methode.

    • concordance_mentier ou null

      Toujours null depuis la résolution v3.

    • rayon_disque_mentier ou null

      Toujours null depuis la résolution v3.

    • resolue_letexte ou null
    • versiontexte ou null

      Version des règles ou du score du résolveur.

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

  • empreinte_dpeobjet ou null

    Adresses retrouvées par l'empreinte du DPE affiché (étiquette, surface, date) ; null si aucune.

    Afficher les 3 champs
    • n_adressesentier

      Adresses que l'empreinte du DPE affiché désigne ; plus d'une : empreinte ambiguë.

    • candidatsliste d'objets
      Afficher les 5 champs
      • numero_dpetexte
      • cle_bantexte ou null
      • date_dpetexte ou null
      • type_batimenttexte ou null
      • ecart_surface_m2nombre ou null

        Écart entre la surface du DPE et celle de l'annonce, en m².

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

  • candidats_dpeobjet ou null

    Calculé à l'appel quand la résolution n'a ni adresse sûre ni adresse probable et qu'aucune adresse n'est validée : les logements dont le DPE enregistré à l'ADEME a la même étiquette, la même surface à 3 m² près et le même type de bâtiment, dans le disque de flou de l'annonce, du plus proche au plus éloigné (l'étape dpe de localiser_annonce). Un seul candidat désigne le plus souvent l'adresse ; plusieurs forment une liste à vérifier. null si la recherche n'a pas pu se faire (annonce sans DPE, sans surface ou sans position) ou n'a pas été nécessaire.

    Afficher les 5 champs
    • n_candidatsentier

      Adresses candidates rendues (logements distincts du DPE).

    • liste_completebooléen

      Faux quand la recherche s'est arrêtée à 12 candidats, les plus proches : d'autres logements peuvent correspondre.

    • rayon_recherche_mentier

      Rayon du disque cherché autour de la position affichée : le flou du portail (ou un rayon supposé) plus une marge.

    • candidatsliste d'objets
      Afficher les 8 champs
      • adressetexte ou null
      • cle_bantexte ou null

        Clé BAN du logement du DPE, celle des opérations /adresses/{cle_ban} ; null si l'ADEME ne la donne pas.

      • distance_mentier ou null

        Distance au centre du disque, en mètres.

      • ecart_surface_m2nombre ou null

        Surface du DPE moins celle de l'annonce, en m².

      • date_dpetexte ou null
      • type_batimenttexte ou null
      • latnombre ou null
      • lonnombre 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.

  • valideeobjet ou null

    Adresse confirmée par un utilisateur de Pillr (cache partagé des localisations) ; null si aucune.

    Afficher les 7 champs
    • adressetexte
    • latnombre ou null
    • lonnombre ou null
    • precisiontexte ou null

      Valeurs : numero, rue, lieu_dit, commune

    • confiancetexte ou null

      Ce qui a fondé la validation, en clair (Street View, DPE...).

    • letexte ou null

      Date de la validation.

    • 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

Localisation pas à pas (étapes déterministes)

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

Étapes déterministes de la localisation d'une annonce floutée, une par appel (etape), celles de l'outil du Hub : disque (centre et rayon du flou du portail, adresse BAN du centre, précision honnête des coordonnées, immeuble annoncé, adresse validée) ; dpe (DPE du miroir ADEME dans le disque, à la même étiquette, à la surface près et du même type, repli sur l'API de l'ADEME) ; dvf (ventes DVF de 2014 à 2026 du même type à 3 % de surface près, adresse retrouvée par la BAN) ; copro (copropriétés du registre national au nombre de lots annoncé) ; parcelle (maisons : parcelles du cadastre IGN à la contenance du terrain annoncé) ; batiments (bâtiments BD TOPO du disque, compatibles d'abord avec l'étage annoncé) ; geocoder (saisie q géocodée par la Base Adresse Nationale, au code postal de l'annonce ou à code_postal, et contrôlée contre le flou). Les candidats sont croisés avec les disques des rediffusions du même bien sur d'autres portails. tolerance règle l'étape : surface en m² pour dpe (1 à 15), lots pour copro (1 à 8), contenance en % pour parcelle (1 à 30). Street View, Google Maps et l'image aérienne ne sont donnés qu'en lien. Rien n'est débité quand l'annonce ne permet pas l'étape (sans étiquette DPE, sans surface, sans position, hors copropriété, sans terrain).

Coût
5 crédits par appel réussi
Accès
À l'usage ou avec l'abonnement Data
Portée
annonces
Outil MCP
localiser_annonce
Bac à sable
Non
Cache serveur
1 h
Délai maximal
30 s

Paramètres

  • idtexteobligatoire

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

    de 3 à 200 caractères

  • etapetexteobligatoire

    L'étape à exécuter.

    Valeurs : disque, dpe, dvf, copro, parcelle, batiments, geocoder

  • tolerancenombre

    Tolérance de l'étape dpe (m²), copro (lots) ou parcelle (% de contenance), bornée par l'étape.

    de 1 à 30

  • qtexte

    geocoder : la rue, le lieu ou l'adresse à géocoder.

    de 2 à 200 caractères

  • code_postaltexte

    geocoder : code postal de la recherche (par défaut, celui de l'annonce).

Exemple d'appel

curl "https://pillr.fr/api/v1/annonces/lbc:2894512345/localisation?etape=dpe" \
  -H "Authorization: Bearer $PILLR_CLE"

Réponse

  • idtexte ou null

    Identifiant Pillr de l'annonce dans la base servie ; null quand l'annonce n'est connue que des archives du lac.

  • id_portailtexte ou null

    Identifiant de l'annonce chez son portail : lbc:<n>, bienici:<id> ou seloger:<id>.

  • etapetexte

    Valeurs : disque, dpe, dvf, copro, parcelle, batiments, geocoder

  • criteresobjet

    Les critères que l'étape a appliqués.

    Afficher les 12 champs
    • dpetexte ou null

      Valeurs : A, B, C, D, E, F, G

    • type_bientexte ou null
    • surface_m2nombre ou null
    • tolerancenombre ou null

      Tolérance appliquée, après bornage par l'étape.

    • unite_tolerancetexte ou null

      Valeurs : m2, lots, pct

    • lotsentier ou null
    • terrain_m2nombre ou null
    • etageentier ou null
    • etage_minimumentier ou null
    • code_postaltexte ou null
    • qtexte ou null
    • anneesliste d'entiers ou null
  • disqueobjet ou null
    Afficher les 5 champs
    • centreobjet
      Afficher les 2 champs
      • latnombre
      • lonnombre
    • rayon_flou_mentier ou null

      Rayon du flou donné par le portail ; null quand il ne le donne pas.

    • rayon_recherche_mentier

      Rayon de recherche : le flou, ou le rayon supposé, plus la marge de géocodage.

    • originetexte

      Valeurs : flou_du_portail, coordonnees_annonce

    • rediffusions_croiseesentier ou null

      Disques des rediffusions du même bien sur d'autres portails, croisés avec celui-ci ; null quand l'étape ne les croise pas.

  • nb_candidatsentier
  • candidatsliste d'objets
    Afficher les 27 champs
    • adressetexte ou null
    • cle_bantexte ou null

      Clé BAN du candidat quand il est retrouvé au numéro ; null sinon.

    • latnombre ou null
    • lonnombre ou null
    • distance_mentier ou null

      Distance au centre du disque, en mètres.

    • ecartnombre ou null

      Écart au critère de l'étape : m² de surface (dpe, dvf), lots (copro), m² de terrain (parcelle) ; null pour batiments et geocoder.

    • dpetexte ou null

      Valeurs : A, B, C, D, E, F, G

    • gestexte ou null

      Valeurs : A, B, C, D, E, F, G

    • datetexte ou null

      Date du DPE (dpe) ou de la vente (dvf).

    • surface_m2nombre ou null
    • typetexte ou null

      Type de bâtiment du DPE (dpe).

    • periode_constructiontexte ou null
    • valeur_foncierenombre ou null

      Prix de la vente DVF, en euros (dvf).

    • lots_totalentier ou null
    • lots_habitationentier ou null
    • nom_coproprietetexte ou null

      Nom d'usage de la copropriété au registre (copro).

    • contenance_m2nombre ou null
    • sectiontexte ou null
    • numero_parcelletexte ou null
    • niveauxentier ou null

      Niveaux du bâtiment BD TOPO, sinon estimés par sa hauteur (batiments).

    • hauteur_mnombre ou null
    • usagetexte ou null
    • logementsentier ou null
    • compatible_etagebooléen ou null

      Vrai si l'étage annoncé existe dans le bâtiment ; null sans étage annoncé ou sans hauteur connue.

    • precisiontexte ou null

      Type du résultat de la Base Adresse Nationale (geocoder) : housenumber, street, locality, municipality.

    • scorenombre ou null

      Score de la Base Adresse Nationale, de 0 à 1 (geocoder).

    • liensobjet

      Liens vers le point ; null quand le point manque.

      Afficher les 3 champs
      • street_viewtexte ou null

        Lien Google Street View du point (un lien : aucune image Google n'est servie).

      • mapstexte ou null

        Lien Google Maps du point.

      • orthotexte ou null

        Image aérienne de l'IGN (Géoplateforme, service WMS) centrée sur le point.

  • dans_le_disquebooléen ou null

    geocoder : vrai si l'adresse tombe dans le flou du portail, faux pour une voie homonyme hors du disque ; null sans flou.

  • situationobjet ou null

    disque : ce que l'annonce dit de sa position ; null pour les autres étapes.

    Afficher les 8 champs
    • precisiontexte

      Précision honnête des coordonnées affichées : avec un flou, jamais au numéro.

      Valeurs : aucune, disque_de_flou, numero, rue, approchee

    • adresse_procheobjet ou null

      Adresse BAN la plus proche du centre : celle du centre du flou, pas celle du bien.

      Afficher les 4 champs
      • adressetexte
      • cle_bantexte ou null
      • typetexte
      • scorenombre
    • communetexte ou null
    • code_postaltexte ou null
    • inseetexte ou null
    • quartiertexte ou null
    • batimentobjet
      Afficher les 5 champs
      • etageentier ou null
      • nb_etagesentier ou null
      • en_coproprietebooléen ou null
      • lots_coproentier ou null
      • ascenseurbooléen ou null
    • liensobjet

      Liens vers le point ; null quand le point manque.

      Afficher les 3 champs
      • street_viewtexte ou null

        Lien Google Street View du point (un lien : aucune image Google n'est servie).

      • mapstexte ou null

        Lien Google Maps du point.

      • orthotexte ou null

        Image aérienne de l'IGN (Géoplateforme, service WMS) centrée sur le point.

  • adresse_valideeobjet ou null

    Adresse confirmée par un utilisateur de Pillr (cache partagé des localisations) ; null si aucune.

    Afficher les 7 champs
    • adressetexte
    • latnombre ou null
    • lonnombre ou null
    • precisiontexte ou null

      Valeurs : numero, rue, lieu_dit, commune

    • confiancetexte ou null

      Ce qui a fondé la validation, en clair (Street View, DPE...).

    • letexte ou null

      Date de la validation.

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

  • 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

Indices de localisation lus sur les photos

Essayer en direct
GET/api/v1/annonces/{id}/localisation/indices-photos

Lecture par vision (Gemini) des 4 premières photos et de la description d'une annonce : noms de rue, enseignes, numéros de voirie, monuments, lieux cités, vue depuis les fenêtres, quartier et indice le plus fort. Seuls des indices lus sont rendus, jamais devinés : un indice se géocode ensuite par localiser_annonce (etape geocoder) ou lieu_par_indice. Les photos sont lues sur les serveurs des portails ; la description d'un particulier est passée au modèle sans ses coordonnées.

Coût
20 crédits par appel réussi
Accès
À l'usage ou avec l'abonnement Data
Portée
annonces
Outil MCP
indices_photos
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

Exemple d'appel

curl https://pillr.fr/api/v1/annonces/lbc:2894512345/localisation/indices-photos \
  -H "Authorization: Bearer $PILLR_CLE"

Réponse

  • idtexte ou null

    Identifiant Pillr de l'annonce dans la base servie ; null quand l'annonce n'est connue que des archives du lac.

  • id_portailtexte ou null

    Identifiant de l'annonce chez son portail : lbc:<n>, bienici:<id> ou seloger:<id>.

  • vues_exterieuresbooléen

    Vrai si au moins une photo montre l'extérieur, la façade, la rue ou une vue.

  • quartiertexte ou null
  • ruesliste de textes

    Noms de rue ou de place lus sur un panneau ou dans la description.

  • enseignesliste de textes

    Enseignes de commerces lisibles.

  • numerosliste de textes

    Numéros de voirie visibles.

  • monumentsliste de textes

    Monuments, églises, gares, écoles identifiés par leur nom.

  • lieux_prochesliste de textes

    Lieux nommés dans la description.

  • vuetexte ou null

    Ce qui se voit depuis les fenêtres ou le balcon.

  • indice_principaltexte ou null

    L'indice le plus exploitable pour situer le bien.

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

Lieu réel d'un indice par Google Maps

Essayer en direct
GET/api/v1/annonces/{id}/localisation/lieux

Résout un indice de localisation (enseigne, repère, ligne de tram) en lieu réel par Gemini avec l'outil Google Maps, biaisé sur le centre du flou de l'annonce (sinon sur lat et lon, sinon sur sa position affichée) pour écarter les homonymes lointains : la réponse du modèle et 5 lieux Google Maps au plus. Le lieu trouvé se contrôle ensuite par localiser_annonce (etape geocoder), qui dit s'il tombe dans le disque. Résultat soumis aux conditions de Google Maps Platform : jamais gardé en mémoire par Pillr, la source est citée.

Coût
40 crédits par appel réussi
Accès
À l'usage ou avec l'abonnement Data
Portée
annonces
Outil MCP
lieu_par_indice
Bac à sable
Non
Cache serveur
Jamais mis en cache
Délai maximal
30 s

Paramètres

  • idtexteobligatoire

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

    de 3 à 200 caractères

  • qtexteobligatoire

    L'indice à résoudre : enseigne, repère, ligne de transport.

    de 2 à 200 caractères

  • latnombre

    Latitude du biais, quand l'annonce n'a pas de flou.

    de -90 à 90

  • lonnombre

    Longitude du biais, quand l'annonce n'a pas de flou.

    de -180 à 180

Exemple d'appel

curl "https://pillr.fr/api/v1/annonces/lbc:2894512345/localisation/lieux?q=pharmacie+rue+de+la+R%C3%A9publique" \
  -H "Authorization: Bearer $PILLR_CLE"

Réponse

  • idtexte ou null

    Identifiant Pillr de l'annonce dans la base servie ; null quand l'annonce n'est connue que des archives du lac.

  • id_portailtexte ou null

    Identifiant de l'annonce chez son portail : lbc:<n>, bienici:<id> ou seloger:<id>.

  • qtexte
  • reponsetexte

    La réponse du modèle : le lieu le plus probable, son adresse ou son quartier.

  • lieuxliste d'objets

    Les lieux Google Maps cités par la réponse.

    Afficher les 3 champs
    • titretexte
    • uritexte ou null
    • place_idtexte ou null
  • point_de_biaisobjet ou null

    Le point autour duquel la recherche est biaisée : le centre du flou, sinon lat et lon, sinon la position affichée.

    Afficher les 2 champs
    • latnombre
    • lonnombre
  • sourcetexte
  • 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

Comparaison de façade avec Street View

Essayer en direct
POST/api/v1/annonces/{id}/localisation/street-view

Compare par vision (Gemini) la façade des 4 premières photos de l'annonce aux images Google Street View de 1 à 3 adresses candidates, en une seule passe : verdict (oui, non, incertain), confiance, raison et classement des candidats. Un candidat sans couverture Street View n'est pas comparé ni payé. Les images Street View ne sont jamais servies ni gardées : seul un lien l'est. Rien n'est débité sans photo d'annonce, sans couverture ou si le service est coupé.

Coût
40 crédits par appel réussi
Accès
À l'usage ou avec l'abonnement Data
Portée
annonces
Outil MCP
street_view
Bac à sable
Non
Cache serveur
Jamais mis en cache
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

  • candidatsliste d'objets

    Les adresses candidates.

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

    Afficher les 3 champs
    • latnombreobligatoire

      de -90 à 90

    • lonnombreobligatoire

      de -180 à 180

    • libelletexte

      Adresse ou nom du candidat, repris dans le classement.

      200 caractères au plus

  • latnombre

    Un seul candidat : sa latitude (sans candidats).

    de -90 à 90

  • lonnombre

    Un seul candidat : sa longitude (sans candidats).

    de -180 à 180

  • capnombre

    Cap de la prise de vue Street View, en degrés.

    de 0 à 360

Exemple d'appel

curl -X POST https://pillr.fr/api/v1/annonces/lbc%3A2894512345/localisation/street-view \
  -H "Authorization: Bearer $PILLR_CLE" \
  -H "Content-Type: application/json" \
  -d '{"lat":49.4431,"lon":1.0993}'

Réponse

  • idtexte ou null

    Identifiant Pillr de l'annonce dans la base servie ; null quand l'annonce n'est connue que des archives du lac.

  • id_portailtexte ou null

    Identifiant de l'annonce chez son portail : lbc:<n>, bienici:<id> ou seloger:<id>.

  • correspondancetexte

    Verdict du candidat retenu : oui, non ou incertain.

    Valeurs : oui, non, incertain

  • confiancenombre ou null

    Confiance déclarée par le modèle, de 0 à 1.

    de 0 à 1

  • raisontexte ou null
  • lien_street_viewtexte ou null

    Lien Google Street View du candidat retenu (aucune image n'est servie).

  • images_compareesentier

    Images Street View réellement comparées (un candidat sans couverture n'est pas payé).

  • classementliste d'objets
    Afficher les 8 champs
    • candidatentier

      Rang du candidat dans la demande, à partir de 1.

    • libelletexte ou null
    • correspondancetexte

      Valeurs : oui, non, incertain

    • confiancenombre ou null

      de 0 à 1

    • raisontexte ou null
    • latnombre ou null
    • lonnombre ou null
    • lien_street_viewtexte 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

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

Enregistrer l'adresse validée d'une annonce

Essayer en direct
POST/api/v1/annonces/{id}/adresse-validee

Enregistre l'adresse que l'utilisateur de la clé a confirmée pour une annonce, dans le cache partagé des localisations de Pillr : une adresse par annonce, la dernière validation remplace la précédente. Elle est ensuite rendue par adresse_annonce et par localiser_annonce (etape disque), et le Hub la lit aussi. Exige une clé rattachée à un compte Pillr.

Coût
0 crédit par appel réussi
Accès
À l'usage ou avec l'abonnement Data
Portée
compte
Outil MCP
valider_adresse
Bac à sable
Non
Cache serveur
Jamais mis en cache
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

  • libelletexteobligatoire

    L'adresse confirmée, en clair.

    de 5 à 300 caractères

  • latnombre

    de -90 à 90

  • lonnombre

    de -180 à 180

  • precisiontexte

    Précision de l'adresse confirmée.

    Valeurs : numero, rue, lieu_dit, commune

  • confiancetexte

    Ce qui fonde la validation (Street View, DPE...).

    120 caractères au plus

Exemple d'appel

curl -X POST https://pillr.fr/api/v1/annonces/lbc%3A2894512345/adresse-validee \
  -H "Authorization: Bearer $PILLR_CLE" \
  -H "Content-Type: application/json" \
  -d '{"libelle":"55 rue du Faubourg Saint-Honoré 75008 Paris"}'

Réponse

  • enregistrebooléen
  • idtexte

    Identifiant Pillr de l'annonce.

  • libelletexte
  • notetexte
  • 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

    Localisation des annonces : référence de l'API | Pillr Data